구독 없이 Claude Code를 무료로 사용하는 방법

Claude Code란?

Claude Code는 Anthropic의 터미널용 에이전틱 코딩 도구입니다. 프로젝트 디렉터리 안에서 실행되며, 파일을 읽고 편집하고, 명령을 실행하며, 브라우저 탭에 무언가를 복사해 넣을 필요 없이 다단계 작업을 처리합니다.

비용이 드는 이유는 상업적이라기보다 구조적입니다. 실행하는 모든 동작이 API 호출이며, 에이전틱 세션은 본질적으로 수다스럽습니다. 모델이 컨텍스트를 재읽고, 도구를 호출하고, 결과를 확인하고, 다시 시도하니까요. 큰 저장소에서 바쁜 오후를 보내면, 특별히 생산적이지 않았다고 느끼더라도 토큰 비용이 몇 달러까지 올라갈 수 있습니다.

도구가 일상적으로 무엇을 하는지 전체 그림을 원하시면, 실무에서의 설정, 리팩터링, 디버깅을 다룬 Claude Code 튜토리얼을 참고하세요.

Claude Code는 무료인가요?

직답은 아닙니다. Anthropic의 설정 문서에 따르면 Claude Code를 사용하려면 Pro, Max, Team, Enterprise, 또는 Console 계정이 필요하며, 무료 Claude.ai 요금제에는 포함되지 않습니다. Pro는 월 $20부터, 연간 선결제 시 월 $17(연 $200)입니다.

대안은 콘솔 과금입니다. 구독 없이 토큰 사용량에 따라 지불합니다. Claude Sonnet 5는 보통 입력 백만 토큰당 $3, 출력 백만 토큰당 $15입니다. Claude Opus 5는 각각 $5와 $25, Haiku 4.5는 $1과 $5입니다.

두 경로는 과금 논리가 완전히 다르며, 잘못 고르면 과금을 과하게 하거나 작업 중 제한에 걸릴 수 있습니다. 다음은 두 경로의 비교입니다.

관건은 사용량의 규모가 아니라 규칙성입니다. 상한에 닿기 전까지는 구독이 API 대비 훨씬 더 좋은 유효 단가를 제공합니다. 그래서 매일 쓰는 사용자는 거의 항상 Pro가 유리합니다. 주마다 편차가 크다면 계량 과금이 승리합니다. 한가한 주에는 비용이 아예 들지 않기 때문입니다.

그렇다면 "무료"는 어디서 오나요? 대략 세 가지입니다. 

• 스타터 크레딧: 신규 API 계정에 Anthropic이 제공
• Claude Code가 Anthropic Messages 형식을 지원하는 서버(호스팅형(OpenRouter)이든 로컬(Ollama)이든, 무료 포함)와 통신할 수 있다는 점
• 오픈 소스 유지관리자를 위한 지원 프로그램

두 번째 범주는 미리 경고할 가치가 있습니다. 무료 모델을 향해 Claude Code를 지정하면 인터페이스와 에이전트 루프는 그대로지만, Claude는 아닙니다. 다단계 추론 품질 격차는 실제로 존재하며, 아래에서 다시 다룹니다.

무료 요금제에 Claude Code가 포함되나요?

가장 흔한 오해부터 짚겠습니다. 많은 사람의 저녁 시간을 낭비시키는 지점입니다.

무료 등급에는 포함되지 않습니다. 축약판도, 체험판도, 아무것도 아닙니다. Anthropic 문서는 명확합니다. 무료 플랜은 웹, iOS, Android, 데스크톱의 Claude를 포함하지만, 터미널 에이전트는 포함하지 않습니다.

대신 제공되는 것은 꽤 괜찮습니다. 2026년 7월 1일 이후 무료 플랜의 기본 모델은 Claude Sonnet 5이며, 웹 검색, 파일 업로드, Projects, Artifacts도 유료 장벽 뒤에 있던 기능이 포함되었습니다. 스택 트레이스를 붙여 넣고 무엇이 잘못됐는지 묻는 용도로는 충분합니다.

개발자가 먼저 맞닥뜨리는 무료 등급 제한

