Configurazione di Claude Code: utilizzo in Cina, proxy e indirizzo API, variabili d'ambiente comuni

Utilizzo in Cina: collegamento al gateway senza VPN

# ~/.zshrc / ~/.bashrc / PowerShell 配置文件
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=你的网关密钥
claude

Claude Code legge queste due variabili, proprio come l'SDK ufficiale. Le richieste vengono inviate al gateway anziché ad api.anthropic.com, consentendo una connessione diretta dalle reti cinesi. Inserisci solo il dominio, senza /v1. Dopo aver configurato le variabili, riapri il terminale e, all'interno della sessione, usa /status per verificare. L'estensione di VS Code e l'applicazione desktop leggono l'ambiente della shell da cui vengono avviate. Dopo aver modificato la configurazione, chiudi completamente l'editor e riavvialo da un nuovo terminale.

Quando serve un proxy

Serve solo quando la connessione della tua rete al gateway stesso è instabile. Si configura come negli altri strumenti da riga di comando:

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

Se /login va in timeout durante l'accesso OAuth («timeout of 15000ms exceeded»), il problema è molto probabilmente legato al proxy o al DNS; l'accesso tramite chiave API consente di bypassare completamente OAuth.

Configurazione dei modelli

export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Claude Code ragiona per categorie (Sonnet / Opus / Haiku): queste tre variabili determinano il modello specifico associato a ciascuna categoria. La categoria Haiku è più importante di quanto sembri: Claude Code la usa per i piccoli compiti di ogni sessione, e associarla a un modello economico permette di risparmiare parecchio. Il gateway offre attualmente 33 ID di modelli Claude, tutti selezionabili in/model .

Dove si trovano i file di configurazione

• CLAUDE.md(nella directory radice del progetto) — memoria del progetto: comandi di compilazione e test, convenzioni;CLAUDE.local.md contiene note personali e non viene incluso nel repository.
• .claude/settings.json(progetto) / ~/.claude/settings.json(globale) — autorizzazioni, hook, variabili d'ambiente, statusLine.
• .claude/agents/ — definizioni dei sottoagenti;.claude/skills/ e ~/.claude/skills/ — competenze.
• .mcp.json — configurazione dei server MCP condivisa nel progetto.

Risoluzione degli errori di configurazione

• 404 e nei log compare /v1/v1/messages → in BASE_URL è stato aggiunto erroneamente /v1。
• 401 / chiave non valida → la chiave non corrisponde all'indirizzo: l'indirizzo del gateway richiede una chiave del gateway.
• Hai effettuato l'accesso a Max, ma ti vengono addebitati i token → nell'ambiente è ancora presente ANTHROPIC_API_KEY; la chiave ha la precedenza sull'accesso. Se non vuoi usarla, rimuovila con unset.
• Il modello non esiste → l'ID non è presente nell'elenco /v1/models dell'endpoint attuale.
• Dopo aver modificato settings.json, l'applicazione si chiude subito all'avvio → errore di sintassi JSON (una virgola di troppo); verifica con uno strumento di validazione.

Costi

Quando punti al gateway, cambia anche la fatturazione: il credito viene venduto a 7.69231 volte il valore nominale; con $13 ottieni $100 di credito. Per un utilizzo intensivo puoi scegliere piani illimitati a partire da $0.80. Consulta la pagina dei prezzi per i dettagli.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Domande frequenti

AI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway.