# Configurazione chiave API Claude Code

Claude Code legge due variabili d'ambiente per instradare le richieste ovunque: ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY. Puntale a RunAPI ed esegui ogni modello Claude a metà della tariffa ufficiale. Questa guida mostra i comandi esatti per Mac, Linux e Windows.

*Updated June 18, 2026 · RunAPI Editorial*

## Come si imposta una chiave API personalizzata in Claude Code?

Claude Code usa due variabili d'ambiente per decidere dove inviare le richieste e come autenticarle. Imposta ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY sui valori RunAPI e ogni richiesta viene instradata tramite RunAPI con il 50% di sconto. Vuoi usare un provider completamente diverso? RunAPI funziona anche come gateway drop-in così puoi eseguire modelli Claude senza un account Anthropic diretto.

- **Due variabili**: ANTHROPIC_BASE_URL imposta l'endpoint. ANTHROPIC_API_KEY imposta la chiave. Questa è tutta la configurazione — due variabili, nessun'altra modifica.
- **Valore endpoint**: Imposta ANTHROPIC_BASE_URL su https://runapi.ai in modo che Claude Code instradi tramite RunAPI.
- **Rendilo persistente**: Aggiungi entrambi gli export al tuo profilo shell (.zshrc o .bashrc) così non devi reimpostarli a ogni sessione. Gli utenti Windows li impostano in PowerShell e aprono una nuova finestra.
- **50% di sconto**: Ogni modello Claude viene fatturato alla metà della tariffa ufficiale di Anthropic. Nessun abbonamento, nessun limite.

## Di cosa hai bisogno prima di configurare Claude Code?

La configurazione richiede pochi minuti. Ti servono Claude Code installato, un account RunAPI e un terminale. Esegui prima claude --version per confermare che Claude Code funzioni prima di toccare qualsiasi configurazione di chiavi API.

### Claude Code installato

Installa Claude Code dalla fonte ufficiale e conferma che funzioni con claude --version nel tuo terminale. Se quel comando dà errore, correggi l'installazione prima di impostare qualsiasi chiave API.

### Un account RunAPI

Registrati su runapi.ai. Il livello gratuito include crediti per testare qualsiasi modello Claude prima di finanziare un saldo.

### Una chiave API

Crea una chiave da Dashboard → API Keys. Copiala una sola volta — viene mostrata per intero solo al momento della creazione. Non incollarla in repository pubblici né condividerla negli screenshot.

### Accesso al terminale

Ti serve una shell per impostare le variabili d'ambiente. macOS e Linux usano .zshrc o .bashrc. Gli utenti Windows possono usare PowerShell — imposta la variabile, poi apri una nuova finestra del terminale perché abbia effetto.


## Come configurare una chiave API Claude Code con RunAPI

Esegui questi comandi in ordine. Impostano endpoint e chiave, li rendono persistenti nel tuo profilo shell e confermano che Claude Code li rilevi. Sostituisci il placeholder con la tua vera chiave RunAPI. Usa ANTHROPIC_API_KEY (non CLAUDE_API_KEY) — è questa la variabile che Claude Code legge effettivamente.

## Quali variabili d'ambiente legge Claude Code?

Claude Code legge un piccolo insieme di variabili per controllare endpoint, autenticazione, modello e lunghezza dell'output. La tabella elenca quelle importanti per configurare un endpoint personalizzato e cosa fa ciascuna. Nota: usa ANTHROPIC_API_KEY (non CLAUDE_API_KEY) — è questa la variabile che Claude Code legge effettivamente.

| Variabile | Scopo | Valore di esempio |
|---|---|---|
| ANTHROPIC_BASE_URL | Endpoint personalizzato a cui Claude Code invia le richieste | https://runapi.ai |
| ANTHROPIC_API_KEY | Chiave usata per autenticare le richieste | sk-your-runapi-key |
| ANTHROPIC_MODEL | Modello predefinito per le nuove sessioni | claude-sonnet-4-6 |
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | Limite sui token restituiti per risposta | 8192 |

## Quale modello Claude dovresti eseguire in Claude Code?

Claude Code accetta qualsiasi ID modello Claude tramite RunAPI. Scegli in base all'attività: un modello veloce ed economico per modifiche di routine, uno bilanciato per il coding quotidiano, o il più potente per problemi difficili. Imposta ANTHROPIC_MODEL per cambiare il predefinito, oppure cambia modello dentro Claude Code — la fatturazione segue il modello che chiami effettivamente.

### claude-haiku-4-5

Il più veloce ed economico a $1/M in input e $5/M in output tramite RunAPI. Ideale per modifiche di routine e ricerche rapide.

### claude-sonnet-4-6

Predefinito bilanciato per il coding quotidiano a $3/M in input e $15/M in output tramite RunAPI. La maggior parte degli sviluppatori usa questo.

### claude-opus-4-7

Il più potente per problemi difficili a $5/M in input e $25/M in output tramite RunAPI. Usalo per refactoring complessi e revisioni.

### Cambia in qualsiasi momento

Imposta ANTHROPIC_MODEL o cambia il modello dentro Claude Code in qualsiasi momento. La fatturazione segue il modello che chiami effettivamente, tutto con il 50% di sconto.


## Perché la mia chiave API di Claude Code non funziona?

