Claude Code

Collega l'agente CLI di Anthropic al gateway con due variabili d'ambiente ed evita l'insidia che addebita silenziosamente i costi alla chiave sbagliata.

Claude Code legge il proprio endpoint dall'ambiente, quindi non servono modifiche al codice. Questa è la configurazione più comune sul gateway.

Configurazione

Copyexport ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

L'integrazione è tutta qui. Aggiungi entrambe le righe a ~/.zshrc o ~/.bashrc per renderla permanente.

Configurazione per progetto

Per limitare l'uso del gateway a un solo repository anziché all'intera shell, usa un file di impostazioni:

Copy{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

Salvalo in .claude/settings.json nel progetto, oppure in ~/.claude/settings.json per una configurazione predefinita valida per l'utente. Aggiungi .claude/settings.json a .gitignore — contiene una chiave.

Verifica del funzionamento

Copy"c"># 1. the gateway answers and the key is valid
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

"c"># 2. start Claude Code and confirm usage appears in your dashboard
claude

Se le richieste non compaiono nella dashboard, vengono inviate altrove — quasi sempre a causa dell'insidia relativa a ANTHROPIC_API_KEY descritta sopra.

Scelta di un modello

Copyclaude --model claude-opus-4-8

Qualsiasi ID presente in Modelli funziona. Opus per i refactoring complessi, Sonnet per il lavoro quotidiano — vedi Controllo dei costi per capire perché questa scelta incide più di ogni altra sulla fattura.

Mantenere i costi ragionevoli

• Claude Code reinvia il contenuto dei file e i risultati degli strumenti a ogni turno — il costo delle sessioni lunghe cresce in modo non lineare. Usa /clear tra attività non correlate.
• Gli output voluminosi degli strumenti (una query con 500 righe, un intero log di compilazione) diventano contesto permanente. Filtrali tramite head quando possibile.
• La memorizzazione dei prompt nella cache è particolarmente utile in questo caso, perché il prompt di sistema e le definizioni degli strumenti restano stabili tra i turni.