Claude Code를 무료로 사용하는 방법
Claude Code는 Anthropic의 코딩 에이전트입니다. Anthropic Messages API가 필요합니다. 이 가이드는 FreeLLMAPI를 통해 Claude Code를 무료 모델에 연결하는 방법을 보여 줍니다. 환경 변수 두 개를 설정합니다. Anthropic 키는 필요하지 않습니다.
코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.
얻는 것과 얻지 못하는 것
Claude Code는 각 요청을 Anthropic 형식의 API로 보냅니다. FreeLLMAPI는 /v1/messages에서 그 형식을 지원합니다. 각 요청을 변환하여 무료 모델로 보냅니다. 예를 들어 Gemini, GPT-OSS, Qwen 또는 GLM입니다.
- 얻는 것: 무료 모델에서 Claude Code 인터페이스, 도구, 파일 편집, 에이전트 루프입니다.
- 얻지 못하는 것: Anthropic의 Claude 모델입니다. API로 Claude 모델을 무료로 제공하는 제공업체는 없습니다. 자세한 내용은 무료 Claude API가 있나요?를 읽으세요.
- 비용: 추론 비용은 $0입니다. 무료 티어에는 요청 한도가 있습니다. 한 한도가 요청을 멈추면 FreeLLMAPI는 다음 제공업체로 넘어갑니다.
1단계: FreeLLMAPI 설치
FreeLLMAPI는 오픈소스입니다. Docker에서 사용자의 컴퓨터에 실행됩니다. 제공업체 키는 사용자의 컴퓨터에 남습니다.
macOS 또는 Linux
curl -fsSL https://freellmapi.co/install.sh | bashhttp://localhost:3001에서 대시보드를 여세요. Keys 페이지에서 무료 제공업체 키를 두 개 이상 추가하세요. Google AI Studio와 Groq는 각각 약 1분 안에 무료 키를 제공합니다. 같은 페이지에서 통합 키를 복사하세요.
2단계: Claude Code 연결
가장 빠른 방법은 설정 명령입니다. 실시간 카탈로그를 읽고, ~/.claude/settings.json의 백업을 만든 다음 게이트웨이 설정을 추가합니다.
명령 한 줄
npx freellmapi setup-claude --url http://localhost:3001 --api-key <unified-key>수동으로 설정하려면 환경 변수 두 개를 설정하고 Claude Code를 시작하세요:
수동 설정 (macOS 또는 Linux)
export ANTHROPIC_BASE_URL=http://localhost:3001
export ANTHROPIC_AUTH_TOKEN=<unified-key>
claude수동 설정 (Windows PowerShell)
$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="<unified-key>"
claudeANTHROPIC_AUTH_TOKEN을 사용하세요. ANTHROPIC_API_KEY를 사용하지 마세요. ANTHROPIC_API_KEY가 설정되어 있으면 Claude Code는 충돌하는 자격 증명을 보고 시작하지 않습니다.요청이 게이트웨이로 가는지 확인하려면 npx freellmapi doctor를 실행하세요. 각 응답에는 X-Routed-Via 헤더도 있습니다. 이 헤더는 응답한 제공업체와 모델을 보여 줍니다.
3단계: 에이전트 작업용 모델 선택
Claude Code는 긴 프롬프트를 보냅니다. 일반적인 요청에는 큰 시스템 프롬프트, 도구 정의, 파일 내용이 들어 있습니다. 도구 호출을 지원하고 컨텍스트 창이 큰 모델을 사용하세요. 분당 토큰 한도가 낮은 작은 무료 티어는 이런 요청에서 실패합니다.
Keys, Anthropic 탭에서 각 Claude 계열(opus, sonnet, haiku)을 auto 또는 모델 하나에 연결하세요. auto를 사용하면 라우터가 요청마다 무료 모델을 선택합니다. 아래 표는 오늘의 카탈로그에서 도구 호출을 지원하고 컨텍스트가 최소 128K인 무료 모델을 보여 줍니다.
| 모델 | 무료 제공 | 컨텍스트 | 무료 한도 (가장 좋은 조건) | 도구 | 비전 |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 요청/분 1 req/min per model | 예 | 아니요 |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 요청/분 40 RPM | 예 | 예 |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | 예 | 예 |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | 예 | 아니요 |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | 예 | 예 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | 예 | 예 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 요청/분 50 요청/일 50 req/day account-wide (1,000 after a $10 purchase) | 예 | 예 |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 요청/분 50 요청/일 Shared rate limit | 예 | 아니요 |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 요청/분 250 요청/일 70,000 토큰/분 ~6M | 예 | 예 |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | 예 | 예 |
일치하는 무료 모델 109개 중 12개를 표시합니다. 모든 모델 보기.
FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.
요청 한도와 대체의 도움
Claude Code 작업 하나가 요청을 20~100개 보낼 수 있습니다. 무료 티어 하나로는 금방 멈춥니다. 예를 들어 무료 Gemini Flash 키는 하루 요청 수가 적습니다. FreeLLMAPI는 키마다 할당량을 셉니다. 제공업체가 429 오류를 반환하면 라우터는 풀의 다음 제공업체를 시도합니다. Claude Code 세션은 계속됩니다.
- 제공업체 네 곳 이상에서 키를 추가하세요. 키가 많을수록 하루 요청 수가 늘어납니다.
haiku를 빠른 소형 모델에 연결하세요. Claude Code는 짧은 백그라운드 작업에 이 모델을 사용합니다.- 컨텍스트를 작게 유지하세요. 작업 사이에
/clear를 사용하면 토큰을 적게 보냅니다.
문제 해결
| 문제 | 원인 | 해결 방법 |
|---|---|---|
| Claude Code가 로그인하라고 요청함 | 이 셸에 환경 변수가 설정되지 않음 | ANTHROPIC_BASE_URL과 ANTHROPIC_AUTH_TOKEN을 설정한 다음 claude를 다시 시작하세요 |
| "충돌하는 자격 증명" 또는 시작되지 않음 | ANTHROPIC_API_KEY가 설정되어 있음 | unset ANTHROPIC_API_KEY로 제거하세요 |
| 모든 요청에서 오류 429 | 모든 제공업체 키가 한도에 도달함 | Keys 페이지에서 더 많은 제공업체의 키를 추가하세요 |
| 도구 호출이 실패하거나 에이전트가 멈춤 | 모델이 도구 호출을 잘 지원하지 않음 | 위 표의 모델을 계열에 연결하세요 |
| 요청이 느림 | 느린 무료 모델에서 큰 프롬프트 | 빠른 모델을 고정하세요. 예를 들어 Groq 또는 Cerebras 모델입니다 |
자주 묻는 질문
Claude Code는 무료로 사용할 수 있나요?
Claude Code 프로그램은 무료로 설치할 수 있습니다. 작동하려면 모델 API가 필요합니다. FreeLLMAPI와 함께 사용하면 무료 제공업체 티어를 쓰므로 추론 비용은 $0입니다.
실제 Claude 모델을 무료로 쓸 수 있나요?
아니요. Anthropic은 무료 Claude API를 제공하지 않습니다. Claude Code는 Anthropic 형식 엔드포인트를 통해 Gemini, GPT-OSS, Qwen, GLM 같은 다른 무료 모델에서 실행됩니다.
ANTHROPIC_API_KEY 대신 ANTHROPIC_AUTH_TOKEN을 사용하는 이유는 무엇인가요?
Claude Code는 ANTHROPIC_AUTH_TOKEN을 Bearer 토큰으로 게이트웨이에 보냅니다. ANTHROPIC_API_KEY가 설정되어 있으면 Claude Code는 이를 자사(first-party) 자격 증명으로 취급하고 시작을 거부합니다.
Claude Code에 가장 좋은 무료 모델은 무엇인가요?
도구 호출을 지원하고 컨텍스트 창이 128K 토큰 이상인 모델을 사용하세요. 이 페이지의 표는 오늘 두 조건을 모두 충족하는 가장 강력한 무료 모델을 보여 줍니다.
Windows에서도 작동하나요?
네. PowerShell에서 $env:ANTHROPIC_BASE_URL과 $env:ANTHROPIC_AUTH_TOKEN으로 두 변수를 설정한 다음 claude를 시작하세요.
관련 가이드
- 무료 Claude API가 있나요?
- 최고의 무료 코딩 모델 API
- 무료 모델로 Codex CLI 사용하기
- 무료 API로 쓰는 Cline, Roo Code, Kilo Code
- 무료 LLM API 속도 제한
출처
- FreeLLMAPI docs: Anthropic and Claude clients (20 November 2026 확인)
- FreeLLMAPI CLI generators (20 November 2026 확인)
- Claude Code documentation: LLM gateway configuration (20 November 2026 확인)