연동 가이드

Claude Code

Claude Code v2.x는 Anthropic Messages API를 사용합니다. 주소를 https://www.coderouter.io로 지정하고(/v1/messages는 Claude Code가 직접 붙입니다), 모델은 auto로 설정하십시오.

한 줄로 설정

curl -fsSL https://www.coderouter.io/setup.sh | bash -s -- cr_YOUR_KEY_HERE
claude

이 스크립트는 아래 변수들을 ~/.claude/settings.json의 env 블록에 추가하며, 다른 설정은 건드리지 않습니다. 먼저 기존 파일을 백업하고, CodeRouter에서 키를 확인한 뒤(모델 호출 없음), 무엇을 바꿨는지 정확히 출력하고, 셸에 ANTHROPIC_API_KEY가 설정되어 있으면 경고합니다. python3 또는 node가 필요합니다(macOS, Linux). 되돌리려면 curl -fsSL https://www.coderouter.io/setup.sh | bash -s -- --uninstall을 실행하십시오. API 키 페이지에서 내 키가 채워진 명령을 확인할 수 있습니다.

또는 환경 변수로 이번 세션에만 설정

export ANTHROPIC_BASE_URL=https://www.coderouter.io
export ANTHROPIC_AUTH_TOKEN=cr_YOUR_KEY_HERE
export ANTHROPIC_MODEL=auto
export ANTHROPIC_DEFAULT_OPUS_MODEL=auto
export ANTHROPIC_DEFAULT_SONNET_MODEL=auto
export ANTHROPIC_DEFAULT_HAIKU_MODEL=auto

# v2.x의 실험적 베타 기능은 서드파티 게이트웨이에서 오류를 일으킬 수 있습니다.
# 이 변수로 해당 기능을 끕니다. 계속 켜 두어도 문제없습니다.
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

claude

또는 직접 설정 — ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.coderouter.io",
    "ANTHROPIC_AUTH_TOKEN": "cr_YOUR_KEY_HERE",
    "ANTHROPIC_MODEL": "auto",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "auto",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "auto",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "auto",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

CodeRouter를 거치는지 확인

실행 후 Claude Code 헤더에 Claude Max가 아니라 API Usage Billing이 표시되어야 합니다. 여전히 Claude Max가 보인다면 Claude 로그인이 인증 정보로 사용되고 있는 것입니다. /status를 실행해 Claude Code가 어떤 인증 정보를 선택했는지 확인한 다음, 아래처럼 로그아웃하고 다시 시작하십시오.

/logout               # Claude Code 안에서
claude auth logout    # 또는 셸에서
# 그다음 claude를 다시 시작합니다(변수를 export했다면 그 변수가 있는 셸에서)

Codex CLI

Codex CLI는 OpenAI Responses API를 사용합니다. CodeRouter는 이 API를 https://www.coderouter.io/api/v1/responses에서 제공합니다. Codex 설정에서 wire_api = "responses"로 CodeRouter를 모델 공급자(model provider)로 추가하고, 모델은 auto로 설정하십시오.

~/.codex/config.toml

model = "auto"
model_provider = "coderouter"

[model_providers.coderouter]
name = "CodeRouter"
base_url = "https://www.coderouter.io/api/v1"
env_key = "CODEROUTER_API_KEY"
wire_api = "responses"

API 키

export CODEROUTER_API_KEY=cr_YOUR_KEY_HERE   # 계속 쓰려면 ~/.zshrc 또는 ~/.bashrc에 추가하십시오
codex

Cursor

Cursor는 모델 이름을 문자열 단위의 허용 목록으로 관리합니다. 따라서 auto를 사용자 지정 모델로 추가해야 모델 선택 목록에 나타납니다. 설정은 UI에서만 하며 환경 변수는 필요 없습니다.

