보유한 기기를 하나의 AI 클러스터로 묶어 대형 모델을 여러 Mac과 다른 컴퓨터에서 로컬로 실행합니다.
nicedreamzapp/claude-code-local
Apple Silicon Mac에서 MLX로 오픈 모델을 실행하고 Anthropic API 호환 서버로 제공해 Claude Code를 오프라인으로 사용합니다.
대체할 수 있는 제품:Claude Code
- 스타
- 3,372
- 포크
- 652
- 열린 이슈
- 3
- 마지막 커밋
- 5일 전
어떤 프로젝트인가요?
Claude Code Local은 Apple의 MLX 프레임워크를 사용해 Mac 칩에서 오픈 모델을 실행하고, Claude Code에 Anthropic Messages API 형식으로 응답하는 소형 Python 서버(proxy/server.py)입니다. Claude Code가 로컬 서버와 직접 통신하므로 클라우드 모델이나 API 키가 필요 없고, 프롬프트와 코드는 기기 밖으로 나가지 않습니다.
지원 모델별 도구 호출 형식(Gemma 4, Qwen, Llama JSON 포함)을 Claude Code의 도구 호출 형식으로 변환하고, 형식이 잘못된 도구 JSON을 수정하며, 대화가 이어지는 동안 프롬프트 캐시를 재사용합니다. 설정 과정에서 Mac의 메모리를 확인해 적합한 모델을 선택합니다. 8 GB 기기에서는 Gemma 4 E4B를, 96 GB 이상에서는 Qwen 3.8 27B를 사용할 수 있습니다.
코딩용 런처, 경량 터미널 에이전트, 브라우저 에이전트, 음성 모드와 Claude 사용량을 모두 소진한 뒤에도 대화를 이어갈 수 있는 ‘keep going’ 무료 클라우드 대체 기능도 포함되어 있습니다. MIT 라이선스이며 Apple Silicon과 Python 3.12가 필요합니다.
핵심 기능
- 01로컬 MLX 모델을 사용해 Claude Code에 스트리밍을 지원하는 Anthropic Messages API를 제공합니다.
- 02모델별 도구 호출 형식을 Claude Code의 도구 호출 형식으로 변환합니다.
- 03긴 세션의 속도를 높이기 위해 대화가 이어지는 동안 프롬프트 캐시를 재사용합니다.
- 04Mac에서 사용 가능한 메모리에 따라 로컬 모델을 선택합니다.
- 05무료 클라우드 또는 로컬 모델로 대화를 계속할 수 있는 ‘keep going’ 옵션을 제공합니다.
활용 사례
- Claude 사용량 한도에 도달한 뒤에도 Claude Code를 계속 사용합니다.
- Mac에서 오프라인 또는 에어갭 환경으로 소스 코드 작업을 합니다.
- 법률이나 의료 프로젝트처럼 민감한 작업에서 프롬프트와 코드를 타사 서버에 보내지 않습니다.
- Apple Silicon에서 Claude Code 워크플로에 오픈 모델을 적용해 봅니다.
빠른 시작
- 1
명령어 하나로 설치
README의 공식 안내에 따라 설치 - 2
또는 저장소를 clone한 후 setup 실행
git clone https://github.com/nicedreamzapp/claude-code-local && cd claude-code-local && bash setup.sh - 3
데스크톱에서 Claude Local.command를 더블클릭해 로컬 코딩 시작
사용 전 알아둘 점
- Apple Silicon(M1 이상)이 탑재된 Mac이 필요하며, 다른 플랫폼에서는 실행되지 않습니다.
- 대형 모델은 상당한 통합 메모리가 필요합니다. 또한 메모리가 8 GB인 Mac에서는 도구 사용에 알려진 문제가 있는 모델이 제공됩니다.
토픽
자주 묻는 질문
- claude-code-local은(는) 무엇인가요?
- Apple Silicon Mac에서 MLX로 오픈 모델을 실행하고 Anthropic API 호환 서버로 제공해 Claude Code를 오프라인으로 사용합니다. Claude Code Local은 Apple의 MLX 프레임워크를 사용해 Mac 칩에서 오픈 모델을 실행하고, Claude Code에 Anthropic Messages API 형식으로 응답하는 소형 Python 서버(proxy/server.py)입니다. Claude Code가 로컬 서버와 직접 통신하므로 클라우드 모델이나 API 키가 필요 없고, 프롬프트와 코드는 기기 밖으로 나가지 않습니다.
- claude-code-local은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- claude-code-local은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- claude-code-local은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. claude-code-local의 마지막 커밋은 2026년 10월 15일입니다.
- claude-code-local은(는) 어디에 사용할 수 있나요?
- Claude 사용량 한도에 도달한 뒤에도 Claude Code를 계속 사용합니다. Mac에서 오프라인 또는 에어갭 환경으로 소스 코드 작업을 합니다. 법률이나 의료 프로젝트처럼 민감한 작업에서 프롬프트와 코드를 타사 서버에 보내지 않습니다. Apple Silicon에서 Claude Code 워크플로에 오픈 모델을 적용해 봅니다.
- claude-code-local는 어떻게 설치하나요?
- 명령어 하나로 설치 또는 저장소를 clone한 후 setup 실행: git clone https://github.com/nicedreamzapp/claude-code-local && cd claude-code-local && bash setup.sh 데스크톱에서 Claude Local.command를 더블클릭해 로컬 코딩 시작
- claude-code-local은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nicedreamzapp/claude-code-local
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
CPU, RAM, GPU를 감지한 뒤 내 시스템에서 실행하기 적합한 오픈 LLM을 순위로 보여주는 Rust CLI 및 TUI입니다.
로컬 문서를 조사하고 변환·편집하는 NotebookLM 스타일 AI 에이전트, 에어갭 환경에서 쓸 수 있는 오픈소스 데스크톱 앱입니다.
Mac에서 로컬로 실행할 수 있도록 최신 이미지 생성 모델(FLUX, Z-Image, Qwen Image 등)을 Apple MLX로 구현한 프로젝트입니다.
Apple silicon용 머신러닝 배열 프레임워크 MLX의 Swift API로, Swift 개발자가 ML 연구와 실험을 실행할 수 있습니다.
Gemma와 MiniCPM-V 모델을 iPhone에서 실행해 Calendar, Reminders, Contacts, Health 기본 Skills를 제공하는 iOS 앱이자 Swift 프레임워크입니다.