Anthropic은 메시지 수치를 공개하지 않으며, 정확한 숫자를 말하는 이는 추측일 뿐입니다. 회사는 Pro가 Free 대비 세션당 최소 5배의 사용량이라고 설명하며, 이는 Free가 고정된 할당량이 아니라 기준선이라는 뜻입니다. 실제로는 5시간 롤링 창에 15~40개 메시지라는 보고가 많고, 메시지가 길거나 첨부가 있으면 더 빠르게 소진됩니다.

메시지 수보다 중요한 제한이 몇 가지 있습니다.

• 5시간 창은 첫 메시지를 보낸 시점부터 굴러가기 시작합니다.
• Claude Code CLI 접근 불가. 이게 가장 큰 제한이며, 우회책이 없습니다.
• 서버 부하에 따라 제한이 가변적입니다. 피크 시간대가 더 빡빡합니다.
• 대화가 길수록 매 턴 전체 스레드를 재읽기 때문에 메시지당 비용이 더 큽니다.

결론적으로, 무료 채팅 등급은 단발성 질문과 코드 리뷰에는 괜찮지만, 코드베이스를 두고 지속적인 티키타카를 원하는 순간 무너집니다. 그게 바로 Claude Code가 필요한 지점입니다.

옵션 1: Anthropic API 무료 크레딧

가장 덜 알려진 공식 경로이며, 대부분의 분들이 여기서 시작하는 것이 좋다고 봅니다.

아래의 platform.claude.com에서 계정을 만들면 일회성 스타터 크레딧이 제공됩니다. Anthropic 가격 문서에는 금액을 특정하지 않고 "소량의 무료 크레딧"이라고만 되어 있으나, 외부 보고에 따르면 대체로 약 $5 수준입니다.

API 크레딧은 Claude Code CLI 인증에 사용됩니다. 실제 에이전트가 실제 Claude 모델로, 실제 코드베이스에서 동작합니다. 크레딧은 갱신되지 않으며 14일 후 만료되므로, 보급품이 아니라 체험판으로 생각하세요.

API 계정 설정과 크레딧 받기

콜드 사인업에서 작동하는 에이전트까지 약 10분이면 끝납니다. 대부분의 시간은 설치 기다림입니다. 단계를 다섯으로 나눈 이유는, 세 번째 단계에 사람들이 재시작하게 만드는 함정이 있기 때문입니다.

1단계: 콘솔 계정 만들기

platform.claude.com으로 가서 이메일로 회원가입하세요. 콘솔은 claude.ai 채팅 인터페이스와는 별도 제품이므로, 기존 Claude 계정 정보가 이관되지 않습니다. 같은 이메일로 다시 등록해야 할 수 있습니다.

참고로, 일부 계정은 이 단계에서 전화번호 인증을 요구합니다. 완료되면 스타터 크레딧은 프로모션 코드 입력 없이 자동 적용됩니다.

2단계: 크레딧 잔액 확인

콘솔 내비게이션에서 Billing을 엽니다. 시작 잔액이 표시되며 결제 수단 추가 옵션도 보이지만, 지금은 필요 없습니다.

다른 것보다 이걸 먼저 확인하세요. 잔액이 0이라면, 이후 어떤 올바른 구성도 세션을 작동시키지 못합니다.

3단계: API 키 생성

Settings > API Keys로 이동해 새 키를 만듭니다. 대부분의 사람은 키가 여러 개 생기니, 석 달 뒤에도 알아볼 수 있는 이름을 붙이세요.

키 전체 값은 단 한 번만 표시됩니다. 대화 상자가 뜨는 즉시 비밀번호 관리자에 복사하세요. 복사하지 않은 채 닫으면 키를 잃어버리고 이 단계를 처음부터 다시 해야 합니다.

4단계: 키 내보내기와 Claude Code 설치

셸에서 환경 변수로 키를 내보낸 다음, CLI를 설치합니다. Anthropic은 자체 런타임을 포함하고 Node.js가 전혀 필요 없는 네이티브 설치 프로그램을 권장합니다.

