홈 / 가이드 / Claude Code를 무료로 사용하는 방법

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 | bash

http://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>"
claude
중요: ANTHROPIC_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인 무료 모델을 보여 줍니다.

Claude Code용 무료 모델: 도구 호출 및 128K 이상 컨텍스트
모델무료 제공컨텍스트무료 한도 (가장 좋은 조건)도구비전
GLM 5.3UnoRouter1M1 요청/분
1 req/min per model
예아니요
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 요청/분
40 RPM
예예
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quota예예
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowance예아니요
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring credit예예
Gemini 3.7 FlashGoogle AI Studio1M10 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring credit예예
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 요청/분
50 요청/일
50 req/day account-wide (1,000 after a $10 purchase)
예예
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 요청/분
50 요청/일
Shared rate limit
예아니요
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 요청/분
250 요청/일
70,000 토큰/분
~6M
예예
Gemini 3.6 FlashGoogle AI Studio1M10 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
Qwen 3.8 27BCloudflare Workers AI262KShared 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 모델입니다
하나의 키로 이 모델을 모두 사용하십시오. FreeLLMAPI는 오픈 소스이며 직접 호스팅하는 라우터입니다. 이 모든 무료 제공 서비스를 하나의 OpenAI 호환 엔드포인트로 묶고, 요청 한도에 걸리면 다른 모델로 자동 전환합니다. 카탈로그 보기 또는 바로 시작.

자주 묻는 질문

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를 시작하세요.

관련 가이드

출처

전체 가이드 · 무료 모델 전체 보기