설정

설정 가이드

60초 안에 사용 중인 AI 에이전트에 CodeRouter를 연결할 수 있습니다.

01

무료로 시작하고, 이후 종량제로

CodeRouter는 자체 프로바이더 키를 사용하므로 직접 키를 준비할 필요가 없습니다. 새 계정에는 7일 동안 $5 상당의 사용량이 제공되어 라우팅 품질을 평가할 수 있습니다.

  • 무료 체험: 카드 등록 없이 7일 동안 $5 상당의 사용량을 Claude Opus를 제외한 모든 모델에 쓸 수 있습니다.
  • 종량제: $20부터 충전하며, 각 요청은 모델 정가 +8%로 청구됩니다. 월 요금은 없습니다. 스마트 라우팅과 Direct 모드 중에서 고를 수 있습니다.
  • Team: 개발자당 월 $19에 사용량은 정가 +8%이며, 멤버와 프로젝트별로 예산을 정할 수 있습니다.
02

API 키 발급

Google로 로그인한 다음 대시보드에서 키를 만듭니다. 키 이름은 엔지니어나 워크플로별로 지정하십시오(예: alice, ci, prod). 나중에 키별 분석을 볼 때 알아보기 쉽습니다.

03

AI 에이전트 설정

사용하는 도구를 선택하십시오. Claude Code(및 OpenClaw)는 한 줄 스크립트로 설정이 자동 작성됩니다. 다른 도구는 베이스 URL과 API 키를 입력하면 됩니다.

Anthropic의 CLI입니다. cr_ 키는 ANTHROPIC_AUTH_TOKEN에 넣습니다(Authorization: Bearer로 전송됩니다). Claude Code는 이 값을 ANTHROPIC_API_KEY나 Claude 로그인보다 우선 사용하며, 승인 프롬프트도 표시되지 않습니다.
한 줄 설정: ~/.claude/settings.json에 기록합니다(기존 파일은 백업되며 --uninstall로 되돌릴 수 있습니다)
curl -fsSL https://www.coderouter.io/setup.sh | bash -s -- cr_YOUR_KEY_HERE
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"
  }
}
주의: 재시작 후 Claude Code 헤더의 배지에 'API Usage Billing'이 아니라 'Claude Max'가 표시되면 Claude Code에서 /logout(또는 `claude auth logout`)을 실행한 다음 다시 시작하십시오. 현재 어떤 인증 정보를 쓰는지는 /status에서 확인할 수 있습니다. ANTHROPIC_API_KEY도 설정되어 있으면 Claude Code가 그 값도 함께 보낼 수 있습니다. 어느 경우든 CodeRouter는 cr_ 키를 사용하지만, 혼동을 피하려면 unset으로 해제해 두십시오.

다른 에이전트(Cline, Continue.dev, LiteLLM을 통한 GitHub Copilot)를 사용한다면 전체 연동 문서를 참고하십시오.

04

동작 확인

토큰을 쓰지 않고 라우팅을 테스트할 수 있습니다. X-Dry-Run을 붙이면 프로바이더를 호출하지 않고 라우팅 결정(모델, 단계, 비용 추정)만 반환합니다:

Dry-run 테스트
curl https://www.coderouter.io/api/v1/chat/completions \
  -H "Authorization: Bearer cr_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Dry-Run: true" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello"}]}'

응답에 선택된 모델과 단계가 포함되어 있어야 합니다. 실제로 호출할 때는 X-Dry-Run을 제거하십시오.

도움이 필요하십니까?

오류나 설정 문제로 막히셨습니까? 첫 답변에서 바로 원인을 파악할 수 있도록, 문의 페이지에 함께 보내 주실 정보를 안내해 두었습니다.

지원팀에 문의