export ANTHROPIC_API_KEY="sk-ant-your-key-here"
curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell에서는 설치 프로그램이 irm https://claude.ai/install.ps1 | iex입니다. npm을 선호한다면, Claude Code v2.1.198 기준으로 패키지는 Node.js 22 이상을 요구한다는 점에 유의하세요. 이는 이전 가이드가 여전히 인용하는 Node.js 18 최소 버전에서 변경된 것입니다.

npm install -g @anthropic-ai/claude-code

export 줄을 새 터미널 창에서도 키가 유지되도록 ~/.zshrc 또는 ~/.bashrc에 추가하세요. 설치가 완료되었는지 확인합니다.

claude --version

5단계: 첫 세션 실행

프로젝트 디렉터리로 이동해 에이전트를 시작합니다. claude를 홈 디렉터리에서 실행해도 기술적으로는 동작하지만, 코드베이스를 읽을 수 없으면 도구는 거의 쓸모가 없습니다.

cd ~/projects/my-app
claude

ANTHROPIC_API_KEY가 설정된 상태의 첫 실행에서는, Claude Code가 OAuth를 위해 브라우저를 여는 대신 키 승인을 한 번 요청합니다. 승인하면, 하단에 작업 디렉터리가 표시된 환영 화면이 나타납니다.

설치만이 아니라 과금 경로를 확인하려면, 세션 안에서 /status를 실행하세요. API key 줄에 ANTHROPIC_API_KEY가 표시되면, 세션이 저장된 claude.ai 로그인 대신 콘솔 크레딧을 사용 중임을 뜻합니다.

이 시점에서 뭔가 이상해 보인다면, claude doctor는 세션을 시작하지 않고 설치 및 설정 진단을 출력합니다. 오류 문자열을 검색하는 것보다 빠른 첫 대응입니다.

무료 크레딧으로 어느 정도까지 가능할까?

대략적인 계산을 Sonnet 5의 현재 출시 기념 요율로 해보겠습니다. 실제 저장소에서 15번의 교환이 있다고 가정하고, 매번 약 30,000토큰의 컨텍스트를 보내고 1,500토큰 정도의 출력을 받는다고 합시다. 첫 턴은 입력을 전액 지불하고, 이후 14턴은 대부분 프롬프트 캐시를 통해 그 가격의 10%만 냅니다.

이를 견적 수준으로 보세요. 위 모델은 컨텍스트를 일정하다고 가정하고, 캐시 쓰기 프리미엄(5분 캐시에 기본 입력가의 1.25배)을 무시합니다. 실제 세션 비용은 이 수치의 양쪽 어디쯤에 위치할 것입니다.

마지막 두 행의 차이가 핵심입니다. 캐싱은 청구액을 약 4분의 3까지 줄입니다. 그래서 Claude Code 세션 비용이 단순 토큰 합산보다 훨씬 낮게 나오고, 캐시를 깨는 모든 행동(저장소 간 점프, 세션을 자주 재시작, 세션 중 모델 전환)이 모르게 비용을 세 배로 만든다는 뜻입니다. 제대로 모델링하고 싶다면 Anthropic의 가격 문서에 전체 승수 표가 있습니다.

모델 요율 차이

모델 선택은 사용자가 통제할 수 있는 요소 중 비용에 가장 큰 영향을 줍니다. 동일한 15회 교환 세션을 라인업 전반에서 실행하면:

즉, 5달러 잔액으로 가능한 세션 수는 어떤 모델을 지정하느냐에 전적으로 달렸고, 5회에서 27회 사이입니다. 평가에는 Sonnet 5가 합리적 기본값입니다.

이 잔액은 장난감 예제가 아닌 실제 작업에 쓰세요. 실제로 소유한 모듈을 리팩터링하거나, 세 파일에 걸친 버그를 추적해 보세요. 그래야만 도구가 주간 업무에 자리 잡을 가치가 있는지 알 수 있습니다.

잔액이 0이 되면 대체 수단은 없습니다. 콘솔 과금은 사용량 기반이며, Claude Code에는 그 아래에 대기하는 무료 등급이 없습니다.

옵션 2: OpenRouter 무료 모델

OpenRouter는 API 게이트웨이로, 수백 개의 모델 앞단에 위치하며 그중 일부는 무료로 호출할 수 있습니다. 신용카드, 월 요금, 구독이 필요 없습니다.

