Agentes de programação no SeedRouter

Agentes de programação podem usar o SeedRouter como fornecedor de modelos. Eles enviam requisições com sua chave de API do SeedRouter, e cada requisição é cobrada por tokens no seu saldo do SeedRouter em vez de uma assinatura.

Para permitir que um agente chame os modelos de imagem e vídeo do SeedRouter, use o servidor MCP ou veja Usar o SeedRouter com agentes de IA.

Claude Code

Execute isto no terminal de onde você inicia o 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

• A URL base não tem caminho. O próprio Claude Code adiciona /v1/messages.
• As três variáveis ANTHROPIC_DEFAULT_*_MODEL apontam os aliases opus, sonnet e haiku do Claude Code, que ele também usa em trabalhos em segundo plano, para IDs de modelo do SeedRouter. Você também pode passar um ID diretamente, por exemplo claude --model claude-fable-5-1.
• A chave substitui seu plano do Claude. Em uma sessão interativa, o Claude Code pede uma única vez que você aprove a chave; a partir daí, as requisições são cobradas no seu saldo do SeedRouter. Remova as variáveis do ambiente para voltar ao seu plano.

Para manter as configurações a cada inicialização, coloque as mesmas variáveis no bloco env de ~/.claude/settings.json. Esse arquivo passa a conter uma chave que permite gastar seu saldo, então mantenha-o privado.

As tarifas vigentes por milhão de tokens estão na página de cada modelo, por exemplo Claude Opus 5.5. O guia do Claude Code documenta a configuração completa, o comportamento do cache de prompts e os resultados dos testes.

Codex CLI

Adicione o SeedRouter ao seu arquivo de usuário ~/.codex/config.toml, mantendo as outras configurações:

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"

Depois exporte sua chave e inicie o Codex:

export SEEDROUTER_API_KEY=YOUR_API_KEY
codex

• Use o arquivo de usuário. O Codex ignora model_provider e model_providers no .codex/config.toml de um projeto.
• Escolha o modelo com model, ou para uma única sessão com codex -m gpt-6-astra. O GPT-6 Astra é indicado para as tarefas mais difíceis, o GPT-6 Sol para programação do dia a dia e o GPT-6 Luna para etapas rápidas e mais baratas.
• Os modelos testados são GPT-6. O Codex envia requisições Responses; qualquer outro modelo de texto precisa aceitar o formato Responses, conforme indicado na referência de API dele, e não foi testado no Codex.

O guia de GPT-6 para Codex documenta as configurações de janela de contexto e esforço de raciocínio, além dos resultados dos testes.

Verificar a conexão

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."}]
  }'

Uma chave válida retorna uma mensagem com uma resposta curta. Para o Codex, execute codex exec "Reply OK." depois de definir a configuração acima.

Custo e limites

• As requisições são cobradas pelos tokens em cada resposta. Uma sessão de programação envia um prefixo de prompt longo em toda requisição: instruções, definições de ferramentas e arquivos do projeto. Quando o modelo aceita cache de prompts, as requisições seguintes leem esse prefixo do cache por uma tarifa menor.
• Cada requisição aparece no seu histórico de uso. Adicione créditos na página de cobrança.
• HTTP 429 significa muitas requisições ao mesmo tempo. Execute menos sessões ou subagentes em paralelo e aguarde o tempo indicado em Retry-After quando estiver presente.

Solução de problemas