La maggior parte dei problemi di configurazione deriva da una di tre cose: il nome sbagliato della variabile d'ambiente (usa ANTHROPIC_API_KEY, non CLAUDE_API_KEY), una sessione shell obsoleta che non ha acquisito le modifiche al profilo, oppure un errore di battitura nella chiave. La tabella elenca gli errori comuni e la correzione per ciascuno.

| Errore o sintomo | Causa probabile | Soluzione |
|---|---|---|
| 401 Unauthorized | Chiave API errata o scaduta | Ricontrolla ANTHROPIC_API_KEY e crea una nuova chiave nella dashboard RunAPI se necessario |
| Le richieste raggiungono ancora Anthropic | ANTHROPIC_BASE_URL non impostata in questa shell | Esegui echo $ANTHROPIC_BASE_URL; se è vuota, ricarica il tuo profilo o apri un nuovo terminale |
| 404 Not Found | Slash finale o percorso errato nell'URL base | Imposta l'URL base esattamente su https://runapi.ai senza percorso finale |
| Modello non trovato | ID modello non valido o scritto in modo errato | Usa un ID valido come claude-sonnet-4-6 o claude-opus-4-7 |
| Variabili perse al riavvio | Export non scritti nel profilo shell | Aggiungi entrambi gli export a ~/.zshrc o ~/.bashrc e ricarica |

## Come configurare una chiave API Claude Code con RunAPI

1. **Imposta l'URL base** — Esporta ANTHROPIC_BASE_URL=https://runapi.ai per instradare le richieste attraverso RunAPI.
2. **Imposta la chiave API** — Esporta ANTHROPIC_API_KEY con la tua chiave RunAPI da Dashboard → Chiavi API.
3. **Persisti entrambe le variabili** — Aggiungi entrambi gli export a ~/.zshrc o ~/.bashrc e ricarica con source ~/.zshrc così sopravvivono alle nuove sessioni. Su Windows, impostali in PowerShell e apri una nuova finestra del terminale.
4. **Esegui Claude Code** — Esegui claude --version per confermare l'installazione, poi avvia claude nel tuo progetto. Ora le richieste vengono instradate tramite RunAPI con il 50% di sconto sulla tariffa ufficiale.

## FAQ sulla chiave API di Claude Code

### Come aggiungo una chiave API a Claude Code?

Imposta due variabili d'ambiente. Esporta ANTHROPIC_BASE_URL su https://runapi.ai e ANTHROPIC_API_KEY sulla tua chiave RunAPI. Aggiungile entrambe al tuo profilo shell (.zshrc o .bashrc) così persistono tra le sessioni. Claude Code le legge all'avvio e instrada ogni richiesta tramite RunAPI.

### Dove ottengo una chiave API per Claude Code?

Creane una su runapi.ai. Registrati, apri Dashboard → API Keys e genera una chiave. Copiala subito — la chiave completa viene mostrata solo alla creazione. Il livello gratuito include crediti per testare qualsiasi modello Claude prima di finanziare un saldo.

### A cosa serve ANTHROPIC_BASE_URL?

Indica a Claude Code a quale endpoint inviare le richieste. Per impostazione predefinita, Claude Code chiama Anthropic direttamente. Impostandola su https://runapi.ai, ogni richiesta viene instradata attraverso RunAPI, che fattura gli stessi modelli al 50% della tariffa ufficiale.

### Posso usare Claude Code con altri provider API come OpenAI?

C'è un modo per usare Claude Code con altri provider API come OpenAI? Sì — Claude Code supporta qualsiasi endpoint compatibile con OpenAI tramite ANTHROPIC_BASE_URL. RunAPI espone un gateway compatibile così puoi cambiare provider senza modificare il codice, usando una sola chiave per Claude, GPT e altri modelli.

### Perché Claude Code fattura ancora alla tariffa piena?

Esegui echo $ANTHROPIC_BASE_URL nel tuo terminale. Se non stampa nulla, l'export non è persistito. Aggiungi entrambi gli export a ~/.zshrc o ~/.bashrc, esegui source ~/.zshrc, poi apri un nuovo terminale e controlla di nuovo. Gli utenti Windows devono aprire una nuova finestra PowerShell dopo aver impostato le variabili d'ambiente.

### Posso memorizzare la chiave in un file di configurazione?

Sì. Inserisci i valori in un file .claude.json nella tua directory home o di progetto invece di esportarli a ogni sessione. Entrambi gli approcci funzionano — il file è comodo per chiavi per progetto, mentre gli export sono più semplici per una singola configurazione globale.

### Come monitoro i costi dopo la configurazione?

Apri la dashboard RunAPI. Mostra la spesa per chiave e per richiesta in tempo reale. Per limitare il costo dell'output, imposta CLAUDE_CODE_MAX_OUTPUT_TOKENS così ogni risposta è limitata, e usa claude-haiku-4-5 per modifiche di routine.

### Questo cambia il comportamento di Claude Code?

No. RunAPI inoltra le richieste direttamente ai modelli Claude sottostanti. Output, uso degli strumenti e comportamento sono identici a una chiamata diretta ad Anthropic. Cambi solo dove vanno le richieste e come vengono fatturate — l'esperienza di coding resta la stessa.