Free Claude Code

Claude Code CLI 및 VSCode를 사용하여 무료로 이용하세요. Anthropic API 키가 필요 없습니다.

License: MIT

A lightweight proxy가 Claude Code의 Anthropic API 호출을 NVIDIA NIM (분당 40회 무료), OpenRouter (수백 개의 모델), 또는 LM Studio (완전 로컬)로 라우팅합니다.

Features · Quick Start · How It Works · Discord Bot · Configuration

</div> <div align="center"> <img src="https://raw.githubusercontent.com/Rishurajgautam24/free-claude-code/HEAD/pic.png" alt="Free Claude Code in action" width="700"> <p><em>NVIDIA NIM을 통해 실행되는 Claude Code, 완전히 무료입니다</em></p> </div>

Features

Feature	Description
Zero Cost	NVIDIA NIM에서 분당 40회 무료. OpenRouter의 무료 모델. LM Studio를 통한 완전 로컬 지원

API 키 받기 (또는 LM Studio를 로컬에서 사용):
- NVIDIA NIM: build.nvidia.com/settings/api-keys
- OpenRouter: openrouter.ai/keys
- LM Studio: API 키가 필요하지 않습니다. LM Studio로 로컬에서 실행
Claude Code 설치
uv 설치
이미 설치된 경우 uv 업데이트: uv self update

클론 및 설정 (Clone & Configure)

git clone https://github.com/Rishurajgautam24/free-claude-code.git
cd free-claude-code
cp .env.example .env

원하는 제공업체를 선택하고 .env 파일을 편집하세요:

<details> <summary><b>NVIDIA NIM</b> (분당 40회 무료, 권장)</summary>

NVIDIA_NIM_API_KEY="nvapi-your-key-here"

MODEL_OPUS="nvidia_nim/z-ai/glm4.7"
...

</details> <details> <summary><b>OpenRouter</b> (수백 개의 모델)</summary>

OPENROUTER_API_KEY="sk-or-your-key-here"

MODEL_OPUS="open_router/deepseek/deepseek-r1-0528:free"
...

</details> <details> <summary><b>LM Studio</b> (완전 로컬, API 키 없음)</summary>

MODEL_OPUS="lmstudio/unsloth/MiniMax-M2.5-GGUF"
MODEL_SONNET="lmstudio/unsloth/Qwen3.5-35B-A3B-GGUF"
MODEL_HAIKU="lmstudio/unsloth/GLM-4.7-Flash-GGUF"
...

</details> <details> <summary><b>제공업체 혼합 사용</b> (여러 제공업체를 함께 사용)</summary>

각 MODEL_* 변수는 다른 제공업체를 사용할 수 있습니다. MODEL은 인식되지 않은 Claude 모델의 대체(fallback)입니다.

NVIDIA_NIM_API_KEY="nvapi-your-key-here"
OPENROUTER_API_KEY="sk-or-your-key-here"

...

</details>

실행 (Run It)

터미널 1: 프록시 서버 시작:

uv run uvicorn server:app --port 8082

터미널 2: Claude Code 실행:

ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude

이것으로 끝입니다! 이제 Claude Code는 구성한 제공업체를 사용하여 무료로 작동합니다.

프록시는 이 머신에서 오는 연결만 허용합니다. WSL, Docker 또는 다른 장치에서 사용하려면 .env 파일에 PROXY_AUTH_TOKEN을 설정하고, 서버를 --host 0.0.0.0으로 시작한 다음, 동일한 토큰을 ANTHROPIC_AUTH_TOKEN으로 전송해야 합니다.

<details> <summary><b>VSCode 확장 프로그램 설정</b></summary>

프록시 서버를 시작합니다 (위와 동일).
설정을 열고 (Ctrl + ,) claude-code.environmentVariables를 검색합니다.
settings.json에서 편집을 클릭하고 다음 내용을 추가합니다:

"claude-code.environmentVariables": [
  { "name": "ANTHROPIC_BASE_URL", "value": "http://localhost:8082" },
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "freecc" }
...

