도구별 실전 가이드 · 공식 정보 확인 2026-08-20

claude-code-local MIT 오픈소스 조건과 시작 절차

작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: macOS · 페이지 갱신: · 운영·편집 기준

MLX 모델을 Anthropic 호환 API로 제공해 Claude Code를 네트워크 없이 로컬 모델에 연결한다.

MLX 모델을 Anthropic 호환 API로 제공해 Claude Code를 네트워크 없이 로컬 모델에 연결한다. claude-code-local의 첫 실전 과제는 “샘플 저장소에서 작은 모델로 README 구조만 요약하게 한다”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.

이럴 때 맞습니다

  • “코드를 수정하지 말고 src와 tests 디렉터리 역할을 각각 세 줄로 정리” 같은 입력으로 claude-code-local의 핵심 기능을 시험하려는 사람
  • Claude Code 요청이 로컬 서버 주소로만 가고 파일 변경 없이 저장소 구조를 맞게 설명한다. 기준으로 claude-code-local 결과를 직접 검수할 수 있는 경우
  • macOS 환경에서 MIT 코드를 직접 설치·관리하려는 작업

이럴 때는 멈추세요

  • Apple Silicon용 로컬 Anthropic API 호환 Claude Code 서버 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
  • 다음 위험을 사람이 확인할 수 없는 작업: 30B~122B 모델은 통합 메모리를 크게 요구하며 로컬 추론이어도 Claude Code의 셸·파일 실행 권한과 모델 가중치 라이선스는 별도 관리해야 한다.

참고 시작점

팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.

Apple Silicon 메모리·MLX 모델 선택

통합 메모리에 맞는 MLX 모델과 Anthropic 호환 서버가 준비된다.

참고 시작점: macOS 메모리와 모델 크기를 비교해 Muse-Glimmer 또는 작은 모델을 고르고 서버를 열어 달라.

  1. Apple Silicon 칩과 사용 가능 메모리를 기록한다.
  2. MLX 모델의 파라미터·양자화 크기를 확인한다.
  3. Anthropic API 호환 endpoint를 localhost에 시작한다.

Claude Code를 airgap 서버에 연결

Claude Code가 로컬 endpoint로 README 구조를 요약한다.

참고 시작점: 환경을 로컬 서버로 지정하고 src와 tests 역할을 세 줄씩 설명하게 해 달라. 실행 로그에서 “offline” 표기를 찾아 해당 단계와 함께 남겨 달라.

  1. 클라우드 Anthropic 키를 세션에서 제거한다.
  2. Claude Code의 base URL을 localhost로 설정한다.
  3. 파일 수정 금지 지시와 함께 README를 질문한다.

요청 경로·메모리 압력 확인

외부 네트워크 요청이 없고 모델이 swap 없이 완료된다.

참고 시작점: 서버 로그와 macOS 메모리 압력을 확인해 로컬 요청과 무수정 상태를 보고해 달라. “Muse-Glimmer”·“Qwen”·“local AI”라는 공식 용어가 실제 설정·출력과 어떻게 대응하는지도 표시해 달라.

  1. 요청 대상과 모델 이름을 서버 로그에서 본다.
  2. Activity Monitor에서 memory pressure를 기록한다.
  3. Git diff와 외부 연결이 모두 비어 있는지 확인한다.

무료 조건과 주의점

MIT 오픈소스 소프트웨어로 로컬 실행 횟수 제한 없음. 모델 다운로드와 GPU·전기 비용은 사용자 부담

MIT 오픈소스 소프트웨어로 로컬 실행 횟수 제한 없음. 모델 다운로드와 GPU·전기 비용은 사용자 부담

MIT 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.

30B~122B 모델은 통합 메모리를 크게 요구하며 로컬 추론이어도 Claude Code의 셸·파일 실행 권한과 모델 가중치 라이선스는 별도 관리해야 한다.

공식 근거와 확인일

claude-code-local 가이드의 주장별 공식 출처
확인 항목확인한 내용공식 출처·확인일
제품 정보MLX 모델을 Anthropic 호환 API로 제공해 Claude Code를 네트워크 없이 로컬 모델에 연결한다.claude-code-local 공식 사이트
무료 조건MIT 오픈소스 소프트웨어로 로컬 실행 횟수 제한 없음. 모델 다운로드와 GPU·전기 비용은 사용자 부담공식 무료 정책·요금 안내
공식 코드 라이선스오픈소스 코드의 사용·수정·재배포 조건공식 코드 라이선스
공식 제품 페이지MLX 모델을 Anthropic 호환 API로 제공해 Claude Code를 네트워크 없이 로컬 모델에 연결한다.공식 제품 페이지