ai2saveai2save

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

  1. Aprite!https://ai2save.com/keys](https://ai2save.com/keys).
  2. Fare clic su "Crea chiave", compilare il nome e selezionare un gruppo che include il modello Claude.
  3. 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:

  1. Inserire una breve domanda, come "Ciao, presentarsi"
  2. Se il contenuto viene restituito normalmente, indica che l'indirizzo, la chiave e il gruppo di modello sono collegati.
  3. 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, o ANTHROPIC_API_KEY non 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/v1 causerà un errore; Claude Code dovrebbe essere riempito come https://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.