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.
Claude Code
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.
Aggiornato il June 18, 2026
RunAPI Editorial
In sintesi
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.
Prima di iniziare
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.
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.
Passo dopo passo
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.
1
Imposta l'URL base
Questo indica a Claude Code di inviare le richieste a RunAPI invece dell'endpoint Anthropic predefinito.
export ANTHROPIC_BASE_URL=https://runapi.ai
2
Imposta la chiave API
Incolla la tua chiave RunAPI al posto del segnaposto. Claude Code la usa per autenticare ogni richiesta.
export ANTHROPIC_API_KEY=sk-your-runapi-key
3
Persisti entrambe le variabili
Aggiungi entrambi gli export a ~/.zshrc (o ~/.bashrc) così sopravvivono alle nuove sessioni del terminale. Ricarica con source ~/.zshrc. Su Windows, impostali in PowerShell e apri una nuova finestra del terminale perché la modifica abbia effetto.
echo 'export ANTHROPIC_BASE_URL=https://runapi.ai' >> ~/.zshrc
4
Verifica la configurazione
Conferma che la variabile stampi l'URL RunAPI. Se è vuota, ricarica il tuo profilo shell o apri un nuovo terminale — le variabili impostate in una sessione non si trasferiscono automaticamente.
echo $ANTHROPIC_BASE_URL
5
Esegui Claude Code
Avvia Claude Code nel tuo progetto. Ora instrada attraverso RunAPI al 50% della tariffa ufficiale.
claudeVariabili d'ambiente
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 |
Puoi anche memorizzare questi valori in un file .claude.json nella tua home directory o nella directory del progetto invece di esportarli a ogni sessione.
Scegliere un modello
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.
Risolvere gli errori comuni
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 |
Versione rapida
Configurazione chiave API Claude Code in quattro passaggi
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.
Domande frequenti
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.
CORRELATI
Esplora altro
Prezzi Claude Code
Confronto costi Claude Code: fatturazione API vs abbonamento Max.
Configurazione API Cursor
Connetti Cursor a RunAPI in due minuti e risparmia il 50% sulle tariffe API.
Configurazione API VS Code
Usa i modelli RunAPI in VS Code Copilot Chat e nelle estensioni.
RunAPI CLI
Esegui qualsiasi modello dal tuo terminale con un singolo comando.
Punta Claude Code su RunAPI con due comandi.
Crea un account RunAPI gratuito, imposta ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY nel tuo profilo shell, ed esegui ogni modello Claude in Claude Code con il 50% di sconto sui prezzi ufficiali Anthropic.