LM Studio 로컬 LLM 설치하고 API 서버 5분 만에 열기

LM Studio 로컬 LLM 설치하고 API 서버 5분 만에 열기

LM Studio 로컬 LLM 설치하고 API 서버 5분 만에 열기

인터넷 연결이 없어도 돌아가는 나만의 인공지능 API 서버 만들기

매달 나가는 OpenAI API 비용이 부담스러워질 때쯤이면 자연스럽게 대안을 찾게 됩니다. 특히 내부 코드나 개인 문서를 상용 API에 그대로 보내는 게 찜찜한 개발자라면 더더욱 그렇습니다. 이런 상황에서 가장 직관적인 선택지는 내 컴퓨터를 직접 활용하는 방식입니다. 복잡한 서버 세팅 없이 GUI 몇 번만으로 로컬 서버를 만들 수 있는 도구 가운데, LM Studio는 꽤 눈에 띄는 선택지입니다. 하드웨어만 받쳐주면 프라이빗한 AI 환경을 바로 열 수 있습니다.

Step 1: 내 운영체제에 맞는 LM Studio 클라이언트 받기

첫 단계는 공식 페이지에서 클라이언트를 내려받는 일입니다. 윈도우용은 물론이고 애플 실리콘 맥OS용 빌드도 준비되어 있어서, 자기 환경에 맞는 파일만 고르면 됩니다. 설치 과정도 복잡하지 않습니다. 실행 파일을 열면 필요한 구성 요소가 자동으로 들어가고, 별도의 세부 경로를 길게 묻지 않는 편입니다. 다만 관리자 권한 문제로 설치가 멈추는 경우가 있으니, 그럴 때는 실행 파일을 우클릭해서 권한을 높여 다시 시도하면 됩니다. 설치가 끝난 뒤 앱을 처음 열었을 때 홈 화면이 정상적으로 보이면 첫 관문은 통과한 셈입니다.

Step 2: 사양에 맞는 GGUF 파일 검색 후 다운로드하기

이제 실제로 돌릴 모델 파일을 골라야 합니다. 화면 왼쪽의 검색 탭에서 Llama 3이나 Qwen 같은 오픈소스 모델을 찾아보면 선택지가 꽤 많습니다. 내장 그래픽이나 평범한 메모리 환경이라면 4비트 양자화가 적용된 GGUF 포맷을 우선 보는 편이 좋습니다. 그래야 하드웨어 부담을 줄이면서도 쓸 만한 속도를 기대할 수 있기 때문입니다. 리포지토리에 등록된 배포본 중에서는 다운로드 수가 높고 검증된 패키지를 고르는 편이 안전합니다. 필요한 파일을 내려받아 내 컴퓨터 저장공간에 얹어두면 다음 단계로 넘어갈 준비가 끝납니다.

Step 3: 로컬 채팅을 켜고 GPU Offload 슬라이더 맞추기

다운로드한 파일이 제대로 움직이는지는 채팅 화면에서 먼저 확인하는 게 좋습니다. 왼쪽 말풍선 아이콘을 열고, 맨 위 선택 박스에서 방금 받은 로컬 파일을 불러오면 됩니다. 이때 그래픽카드를 제대로 활용하려면 우측 설정 패널의 하드웨어 가속 옵션을 켜 두는 편이 낫습니다. GPU Offload 슬라이더를 가능한 한 많이 올리면 레이어 연산을 그래픽 메모리에 더 많이 맡길 수 있어서 응답 속도가 훨씬 나아집니다. 반대로 시스템 메모리나 VRAM이 버티지 못해 끊기거나 튕긴다면 슬라이더를 절반 정도로 낮춰 다시 맞추면 됩니다. 무조건 끝까지 올리는 것보다 내 사양에 맞게 균형을 잡는 쪽이 안정적입니다.

Step 4: OpenAI 호환 API 서버 구동시키기

채팅창에서 질문을 넣었을 때 답변 속도와 한글 출력이 자연스럽게 나오는 걸 확인했다면, 이제 API 서버를 열 차례입니다. 좌측 하단의 랜선 커넥터 모양 버튼을 누르면 포트 설정과 서버 상태를 다루는 화면이 나타납니다. 포트 번호는 겹치지 않게 기본 1234 포트를 유지한 뒤 Start Server 버튼을 클릭하면 서버가 본격적으로 동작합니다. 서버가 켜지면 아래쪽 로그 콘솔에 요청을 받을 준비가 되었다는 메시지가 계속 찍힙니다. 외부 확장 도구나 Vibe 코딩 툴에서 바로 연결해 쓸 수 있도록 창을 띄워 둔 채로 두면 작업이 편합니다.

Step 5: 터미널 Curl 명령어로 API 응답 확인하기

서버가 실제로 외부 요청을 받아 응답하는지는 터미널에서 직접 한 번 찍어보는 게 가장 빠릅니다. 아래처럼 간단한 요청을 복사해서 PowerShell이나 터미널에 붙여 넣고 실행하면 됩니다.

curl http://localhost:1234/v1/chat/completions -H "Content-Type: application/json" -d "{\"messages\": [{\"role\": \"user\", \"content\": \"안녕\"}]}"

로그 창에 요청이 들어온 기록이 남고, 터미널에 JSON 형태의 응답이 돌아오면 로컬 API 서버가 정상적으로 열린 것입니다. 만약 접속 권한 에러가 나온다면 로컬 방화벽에서 들어오는 트래픽 허용이 빠졌는지 확인해 보는 편이 좋습니다. 그 다음에는 외부 에이전트 툴에서 http://localhost:1234/v1 주소를 넣고, API 키 없이 로컬 LLM 기반 작업을 이어가면 됩니다.

유료 구독료 부담을 줄이면서 로컬 캐시를 마음껏 쌓고, 원하는 만큼 쿼리를 테스트하고 싶은 사람에게는 꽤 매력적인 환경입니다. 그래픽카드 팬 소리와 전기세는 조금 신경 쓰이겠지만, 오프라인에서 안정적으로 코딩 작업을 이어갈 수 있다는 장점이 더 크게 느껴집니다. 집에 있는 게이밍 PC 사양이 괜찮다면, 퇴근 후 바로 설치해서 테스트해 보는 주말 프로젝트로도 충분히 괜찮습니다. LM Studio로 로컬 LLM을 직접 설치해 두면, 필요할 때마다 내 컴퓨터에서 바로 API 서버를 여는 흐름이 훨씬 단순해집니다.

관련 검색어

  • 🔍 LM Studio 사용법
  • 🔍 LM Studio 비교
  • 🔍 로컬 LLM 사용법
  • 🔍 로컬 LLM 비교
  • 🔍 AI API 사용법
  • 🔍 AI API 비교

댓글 쓰기

다음 이전