이것이 Claude Code와 연결되는 이유는 CLI가 엔드포인트를 환경 변수에서 읽기 때문입니다. 변수를 바꾸면 요청 대상이 바뀝니다. OpenRouter는 "Anthropic Skin"이라 부르는, Anthropic Messages 형식을 수용하고 생각 블록과 네이티브 툴 사용을 그대로 통과시키는 엔드포인트를 운영합니다. 로컬 프록시는 필요 없습니다.

무엇을 얻는지 분명히 하세요. 이 모델들은 Claude가 아닙니다. Claude Code 인터페이스, 에이전트 루프, 파일 편집, 슬래시 명령은 유지되지만, 추론은 Qwen이나 Llama 변형이 담당합니다.

OpenRouter 문서 자체도, Claude Code는 Anthropic의 1차 제공자에 연결될 때만 동작이 보장되며 "다른 제공자에서는 제대로 동작하지 않을 수 있다"고 경고합니다. 사실을 그대로 인용하는 편이 낫겠습니다.

리다이렉트 작동 방식

세 가지 변수가 핵심입니다.

• ANTHROPIC_BASE_URL을 Anthropic 엔드포인트 대신 https://openrouter.ai/api로 지정합니다.

• ANTHROPIC_AUTH_TOKEN에 OpenRouter 키를 넣고, Authorization: Bearer 헤더로 전송합니다.

• ANTHROPIC_API_KEY는 명시적으로 빈 문자열이어야 합니다. 그렇지 않으면 Claude Code가 Anthropic 인증으로 되돌아갈 수 있습니다.

이 값들은 셸 프로필이나 Claude Code 설정 파일에 넣을 수 있습니다. 피해야 할 한 가지: 프로젝트의 .env 파일은 동작하지 않습니다. 네이티브 설치본은 표준 .env 파일을 읽지 않기 때문입니다.

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-your-openrouter-key",
    "ANTHROPIC_API_KEY": ""
  }
}

파일 위치는 생각보다 중요합니다. 전역 구성에는 ~/.claude/settings.json을, 단일 프로젝트 전용에는 .claude/settings.local.json을 사용하세요. Claude Code가 후자를 gitignore에 추가합니다. 

프로젝트의 .claude/settings.json에는 자격 증명을 넣지 마세요. 해당 파일은 커밋되어 저장소를 클론하는 모든 이와 공유됩니다.

OpenRouter로 Claude Code 설정하기

1. Claude Code 설치: 아직이라면 네이티브 설치 프로그램으로 설치하세요.

2. 무료 계정 생성: openrouter.ai에서 계정을 만들고 Settings > Keys에서 키를 발급받으세요. 무료 모델만 호출하는 계정에는 카드가 필요 없습니다.

3. 구성 작성: 위 블록을 참고해 ~/.claude/settings.json에 쓰거나, 셸 프로필에 동일한 세 변수를 export하세요.

4. 과거에 Anthropic 계정으로 Claude Code에 로그인한 적이 있다면, CLI 안에서 /logout을 실행한 뒤 종료하고 재실행하세요. 캐시된 세션이 변수를 덮어써, 모델을 찾을 수 없다는 혼란스러운 오류로 드러납니다.

5. claude 시작 후 요청 대상지를 확인합니다.

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://openrouter.ai/api

요청은 몇 초 안에 OpenRouter 활동 대시보드에도 표시되어, 리다이렉트 성공을 가장 빠르게 확인할 수 있습니다.

OpenRouter에서 무료 모델 선택하기

무료 모델 ID는 :free로 끝나며, 제공자가 모델을 추가/철회/변경함에 따라 목록은 계속 바뀝니다. OpenRouter 무료 모델 컬렉션에서 비용 없이 이용 가능한 모델을 확인하세요. openrouter/free는 무료 모델용 자동 라우터입니다. 가용성과 요청에 맞는 모델을 알아서 선택해, 개별 모델이 교체되어도 설정이 유지되게 합니다. 가장 간단한 시작점이지만, 품질은 크게 변동합니다.

