Agenti di programmazione su SeedRouter

Gli agenti di programmazione possono usare SeedRouter come fornitore di modelli. Inviano richieste con la tua chiave API SeedRouter e ogni richiesta viene addebitata in base ai token sul tuo saldo SeedRouter anziché tramite un abbonamento.

Per consentire a un agente di chiamare i modelli di immagine e video di SeedRouter, usa il server MCP oppure vedi Usare SeedRouter dagli agenti IA.

Claude Code

Esegui questo nel terminale da cui avvii 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

• L'URL di base non contiene un percorso. Claude Code aggiunge autonomamente /v1/messages.
• Le tre variabili ANTHROPIC_DEFAULT_*_MODEL fanno puntare gli alias opus, sonnet e haiku di Claude Code, usati anche per il lavoro in background, agli ID modello di SeedRouter. Puoi anche passare direttamente un ID, ad esempio claude --model claude-fable-5-1.
• La chiave sostituisce il tuo abbonamento Claude. In una sessione interattiva, Claude Code ti chiede una sola volta di approvare la chiave; da quel momento le richieste vengono addebitate sul tuo saldo SeedRouter. Rimuovi le variabili per tornare al tuo abbonamento.

Per mantenere le impostazioni a ogni avvio, inserisci le stesse variabili nel blocco env di ~/.claude/settings.json. Il file contiene quindi una chiave che consente di spendere il tuo saldo: mantienilo privato.

Le tariffe aggiornate per milione di token sono sulla pagina di ciascun modello, ad esempio Claude Opus 5.5. La guida a Claude Code riporta la configurazione completa, il comportamento della cache dei prompt e i risultati dei test.

Codex CLI

Aggiungi SeedRouter al file utente ~/.codex/config.toml, mantenendo le altre impostazioni:

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"

Poi esporta la chiave e avvia Codex:

export SEEDROUTER_API_KEY=YOUR_API_KEY
codex

• Usa il file utente. Codex ignora model_provider e model_providers nel file .codex/config.toml di un progetto.
• Scegli il modello con model, oppure per una singola sessione con codex -m gpt-6-astra. GPT-6 Astra è adatto alle attività più difficili, GPT-6 Sol alla programmazione quotidiana e GPT-6 Luna a passaggi rapidi e meno costosi.
• I modelli testati sono GPT-6. Codex invia richieste Responses; un altro modello di testo deve accettare il formato Responses, indicato nel suo riferimento API, e non è stato testato in Codex.

La guida a GPT-6 per Codex riporta la finestra di contesto, le impostazioni dello sforzo di ragionamento e i risultati dei test.

Verificare la connessione

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

Una chiave funzionante restituisce un messaggio con una breve risposta. Per Codex, esegui codex exec "Reply OK." dopo aver impostato la configurazione qui sopra.

Costi e limiti

• Le richieste vengono addebitate in base ai token di ciascuna risposta. Una sessione di programmazione invia un lungo prefisso del prompt a ogni richiesta: istruzioni, definizioni degli strumenti e file del progetto. Se il modello supporta la cache dei prompt, le richieste successive leggono quel prefisso dalla cache a una tariffa inferiore.
• Ogni richiesta compare nello storico di utilizzo. Aggiungi credito nella pagina Fatturazione.
• HTTP 429 indica troppe richieste contemporanee. Esegui meno sessioni o sottoagenti in parallelo e rispetta l'attesa indicata da Retry-After quando è presente.

Risoluzione dei problemi