Configurazione del modello

Per impostazione predefinita, Claude Code utilizza claude-3-7-sonnet-20250219. Puoi sovrascrivere questo utilizzando le seguenti variabili d’ambiente:

# Anthropic API
ANTHROPIC_MODEL='claude-3-7-sonnet-20250219'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku-20241022'

# Amazon Bedrock
ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'
ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# Google Vertex AI
ANTHROPIC_MODEL='claude-3-7-sonnet@20250219'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku@20241022'

Puoi anche impostare queste variabili utilizzando la configurazione globale:

# Configura per Anthropic API
claude config set --global env '{"ANTHROPIC_MODEL": "claude-3-7-sonnet-20250219"}'

# Configura per Bedrock
claude config set --global env '{"CLAUDE_CODE_USE_BEDROCK": "true", "ANTHROPIC_MODEL": "us.anthropic.claude-3-7-sonnet-20250219-v1:0"}'

# Configura per Vertex AI
claude config set --global env '{"CLAUDE_CODE_USE_VERTEX": "true", "ANTHROPIC_MODEL": "claude-3-7-sonnet@20250219"}'

Consulta il nostro riferimento dei nomi dei modelli per tutti i modelli disponibili tra i diversi provider.

Uso con API di terze parti

Claude Code richiede l’accesso sia ai modelli Claude 3.7 Sonnet che Claude 3.5 Haiku, indipendentemente dal provider API che utilizzi.

Connessione ad Amazon Bedrock

CLAUDE_CODE_USE_BEDROCK=1

Se desideri accedere a Claude Code tramite proxy, puoi utilizzare la variabile d’ambiente ANTHROPIC_BEDROCK_BASE_URL:

ANTHROPIC_BEDROCK_BASE_URL='https://your-proxy-url'

Se non hai abilitato la memorizzazione nella cache dei prompt, imposta anche:

DISABLE_PROMPT_CACHING=1

Richiede credenziali AWS SDK standard (ad esempio, ~/.aws/credentials o variabili d’ambiente pertinenti come AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY). Per configurare le credenziali AWS, esegui:

aws configure

Contatta Amazon Bedrock per la memorizzazione nella cache dei prompt per costi ridotti e limiti di velocità più elevati.

Gli utenti avranno bisogno dell’accesso sia ai modelli Claude 3.7 Sonnet che Claude 3.5 Haiku nel loro account AWS. Se hai un ruolo di accesso al modello, potresti dover richiedere l’accesso a questi modelli se non sono già disponibili. L’accesso a Bedrock in ogni regione è necessario perché i profili di inferenza richiedono capacità cross-region.

Connessione a Google Vertex AI

CLAUDE_CODE_USE_VERTEX=1
CLOUD_ML_REGION=us-east5
ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

Se desideri accedere a Claude Code tramite proxy, puoi utilizzare la variabile d’ambiente ANTHROPIC_VERTEX_BASE_URL:

ANTHROPIC_VERTEX_BASE_URL='https://your-proxy-url'

Se non hai abilitato la memorizzazione nella cache dei prompt, imposta anche:

DISABLE_PROMPT_CACHING=1

Claude Code su Vertex AI attualmente supporta solo la regione us-east5. Assicurati che il tuo progetto abbia quota allocata in questa specifica regione.

Gli utenti avranno bisogno dell’accesso sia ai modelli Claude 3.7 Sonnet che Claude 3.5 Haiku nel loro progetto Vertex AI.

Richiede credenziali GCP standard configurate attraverso google-auth-library. Per configurare le credenziali GCP, esegui:

gcloud auth application-default login

Per la migliore esperienza, contatta Google per limiti di velocità più elevati.

Connessione attraverso un proxy

Quando utilizzi Claude Code con un proxy LLM (come LiteLLM), puoi controllare il comportamento dell’autenticazione utilizzando le seguenti variabili d’ambiente e configurazioni. Nota che puoi combinare queste con le impostazioni specifiche di Bedrock e Vertex.

Variabili d’ambiente

  • ANTHROPIC_AUTH_TOKEN: Valore personalizzato per le intestazioni Authorization e Proxy-Authorization (il valore che imposti qui sarà prefissato con Bearer )
  • ANTHROPIC_CUSTOM_HEADERS: Intestazioni personalizzate che vuoi aggiungere alla richiesta (nel formato Nome: Valore)
  • HTTP_PROXY: Imposta l’URL del proxy HTTP
  • HTTPS_PROXY: Imposta l’URL del proxy HTTPS

Se preferisci configurare tramite un file invece che con variabili d’ambiente, puoi aggiungere qualsiasi di queste variabili all’oggetto env nella tua configurazione globale di Claude (in ~/.claude.json).

Opzioni di configurazione globale

  • apiKeyHelper: Uno script shell personalizzato per ottenere una chiave API (invocato una volta all’avvio e memorizzato nella cache per la durata di ogni sessione)

Was this page helpful?