Claude Code

L'agente di coding da terminale ufficiale di Anthropic. Parla il protocollo Anthropic Messages, quindi una volta puntato su Synthorai con due variabili d'ambiente ogni modello Claude del tuo workspace è disponibile — nient'altro cambia nella tua configurazione.

✦

È il percorso di integrazione più popolare per i team che vogliono Claude nel terminale e fatturazione centralizzata + limiti di frequenza sul gateway.

Prima di iniziare

Crea una chiave API in Console → Chiavi API. La chiave completa viene mostrata una sola volta — copiala prima di chiudere la finestra.

Passo 1 — Imposta le variabili d'ambiente

Claude Code legge ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY dall'ambiente. Aggiungile al profilo della shell (~/.zshrc, ~/.bashrc, o ~/.config/fish/config.fish) così ogni nuovo terminale le carica.

# ~/.zshrc (or equivalent)
export ANTHROPIC_BASE_URL="https://synthorai.io"
export ANTHROPIC_API_KEY="sk-..."   # your Synthorai key

⚠

Il base URL non include /v1 — l'SDK Anthropic aggiunge /v1/messages internamente. Se hai incollato https://synthorai.io/v1, le richieste colpiranno /v1/v1/messages e restituiranno 404.

Passo 2 — Invia la tua prima richiesta

# 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

Una risposta riuscita stampa l'output del modello su stdout. Se ottieni 401 la chiave è errata o disabilitata; se ottieni 404 il nome del modello non è instradabile nel tuo workspace — controlla /console/pricing.

Modelli consigliati

Parametro	Tipo	Descrizione
`claude-opus-4-6`	`reasoning`	Qualità flagship. Da usare per refactoring profondi e problemi ambigui.
`claude-sonnet-4-6`	`balanced`	Miglior rapporto prezzo/qualità per il coding quotidiano e le sessioni agent lunghe.
`claude-haiku-4-5`	`fast`	Il più economico e rapido. Ottimo per domande estemporanee e modifiche brevi.

Risoluzione dei problemi

401 Unauthorized — la chiave è errata, disabilitata o già revocata. Rigenerala in /console/keys.

404 / "model not found" — il modello che hai passato a --model non è nel catalogo canali del tuo workspace. Esegui curl $ANTHROPIC_BASE_URL/v1/models -H "x-api-key: $ANTHROPIC_API_KEY" per vedere cosa è disponibile.

"Continua a chiamare api.anthropic.com" — la tua shell non ha caricato le nuove variabili d'ambiente. Apri un nuovo terminale, oppure source ~/.zshrc.

Posso usare modelli non Claude tramite claude-code? — No. La CLI parla solo l'API Anthropic Messages e l'endpoint /v1/messages di Synthorai instrada solo verso modelli Claude. Per modelli OpenAI / Gemini / Qwen usa Codex, Aider o direttamente l'SDK OpenAI.

I prezzi attuali per token di tutti e tre i livelli sono nel Claude model price comparison.