Claude Code
Anthropic의 공식 터미널 코딩 에이전트입니다. Anthropic Messages 프로토콜을 사용하므로 두 개의 환경 변수로 Synthorai를 지정하기만 하면 워크스페이스의 모든 Claude 모델을 사용할 수 있습니다 — 설정의 다른 부분은 전혀 바뀌지 않습니다.
터미널에서 Claude를 사용하려는 팀에게 가장 인기 있는 통합 경로입니다 및 게이트웨이에서 중앙 집중식으로 관리되는 청구 + 속도 제한.
시작하기 전에
다음 위치에서 API key를 생성하세요： Console → API Keys. 전체 key가 표시되는 것은 한 번뿐 입니다 — 대화 상자를 닫기 전에 복사하세요.
1단계 — 환경 변수 설정
Claude Code는 ANTHROPIC_BASE_URL 및 ANTHROPIC_API_KEY 에서 읽어옵니다. shell 프로필에 추가하여 (~/.zshrc, ~/.bashrc, 또는 ~/.config/fish/config.fish) 모든 새 터미널이 이를 읽어오도록 하세요.
# ~/.zshrc (or equivalent)
export ANTHROPIC_BASE_URL="https://synthorai.io"
export ANTHROPIC_API_KEY="sk-..." # your Synthorai key이 base URL에는 다음이 포함되지 않습니다 /v1 — Anthropic SDK가 다음을 추가합니다 /v1/messages （내부적으로）. 다음을 붙여넣은 경우 https://synthorai.io/v1요청이 다음으로 전송되어 /v1/v1/messages 404가 발생합니다.
2단계 — 첫 요청 보내기
# Reload env, then:
claude --model claude-sonnet-4-6 "explain this diff" < <(git diff HEAD~1)
# Or start an interactive coding session:
claude code --model claude-opus-4-6성공하면 모델 출력이 stdout에 표시됩니다. 다음이 표시되면 401 key가 잘못되었거나 비활성화된 것입니다. 다음이 표시되면 404 해당 모델 이름이 워크스페이스에서 라우팅되지 않는 것입니다 — 확인하세요： /console/pricing.
추천 모델
| 매개변수 | 유형 | 설명 |
|---|---|---|
claude-opus-4-6 | reasoning | 플래그십 품질. 심층 리팩터링과 모호한 문제에 사용하세요. |
claude-sonnet-4-6 | balanced | 일상적인 코딩과 긴 에이전트 세션에 가장 좋은 가격 대비 품질. |
claude-haiku-4-5 | fast | 가장 저렴하고 빠릅니다. 가벼운 즉석 질문과 짧은 편집에 적합합니다. |
문제 해결
401 Unauthorized — 키가 잘못되었거나 비활성화되었거나 이미 취소되었습니다. 다음 위치에서 재발급하세요 /console/keys.
404 / "model not found" — 다음에 전달한 모델이 --model 워크스페이스의 채널 카탈로그에 없습니다. 다음을 실행하세요 curl $ANTHROPIC_BASE_URL/v1/models -H "x-api-key: $ANTHROPIC_API_KEY" 사용 가능한 항목을 확인할 수 있습니다.
"여전히 api.anthropic.com으로 요청됨" — 셸이 새 환경 변수를 인식하지 못했습니다. 새 터미널을 열거나 source ~/.zshrc.
claude-code를 통해 Claude가 아닌 모델을 사용할 수 있나요? — 아니요. CLI는 Anthropic Messages API만 지원하며 Synthorai의 /v1/messages 엔드포인트는 Claude 모델로만 라우팅됩니다. OpenAI / Gemini / Qwen 모델을 사용하려면 Codex, Aider 또는 OpenAI SDK를 직접 사용하세요.
세 가지 등급 모두의 최신 토큰당 가격은 Claude model price comparison에 있습니다.