1. Cursor를 열고 Cmd+Shift+P(또는 Ctrl+Shift+P)를 누른 뒤 → "Cursor Settings"를 입력합니다
2. 왼쪽 사이드바에서 Models를 클릭합니다
3. OpenAI API Key 섹션에서 "Override OpenAI Base URL"을 켜고 다음을 붙여 넣습니다:
   • URL: https://www.coderouter.io/api/v1
   • 키: cr_YOUR_KEY_HERE
4. Verify를 클릭합니다. 반드시 초록색 ✓가 표시되어야 합니다
5. 위로 스크롤해 Models로 돌아가 + Add custom model을 클릭하고 auto를 입력합니다
6. auto 체크박스를 선택해 활성화합니다
7. 채팅 모델 드롭다운(채팅 창 오른쪽 위)에서 auto를 선택합니다

문제 해결

"There's an issue with the selected model (auto)" 오류

Claude Code에서만 발생합니다. 원인은 세 가지입니다(가능성이 높은 순서):

1. cr_ 키가 인증 정보로 사용되지 않아 요청이 Claude 구독으로 가고 있습니다(예: 키가 ANTHROPIC_API_KEY에 들어 있는데 Claude Code는 승인한 뒤에만 이 값을 쓰는 경우, 또는 설정 전에 세션을 시작한 경우). 키를 ANTHROPIC_AUTH_TOKEN에 넣고 Claude Code를 다시 시작한 뒤, /status를 확인하고 배지에 Claude Max가 아니라 API Usage Billing이 표시되는지 확인하십시오.
2. 새 베타 기능이 켜진 구버전 Claude Code v2.1.x: 환경 변수에 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1을 추가하십시오.
3. base URL 형식이 잘못되어 요청 경로에 /v1이 두 번 붙는 경우입니다. CodeRouter는 내부 경로 재작성으로 https://www.coderouter.io와 https://www.coderouter.io/api/v1을 모두 받습니다.

"Your free trial has ended" / "usage credit is used up" 오류(HTTP 429)

무료 체험은 7일 동안 $5 상당의 사용량을 제공하며, 신용카드는 필요 없습니다. 가입 후 7일이 지나거나 크레딧을 모두 쓰면, 둘 중 먼저 오는 시점에 종료됩니다. 그 후의 요청은 위 메시지 중 하나와 함께 HTTP 429를 반환합니다. 잔액을 충전해 종량제로 계속 쓰거나(/pricing 참고), /dashboard/models에서 직접 보유한 공급자 키를 추가해 자체 키로 계속 사용할 수 있습니다. 크레딧이 거의 소진되었을 때 입력만으로도 남은 크레딧만큼 비용이 드는 요청은, 필요한 금액과 남은 금액이 함께 표시된 "usage credit is used up for this request" 오류를 받습니다. 더 짧은 요청은 여전히 처리될 수 있습니다(CodeRouter가 변경하는 파라미터 참고).

"Rate limit exceeded" 오류(HTTP 429)

키별 및 사용자별 속도 제한이 적용됩니다. 기본값(분당 요청 수): 무료 체험 60, 종량제 1,000, Team 2,400(이전 요금제는 기존 한도가 그대로 유지됩니다). 재시도 시점은 X-RateLimit-Reset 응답 헤더에서 확인하십시오.

그 밖의 문제

다음 내용을 적어 support@coderouter.io로 메일을 보내 주십시오.

• 정확한 오류 메시지와 HTTP 상태 코드
• 사용 중인 에이전트 이름과 버전
• 문제를 재현하는 전체 curl 명령(cr_ 키는 제외)

기타 도구 및 세부 사항

아래 도구의 설정 방법, 설정 확인 절차, CodeRouter가 변경하는 파라미터, 긴 대화 처리, 코딩 에이전트 세션의 라우팅 방식, 전체 오류 목록은 영어 가이드에서 확인할 수 있습니다.

• Aider
• Cline
• Continue.dev
• OpenClaw
• GitHub Copilot
• OpenAI SDK
• Anthropic SDK
• 설정 확인(dry run, 응답 헤더)
• CodeRouter가 변경하는 파라미터
• 코딩 에이전트 세션(라우팅 정책)
• 전체 오류 목록