Free Claude Code – Anthropic API 키 없이 Claude Code를 무료로 쓰는 프록시

지원 프로바이더
주요 기능
설치
NVIDIA NIM 예시 설정 (권장)
프로바이더 혼합 예시
어떤 경우에 쓰면 좋은가
아키텍처
라이선스
관련 문서

Free Claude Code는 Claude Code CLI·VSCode 확장이 보내는 Anthropic API 요청을 무료 또는 로컬 프로바이더로 투명하게 재라우팅하는 경량 프록시다. 환경 변수 두 개만 설정하면 Claude Code 클라이언트를 전혀 수정하지 않고 그대로 사용할 수 있다.

지원 프로바이더

프로바이더	특징
NVIDIA NIM	분당 40 요청 무료, 기본 권장 옵션
OpenRouter	수백 가지 모델 선택 가능, 다수 무료 모델 포함
DeepSeek	Anthropic 호환 API로 직접 연결
LM Studio	API 키 불필요, 완전 로컬 실행
llama.cpp	`llama-server` 기반 완전 로컬 실행
Ollama	네이티브 Anthropic Messages API 지원 로컬 실행

Claude Opus·Sonnet·Haiku 요청을 각각 다른 프로바이더와 모델로 라우팅하거나 혼합해서 쓸 수 있다.

주요 기능

드롭인 교체: ANTHROPIC_BASE_URL·ANTHROPIC_API_KEY 두 환경 변수만 지정하면 동작
싱킹 토큰 지원: <think> 태그와 reasoning_content를 Claude 네이티브 사고 블록으로 변환
휴리스틱 툴 파서: 텍스트로 출력된 도구 호출을 자동으로 구조화된 tool use로 파싱
요청 최적화: 네트워크 프로브·타이틀 생성·파일 경로 추출 등 5종 경량 요청을 로컬에서 차단해 API 쿼터 절약
스마트 레이트 리미팅: 롤링 윈도우 사전 제어 + 429 응답 시 지수 백오프 + 동시 스트림 제한
Discord·Telegram 봇: 원격 자율 코딩, 트리 기반 스레딩, 세션 영속화, 실시간 진행 상황 표시
음성 노트: Whisper(로컬·NVIDIA NIM) 기반 음성 입력 지원

설치

# uv 설치 (macOS/Linux)
curl -LsSf https://astral.sh/uv/install.sh | sh
uv python install 3.14

# 저장소 클론
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
cp .env.example .env

.env에서 프로바이더와 모델을 설정한 뒤 실행:

uv run server.py

그런 다음 Claude Code에서 환경 변수를 지정하면 된다:

export ANTHROPIC_BASE_URL=http://localhost:8080
export ANTHROPIC_API_KEY=any-string  # 값은 무관
claude

NVIDIA NIM 예시 설정 (권장)

NVIDIA_NIM_API_KEY="nvapi-your-key-here"
MODEL="nvidia_nim/z-ai/glm4.7"
ENABLE_MODEL_THINKING=true

프로바이더 혼합 예시

NVIDIA_NIM_API_KEY="nvapi-..."
OPENROUTER_API_KEY="sk-or-..."

MODEL_OPUS="nvidia_nim/moonshotai/kimi-k2.5"
MODEL_SONNET="open_router/deepseek/deepseek-r1-0528:free"
MODEL_HAIKU="lmstudio/unsloth/GLM-4.7-Flash-GGUF"

어떤 경우에 쓰면 좋은가

Anthropic API 비용 없이 Claude Code를 체험·학습하려는 개발자
NVIDIA NIM 무료 티어나 OpenRouter 무료 모델로 일상적인 코딩 작업을 처리하고 싶은 경우
인터넷 연결 없는 오프라인 환경에서 Ollama·LM Studio로 Claude Code를 쓰고 싶은 경우
Discord·Telegram 봇을 통해 원격으로 자율 코딩 에이전트를 운용하려는 경우

아키텍처

free-claude-code/
├── server.py          # 진입점 (FastAPI)
├── api/               # 라우트, 모델 라우팅, 요청 최적화
├── core/              # Anthropic 프로토콜 헬퍼, SSE, 변환, 파서
├── providers/         # 프로바이더 레지스트리, OpenAI·Anthropic 트랜스포트
├── messaging/         # Discord/Telegram 봇, 음성, 세션 관리
└── config/            # 설정, 로깅

새 프로바이더는 OpenAIChatTransport 또는 AnthropicMessagesTransport를 상속해 레지스트리에 등록하면 추가할 수 있다.

라이선스

MIT

AI Sparkup