Integrazioni Bedrock & Vertex
Configura Claude Code per lavorare con Amazon Bedrock e Google Vertex AI, e connettiti attraverso i proxy.
Configurazione del modello
Per impostazione predefinita, Claude Code utilizza claude-3-7-sonnet-20250219
. Puoi sovrascrivere questo utilizzando le seguenti variabili d’ambiente:
Puoi anche impostare queste variabili utilizzando la configurazione globale:
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
Se desideri accedere a Claude Code tramite proxy, puoi utilizzare la variabile d’ambiente ANTHROPIC_BEDROCK_BASE_URL
:
Se non hai abilitato la memorizzazione nella cache dei prompt, imposta anche:
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:
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
Se desideri accedere a Claude Code tramite proxy, puoi utilizzare la variabile d’ambiente ANTHROPIC_VERTEX_BASE_URL
:
Se non hai abilitato la memorizzazione nella cache dei prompt, imposta anche:
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:
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 intestazioniAuthorization
eProxy-Authorization
(il valore che imposti qui sarà prefissato conBearer
)ANTHROPIC_CUSTOM_HEADERS
: Intestazioni personalizzate che vuoi aggiungere alla richiesta (nel formatoNome: Valore
)HTTP_PROXY
: Imposta l’URL del proxy HTTPHTTPS_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)