OpenRouter의 가격, 크레딧, 무료 모델 목록은 월 단위로 변동하며, 이 글을 쓰는 동안에도 일부가 바뀌었습니다. 여기의 수치로 계획을 세우기 전, Anthropic의 가격 페이지와 OpenRouter의 무료 필터를 확인하세요.

그리고 요율 제한은 모델 선택보다 더 뼈아픕니다. 무료 모델은 계정과 무관하게 분당 20요청, 크레딧을 한 번도 구매하지 않았다면 하루 50요청이 한도입니다. 한 번이라도 $10 크레딧을 구매하면 일일 한도가 1,000으로 상승하고, 잔액이 0으로 돌아가도 그대로 유지됩니다.

하루 50요청이면 충분해 보이지만, 에이전틱 세션은 수다스러운 동료처럼 요청을 소모한다는 점을 잊기 쉽습니다. 적당히 복잡한 작업 하나가 하루 한도의 3분의 1을 먹을 수 있습니다. 실패한 시도도 카운트되므로, 무작정 재시도는 상황을 악화시킵니다.

역할별로 특정 모델을 라우팅하려면, Claude Code는 각 티어에 대해 별도 변수를 제공합니다.

bash
export ANTHROPIC_DEFAULT_SONNET_MODEL="cohere/north-mini-code:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="cohere/north-mini-code:free"
export CLAUDE_CODE_SUBAGENT_MODEL="cohere/north-mini-code:free"

간단한 리팩터링, 단일 파일 편집, 설명 작업은 꽤 견딜 만합니다. 다만, 길고 다단계인 작업은 눈에 띄게 저하되며, 실패 양상은 보통 코드 품질 자체보다 도구 호출에서 발생합니다. 즉, 모델이 잘못된 도구를 고르거나, 결과를 오독하거나, 루프에 빠집니다.

작업에 따라 모델을 의도적으로 혼합하고 싶다면, Claude Code Router 가이드에서 다중 모델 라우팅을 자세히 다룹니다.

옵션 3: Ollama 로컬 모델

Ollama는 오픈 모델을 로컬 머신에서 실행합니다. API 키도, 요율 제한도, 가중치 다운로드 후에는 인터넷 연결도 필요 없습니다.

2026년 1월, Ollama v0.14.0에서 Anthropic Messages API 호환성이 추가되면서 이 워크플로가 현실화되었습니다. 이전에는 중간에 변환 프록시가 필요했습니다. 이제 Claude Code는 localhost에 직접 통신합니다.

비용이 사라지는 것이 아니라 하드웨어로 옮겨갑니다. 정확히는 메모리 대역폭이 관건입니다. 용량만의 문제가 아닙니다. 

• Apple Silicon에서는 통합 메모리가 핵심 수치입니다. 16 GB로는 gpt-oss:20b 같은 ~14B 모델이 돌아가지만, 쓸 만한 30B급 코딩 모델은 32K 컨텍스트를 더하면 32 GB 이상을 원합니다. 

• Windows/Linux 머신에서는 지표가 GPU VRAM입니다. 시스템 RAM이 아니라요. RAM에는 들어가도 CPU로 돌리면, 에이전틱 작업처럼 수십 번 호출하는 경우에는 너무 느립니다.

Ollama와 Claude Code 연동 설정

1. Ollama 설치. macOS/Linux는 curl -fsSL https://ollama.com/install.sh | sh, Windows는 ollama.com에서 설치 파일을 내려 받아 실행합니다.

2. 코딩 모델 받기. 최신 Claude에는 못 미치지만 Qwen3-Coder가 준수합니다: ollama pull qwen3-coder.

3. 모델 존재 확인: ollama list.

4. 컨텍스트 길이 늘리기. 사람들이 잊어버리고 모델 탓을 하는 설정입니다. Claude Code에는 최소 32K 토큰을 권장합니다.

5. 로컬 엔드포인트로 지정하고 모델 선택.

bash
export OLLAMA_CONTEXT_LENGTH=32768
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_BASE_URL=http://localhost:11434

claude --model qwen3-coder

인증 토큰은 프로토콜상 필수지만 Ollama는 무시하므로 값은 중요하지 않습니다. 구성을 영구화하고 싶다면 동일한 세 키를 ~/.claude/settings.json의 env 블록에 넣으세요.

