Claude Code를 무료로 실행하는 방법!

중요

README에 있는 모델을 사용하지 마세요.

기본값은 다음과 같습니다:

z-ai/glm4.7

이 모델은 영원히 멈춰서 응답하지 않습니다.

다른 모델들도 시도해봤습니다:

• "deepseek-v4-pro"
• "qwen3-coder-480b"

둘 다 연결할 수 없습니다.

무료 티어에서 실제로 작동하는 두 가지 모델은 다음과 같습니다:

• "moonshotai/kimi-k2-instruct" ← 코딩에 가장 적합
• "meta/llama-3.3-70b-instruct" ← 괜찮은 백업

"ANTHROPIC_AUTH_TOKEN" 정보

ANTHROPIC_AUTH_TOKEN=freecc

이것은 래퍼와 프록시 사이의 로컬 비밀번호일 뿐입니다.

프록시는 이 토큰이 없으면 요청을 거부합니다.

절대 컴퓨터 밖으로 나가지 않습니다.

원하는 대로 설정할 수 있습니다. 래퍼와 ".env" 파일만 일치시키면 됩니다.

래퍼 스크립트

다음 경로에 저장하세요:

~/.local/bin/claude-free

#!/usr/bin/env bash

set -e

PROXY_DIR="$HOME/.local/share/claude-free"
PORT=8082

if ! curl -s -m 1 "http://127.0.0.1:$PORT/v1/models" -H "x-api-key: freecc" >/dev/null 2>&1; then

  echo "claude-free: starting proxy on :$PORT..." >&2

  cd "$PROXY_DIR"

  nohup uv run uvicorn server:app \

--host 127.0.0.1 \

--port "$PORT" \

>> "$PROXY_DIR/proxy.log" 2>&1 &

  for i in {1..30}; do

curl -s -m 1 "http://127.0.0.1:$PORT/v1/models" \

-H "x-api-key: freecc" >/dev/null 2>&1 && break

sleep 0.5

  done

fi

export ANTHROPIC_AUTH_TOKEN=freecc

export ANTHROPIC_BASE_URL="http://127.0.0.1:$PORT"

export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

exec claude "$@"

실행 권한을 부여하세요:

chmod +x ~/.local/bin/claude-free

"~/.local/bin"이 PATH에 있는지 확인하세요:

echo $PATH | grep -q "$HOME/.local/bin" && echo ok || echo "add to .zshrc"

새 터미널을 여세요.

실행:

claude-free

이제 무료 모델로 Claude Code를 실행 중입니다.

작동 확인

프록시를 거치고 있는지, Anthropic에 직접 연결되는 것이 아닌지 확인하려면:

프록시를 종료하고 "claude-free"를 다시 실행하세요.

래퍼가 자동으로 다시 시작해야 합니다.

로그를 확인할 수도 있습니다:

tail -f ~/.local/share/claude-free/proxy.log

요청이 들어오는 것을 지켜보세요.

혼란스러웠던 점 하나

Claude Code UI 헤더에는 여전히 이전 계정/모델 이름이 표시될 수 있습니다:

Sonnet 4.6

또는 이전에 사용했던 모델명.

그 라벨은 로컬에 캐시된 것입니다.

실제로 서비스를 제공하는 모델은 Kimi입니다.

UI가 아닌 로그를 믿으세요.

더 빠른 방법

이 전체 설정을 하나의 npad 노트로 저장했습니다:

https://npad.run/p/free-claude-code-in-3-minutes-claude-free-wrapper-nvidia-nim-fbh3d9p443

이 URL을 Claude Code에 붙여넣고 이렇게 말하세요:

«"do this, ask me when you need the NVIDIA key"»

당신의 에이전트가:

• 노트를 읽고
• 모든 명령을 실행하며
• 사람이 직접 해야 하는 단계에서 멈추고
• 자동으로 계속 진행하며
• 설치를 테스트합니다.

한 번에 끝납니다.

에이전트가 제가 겪었던 실수를 반복하지 않으므로 토큰도 절약할 수 있습니다.

주의사항

"Kimi-K2"는 Opus가 아닙니다.

코딩과 도구 사용에는 능숙하지만 다음 작업에서는 차이를 느낄 것입니다:

• 어려운 추론
• 긴 문맥 작업

다음 상황에서 사용하세요:

• 실제 할당량이 소진되었을 때
• 가벼운 코딩 작업 시
• s

(이하 생략)