Source: https://aiprimetech.io/it/docs/guides/claude-code/

[Home](/it/) / [Documentazione](/it/docs/) / Claude Code 

# 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. 

 Copia pagina [ Visualizza in Markdown](/it/docs/guides/claude-code.md) [ Chiedi a ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/guides/claude-code.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Chiedi in Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/guides/claude-code.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

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. 

L'insidia: se ANTHROPIC_API_KEY è impostata nella shell, Claude Code potrebbe darle la precedenza e addebitare l'utilizzo a quella chiave, ignorando silenziosamente sia la chiave del gateway sia un eventuale abbonamento Pro/Max. Esegui echo $ANTHROPIC_API_KEY — se stampa qualcosa, unset ANTHROPIC_API_KEY prima di avviare. 

## 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](/it/docs/getting-started/models/) funziona. Opus per i refactoring complessi, Sonnet per il lavoro quotidiano — vedi [Controllo dei costi](/it/docs/guides/cost-control/) 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. 

[Server MCPFornisci a Claude Code strumenti reali](/it/docs/guides/mcp-servers/)[Controllo dei costiDove vengono consumati i token degli agenti](/it/docs/guides/cost-control/)[Risoluzione dei problemiQuando non succede nulla](/it/docs/guides/troubleshooting/) 

[PrecedenteVisione e input di immagini](/it/docs/api-reference/vision/)[AvantiCursor](/it/docs/guides/cursor/)