Claude Code

기본 Messages 게이트웨이 설정으로 Claude Code를 연결합니다.

설치 및 준비

아래 기본 설치 프로그램으로 Claude Code를 설치합니다. Windows에서는 아래 PowerShell 명령을 사용합니다. 터미널을 다시 열고 claude --version을 실행합니다.
routerra.ai 콘솔에서 API 키를 만들고 허용된 Claude 모델 ID를 복사합니다. Claude 구독 로그인은 게이트웨이 키를 대신하지 않습니다. 선택한 모델은 Messages 스트리밍과 도구 호출을 지원해야 합니다.

curl -fsSL https://claude.ai/install.sh | bash
claude --version

Windows PowerShell 환경：

irm https://claude.ai/install.ps1 | iex
claude --version

Claude 설정

아래 env를 ~/.claude/settings.json(Windows: %USERPROFILE%\.claude\settings.json)에 병합하고 기존 설정을 유지한 채 자리표시자 두 개를 바꿉니다. ANTHROPIC_BASE_URL은 /v1 없는 루트 주소입니다. Claude Code가 Messages 경로를 추가하고 ANTHROPIC_AUTH_TOKEN으로 Bearer 인증을 합니다.
실행 중인 Claude Code를 종료한 뒤 claude를 시작하고 /status로 인증을 확인합니다. /model YOUR_CLAUDE_MODEL_ID로 모델을 명시하여 사용할 수 없는 모델로 연결되는 별칭을 피합니다.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://routerra.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_CLAUDE_MODEL_ID"
  }
}

연결 확인

짧은 프롬프트를 보낸 뒤 프로젝트 파일 목록을 요청해 도구 사용을 확인합니다. 401이면 오래된 토큰이나 상속된 ANTHROPIC_API_KEY 충돌을 확인하고 충돌하는 자격 증명을 지운 후 재시작합니다. 경로 404는 /v1 중복을 확인합니다. 게이트웨이가 /v1/messages/count_tokens를 제공하지 않아 /context 수치가 추정치이거나 표시되지 않을 수 있습니다. 스트리밍 및 도구 지원과는 별개의 제한입니다.