Source: https://aiprimetech.io/ko/claude-code/openrouter/

[홈](/ko/) › [Claude Code](/ko/claude-code/) › OpenRouter

[개요](/ko/claude-code/)[설치](/ko/claude-code/install/)[CLI 참조](/ko/claude-code/cli/)[요금 및 한도](/ko/claude-code/pricing/)[Agent SDK](/ko/claude-code/sdk/)[스킬 및 플러그인](/ko/claude-code/skills/)[GitHub](/ko/claude-code/github/)[웹, 데스크톱 및 IDE](/ko/claude-code/web-and-desktop/)[모델](/ko/claude-code/models/)[오류](/ko/claude-code/errors/)[오픈 소스인가요?](/ko/claude-code/open-source/)[튜토리얼](/ko/claude-code/tutorial/)[학생용 안내](/ko/claude-code/for-students/)[QA 자동화](/ko/claude-code/qa-automation/)[Cursor와 비교](/ko/claude-code/vs-cursor/)[Codex 및 OpenCode와 비교](/ko/claude-code/vs-codex/)[하위 에이전트](/ko/claude-code/subagents/)[훅](/ko/claude-code/hooks/)[MCP](/ko/claude-code/mcp/)[생태계](/ko/claude-code/ecosystem/)[VS Code](/ko/claude-code/vscode/)[OpenRouter](/ko/claude-code/openrouter/)[요청 속도 제한](/ko/claude-code/rate-limits/)[중국어 가이드](/claude-code/zh/)

최종 업데이트: 2026년 10월 11일

# Claude Code에서 OpenRouter를 사용하는 방법과 사용하지 않는 편이 나은 경우

사람들이 Claude Code를 OpenRouter에 연결하는 이유는 두 가지입니다. 이미 보유한 계정으로 Claude 사용료를 결제하거나, Claude Code 안에서 다른 제공업체의 모델을 실행하기 위해서입니다. 둘 다 가능하지만, 반나절을 들이기 전에 알아둘 만한 주의점이 있습니다.

## TLDR
- 경로 1: 다음을 통해 OpenRouter의 Anthropic 호환 엔드포인트에 연결 ANTHROPIC_BASE_URL + OpenRouter 키 — Claude 모델만 사용할 수 있으며, 정가에 OpenRouter 수수료가 추가됩니다.
- 경로 2: claude-code-router 를 Claude Code 앞단에 배치 — 작업별로 어떤 OpenRouter 모델이든 사용할 수 있지만, 로컬 프록시가 필요하고 간혹 도구 호출 문제가 발생합니다.
- Claude 이외의 모델은 Claude Code의 도구 스키마를 처리하는 능력이 제각각이므로, 재시도가 더 잦을 수 있습니다.
- Claude만 필요하다면 Claude 게이트웨이가 OpenRouter보다 저렴합니다. 정가에 수수료를 더하는 대신, 동일한 모델을 액면가의 7.69231배 가격으로 이용할 수 있습니다.

## 경로 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

[모든 무제한 요금제 →](/ko/plans/)

## 먼저 무료로 사용해 보세요

신규 계정에는 $5의 무료 API 크레딧이 제공됩니다 사용할 코드: CLAUDECODE — Sonnet으로 저녁 한나절 Claude Code를 사용하기에 충분합니다. 이후에는 액면가의 7.69231배에 해당하는 크레딧이 제공됩니다.

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[코드 CLAUDECODE로 계정 만들기](/register?promo=CLAUDECODE)

## 자주 묻는 질문

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 키 발급받기](/register?promo=CLAUDECODE) [무제한 요금제 보기](/ko/plans/)

AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.

## 더 많은 Claude Code 가이드

[Claude Code: 완벽 가이드](/ko/claude-code/)[Claude Code 설치 방법](/ko/claude-code/install/)[Claude Code CLI 문서: 명령어와 플래그](/ko/claude-code/cli/)[Claude Code 요금 및 한도 설명](/ko/claude-code/pricing/)[Claude Code SDK, 이제 Claude Agent SDK로](/ko/claude-code/sdk/)[Claude Code 스킬과 플러그인](/ko/claude-code/skills/)[GitHub에서 Claude Code 사용하기: App, Action 및 @claude](/ko/claude-code/github/)[Claude Code에 웹 인터페이스가 있나요? 웹, 데스크톱 및 IDE 설명](/ko/claude-code/web-and-desktop/)[Claude Code가 사용하는 모델과 변경 방법](/ko/claude-code/models/)[Claude Code 오류와 해결 방법](/ko/claude-code/errors/)[Claude Code는 오픈 소스인가요?](/ko/claude-code/open-source/)[Claude Code 튜토리얼: 첫 실전 세션](/ko/claude-code/tutorial/)[학생을 위한 Claude: Claude Code, API 및 교육 분야에서 실제로 제공되는 혜택](/ko/claude-code/for-students/)[QA 자동화에 Claude Code를 사용하는 방법](/ko/claude-code/qa-automation/)[Claude Code와 Cursor 비교: 어떤 도구를 언제 선택하고, 둘 다 어떻게 사용할까](/ko/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: 터미널 에이전트 비교](/ko/claude-code/vs-codex/)[Claude Code 하위 에이전트: 작동 방식, 정의 방법, 에이전트 팀](/ko/claude-code/subagents/)[Claude Code 훅: 에이전트 동작에 대한 결정론적 제어](/ko/claude-code/hooks/)[Claude Code MCP: 서버 연결, 범위, 원격 MCP와 실제 예제](/ko/claude-code/mcp/)[Claude Code 생태계: 라우터, 프레임워크, 플러그인과 이를 모아 둔 목록](/ko/claude-code/ecosystem/)[VS Code에서 Claude Code 사용하기: 확장 프로그램, 터미널 사용 방식, 오류](/ko/claude-code/vscode/)[Claude 요청 한도 오류: "API 오류: 요청 한도 도달"의 의미와 해결 방법](/ko/claude-code/rate-limits/)[Claude Code 사용법: 설치부터 일상적인 사용까지](/claude-code/zh/)