CC Switch

CC Switch에서 Claude Code와 Codex의 routerra.ai 프로필을 관리합니다.

설치 및 준비

  1. CC Switch Releases에서 OS용 설치 파일을 받아 설치하고 엽니다. 대상 CLI는 별도로 설치합니다. CC Switch는 CLI 설정을 관리합니다. 이 안내는 v3.20.1 이상 키 처리 방식에 따릅니다.
  2. routerra.ai API 키에서 키를 만들고 모델에서 허용된 ID를 복사합니다.

앱 프로필 추가 및 활성화

  1. 사이드바에서 대상 앱을 선택하고 Direct → Add Provider → Custom Configuration에서 routerra.ai로 이름을 정합니다. Claude Code는 아래 JSON과 CLI의 /model YOUR_CLAUDE_MODEL_ID를 사용합니다. Codex는 API Key, https://routerra.ai/v1, Responses 지원 모델을 입력하고 업스트림 형식 Responses를 선택합니다. 아래 TOML은 생성되는 provider 필드입니다.
  2. Add와 카드의 Enable을 누르고 CLI를 다시 시작합니다. CC Switch v3.20.1 이상은 Codex 키를 experimental_bearer_token으로 ~/.codex/config.toml에 저장하며 auth.json에는 쓰지 않습니다. 이 흐름에서 기존 requires_openai_auth = true 방식을 사용하지 않습니다.
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://routerra.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_CLAUDE_MODEL_ID"
  }
}

생성된 Codex 설정

Codex 프로필을 활성화한 뒤 ~/.codex/config.toml의 필드를 확인합니다.

model = "YOUR_MODEL_ID"
model_provider = "routerra"

[model_providers.routerra]
name = "routerra.ai"
base_url = "https://routerra.ai/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_API_KEY"

연결 확인

저장과 활성화는 다릅니다. provider 카드와 생성된 CLI 파일을 확인합니다. 전환이 안 되면 CLI를 닫고 충돌하는 셸 환경 변수를 지운 후 다시 엽니다. Codex의 공식 계정 표시는 요청 경로를 뜻하지 않으므로 routerra.ai 사용량을 확인합니다. 직접 전환 시 기존 로그인을 유지하려면 Settings → General → Codex App Enhancements → Keep official login for direct switches를 켭니다. 모델 검색 404/405는 ID 수동 입력으로 해결할 수 있습니다.