Guida alla configurazione di Claude Code
Claude Code utilizza il protocollo Antropic Messages. Quando si collega a ai2save, immettere l'indirizzo root del sito https://ai2save.com, non applicare manualmente /v1; utilizzare il sk-... creato nella console ai2save come la chiave.
1. Prepara la chiave API
- Aprite!https://ai2save.com/keys](https://ai2save.com/keys).
- Fare clic su "Crea chiave", compilare il nome e selezionare un gruppo che include il modello Claude.
- Copiare il tasto completo immediatamente dopo la creazione. La chiave completa viene mostrata solo una volta.
2. Installa Claude Code
Prima completare la configurazione dell'ambiente Node.js, poi correte:
npm install -g @anthropic-ai/claude-code
claude --version
Se la versione è inferiore ai requisiti di gateway, eseguire l'aggiornamento come richiesto:
npm update -g @anthropic-ai/claude-code
3. Abilita temporaneamente nel terminale corrente
macOS / Linux / WSL:
export ANTHROPIC_BASE_URL="https://ai2save.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
claude
Windows PowerShell:
$env:ANTHROPIC_BASE_URL="https://ai2save.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
claude
ANTHROPIC_AUTH_TOKEN è una variabile speciale per la chiave della stazione di transito. Non impostare ANTHROPIC_API_KEY a qualsiasi altra chiave ufficiale allo stesso tempo, per evitare Claude Code leggere credenziali errate.
4. Scrivi nel file di configurazione di Claude Code (consigliato)
Modifica ~/.claude/settings.json (su Windows, di solito in %USERPROFILE%\.claude\settings.json):
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"env": {
"ANTHROPIC_BASE_URL": "https://ai2save.com",
"ANTHROPIC_AUTH_TOKEN": "sk-your-api-key"
}
}
Dopo aver salvato, riaprire il terminale e iniziare claude. Se si desidera solo di prendere effetto per un progetto specifico, scrivere lo stesso contenuto in .claude/settings.local.json all'interno del progetto, e non inviare la vera chiave a Git.
5. Seleziona un modello e verifica
claude --model claude-sonnet-4-6
Dopo aver inserito l'interfaccia interattiva:
- Inserire una breve domanda, come "Ciao, presentarsi"
- Se il contenuto viene restituito normalmente, indica che l'indirizzo, la chiave e il gruppo di modello sono collegati.
- Per cambiare i modelli, utilizzare
/model, e il modello ID deve corrispondere all'ID aperto nella console.
È inoltre possibile utilizzare in primo luogo il codice diagnostico integrato Claude per controllare lo stato di configurazione:
/status
/doctor
6. Configurazioni multiple e pulizia delle impostazioni precedenti
Se avete precedentemente effettuato l'accesso al Claude ufficiale o ad altre stazioni di relè:
- Priorizzare l'utilizzo di CC Switch per gestire più fornitori per evitare la configurazione manuale.
- Quando si configura manualmente, assicurarsi che il vecchio
ANTHROPIC_BASE_URL,ANTHROPIC_AUTH_TOKEN, oANTHROPIC_API_KEYnon sovrascrivendo i valori attuali. - WSL e Windows sono due ambienti separati; dopo la configurazione nel terminale di Windows, WSL deve anche essere configurato separatamente.
macOS / Linux pulizia temporanea:
unset ANTHROPIC_API_KEY
Errori comuni
- 401 / invalid_api_key: La chiave non è stata completamente copiata, è stato revocato o il gruppo non include l'attuale modello.
- 404 - Categoria non trovata: Il modello ID non è corretto, o il gruppo chiave non ha abilitato questo modello.
- La connessione non è riuscita: Scrivere l'URL di base come
https://ai2save.com/v1causerà un errore; Claude Code dovrebbe essere riempito comehttps://ai2save.com. - Cerca ancora di richiedere l'indirizzo ufficiale: Controllare se il vecchio indirizzo rimane in
~/.claude/settings.json, progetto.claude/settings.local.json, o variabili ambientali terminali. - Windows non ha effetto dopo l'apertura: Esci completamente dal terminal, VS Code o Claude Desktop e poi riaprire.