확장 프로그램을 새로고침합니다.
로그인 화면이 나타나면 (

┌─────────────────┐ ┌──────────────────────┐ ┌──────────────────┐
│ Claude Code │───────>│ Free Claude Code │───────>│ LLM Provider │
│ CLI / VSCode │<───────│ Proxy (:8082) │<───────│ NIM / OR / LMS │
...

투명 프록시 (Transparent proxy): Claude Code는 표준 Anthropic API 요청을 프록시 서버로 전송합니다.
모델별 라우팅 (Per-model routing): Opus / Sonnet / Haiku 요청은 해당 모델 전용 백엔드 및 제공업체로 해결되며, 기본 MODEL이 폴백(fallback)으로 사용됩니다.
요청 최적화 (Request optimization): 5가지 범주의 사소한 요청(할당량 조사, 제목 생성, 접두사 감지, 제안, 파일 경로 추출)은 가로채져 API 할당량을 사용하지 않고 즉시 응답합니다.
형식 변환 (Format translation): 실제 요청은 Anthropic 형식에서 제공업체의 OpenAI 호환 형식으로 번역되어 스트리밍됩니다.
사고 토큰 (Thinking tokens): <think> 태그와 reasoning_content 필드는 네이티브 Claude 사고 블록으로 변환되어 Claude Code가 이를 올바르게 렌더링하도록 합니다。

제공업체 (Providers)

제공업체	비용	할당량 제한	모델	최적 사용처
NVIDIA NIM	무료	분당 40회	Kimi K2, GLM5, Devstral, MiniMax	일상 사용, 관대한 무료 등급
...
제공업체는 `.env`에서 `MODEL`을 변경하여 전환할 수 있습니다. 접두사 형식인 `provider/model/name`을 사용하세요. 잘못된 접두사는 오류를 유발합니다.

제공업체	MODEL 접두사	API 키 변수	기본 URL
NVIDIA NIM	`nvidia_nim/...`	`NVIDIA_NIM_API_KEY`	`integrate.api.nvidia.com/v1`
...
LM Studio는 로컬에서 실행됩니다. 개발자 탭이나 `lms server start`를 통해 서버를 시작하고, 모델을 로드한 후, `MODEL`을 모델 식별자로 설정하세요.

Discord Bot

Discord에서 원격으로 Claude Code를 제어하세요. 작업을 보내고 실시간 진행 상황을 확인하며 여러 동시 세션을 관리할 수 있습니다. Telegram도 지원됩니다.

기능:

트리 기반 메시지 스레딩: 메시지에 답장하여 대화를 분기(fork)합니다.
서버 재시작 시에도 유지되는 세션 지속성(Session persistence)
사고 토큰(thinking tokens), 도구 호출(tool calls), 결과의 실시간 스트리밍
무제한 동시 Claude CLI 세션 (프로바이더 동시성은 PROVIDER_MAX_CONCURRENCY로 제어)
음성 메모: 음성 메시지를 보내면 일반 프롬프트처럼 전사(transcribed)되어 처리됩니다 (Voice Notes 참고).
명령어: /stop (작업 취소; 특정 작업만 중지하려면 메시지에 답장), /clear (단독 사용: 모든 세션 초기화; 특정 브랜치를 아래로 지우려면 메시지에 답장), /stats

설정(Setup)

Discord 봇 생성: Discord Developer Portal로 이동하여 애플리케이션을 만들고, 봇을 추가한 후 토큰을 복사합니다. 봇 설정에서 **메시지 콘텐츠 인텐트(Message Content Intent)**를 활성화하세요.
.env 파일 편집:

MESSAGING_PLATFORM="discord"
DISCORD_BOT_TOKEN="your_discord_bot_token"
ALLOWED_DISCORD_CHANNELS="123456789,987654321"

Discord에서 개발자 모드를 활성화(설정 → 고급)한 다음, 채널을 마우스 오른쪽 버튼으로 클릭하고

TELEGRAM_BOT_TOKEN="123456789:ABCdefGHIjklMNOpqrSTUvwxYZ"
ALLOWED_TELEGRAM_USER_ID="your_telegram_user_id"

@BotFather에서 토큰을 받고, @userinfobot을 통해 사용자 ID를 찾으세요.

음성 메모 (Voice Notes)

Telegram 또는 Discord에서 음성 메시지를 보내면 텍스트로 전사(transcribed)되어 일반 프롬프트처럼 처리됩니다. 두 가지 전사 백엔드가 제공됩니다:

Local Whisper (기본값): Hugging Face transformers Whisper를 사용합니다 — 무료이며 API 키가 필요 없고, 오프라인에서 작동하며, CUDA와 호환됩니다. ffmpeg이 필요하지 않습니다.
NVIDIA NIM: gRPC를 통해 NVIDIA NIM Whisper/Parkeet 모델을 사용합니다 — NVIDIA_NIM_API_KEY가 필요합니다.

선택적 음성 추가 기능을 설치하세요:

# local Whisper (cpu/cuda)용
uv sync --extra voice_local

...

설정 (Configuration):

변수 (Variable)	설명 (Description)	기본값 (Default)
`VOICE_NOTE_ENABLED`	음성 메모 처리 활성화	`true`
...
지원되는 `WHISPER_MODEL` 값:

모델 (Model)	장치 (Device)	설명 (Description)
`tiny`, `base`, `small`, `medium`, `large-v2`, `large-v3`, `large-v3-turbo`	`cpu` / `cuda`	Local Whisper (Hugging Face)
...

모델 (Models)

<details> <summary><b>NVIDIA NIM</b></summary>

전체 목록은 nvidia_nim_models.json에서 확인할 수 있습니다.

Free Claude Code: Anthropic API 키 없이 Claude Code CLI 및 VSCode 무료 사용

요약

핵심 포인트