Claude Code installato
Installa Claude Code dalla fonte ufficiale e conferma che funziona con il comando claude nel tuo terminale.
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 su RunAPI ed esegui ogni modello Claude alla metà della tariffa ufficiale. Questa guida mostra i comandi esatti.
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 vanno le richieste e come si autenticano. Impostale sui valori RunAPI e ogni richiesta viene instradata attraverso RunAPI al 50% di sconto. Le card qui sotto coprono gli elementi essenziali prima della guida completa.
Due variabili
ANTHROPIC_BASE_URL imposta l'endpoint. ANTHROPIC_API_KEY imposta la chiave. Questa è tutta la configurazione.
Valore endpoint
Imposta ANTHROPIC_BASE_URL su https://api.runapi.ai in modo che Claude Code instradi tramite RunAPI.
Rendilo persistente
Aggiungi entrambi gli export al tuo profilo shell o .claude.json in modo da non doverli reimpostare a ogni sessione.
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. Hai bisogno di Claude Code installato, un account RunAPI e un terminale. L'elenco seguente copre tutto il necessario prima del primo comando.
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 → Chiavi API. Copiala subito — viene mostrata per intero solo al momento della creazione.
Accesso al terminale
Hai bisogno di una shell per impostare le variabili d'ambiente. macOS, Linux e WSL su Windows funzionano tutti allo stesso modo.
Passo dopo passo
Come configurare una chiave API Claude Code con RunAPI
Esegui questi comandi in ordine. Impostano l'endpoint e la chiave, li persistono nel profilo shell e confermano che Claude Code li rileva. Sostituisci il segnaposto con la tua vera chiave RunAPI.
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://api.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) in modo che sopravvivano alle nuove sessioni del terminale. Ricarica con source ~/.zshrc.
echo 'export ANTHROPIC_BASE_URL=https://api.runapi.ai' >> ~/.zshrc
4
Verifica la configurazione
Conferma che la variabile stampi l'URL RunAPI. Se è vuota, ricarica il profilo shell o apri un nuovo terminale.
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 set di variabili per controllare endpoint, autenticazione, modello e lunghezza dell'output. La tabella elenca quelle rilevanti per una configurazione con endpoint personalizzato e cosa fa ciascuna.
| Variabile | Scopo | Valore di esempio |
|---|---|---|
| ANTHROPIC_BASE_URL | Endpoint personalizzato a cui Claude Code invia le richieste | https://api.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 al compito: un modello veloce ed economico per modifiche di routine, uno bilanciato per il coding quotidiano, o il più potente per problemi difficili.
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. La fatturazione segue il modello che chiami effettivamente, tutto al 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 variabile non impostata, una shell obsoleta o un errore di digitazione nella chiave. La tabella elenca gli errori comuni e la soluzione 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://api.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://api.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 in modo che sopravvivano alle nuove sessioni.
4
Esegui Claude Code
Avvia claude nel tuo progetto. Le richieste ora vengono instradate tramite RunAPI al 50% della 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://api.runapi.ai e ANTHROPIC_API_KEY sulla tua chiave RunAPI. Aggiungi entrambe al tuo profilo shell in modo che persistano. Claude Code le legge all'avvio e instrada ogni richiesta attraverso RunAPI.
Dove ottengo una chiave API per Claude Code?
Creane una su runapi.ai. Registrati, apri Dashboard → Chiavi API e genera una chiave. Copiala immediatamente, poiché la chiave completa viene mostrata solo al momento della 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://api.runapi.ai, ogni richiesta viene instradata attraverso RunAPI, che fattura gli stessi modelli al 50% della tariffa ufficiale.
Perché Claude Code continua a fatturare alla tariffa completa?
L'URL base probabilmente non è impostato nella shell corrente. Esegui echo $ANTHROPIC_BASE_URL — se è vuoto, l'export non è persistito. Aggiungilo a ~/.zshrc o ~/.bashrc, ricarica con source, poi apri un nuovo terminale e controlla di nuovo.
Posso memorizzare la chiave in un file di configurazione?
Sì. Inserisci i valori in un file .claude.json nella tua home directory o nella directory del progetto invece di esportarli a ogni sessione. Entrambi gli approcci funzionano; il file è più comodo per chiavi per-progetto, mentre gli export sono più semplici per una configurazione globale singola.
Come monitorare 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 per limitare i token per risposta, e scegli un modello più economico come Haiku per le modifiche di routine.
Questo cambia il comportamento di Claude Code?
No. RunAPI fa da proxy alle richieste direttamente verso i modelli Claude sottostanti. Output, tool use e comportamento sono identici alla configurazione predefinita. Cambi solo dove vanno le richieste e come vengono fatturate — l'esperienza di coding rimane la stessa.
Quale modello dovrei impostare come predefinito?
La maggior parte degli sviluppatori imposta ANTHROPIC_MODEL su claude-sonnet-4-6 per il coding quotidiano. Usa claude-haiku-4-5 per modifiche rapide ed economiche o claude-opus-4-7 per refactoring complessi. Puoi cambiare modello dentro Claude Code in qualsiasi momento, e la fatturazione segue il modello che chiami.
Punta Claude Code su RunAPI con due comandi.
Crea un account RunAPI gratuito, imposta ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY, ed esegui ogni modello Claude in Claude Code al 50% rispetto ai prezzi ufficiali di Anthropic.