설정 가이드
60초 안에 사용 중인 AI 에이전트에 CodeRouter를 연결할 수 있습니다.
01
무료로 시작하고, 이후 종량제로
CodeRouter는 자체 프로바이더 키를 사용하므로 직접 키를 준비할 필요가 없습니다. 새 계정에는 7일 동안 $5 상당의 사용량이 제공되어 라우팅 품질을 평가할 수 있습니다.
- 무료 체험: 카드 등록 없이 7일 동안 $5 상당의 사용량을 Claude Opus를 제외한 모든 모델에 쓸 수 있습니다.
- 종량제: $20부터 충전하며, 각 요청은 모델 정가 +8%로 청구됩니다. 월 요금은 없습니다. 스마트 라우팅과 Direct 모드 중에서 고를 수 있습니다.
- Team: 개발자당 월 $19에 사용량은 정가 +8%이며, 멤버와 프로젝트별로 예산을 정할 수 있습니다.
02
API 키 발급
03
AI 에이전트 설정
사용하는 도구를 선택하십시오. Claude Code(및 OpenClaw)는 한 줄 스크립트로 설정이 자동 작성됩니다. 다른 도구는 베이스 URL과 API 키를 입력하면 됩니다.
Anthropic의 CLI입니다. cr_ 키는 ANTHROPIC_AUTH_TOKEN에 넣습니다(Authorization: Bearer로 전송됩니다). Claude Code는 이 값을 ANTHROPIC_API_KEY나 Claude 로그인보다 우선 사용하며, 승인 프롬프트도 표시되지 않습니다.
curl -fsSL https://www.coderouter.io/setup.sh | bash -s -- cr_YOUR_KEY_HERE claude
{
"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을 붙이면 프로바이더를 호출하지 않고 라우팅 결정(모델, 단계, 비용 추정)만 반환합니다:
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을 제거하십시오.
도움이 필요하십니까?
오류나 설정 문제로 막히셨습니까? 첫 답변에서 바로 원인을 파악할 수 있도록, 문의 페이지에 함께 보내 주실 정보를 안내해 두었습니다.