AI Perks는 스타트업과 개발자가 비용을 절감할 수 있도록 AI 도구, 클라우드 서비스, API에 대한 독점 할인, 크레딧 및 혜택을 제공합니다.
OpenRouter로 Claude Code를 어떻게 사용하나요?
기본 URL을 https://openrouter.ai/api 로 설정하고, OpenRouter API 키를 ANTHROPIC_AUTH_TOKEN에 넣은 뒤 ANTHROPIC_API_KEY는 비워 두세요. 그러면 Claude Code가 로컬 프록시 없이 OpenRouter와 직접 통신하고, 사용량은 OpenRouter 크레딧으로 청구됩니다.
이 설정은 Claude Code용 공식 OpenRouter 가이드에 설명되어 있습니다. 가이드에 따르면 Claude Code는 기본 프로토콜로 OpenRouter와 직접 통신하며, 로컬 프록시 서버는 필요하지 않습니다. 이것이 자기 컴퓨터에서 프록시를 실행하는 Claude Code Router 같은 도구와의 주요 차이점입니다(그 방식을 원한다면 Claude Code Router 가이드를 참고하세요).
이 글의 나머지 부분에서는 정확한 환경 변수, 설정 위치, OpenRouter가 밝힌 주의 사항, 비용, 그리고 무료 크레딧으로 비용을 충당하는 방법을 다룹니다.
스타트업을 위한 최고의 AI 크레딧
검증된 프로그램을 통해 직접 신청하세요.
OpenRouter에 필요한 환경 변수는 무엇인가요?
세 가지 변수가 핵심 역할을 합니다. 가이드에서는 스킴을 포함한 전체 OpenRouter API URL을 요구하므로, 호스트 이름만 입력하면 동작하지 않습니다.
| 변수 | 값 | 이유 |
|---|---|---|
| ANTHROPIC_BASE_URL | https://openrouter.ai/api | Claude Code 트래픽을 OpenRouter로 보냅니다 |
| ANTHROPIC_AUTH_TOKEN | 본인의 OpenRouter API 키 | OpenRouter 인증을 수행합니다 |
| ANTHROPIC_API_KEY | 빈 문자열 | 충돌을 막기 위해 명시적으로 비웁니다 |
claude code base url openrouter를 검색할 때 사람들이 가장 자주 틀리는 부분이 기본 URL입니다. https://를 앞에 붙여 https://openrouter.ai/api를 정확히 사용하세요.
ANTHROPIC_API_KEY를 비워 두는 것은 Claude Code가 두 변수를 모두 읽기 때문에 중요합니다. 이전 Anthropic 키가 여전히 설정되어 있으면 OpenRouter 토큰과 충돌할 수 있습니다.
변수는 어디에 넣고, 어디에 넣으면 안 되나요?
지원되는 위치는 두 곳이고, 동작하지 않는 위치가 한 곳 있습니다.
옵션 1: 셸 프로필. OpenRouter는 지속적인 설정을 위해 이 방법을 권장합니다. 변수를 여기에 추가한 다음 셸을 다시 불러오세요. 가이드는 재로드에 대해 단호하게 말합니다. 이를 건너뛰면 이전 환경으로 계속 테스트하게 되고, 설정이 잘못되었다고 잘못 판단하게 됩니다.
옵션 2: 프로젝트 수준 설정 파일. 대신 프로젝트 루트의 .claude/settings.local.json을 사용할 수 있습니다. 이렇게 하면 설정이 한 프로젝트에만 적용됩니다.
.env 파일은 안 됩니다. 가이드에 따르면 네이티브 Claude Code 설치 프로그램은 표준 .env 파일을 읽지 않으므로, 프로젝트 수준 .env 파일에 이 값을 넣지 마세요.
한 가지 함정이 더 있습니다. OpenRouter 키가 ANTHROPIC_AUTH_TOKEN이 참조하는 다른 변수에 들어 있다면, 사용되기 전에 먼저 정의해야 합니다. 그렇지 않으면 인증이 실패합니다. 가이드는 zsh의 경우 ~/.zshenv처럼 더 일찍 로드되는 파일을 사용하라고 제안합니다.
스타트업을 위한 최고의 AI 크레딧
검증된 프로그램을 통해 직접 신청하세요.
단계별로 어떻게 설정하나요?
1단계: AI Perks로 크레딧 받기
OpenRouter를 통한 Claude Code는 OpenRouter 크레딧으로 청구되므로, 먼저 무료 크레딧을 찾는 것부터 시작하세요. AI Perks 가이드에는 최대 $3,000의 OpenRouter 크레딧이 나와 있으며, 직접 키를 가져온다면 사용할 수 있는 Anthropic 크레딧도 있습니다. 본인 돈을 쓰기 전에 카탈로그에서 금액과 세부 사항을 확인하세요.
2단계: OpenRouter API 키 만들기
OpenRouter 계정 설정에서 키를 생성하세요. 이 값이 ANTHROPIC_AUTH_TOKEN에 들어갑니다.
3단계: 변수 추가하기
기본 URL, 인증 토큰, 그리고 비워 둔 ANTHROPIC_API_KEY를 셸 프로필 또는 .claude/settings.local.json에 넣으세요. .env 파일은 사용하지 마세요. 그다음 셸을 다시 불러오세요.
4단계: 필요하면 /logout 실행하기
이전에 Anthropic 계정으로 Claude Code에 로그인한 적이 있다면, /logout을 한 번 실행해 캐시된 세션을 제거하세요. 그런 다음 claude를 종료했다가 다시 실행해 새 변수를 적용하세요. Anthropic 계정으로 로그인한 적이 없다면 이 단계는 건너뛰어도 됩니다.
5단계: /status로 확인하기
Claude Code 안에서 /status를 실행해 연결을 확인하세요. 그다음 OpenRouter 대시보드를 확인하세요. 추론 토큰을 포함한 사용량이 거기에 표시됩니다.
OpenRouter가 밝힌 주의 사항은 무엇인가요?
가이드는 제약 사항을 명확히 밝히고 있으며, 이는 설정 방법에 영향을 줍니다.
- Anthropic 자사 프로바이더만 해당. OpenRouter를 통한 Claude Code는 Anthropic 자사(first-party) 프로바이더에서만 동작이 보장됩니다. 최대 호환성을 위해 OpenRouter는 Anthropic 1P를 최우선 프로바이더로 설정할 것을 권장합니다.
- 다른 모델은 동작하지 않을 수 있음. Claude Code는 Anthropic 모델에 최적화되어 있으며, 다른 프로바이더의 모델에서는 올바르게 동작하지 않을 수 있습니다. Anthropic이 아닌 모델은 기본값이 아니라 실험으로 취급하세요.
- 컨텍스트 윈도우 가정. 모델 이름이
[1m]으로 끝나지 않는 한, Claude Code는 200k 컨텍스트 윈도우를 가정합니다. - 장애 조치. OpenRouter를 통해 라우팅되면, 요청은 여러 Anthropic 프로바이더 사이에서 자동으로 장애 조치됩니다.
- 개인정보. 계정 설정에서 프롬프트 로깅에 동의하지 않는 한, OpenRouter는 소스 코드 프롬프트를 기록하지 않습니다.
첫 번째 주의 사항 때문에 "claude code openrouter free" 검색은 신중하게 접근해야 합니다. OpenRouter는 무료 모델을 제공하지만 사용량에 상한이 있고, Claude Code는 Anthropic 자사 프로바이더에서만 동작이 보장됩니다. 무료 모델은 분당 20건, 하루 50건으로 제한되며, $10 이상의 크레딧을 구매하면 하루 1,000건으로 늘어납니다. 자세한 내용은 OpenRouter 무료 티어 가이드를 참고하세요.
스타트업을 위한 최고의 AI 크레딧
검증된 프로그램을 통해 직접 신청하세요.
OpenRouter를 통해 빠른 모드를 사용할 수 있나요?
가능하지만, 특정 조건에서만 됩니다. Anthropic의 빠른 모드는 기반 Opus 모델의 표준 토큰 요금보다 높은 프리미엄 가격으로 최대 2.5x 빠른 출력을 제공합니다.
| 요구 사항 | 세부 내용 |
|---|---|
| 모델 | Claude Opus 4.6, 4.7, 4.8 및 Claude Opus 5 |
| Claude Code 버전 | v2.1.96 이상 |
| 환경 변수 | /fast 사용 시 CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1 |
| 프로바이더 | Anthropic 자사 프로바이더만 해당 |
| 모델 설정 | Opus 변수를 anthropic/claude-opus-5와 같은 특정 ID로 고정 |
빠른 모드는 Anthropic 자사 프로바이더에서만 제공되며, Amazon Bedrock이나 Google Vertex 같은 다른 프로바이더는 지원하지 않습니다. 실제로 사용하려면 최신 별칭 대신 Opus 모델 변수를 특정 Opus ID로 고정하세요. 가이드는 여기서 프리미엄 배수를 공개하지 않으므로, 의존하기 전에 현재 요금을 확인하세요.
OpenRouter의 Claude Code 비용은 Anthropic 직접 결제와 비교하면 어떤가요?
OpenRouter는 추론 요금에 마진을 붙이지 않습니다. 추론은 모든 요금제에서 프로바이더의 정가로 청구됩니다. 수수료는 개별 요청이 아니라 크레딧을 구매할 때만 부과됩니다.
$10 크레딧을 구매할 때 수수료가 어떻게 계산되는지는 다음과 같습니다.
| 크레딧 구매 | 수수료율 | $10에 대한 수수료 |
|---|---|---|
| 암호화폐 외, Standard | 5.5%, 최소 $0.80 | $0.80 (5.5%인 $10의 $0.55는 최소 금액보다 낮으므로 최소 금액이 적용됨) |
| 암호화폐 | 고정 5.0%, 최소 금액 없음 | $0.50 ($10의 5.0%) |
| 암호화폐 외, Business | 8% | $0.80 ($10의 8%) |
따라서 솔직한 비교는 이렇습니다. 토큰당 가격은 프로바이더의 정가이고, OpenRouter는 그 위에 구매 수수료를 더합니다. Anthropic에 직접 결제하면 이 수수료를 피할 수 있습니다. 대신 얻는 것은 하나의 키, 하나의 대시보드, 그리고 Anthropic 프로바이더 간의 장애 조치입니다.
모델별 토큰 가격은 OpenRouter 가격 페이지에 공개되어 있지 않습니다. 모델 API에서 확인해야 합니다. Anthropic 자체 가격은 Claude API 가격 분석을 참고하세요.
BYOK는 계산을 어떻게 바꾸나요?
Standard와 Business 요금제에는 BYOK(본인 키 사용)를 통해 월 $25,000까지 정가 기준 추론이 포함되며, OpenRouter 수수료는 없습니다. 이 한도를 넘으면 OpenRouter는 정가 기준 요청 비용의 5%를 부과하고, 이는 크레딧에서 차감됩니다.
BYOK를 사용하면 본인의 프로바이더 계정을 통해 속도 제한과 비용을 직접 관리합니다. 여기서 무료 벤더 크레딧이 유용해집니다. 프로바이더 계정에 크레딧이 있다면, 해당 벤더의 크레딧 약관에 따라 Claude Code 사용량에 이 크레딧을 사용할 수 있습니다.
스타트업을 위한 최고의 AI 크레딧
검증된 프로그램을 통해 직접 신청하세요.
어떤 무료 크레딧으로 Claude Code 사용량을 충당할 수 있나요?
다음은 Claude Code 실행과 가장 관련 있는 카탈로그 금액입니다. 세부 사항과 각 혜택의 조건은 AI Perks 카탈로그에서 확인할 수 있습니다.
| 회사 | 무료 크레딧 | 받는 방법 |
|---|---|---|
| OpenRouter | 최대 $3,000 | 이 혜택 받기 |
| Anthropic (직접) | $20,000 | 이 혜택 받기 |
| 파트너 경유 Claude | 최대 $100,000 | 이 혜택 받기 |
| AWS (Amazon Bedrock) | $300,000 | 이 혜택 받기 |
이 네 항목의 합계: $3,000 + $20,000 + $100,000 + $300,000 = 목록에 있는 크레딧 최대 $423,000.
카탈로그에는 OpenAI, Google Cloud, Azure OpenAI, Mistral AI, Together AI, Cerebras, Novita AI의 크레딧도 나와 있습니다. 이들은 주로 Anthropic이 아닌 모델을 테스트하고 싶을 때 유용하며, OpenRouter가 Claude Code가 이들 모델에서 올바르게 동작하지 않을 수 있다고 경고한 점을 염두에 두세요. 특히 Anthropic 쪽은 무료 Anthropic API 키 가이드를 읽어 보고, 더 큰 Claude 크레딧 금액은 카탈로그에서 확인하세요.
FAQ
Claude Code가 OpenRouter와 동작하려면 로컬 프록시가 필요한가요?
아니요. OpenRouter는 Claude Code가 기본 프로토콜로 OpenRouter와 직접 통신하며 로컬 프록시 서버가 필요하지 않다고 밝히고 있습니다. 환경 변수만 설정하면 됩니다. Claude Code Router 같은 프록시 기반 도구는 다른 방식이며, 여러 모델에 걸쳐 사용자 정의 라우팅 규칙이 필요할 때 유용합니다.
왜 Claude Code가 여전히 이전 Anthropic 로그인을 사용하나요?
캐시된 세션이 남아 있을 가능성이 높습니다. /logout을 한 번 실행한 다음 claude를 종료했다가 다시 실행해 새 변수를 읽게 하세요. 또한 프로필을 수정한 뒤 셸을 다시 불러왔는지, ANTHROPIC_API_KEY가 비어 있는지 확인하세요. 결과는 /status로 확인할 수 있습니다.
Claude Code를 OpenRouter와 함께 무료로 사용할 수 있나요?
부분적으로 가능합니다. 새 OpenRouter 사용자는 소량의 무료 사용량을 받을 수 있고, 분당 20건, 하루 50건 상한이 있는 무료 모델도 있습니다. 하지만 Claude Code는 Anthropic 자사 프로바이더에서만 동작이 보장됩니다. 실제 사용을 위해서는 getaiperks.com에 나온 무료 크레딧을 확인해 보세요.
OpenRouter는 Claude 모델의 요청마다 추가 요금을 부과하나요?
아니요. 추론은 프로바이더의 정가로 청구되며, OpenRouter 수수료는 크레딧을 구매할 때 적용됩니다. Standard는 5.5%, Business는 8%입니다. 암호화폐 외 구매에는 $0.80의 최소 금액이 있고, 암호화폐 구매에는 고정 5.0%가 부과됩니다. 카탈로그의 Anthropic 크레딧을 이용해 Anthropic에 직접 결제하는 것과 비교해 보세요.
OpenRouter를 통해 무료 Anthropic 크레딧을 사용할 수 있나요?
BYOK를 통해 가능합니다. 본인의 프로바이더 키를 연결하면 비용은 프로바이더 계정을 통해 처리됩니다. Standard와 Business에는 OpenRouter 수수료 없이 월 $25,000의 BYOK 한도가 포함됩니다. 파트너 경유 최대 $100,000 상당의 Anthropic 크레딧을 찾으려면 AI Perks 카탈로그를 확인하세요.
왜 제 Claude Code 컨텍스트 윈도우가 200k인가요?
모델 이름이 [1m]으로 끝나지 않는 한, Claude Code는 200k 컨텍스트 윈도우를 가정합니다. Claude Code가 윈도우를 더 크게 취급하게 하려면 모델 이름에 그 접미사가 있어야 합니다. 가이드는 어떤 모델이 이를 지원하는지에 대한 추가 세부 정보는 공개하지 않습니다.
스타트업을 위한 최고의 AI 크레딧
검증된 프로그램을 통해 직접 신청하세요.
Claude Code 환경을 구축할 준비가 되셨나요?
설정은 몇 분이면 끝납니다. 계획이 필요한 부분은 비용입니다. OpenRouter 크레딧, Anthropic 크레딧, 클라우드 크레딧이 모두 하나의 카탈로그에서 관리되므로, 정가를 지불하기 전에 사용량에 맞는 크레딧을 골라 쓸 수 있습니다.
getaiperks.com에서 무료 AI 크레딧 받기 →
getaiperks.com에서 무료 AI 크레딧의 전체 카탈로그를 둘러보고, 직접 지불하지 않은 크레딧으로 Claude Code를 실행해 보세요.