판단 전에 알아둘 간극이 두 가지 있습니다.

• Anthropic의 프롬프트 캐싱은 적용되지 않습니다. 매 요청마다 시스템 프롬프트와 전체 대화 이력을 처음부터 다시 처리합니다. 여기서는 비싸지 않고 느린 문제가 됩니다.

• Ollama 호환 레이어는 tool_choice도 무시합니다. Claude Code가 때때로 특정 도구 호출을 강제하는 데 사용하는 필드인데, 이게 중요할 때는 에이전트가 틀린 도구를 골라 루프에 빠질 수 있습니다.

이 설정에 대한 자세한 안내는 Ollama 로컬 모델과 함께 Claude Code 사용하기 전용 튜토리얼을 참고하세요. Qwen 3와 DeepSeek R1 로컬 실행 가이드도 별도로 있습니다.

하드웨어 현실 점검

대부분의 개발자에게 OpenRouter는 Ollama보다 유리합니다. 다만 통합 메모리/VRAM 32 GB 이상이 있거나, 오프라인 접근이 필요하거나, 코드가 머신 밖으로 나가지 않기를 원한다면 이야기가 달라집니다. 마지막 이유는 충분히 설득력 있으며, 성능만으로 이 경로를 배제하지 않는 이유입니다.

옵션 4: Claude for Open Source 프로그램

이 주제의 대부분 가이드는 세 가지 옵션에서 멈추고, 실제 제품을, 그것도 최상위 등급으로, 반년간 제공하는 옵션을 놓칩니다.

Anthropic은 2026년 2월 Claude for Open Source를 시작했고 7월에 확대했습니다. 자격을 갖춘 유지관리자와 기여자는 월 $200 요금제인 Claude Max 20x를 6개월간 무료로 받습니다. 여기에 Claude Code가 포함되며, 소비자 최상위 등급의 사용 여유가 주어집니다.

공개된 자격 요건은 많은 이들의 예상보다 폭넓습니다.

• npm, PyPI, crates.io, RubyGems 등에서 종속 저장소 500개 이상, 종속 패키지 100개 이상, 또는 월간 총다운로드 200,000건 이상을 가진 패키지 유지관리자.
• CPython, Rust 팀, Node.js TSC, Apache PMC, CNCF, Kubernetes, Linux 커널, Django, Rails 등 재단/언어 프로젝트의 등재 커미터.
• 지난 12개월 동안 본인 소유가 아닌 저장소에 머지된 PR 100건 이상을 만든 사람.
• 지난 1년간 외부 기여자 20명 이상이 머지된 PR로 참여한 커뮤니티 리포지토리의 빌더.
• OpenSSF 중대성 점수 0.4 이상인 프로젝트의 유지관리자.

Anthropic 페이지는 경계선 사례도 지원하도록 명시하며, 생태계가 조용히 의존하는 바를 설명하라고 권합니다. 프로그램은 10,000명으로 상한이 있으며 수시 심사합니다. 신청은 claude.com/contact-sales/claude-for-oss에서 진행합니다.

주의점 한 가지: 이 프로그램은 구독을 커버할 뿐, API 크레딧은 포함하지 않습니다. ANTHROPIC_API_KEY 사용은 별도 과금입니다. 개인용 플랜이지 CI 파이프라인에 지정할 성격은 아닙니다.

당신에게 맞는 무료 옵션 고르기

두 가지 질문이면 충분합니다. 무엇을 위해 Claude Code가 필요한가요? 그리고 지루해지기 전에 어느 정도의 설정까지 감당하실 수 있나요?

비교 표

무엇을 선택해야 할까요?

