경로 1: Claude Code를 OpenRouter에 직접 연결
OpenRouter는 OpenAI 방식의 API와 함께 Anthropic 호환 Messages 엔드포인트를 제공합니다. Claude Code에는 기본 URL과 키만 있으면 되므로, 다른 게이트웨이에서 사용하는 것과 동일한 두 변수로 설정할 수 있습니다. 아래의 기본 경로가 변경되었다면 OpenRouter 문서에서 현재 경로를 확인하세요.
export ANTHROPIC_BASE_URL=https://openrouter.ai/api
export ANTHROPIC_AUTH_TOKEN=sk-or-... # your OpenRouter key
claude --model anthropic/claude-sonnet-5 # OpenRouter's model id format모델 ID는 OpenRouter의 vendor/model 명명 규칙을 따르며, 등급별 변수(ANTHROPIC_DEFAULT_SONNET_MODEL 등)에도 이 이름을 입력합니다. 다음을 실행하여 /status 엔드포인트를 확인하고, 다음을 실행하여 /model 전환합니다. 요금은 OpenRouter 기준으로 청구됩니다. 모델 정가에 크레딧에 대한 OpenRouter 플랫폼 수수료가 더해지므로, 이 경로는 Anthropic 직접 이용보다 비용이 약간 *더* 높습니다. 목적은 가격 절감이 아니라 편의성과 계정 통합입니다.
경로 2: Claude 이외의 모델을 위한 claude-code-router
claude-code-router 는 Claude Code의 요청을 받아 규칙에 따라 선택한 제공업체로 각 요청을 전달하는 로컬 프록시입니다. 규칙에는 기본, 백그라운드, 사고, 긴 컨텍스트가 있습니다. 키를 사용해 OpenRouter를 제공업체로 설정하고, 경로별 모델을 선택한 다음, 다음으로 실행합니다. ccr code. 이 방식으로 Claude Code 안에서 가중치가 공개된 모델이나 다른 제공업체의 모델을 실행할 수 있습니다.
// ~/.claude-code-router/config.json (excerpt)
{
"Providers": [{
"name": "openrouter",
"api_base_url": "https://openrouter.ai/api/v1/chat/completions",
"api_key": "sk-or-...",
"models": ["anthropic/claude-sonnet-5", "google/gemini-2.5-pro", "deepseek/deepseek-chat"]
}],
"Router": { "default": "openrouter,anthropic/claude-sonnet-5", "background": "openrouter,deepseek/deepseek-chat" }
}발생하는 문제: Claude Code의 에이전트 루프는 Anthropic의 도구 사용 형식에 의존하므로, 라우터가 이를 OpenAI 방식 모델에 맞게 변환해야 합니다. 성능이 좋은 모델은 잘 처리하지만, 작은 모델은 도구 호출을 누락하거나 파일 경로를 지어내거나 권한 프로토콜을 무시하여 세션이 재시도를 반복하는 상태로 악화됩니다. *기본* 및 *사고* 경로에는 Claude 모델을 유지하고 나머지는 백그라운드 작업에 사용하면 좋은 구성이 됩니다.
실제 비용
- OpenRouter 직접 연결: Anthropic 정가 + OpenRouter 수수료. 편리하지만 Anthropic보다 저렴하지는 않습니다.
- claude-code-router + OpenRouter: 라우팅된 모델의 비용에 따라 달라집니다. 비용 절감은 Claude가 저렴해져서가 아니라, 백그라운드 작업을 저렴한 모델로 보내는 데서 나옵니다.
- Claude 게이트웨이(이 사이트): 동일한 Claude 모델을 제공하며, 액면가보다 87% 저렴하게 구매한 크레딧($13 → $100 상당의 사용량)에서 정가 기준으로 차감하거나, $1부터 시작하는 정액 무제한 요금제를 이용할 수 있습니다. GPT-6 / GPT-5.x도 Codex 그룹을 통해 제공됩니다.
Claude만 필요하다면 OpenRouter를 건너뛰세요
"Claude Code에서 OpenRouter 사용"을 검색하는 사람들은 대부분 Claude 요금을 줄이거나 Anthropic 콘솔 계정 없이 결제하는 방법을 원합니다. OpenRouter는 후자를 해결하지만 전자의 비용은 오히려 높입니다. 게이트웨이는 두 가지를 모두 해결합니다. 동일한 두 변수만 설정하면 되고 프록시는 필요 없습니다.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude두 방식은 함께 사용할 수도 있습니다. claude-code-router에서 이 게이트웨이를 Anthropic 유형의 제공업체로 정의하고, Claude 등급의 요청은 여기로 라우팅하면서 백그라운드 작업은 다른 곳으로 보내세요. 생태계 가이드에서 라우터를 더 자세히 다룹니다.
| 계획 | 기간 | 가격 |
|---|---|---|
| 1시간 무제한 | 1시간 | $1 |
| 24시간 무제한 | 24시간 | $10 |
| 1주 무제한 | 1주 | $49 |
| 15일 무제한 | 15일 | $89 |
먼저 무료로 사용해 보세요
신규 계정에는 $5의 무료 API 크레딧이 제공됩니다 사용할 코드: CLAUDECODE — Sonnet으로 저녁 한나절 Claude Code를 사용하기에 충분합니다. 이후에는 액면가의 7.69231배에 해당하는 크레딧이 제공됩니다.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key자주 묻는 질문
Claude Code에서 OpenRouter를 사용할 수 있나요?
네. OpenRouter의 Anthropic 호환 엔드포인트를 통해 Claude 모델에 직접 연결하거나, claude-code-router를 통해 어떤 OpenRouter 모델이든 사용할 수 있습니다. 직접 연결하려면 ANTHROPIC_BASE_URL와 OpenRouter 키를 설정하세요.
Claude Code에서 OpenRouter를 사용하면 더 저렴한가요?
아니요. OpenRouter는 Anthropic 정가에 자체 수수료를 더해 청구합니다. 비용을 절감하려면 백그라운드 작업을 더 저렴한 Claude 이외의 모델로 라우팅하거나, 동일한 모델을 정가보다 저렴하게 제공하는 Claude 게이트웨이를 사용해야 합니다.
OpenRouter를 통해 Claude Code에서 사용할 때 가장 잘 작동하는 모델은 무엇인가요?
예상대로 Claude 모델입니다. 에이전트 루프가 Anthropic의 도구 형식을 중심으로 만들어졌기 때문입니다. 성능이 좋은 다른 모델도 라우터를 통해 작동하지만, 작은 모델은 도구 호출에 어려움을 겪습니다.
게이트웨이에서 Claude Code 실행하기
동일한 모델, 환경 변수 두 개, 액면가의 7.69231배에 해당하는 크레딧 또는 정액 무제한 요금제를 이용하세요. 신규 계정: 코드 CLAUDECODE로 $5의 무료 API 크레딧을 받으세요.
API 키 발급받기 무제한 요금제 보기AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.