LM Studio로 OpenAI 코드 로컬에서 돌리기

LM Studio · 파이썬 · 읽는 데 12분 · 2026-09-30 확인

LM Studio는 모델 검색·다운로드·대화를 화면으로 할 수 있는 로컬 AI 앱이에요. 터미널이 낯설면 Ollama보다 편해요.

핵심은 로컬 서버예요. OpenAI API와 같은 모양의 주소를 내 컴퓨터에 열어 줘서, 이미 짜 둔 OpenAI 코드를 거의 안 고치고 공짜로 시험해 볼 수 있어요.

1단계앱 설치하고 모델 받기

lmstudio.ai에서 내 운영체제용 앱을 받아 설치하고 한 번 실행해요.
앱 안에서 모델을 검색해 받아도 되고, 터미널에서 lms 명령으로 받아도 돼요. lms는 앱을 한 번 실행하면 같이 깔려요.
```
lms get openai/gpt-oss-20b
```
받은 모델 이름을 확인해요. 코드에 이 이름을 그대로 적어야 해요.
```
lms ls
```

2025년 7월부터 회사 업무에 써도 따로 신청할 필요 없이 무료예요. 다만 앱 자체는 오픈소스가 아니고, lms 명령 도구만 MIT 라이선스예요.

2단계로컬 서버 켜기

터미널에서 서버를 켜요. 기본 포트(프로그램끼리 통하는 문 번호)는 1234예요.
```
lms server start
```
제대로 켜졌는지 모델 목록 주소를 불러 봐요. 받은 모델들이 JSON으로 나오면 성공이에요.
```
curl http://localhost:1234/v1/models
```
다 쓰면 끄세요.
```
lms server stop
```

앱 화면의 개발자(Developer) 쪽에서도 서버를 켜고 끌 수 있어요.

3단계OpenAI 코드를 그대로 연결하기

OpenAI 파이썬 라이브러리를 깔아요(파이썬 3.10 이상).
```
pip install openai
```
맥·리눅스 터미널에서 주소와 키를 환경변수로 넣어요. 로컬 서버는 키를 검사하지 않지만 라이브러리가 빈칸을 싫어해서 아무 글자나 넣어요.
```
export OPENAI_BASE_URL=http://localhost:1234/v1
export OPENAI_API_KEY=lm-studio
export MODEL=openai/gpt-oss-20b
```

윈도우 PowerShell이라면 이렇게요.

$env:OPENAI_BASE_URL="http://localhost:1234/v1"
$env:OPENAI_API_KEY="lm-studio"
$env:MODEL="openai/gpt-oss-20b"

아래를 ask.py로 저장해 실행해요. 코드 안에는 주소도 키도 없어요.

import os
from openai import OpenAI

client = OpenAI()  # OPENAI_BASE_URL, OPENAI_API_KEY 를 알아서 읽어요
res = client.chat.completions.create(
    model=os.environ["MODEL"],
    messages=[{"role": "user", "content": "보고서 첫 문장 세 가지 버전으로 써 줘"}],
)
print(res.choices[0].message.content)

나중에 진짜 OpenAI로 바꿀 땐 OPENAI_BASE_URL을 지우고 진짜 키와 모델 이름만 넣으면 끝이에요. 코드는 한 글자도 안 바뀝니다.
지원 주소: /v1/models, /v1/chat/completions, /v1/responses, /v1/embeddings, /v1/completions.

비싼 API로 수백 번 시험하기 전에 여기서 먼저 굴려 보세요. 전기세는 조금 나와요.

출처 (2026-09-30 확인)
LM Studio 문서 — OpenAI 호환 주소 — https://lmstudio.ai/docs/app/api/endpoints/openai
LM Studio 문서 — lms 명령 도구 — https://lmstudio.ai/docs/cli
LM Studio 블로그 — 업무용 무료 전환(2025-07-08) — https://lmstudio.ai/blog/free-for-work
GitHub lmstudio-ai/lms (MIT 라이선스) — https://github.com/lmstudio-ai/lms
GitHub openai/openai-python (Apache-2.0) — https://github.com/openai/openai-python