• Claude Code를 한 번도 써보지 않았다면 월 $20의 가치가 있는지 알고 싶을 때 API 스타터 크레딧을 쓰세요. 실제 제품을 보여주는 유일한 경로이며, 한두 번이 아닌 열댓 번의 세션이면 충분히 판단할 수 있습니다.
• 지속적인 무료 접근이 필요하고 반드시 Claude일 필요가 없다면, OpenRouter가 품질 대비 노력의 최선입니다. 첫 설정에 저녁 한 끼 만큼의 시간을 잡고, 일일 요청 한도에 예상보다 일찍 닿을 것을 기대하세요.
• 오프라인 접근이 필요하거나, 소스 코드의 이동 경로에 대해 회사 정책이 엄격하다면, 하드웨어 비용에도 불구하고 Ollama가 답입니다. 통합 메모리/VRAM 16 GB 미만이라면 추천하지 않습니다.
• 남들이 의존하는 무언가를 유지한다면, 이 모든 것보다 오픈 소스 지원을 먼저 확인하세요. 최상위 등급 6개월이면 고민이 사라집니다.

리다이렉트 설정 문제 해결

옵션 3과 4는 실패 양상이 겹치며, 대부분이 같은 몇 가지 문제에서 비롯됩니다. Anthropic도 게이트웨이 제공자도 각자의 조합을 디버깅해 줄 수 없으니, 먼저 다음을 확인하세요.

• Claude Code가 계속 로그인을 요구합니다. CLI는 자체 자격 증명이 없고, 접근 가능한 base URL만으로는 충분하지 않습니다. 프로젝트 .claude/settings.json의 env 블록은 최초 실행 마법사 이후에만 적용되므로, ANTHROPIC_AUTH_TOKEN을 더 이른 타이밍에 읽히는 곳(셸 export나 ~/.claude/settings.json)에 설정하세요.

• 시작 경고에 두 개의 자격 증원 출처가 표시됩니다. 게이트웨이 자격 증명과 저장된 로그인이 동시에 활성화되어 있습니다. /logout으로 저장된 로그인을 지우거나, 변수를 해제해 이전 로그인으로 되돌리세요.

• 인식되지 않는 필드를 언급하는 400 오류. Claude Code는 일부 상류에서 거부하는 필드를 Anthropic 형식 엔드포인트에 전송합니다. CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1을 설정하면 대부분의 사전 릴리스 필드를 억제해 상황을 명확히 합니다.

• thinking 또는 adaptive를 언급하는 400 오류. 상류 모델이 적응형 추론을 수용하지 않는데, Claude Code는 최신 Claude 모델에 대해 이를 요청합니다. 대개 게이트웨이의 상류 업데이트가 필요하며, 클라이언트 측 수정만으로는 어렵습니다.

• 원격 제어와 음성 받아쓰기가 작동하지 않습니다. 둘 다 claude.ai ID에 의존하며, 게이트웨이 자격 증명이 설정되어 있는 동안은 사용할 수 없습니다. v2.1.196부터는 ANTHROPIC_BASE_URL이 비-Anthropic 호스트를 가리키면 원격 제어가 비활성화됩니다.

원인이 어느 레이어인지 확신이 서지 않을 때는, 세션 안에서 /status를 실행해 실제로 어떤 base URL과 자격 증명 출처가 사용 중인지 확인하세요. 이 한 가지 명령이 재설정보다 더 많은 문제를 해결합니다.

마무리

Claude Code를 무료로 쓰는 네 가지 경로. 완벽한 것은 없고, 트레이드오프야말로 부차가 아니라 핵심입니다.

제 추천은 분명합니다. 원하는 것이 채팅창이 아니라 Claude Code CLI 에이전트라면, API 크레딧부터 시작하세요. 대체재를 저녁 내내 설정하는 것보다, 실제 제품에서의 한 번의 진짜 세션이 훨씬 많은 걸 알려줍니다. 워크플로에 자리를 잡는다면 월 $20은 방어 가능한 비용입니다. 아니라면 잃을 것은 없으며, 이유도 알게 됩니다.

장기적으로는 OpenRouter가 가장 지속 가능한 무료 옵션이고, 프라이버시나 오프라인 접근이 협상 불가인 순간 Ollama가 승리합니다.

유용한 세션과 답답한 세션을 가르는 습관은, 실전 프로젝트에서의 계획, 컨텍스트 전달, 테스트 주도 개발을 다룬 Claude Code 모범 사례를 참고하세요. 처음부터 시작하신다면, Claude Code 101에서 첫 설치부터 작동하는 워크플로까지를 인터랙티브한 구조화 수업으로 학습할 수 있습니다.