SeedRouter에서 코딩 에이전트 사용

코딩 에이전트는 SeedRouter를 모델 공급자로 사용할 수 있습니다. SeedRouter API 키로 요청을 보내며, 구독 대신 각 요청의 토큰 사용량에 따라 SeedRouter 잔액에서 비용이 차감됩니다.

에이전트가 SeedRouter의 이미지 및 동영상 모델을 호출하게 하려면 MCP 서버를 사용하거나 AI 에이전트에서 SeedRouter 사용을 참고하세요.

Claude Code

Claude Code를 시작할 터미널에서 다음을 실행하세요:

export ANTHROPIC_BASE_URL=https://api.seedrouter.ai
export ANTHROPIC_API_KEY=YOUR_API_KEY
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5

claude --model claude-opus-5-5

• 기본 URL에는 경로를 넣지 않습니다. Claude Code가 /v1/messages를 직접 추가합니다.
• 세 가지 ANTHROPIC_DEFAULT_*_MODEL 변수는 Claude Code의 opus, sonnet, haiku 별칭이 SeedRouter 모델 ID를 가리키도록 합니다. 이 별칭은 백그라운드 작업에도 사용됩니다. ID를 직접 전달할 수도 있습니다. 예: claude --model claude-fable-5-1.
• Claude 구독 대신 키를 사용합니다. 대화형 세션에서는 Claude Code가 키 사용 승인을 한 번 요청합니다. 그 이후의 요청은 SeedRouter 잔액에서 과금됩니다. 기존 구독으로 돌아가려면 변수 설정을 해제하세요.

시작할 때마다 설정을 유지하려면 같은 변수를 ~/.claude/settings.json의 env 블록에 넣으세요. 이 파일에는 잔액을 사용할 수 있는 키가 저장되므로 비공개로 보관하세요.

100만 토큰당 실시간 요금은 Claude Opus 5.5 등 각 모델 페이지에서 확인할 수 있습니다. Claude Code 가이드에는 전체 설정 과정, 프롬프트 캐싱 동작, 테스트 결과가 기록되어 있습니다.

Codex CLI

다른 설정은 유지하면서 사용자 수준의 ~/.codex/config.toml에 SeedRouter를 추가하세요:

model = "gpt-6-sol"
model_provider = "seedrouter"

[model_providers.seedrouter]
name = "SeedRouter"
base_url = "https://api.seedrouter.ai/v1"
env_key = "SEEDROUTER_API_KEY"
wire_api = "responses"

그런 다음 키를 환경 변수로 내보내고 Codex를 시작하세요:

export SEEDROUTER_API_KEY=YOUR_API_KEY
codex

• 사용자 수준 파일을 사용하세요. Codex는 프로젝트의 .codex/config.toml에 있는 model_provider와 model_providers를 무시합니다.
• 모델을 선택하세요. model로 지정하거나, 한 세션에만 적용하려면 codex -m gpt-6-astra로 지정합니다. GPT-6 Astra는 가장 어려운 작업에, GPT-6 Sol은 일상적인 코딩에, GPT-6 Luna는 빠르고 비용이 적게 드는 단계에 적합합니다.
• 테스트한 모델은 GPT-6입니다. Codex는 Responses 요청을 보냅니다. 다른 텍스트 모델은 해당 API 레퍼런스에 나와 있는 지원 형식에 Responses가 포함되어야 하며, Codex에서는 테스트되지 않았습니다.

GPT-6 Codex 가이드에는 컨텍스트 윈도와 추론 강도 설정, 테스트 결과가 기록되어 있습니다.

연결 확인

curl https://api.seedrouter.ai/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 32,
    "messages": [{"role": "user", "content": "Reply OK."}]
  }'

키가 정상적으로 작동하면 짧은 답변을 담은 메시지가 반환됩니다. Codex에서는 위 설정을 마친 뒤 codex exec "Reply OK."를 실행하세요.

비용과 제한

• 요청은 각 응답의 토큰 수에 따라 과금됩니다. 코딩 세션은 요청할 때마다 지침, 도구 정의, 프로젝트 파일로 이루어진 긴 프롬프트 접두부를 보냅니다. 모델이 프롬프트 캐싱을 지원하면 이후 요청에서는 캐시에서 해당 접두부를 읽어 더 낮은 요금이 적용됩니다.
• 모든 요청은 사용 내역에 표시됩니다. 결제 페이지에서 크레딧을 충전하세요.
• HTTP 429는 동시에 보낸 요청이 너무 많다는 뜻입니다. 병렬로 실행하는 세션이나 하위 에이전트 수를 줄이고, Retry-After가 있으면 해당 시간만큼 기다리세요.

문제 해결