Claude Code con un base URL personalizzato
Imposta queste quattro variabili nella shell, oppure nel blocco env di ~/.claude/settings.json, e Claude Code funziona con i modelli Claude tramite la tua chiave AIGROW.
Hai già un codice? Riscattalo su Accesso API, poi crea una chiave.
Shell, prima di avviare claude
export ANTHROPIC_BASE_URL="https://aigrow.gg"
export ANTHROPIC_AUTH_TOKEN="ag_your_key_here"
export ANTHROPIC_MODEL="claude-opus-5.5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-sonnet-5.5"Sostituisci ag_your_key_here con una chiave presa da Accesso API.
Dove si trova l'impostazione
- macOS e Linux
~/.claude/settings.json- Windows
%USERPROFILE%\.claude\settings.json- Un solo progetto
.claude/settings.local.json- Estensione per VS Code
claudeCode.environmentVariables
Oppure tienila in settings.json
Claude Code legge il blocco env del suo file di impostazioni a ogni avvio, quindi la configurazione resta valida anche in un nuovo terminale. Un valore impostato qui prevale su un export della shell. Non inserire la chiave nel file .claude/settings.json di un progetto, pensato per essere committato.
{
"env": {
"ANTHROPIC_BASE_URL": "https://aigrow.gg",
"ANTHROPIC_AUTH_TOKEN": "ag_your_key_here",
"ANTHROPIC_MODEL": "claude-opus-5.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5.5"
}
}Quale modello usare
Inserisci l'id esattamente come è scritto qui.
- Claude Opus 5.5
claude-opus-5.5 - ANTHROPIC_MODEL, il modello con cui lavori. È l’impostazione predefinita in ogni blocco di questa pagina. Contesto: 1.000.000 token.
- Claude Sonnet 5.5
claude-sonnet-5.5 - ANTHROPIC_DEFAULT_HAIKU_MODEL, per titoli, riassunti e altre chiamate in background. Per impostazione predefinita Claude Code le invia a un modello Haiku, che l’endpoint non offre. Come modello principale costa meno in una sessione lunga, perché le sue letture dalla cache sono le più economiche qui. Contesto: 1.000.000 token.
- Claude Fable 5.1
claude-fable-5.1 - Costa più di Opus per token. Confronta i due sulla classifica di coding prima di passare all’altro. Contesto: 1.000.000 token.
Il listino prezzi riporta ogni id con la sua tariffa in crediti, i prezzi dell'API di Claude riportano i prezzi di listino e la classifica per il coding confronta i modelli su prompt di programmazione.
Verifica che funzioni
Prima la chiave da sola, poi Claude Code con la chiave.
La chiave
Richiedi l'elenco dei modelli. Serve una chiave valida e non costa nulla.
curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"{
"object": "list",
"data": [
{ "id": "claude-opus-5.5", "object": "model", ... },
{ "id": "claude-fable-5.1", "object": "model", ... },
{ "id": "gpt-6-astra", "object": "model", ... },
{ "id": "claude-sonnet-5.5", "object": "model", ... },
{ "id": "gpt-6.1-sol", "object": "model", ... },
{ "id": "grok-4.7", "object": "model", ... },
...
],
"has_more": false
}Claude Code
Esegui un prompt dalla shell. All’interno di una sessione, /status mostra il base URL e la provenienza della chiave.
claude -p "Reply with the word ready"readyQuando non funziona
Prima gli errori di Claude Code, poi le risposte che l'endpoint dà a qualsiasi strumento.
- 404 a ogni richiesta
- Il base URL termina con /v1. Claude Code aggiunge da solo /v1/messages, quindi ANTHROPIC_BASE_URL è https://aigrow.gg senza nulla dopo.
- 400 per un campo sconosciuto
- Imposta CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 e riavvia. Claude Code smette così di inviare i suoi campi di richiesta sperimentali.
- Ti chiede di approvare una chiave API
- Hai impostato ANTHROPIC_API_KEY, che viaggia come header x-api-key e richiede la tua approvazione una volta. Approvala, oppure usa ANTHROPIC_AUTH_TOKEN come nel blocco, che viaggia come header Bearer senza richieste.
- Usa ancora il tuo login Claude
- Esegui /status. Se non mostra alcun base URL personalizzato, le variabili non sono arrivate a Claude Code: esportale nella shell da cui avvii claude, oppure inseriscile nel blocco env di settings.json.
- Il mio strumento mostra un errore 401 o di autenticazione
- La chiave manca o è stata digitata in modo errato. Copiala di nuovo da Accesso API nella dashboard e assicurati che venga inviata come chiave, non come nome di un modello. Una chiave revocata dà lo stesso errore: creane una nuova e sostituiscila.
- Ricevo un errore 402 o un messaggio sul credito
- Il tuo saldo è esaurito. Apri Accesso API nella dashboard, riscatta un codice o acquista un altro pacchetto e la richiesta successiva andrà a buon fine. Non serve cambiare nient’altro.
- Compare 404 o Unknown model
- Il modello deve essere uno di quelli serviti dall’endpoint, per esempio claude-opus-5.5. Funzionano anche le grafie originali del provider (claude-opus-5-5, anthropic/claude-opus-5.5), ma un id con data o qualsiasi modello fuori dal catalogo viene rifiutato prima che la richiesta sia inoltrata, e non viene addebitato nulla. Con la tua chiave richiedi GET /v1/models per l’elenco aggiornato, oppure leggi gli id nel listino.
- Le richieste vengono rifiutate con errore 429
- La capacità dell’endpoint è condivisa da tutti i clienti: circa 20 richieste al minuto e 4 contemporaneamente. Ogni risposta 429 include un header retry-after, e gli SDK di OpenAI e Anthropic attendono quel tempo e riprovano da soli. In un ciclo scritto da te, attendi i secondi indicati oppure riduci la concorrenza.
- Il modello al momento non è disponibile
- Un 404 che indica che il modello non è al momento disponibile significa che è temporaneamente fuori servizio presso il provider a monte, non che c'è un problema con la tua chiave o il tuo saldo. Riprova tra qualche istante oppure invia la richiesta a un altro modello.
- Ricevo un errore 502 o 503
- Un problema temporaneo a monte o di configurazione, che non viene addebitato sul tuo saldo. Riprova la richiesta; se continua a fallire, scrivici tramite lo store e ce ne occuperemo.
Cosa non funziona tramite AIGROW
GPT e Grok. Claude Code è fatto per i modelli Claude, quindi imposta qui solo id di Claude e usa uno degli altri strumenti di questa pagina per il resto.
Remote Control e dettatura vocale. Richiedono un login Claude e sono disattivati con una chiave gateway.
Dimensione del contesto per un ID che Claude Code non riconosce. Lo tratta come se fosse di 200.000 token, quindi una sessione può essere compattata prima del necessario.
Conteggio esatto dei token prima di una richiesta. L’endpoint non ha una route per il conteggio dei token, quindi Claude Code stima da solo la dimensione di un prompt.
Ricerca web in tempo reale all’interno del modello. Uno strumento di ricerca web inviato con una richiesta riceve risposta da ciò che il modello già sa, senza risultati in tempo reale. Uno strumento che recupera pagine sulla tua macchina funziona comunque.
Qualsiasi endpoint oltre a questi tre: /v1/messages, /v1/chat/completions e /v1/models. La Responses API, gli embedding e il conteggio dei token rispondono 404.
I campi del router, come models, route, provider e plugins. Vengono scartati, quindi una richiesta va sempre al solo modello che indica.
Quanto costa un mese di Claude Code
Uno sviluppatore al lavoro tutto il giorno, con la maggior parte di ogni richiesta letta dalla cache del prompt, al prezzo di listino e tramite credito. Cambia il modello per confrontare.
Claude Opus 5.5, Agente di coding: $214.20 al mese al prezzo di listino, $100.80 con il credito AIGROW, $113.40 in meno (53%).
Domande su Claude Code e su un'API personalizzata
- Claude Code funziona con un base URL personalizzato?
- Sì. Imposta ANTHROPIC_BASE_URL su https://aigrow.gg e ANTHROPIC_AUTH_TOKEN sulla tua chiave: Claude Code invia ogni richiesta lì invece che ad Anthropic. L’estensione per VS Code legge le stesse impostazioni.
- ANTHROPIC_BASE_URL deve terminare con /v1?
- No. Claude Code aggiunge /v1/messages da solo, quindi il valore è https://aigrow.gg. Con /v1 alla fine ogni richiesta va a /v1/v1/messages e fallisce con un errore 404.
- ANTHROPIC_AUTH_TOKEN o ANTHROPIC_API_KEY?
- Vanno bene entrambe con una chiave AIGROW. ANTHROPIC_AUTH_TOKEN viene inviato come header Bearer, senza alcuna richiesta di conferma. ANTHROPIC_API_KEY viene inviata come x-api-key e, in una sessione interattiva, Claude Code ti chiede di approvarla una sola volta.
- Posso usarlo per un solo progetto?
- Sì. Inserisci il blocco env in .claude/settings.local.json nella radice del progetto. Claude Code lo legge solo in quel progetto e il file non è pensato per essere incluso nei commit.
- Il Claude Agent SDK funziona allo stesso modo?
- Sì, con le stesse variabili passate nella sua opzione env. In TypeScript quell’opzione sostituisce l’ambiente, quindi includi process.env con lo spread; in Python, ClaudeAgentOptions(env=...) si aggiunge all’ambiente esistente.
- Come torno al mio abbonamento Claude?
- Rimuovi le variabili dalla shell e dal blocco env di settings.json, poi riavvia claude. Senza un base URL impostato, usa il tuo login Claude.
Fonti: Claude Code LLM gateway · Claude Code Connect a gateway · Claude Code Settings. Consultato il 21 ottobre 2026.
Configura un altro strumento
- ClineProtocollo OpenAI
Il provider OpenAI Compatible, quattro campi nella schermata delle impostazioni.
- Roo CodeProtocollo OpenAI
Il provider OpenAI Compatible, con gli stessi campi di Cline.
- Kilo CodeProtocollo OpenAI
Un provider personalizzato nella scheda Providers; l’elenco dei modelli si compila da solo.
- ContinueProtocollo OpenAI
Una voce in models nel file config.yaml, con provider openai e un apiBase.
- AiderProtocollo OpenAI
OPENAI_API_BASE e OPENAI_API_KEY, poi openai/ prima dell’id del modello.
- OpenCodeProtocollo OpenAI
Un blocco provider in opencode.json e la chiave tramite /connect.
- ZedProtocolli Anthropic e OpenAI
Un provider compatibile con Anthropic per Claude, uno compatibile con OpenAI per GPT e Grok.
- GooseProtocollo OpenAI
Il provider OpenAI con OPENAI_HOST, oppure un file di provider personalizzato.
- Vercel AI SDKProtocolli Anthropic e OpenAI
Il provider OpenAI Compatible per ogni modello, oppure il provider Anthropic per Claude.
- OpenAI Agents SDKProtocollo OpenAI
Il tuo client AsyncOpenAI, passato alle chat completions, con il tracing disattivato.
- LangChainProtocolli Anthropic e OpenAI
ChatOpenAI con base_url per ogni modello, oppure ChatAnthropic per Claude.
La guida all'API comprende gli SDK, curl, gli endpoint e i limiti di frequenza.
Incolla il blocco e Claude Code funziona con il tuo credito.
Acquista un pacchetto di credito, riscatta il codice ricevuto via email su Accesso API, crea una chiave e inseriscila al posto di ag_your_key_here.