Vai al contenuto principale
Questa pagina fornisce una panoramica delle opzioni di distribuzione disponibili e ti aiuta a scegliere la configurazione giusta per la tua organizzazione.

​
Confronto dei provider

FunzionalitàAnthropicAmazon BedrockGoogle Vertex AI
RegioniPaesi supportatiPiù regioni AWSPiù regioni GCP
Prompt cachingAbilitato per impostazione predefinitaAbilitato per impostazione predefinitaAbilitato per impostazione predefinita
AutenticazioneChiave APICredenziali AWS (IAM)Credenziali GCP (OAuth/Service Account)
Tracciamento dei costiDashboardAWS Cost ExplorerFatturazione GCP
Funzionalità aziendaliTeam, monitoraggio dell’utilizzoPolitiche IAM, CloudTrailRuoli IAM, Cloud Audit Logs

​
Provider cloud

Amazon Bedrock

Utilizza i modelli Claude attraverso l’infrastruttura AWS con autenticazione basata su IAM e monitoraggio nativo di AWS

Google Vertex AI

Accedi ai modelli Claude tramite Google Cloud Platform con sicurezza e conformità di livello aziendale

​
Infrastruttura aziendale

Enterprise Network

Configura Claude Code per funzionare con i server proxy della tua organizzazione e i requisiti SSL/TLS

LLM Gateway

Distribuisci l’accesso centralizzato ai modelli con tracciamento dell’utilizzo, budgeting e registrazione di audit

​
Panoramica della configurazione

Claude Code supporta opzioni di configurazione flessibili che ti permettono di combinare diversi provider e infrastrutture:
Comprendi la differenza tra:
  • Proxy aziendale: Un proxy HTTP/HTTPS per l’instradamento del traffico (impostato tramite HTTPS_PROXY o HTTP_PROXY)
  • LLM Gateway: Un servizio che gestisce l’autenticazione e fornisce endpoint compatibili con il provider (impostato tramite ANTHROPIC_BASE_URL, ANTHROPIC_BEDROCK_BASE_URL o ANTHROPIC_VERTEX_BASE_URL)
Entrambe le configurazioni possono essere utilizzate insieme.

​
Utilizzo di Bedrock con proxy aziendale

Instrada il traffico Bedrock attraverso un proxy HTTP/HTTPS aziendale: 
# Abilita Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

# Configura proxy aziendale
export HTTPS_PROXY='https://proxy.example.com:8080'

​
Utilizzo di Bedrock con LLM Gateway

Utilizza un servizio gateway che fornisce endpoint compatibili con Bedrock: 
# Abilita Bedrock
export CLAUDE_CODE_USE_BEDROCK=1

# Configura gateway LLM
export ANTHROPIC_BEDROCK_BASE_URL='https://your-llm-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1  # Se il gateway gestisce l'autenticazione AWS

​
Utilizzo di Vertex AI con proxy aziendale

Instrada il traffico Vertex AI attraverso un proxy HTTP/HTTPS aziendale: 
# Abilita Vertex
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

# Configura proxy aziendale
export HTTPS_PROXY='https://proxy.example.com:8080'

​
Utilizzo di Vertex AI con LLM Gateway

Combina i modelli Google Vertex AI con un gateway LLM per la gestione centralizzata: 
# Abilita Vertex
export CLAUDE_CODE_USE_VERTEX=1

# Configura gateway LLM
export ANTHROPIC_VERTEX_BASE_URL='https://your-llm-gateway.com/vertex'
export CLAUDE_CODE_SKIP_VERTEX_AUTH=1  # Se il gateway gestisce l'autenticazione GCP

​
Configurazione dell’autenticazione

Claude Code utilizza ANTHROPIC_AUTH_TOKEN per l’intestazione Authorization quando necessario. I flag SKIP_AUTH (CLAUDE_CODE_SKIP_BEDROCK_AUTH, CLAUDE_CODE_SKIP_VERTEX_AUTH) vengono utilizzati negli scenari di gateway LLM in cui il gateway gestisce l’autenticazione del provider.

​
Scelta della giusta configurazione di distribuzione

Considera questi fattori quando selezioni il tuo approccio di distribuzione:

​
Accesso diretto al provider

Ideale per le organizzazioni che:
  • Desiderano la configurazione più semplice
  • Hanno infrastruttura AWS o GCP esistente
  • Hanno bisogno di monitoraggio e conformità nativi del provider

​
Proxy aziendale

Ideale per le organizzazioni che:
  • Hanno requisiti di proxy aziendale esistenti
  • Hanno bisogno di monitoraggio del traffico e conformità
  • Devono instradare tutto il traffico attraverso percorsi di rete specifici

​
LLM Gateway

Ideale per le organizzazioni che:
  • Hanno bisogno di tracciamento dell’utilizzo tra i team
  • Desiderano passare dinamicamente tra i modelli
  • Richiedono limitazione della velocità personalizzata o budget
  • Hanno bisogno di gestione dell’autenticazione centralizzata

​
Debug

Quando esegui il debug della tua distribuzione:
  • Utilizza il comando slash claude /status. Questo comando fornisce visibilità su qualsiasi autenticazione, proxy e impostazioni URL applicate.
  • Imposta la variabile di ambiente export ANTHROPIC_LOG=debug per registrare le richieste.

​
Best practice per le organizzazioni

​
1. Investire in documentazione e memoria

Ti consigliamo vivamente di investire nella documentazione in modo che Claude Code comprenda il tuo codebase. Le organizzazioni possono distribuire file CLAUDE.md a più livelli:
  • A livello di organizzazione: Distribuisci in directory di sistema come /Library/Application Support/ClaudeCode/CLAUDE.md (macOS) per gli standard aziendali
  • A livello di repository: Crea file CLAUDE.md nelle radici dei repository contenenti l’architettura del progetto, i comandi di build e le linee guida per i contributi. Archivialo nel controllo del codice sorgente in modo che tutti gli utenti ne traggano vantaggio Scopri di più.

​
2. Semplificare la distribuzione

Se hai un ambiente di sviluppo personalizzato, riteniamo che creare un modo “con un clic” per installare Claude Code sia fondamentale per aumentare l’adozione in tutta l’organizzazione.

​
3. Iniziare con un utilizzo guidato

Incoraggia i nuovi utenti a provare Claude Code per domande e risposte sul codebase, o su correzioni di bug più piccole o richieste di funzionalità. Chiedi a Claude Code di fare un piano. Controlla i suggerimenti di Claude e fornisci feedback se non è sulla giusta strada. Nel tempo, man mano che gli utenti comprendono meglio questo nuovo paradigma, saranno più efficaci nel permettere a Claude Code di funzionare in modo più agenziale.

​
4. Configurare le politiche di sicurezza

I team di sicurezza possono configurare autorizzazioni gestite per ciò che Claude Code è e non è autorizzato a fare, che non può essere sovrascritto dalla configurazione locale. Scopri di più.

​
5. Sfruttare MCP per le integrazioni

MCP è un ottimo modo per fornire a Claude Code più informazioni, come la connessione a sistemi di gestione dei ticket o registri di errori. Ti consigliamo che un team centrale configuri i server MCP e archivi una configurazione .mcp.json nel codebase in modo che tutti gli utenti ne traggano vantaggio. Scopri di più. In Anthropic, confidiamo in Claude Code per alimentare lo sviluppo in ogni codebase di Anthropic. Speriamo che tu apprezzi l’utilizzo di Claude Code tanto quanto lo facciamo noi!

​
Passaggi successivi