AI Perks offre accesso a sconti esclusivi, crediti e offerte su strumenti AI, servizi cloud e API per aiutare startup e sviluppatori a risparmiare.
Come si usa Claude Code con OpenRouter?
Imposta il base URL su https://openrouter.ai/api, inserisci la tua chiave API di OpenRouter in ANTHROPIC_AUTH_TOKEN e lascia vuota ANTHROPIC_API_KEY. Claude Code comunica poi direttamente con OpenRouter, senza proxy locale, e addebita i crediti del tuo account OpenRouter.
Questa è la configurazione descritta nella guida ufficiale di OpenRouter per Claude Code. Secondo quanto scritto, Claude Code parla direttamente con OpenRouter usando il proprio protocollo nativo e non è richiesto alcun server proxy locale. Questa è la differenza principale rispetto a strumenti come Claude Code Router, che eseguono un proxy sulla tua macchina (vedi la nostra guida a Claude Code Router se preferisci quella strada).
Il resto dell'articolo illustra le variabili esatte, dove vanno inserite, le avvertenze indicate da OpenRouter, il costo e il modo in cui i crediti gratuiti possono coprirlo.
Principali Crediti AI per Startup
Candidati direttamente tramite questi programmi verificati.
OpenRouter Up to $3,000 + 0% fees for 12 months
Idoneo per startup in fase iniziale
Claude (via program) $100,000
Idoneo per startup in fase iniziale
OpenAI (via program) $2,500
Idoneo per startup in fase iniziale
Anthropic $20,000
Idoneo per startup in fase iniziale
AWS $300,000
Idoneo per startup in fase iniziale
Google Cloud $350,000
Idoneo per startup in fase iniziale
Quali variabili d'ambiente servono a OpenRouter?
Tre variabili svolgono il lavoro. La guida richiede l'URL completo dell'API di OpenRouter, incluso lo schema, quindi un semplice nome host non basta.
| Variabile | Valore | Motivo |
|---|---|---|
| ANTHROPIC_BASE_URL | https://openrouter.ai/api | Invia il traffico di Claude Code a OpenRouter |
| ANTHROPIC_AUTH_TOKEN | La tua chiave API di OpenRouter | Autentica con OpenRouter |
| ANTHROPIC_API_KEY | Stringa vuota | Svuotata esplicitamente per evitare conflitti |
Il base URL è la parte che più spesso viene sbagliata quando si cerca la risposta a claude code base url openrouter. Usa https://openrouter.ai/api esattamente così, con https:// all'inizio.
Svuotare ANTHROPIC_API_KEY è importante perché Claude Code legge entrambe le variabili. Se è ancora impostata una vecchia chiave Anthropic, può entrare in conflitto con il token di OpenRouter.
Dove vanno inserite le variabili e dove no?
Ci sono due posti supportati e un posto che non funziona.
Opzione 1: il profilo della shell. OpenRouter consiglia questa soluzione per la persistenza. Aggiungi le variabili lì, poi ricarica la shell. La guida è esplicita sul ricaricamento: se lo salti, continuerai a testare l'ambiente vecchio e concluderai erroneamente che la configurazione non funziona.
Opzione 2: un file di impostazioni a livello di progetto. In alternativa puoi usare .claude/settings.local.json nella radice del progetto. In questo modo la configurazione resta limitata a un solo progetto.
Non un file .env. La guida dice di non inserire queste variabili in un file .env a livello di progetto, perché l'installer nativo di Claude Code non legge i file .env standard.
Un'ulteriore trappola: se la tua chiave di OpenRouter si trova in un'altra variabile a cui fa riferimento ANTHROPIC_AUTH_TOKEN, definiscila prima che venga utilizzata. Altrimenti l'autenticazione fallisce. La guida suggerisce un file che viene caricato prima, come ~/.zshenv per zsh.
Principali Crediti AI per Startup
Candidati direttamente tramite questi programmi verificati.
OpenRouter Up to $3,000 + 0% fees for 12 months
Idoneo per startup in fase iniziale
Claude (via program) $100,000
Idoneo per startup in fase iniziale
OpenAI (via program) $2,500
Idoneo per startup in fase iniziale
Anthropic $20,000
Idoneo per startup in fase iniziale
AWS $300,000
Idoneo per startup in fase iniziale
Google Cloud $350,000
Idoneo per startup in fase iniziale
Come si configura, passo dopo passo?
Passo 1: Ottieni crediti tramite AI Perks
Claude Code tramite OpenRouter viene fatturato con i tuoi crediti OpenRouter, quindi inizia cercandone di gratuiti. La AI Perks Guide elenca crediti OpenRouter fino a $3,000, oltre ai crediti Anthropic che puoi usare se porti la tua chiave. Controlla il catalogo per importi e dettagli prima di spendere denaro tuo.
Passo 2: Crea una chiave API di OpenRouter
Genera una chiave nelle impostazioni del tuo account OpenRouter. Questo è il valore che va in ANTHROPIC_AUTH_TOKEN.
Passo 3: Aggiungi le variabili
Inserisci il base URL, il token di autenticazione e ANTHROPIC_API_KEY vuota nel profilo della shell, oppure in .claude/settings.local.json. Non usare un file .env. Successivamente ricarica la shell.
Passo 4: Esegui /logout se necessario
Se in precedenza hai effettuato l'accesso a Claude Code con un account Anthropic, esegui una volta /logout per rimuovere la sessione memorizzata. Poi chiudi e riavvia claude in modo che legga le nuove variabili. Se non hai mai effettuato l'accesso con Anthropic, puoi saltare questo passo.
Passo 5: Verifica con /status
Esegui /status dentro Claude Code per confermare la connessione. Poi controlla la dashboard di OpenRouter: lì compaiono l'utilizzo, inclusi i token di ragionamento.
Quali avvertenze indica OpenRouter?
La guida è chiara sui limiti, e questi influenzano il modo in cui dovresti configurare le cose.
- Solo Anthropic di prima parte. Claude Code con OpenRouter è garantito solo con il provider Anthropic di prima parte. Per la massima compatibilità, OpenRouter consiglia di impostare Anthropic 1P come provider con priorità più alta.
- Altri modelli potrebbero non funzionare. Claude Code è ottimizzato per i modelli Anthropic e potrebbe non funzionare correttamente con altri provider. Considera i modelli non Anthropic un esperimento, non un'impostazione predefinita.
- Ipotesi sulla finestra di contesto. Claude Code presume una finestra di contesto da 200k, a meno che il nome del modello non termini con
[1m]. - Failover. Le richieste passano automaticamente da un provider Anthropic all'altro quando vengono instradate tramite OpenRouter.
- Privacy. OpenRouter non registra i tuoi prompt con il codice sorgente, a meno che tu non attivi la registrazione dei prompt nelle impostazioni del tuo account.
Questa prima avvertenza è il motivo per cui le ricerche come "claude code openrouter free" richiedono cautela. OpenRouter offre modelli gratuiti, ma sono limitati e Claude Code è garantito solo su Anthropic di prima parte. I modelli gratuiti sono limitati a 20 richieste al minuto e 50 al giorno, che salgono a 1.000 al giorno dopo aver acquistato almeno $10 di crediti. Vedi la nostra guida al piano gratuito di OpenRouter per il quadro completo.
Principali Crediti AI per Startup
Candidati direttamente tramite questi programmi verificati.
OpenRouter Up to $3,000 + 0% fees for 12 months
Idoneo per startup in fase iniziale
Claude (via program) $100,000
Idoneo per startup in fase iniziale
OpenAI (via program) $2,500
Idoneo per startup in fase iniziale
Anthropic $20,000
Idoneo per startup in fase iniziale
AWS $300,000
Idoneo per startup in fase iniziale
Google Cloud $350,000
Idoneo per startup in fase iniziale
È possibile usare la modalità veloce tramite OpenRouter?
Sì, ma solo a condizioni specifiche. La modalità veloce di Anthropic offre un output fino a 2.5x più rapido a un prezzo premium, superiore alle tariffe standard per token del modello Opus sottostante.
| Requisito | Dettaglio |
|---|---|
| Modelli | Claude Opus 4.6, 4.7, 4.8 e Claude Opus 5 |
| Versione di Claude Code | v2.1.96 o successiva |
| Variabile d'ambiente | CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1 per usare /fast |
| Provider | Solo Anthropic di prima parte |
| Impostazione del modello | Fissa la variabile Opus a un ID specifico come anthropic/claude-opus-5 |
La modalità veloce è offerta solo dal provider Anthropic di prima parte, poiché altri provider come Amazon Bedrock e Google Vertex non la supportano. Per usarla davvero, fissa la variabile del modello Opus a un ID Opus specifico anziché all'alias più recente. La guida non pubblica qui il moltiplicatore premium, quindi verifica le tariffe attuali prima di farci affidamento.
Quanto costa Claude Code su OpenRouter rispetto ad Anthropic diretto?
OpenRouter non applica un ricarico sull'inferenza. L'inferenza è fatturata al prezzo di listino del provider in ogni piano. La commissione viene addebitata quando acquisti i crediti, mai sulle singole richieste.
Ecco a quanto ammonta la commissione su un acquisto di crediti da $10:
| Acquisto di crediti | Aliquota della commissione | Commissione su $10 |
|---|---|---|
| Non-crypto, Standard | 5.5%, minimo $0.80 | $0.80 (5.5% di $10 è $0.55, inferiore al minimo, quindi si applica il minimo) |
| Crypto | 5.0% fisso, nessun minimo | $0.50 (5.0% di $10) |
| Non-crypto, Business | 8% | $0.80 (8% di $10) |
Il confronto onesto è quindi questo: il prezzo per token è il prezzo di listino del provider, e OpenRouter aggiunge sopra una commissione di acquisto. Pagare direttamente Anthropic evita questa commissione. In cambio ottieni una sola chiave, un'unica dashboard e il failover tra provider Anthropic.
I prezzi per token dei singoli modelli non sono pubblicati nella pagina dei prezzi di OpenRouter. Vanno letti dall'API dei modelli. Per i prezzi di Anthropic, vedi la nostra analisi dei prezzi dell'API Claude.
Come cambia il conto con BYOK?
I piani Standard e Business includono $25,000 al mese di inferenza a prezzo di listino tramite BYOK (portare la propria chiave) senza commissione di OpenRouter. Oltre questa soglia, OpenRouter addebita il 5% di quanto costerebbe la richiesta a prezzo di listino, detratto dai tuoi crediti.
Con BYOK controlli i limiti di frequenza e i costi tramite il tuo account presso il provider. È qui che i crediti gratuiti dei fornitori diventano utili: se il tuo account presso il provider ha crediti, l'uso di Claude Code può attingervi, nel rispetto delle condizioni sui crediti di quel fornitore.
Principali Crediti AI per Startup
Candidati direttamente tramite questi programmi verificati.
OpenRouter Up to $3,000 + 0% fees for 12 months
Idoneo per startup in fase iniziale
Claude (via program) $100,000
Idoneo per startup in fase iniziale
OpenAI (via program) $2,500
Idoneo per startup in fase iniziale
Anthropic $20,000
Idoneo per startup in fase iniziale
AWS $300,000
Idoneo per startup in fase iniziale
Google Cloud $350,000
Idoneo per startup in fase iniziale
Quali crediti gratuiti possono coprire l'uso di Claude Code?
Questi sono gli importi del catalogo più pertinenti per l'uso di Claude Code. I dettagli, e ciò che comporta ciascun bonus, si trovano nel catalogo di AI Perks.
| Azienda | Crediti gratuiti | Come ottenerli |
|---|---|---|
| OpenRouter | Fino a $3,000 | Ottieni questo bonus |
| Anthropic (diretto) | $20,000 | Ottieni questo bonus |
| Claude tramite partner | Fino a $100,000 | Ottieni questo bonus |
| AWS (Amazon Bedrock) | $300,000 | Ottieni questo bonus |
Totale di queste quattro righe: $3,000 + $20,000 + $100,000 + $300,000 = fino a $423,000 in crediti elencati.
Il catalogo elenca anche crediti di OpenAI, Google Cloud, Azure OpenAI, Mistral AI, Together AI, Cerebras e Novita AI. Sono utili soprattutto se vuoi testare modelli non Anthropic, tenendo presente l'avvertenza di OpenRouter secondo cui Claude Code potrebbe non funzionare correttamente con essi. Per il lato Anthropic in particolare, leggi la nostra guida a una chiave API gratuita di Anthropic, e consulta il catalogo per gli importi più elevati di crediti Claude.
FAQ
Claude Code ha bisogno di un proxy locale per funzionare con OpenRouter?
No. OpenRouter afferma che Claude Code parla direttamente con OpenRouter usando il proprio protocollo nativo e non è richiesto alcun server proxy locale. Basta impostare le variabili d'ambiente. Uno strumento basato su proxy come Claude Code Router è un approccio diverso, utile quando vuoi regole di instradamento personalizzate tra molti modelli.
Perché Claude Code usa ancora il mio vecchio accesso Anthropic?
Probabilmente hai una sessione memorizzata. Esegui una volta /logout, poi chiudi e riavvia claude in modo che legga le nuove variabili. Verifica anche di aver ricaricato la shell dopo aver modificato il profilo, e che ANTHROPIC_API_KEY sia vuota. Controlla il risultato con /status.
Posso usare Claude Code con OpenRouter gratuitamente?
In parte. I nuovi utenti di OpenRouter ricevono una piccola quota gratuita, ed esistono modelli gratuiti con limiti di 20 richieste al minuto e 50 al giorno. Ma Claude Code è garantito solo sul provider Anthropic di prima parte. Per un uso reale, cerca i crediti gratuiti elencati su getaiperks.com.
OpenRouter addebita una commissione extra per richiesta sui modelli Claude?
No. L'inferenza è fatturata al prezzo di listino del provider, e la commissione di OpenRouter si applica all'acquisto dei crediti: 5.5% sullo Standard e 8% sul Business. Gli acquisti non-crypto hanno un minimo di $0.80, mentre gli acquisti in crypto prevedono un 5.0% fisso. Confrontalo con il pagamento diretto ad Anthropic usando i crediti Anthropic presenti nel catalogo.
Posso usare crediti Anthropic gratuiti tramite OpenRouter?
Tramite BYOK, colleghi la tua chiave del provider e i costi passano dal tuo account presso il provider. I piani Standard e Business includono una quota BYOK mensile da $25,000 senza commissione di OpenRouter. Per trovare crediti Anthropic fino a $100,000 tramite partner, consulta il catalogo su AI Perks.
Perché la finestra di contesto di Claude Code è 200k?
Claude Code presume una finestra di contesto da 200k, a meno che il nome del modello non termini con [1m]. Se vuoi che Claude Code tratti la finestra come più grande, il nome del modello deve includere quel suffisso. La guida non pubblica ulteriori dettagli su quali modelli lo supportino.
Principali Crediti AI per Startup
Candidati direttamente tramite questi programmi verificati.
OpenRouter Up to $3,000 + 0% fees for 12 months
Idoneo per startup in fase iniziale
Claude (via program) $100,000
Idoneo per startup in fase iniziale
OpenAI (via program) $2,500
Idoneo per startup in fase iniziale
Anthropic $20,000
Idoneo per startup in fase iniziale
AWS $300,000
Idoneo per startup in fase iniziale
Google Cloud $350,000
Idoneo per startup in fase iniziale
Pronto a finanziare la tua configurazione di Claude Code?
La configurazione richiede pochi minuti. La parte che vale la pena pianificare è il costo: i crediti OpenRouter, i crediti Anthropic e i crediti cloud sono tutti tracciati in un unico catalogo, così puoi abbinare i crediti giusti al tuo utilizzo prima di pagare il prezzo di listino.
Ottieni crediti AI gratuiti su getaiperks.com →
Sfoglia il catalogo completo dei crediti AI gratuiti su getaiperks.com ed esegui Claude Code con crediti che non hai pagato.
