Vai al contenuto principale

Claude Code FAQ

Aggiornato nell'ultima ora

Questo articolo è una raccolta di domande frequenti su Claude Code relative all'autenticazione, alle integrazioni, alla configurazione e altro ancora. Se sei interessato a saperne di più su Claude Code, consulta la nostra documentazione Claude qui: Panoramica di Claude Code.

Come configuro il single sign-on (SSO) per Claude Code?

Se stai configurando il single sign-on per un'organizzazione Claude Console, abbiamo istruzioni dettagliate qui: Configurazione del Single Sign-On su Claude Console. Se stai utilizzando Claude Code con un piano Enterprise, consulta questo articolo per le istruzioni di configurazione SSO: Configurazione del Single Sign-On (SSO) sul piano Enterprise.

C'è un modo per disabilitare l'accesso al modello Opus in tutta l'organizzazione in Claude Code?

Se sei un utente Claude Console, questo può essere configurato tramite il rate limiting nella tua organizzazione Console. Se stai utilizzando Bedrock o Vertex, imposta il limite di velocità Opus a 0 nelle impostazioni del tuo progetto Vertex/Bedrock. Nota che anche se disabilitato in Vertex, gli utenti potrebbero essere in grado di cambiare modelli in Claude Code, quindi il rate limiting è l'approccio più efficace.

Claude Code supporta l'integrazione dell'IDE Microsoft Visual Studio (non VS Code)?

Non esiste attualmente alcuna integrazione Visual Studio 2022. Claude Code supporta attualmente VS Code, Cursor (e altri fork di VS Code), Intellij, Pycharm (e altri IDE Jetbrains).

Come possiamo implementare l'automazione della revisione PR con Claude Code?

Sebbene non esista ancora una soluzione di revisore PR chiavi in mano, puoi utilizzare l'integrazione GitHub Actions di Claude Code per le revisioni automatizzate. Per ora, puoi utilizzare l'azione di revisione della sicurezza come modello e personalizzarla per le revisioni PR generali. Questo è anche un buon caso d'uso per l'SDK di Claude Code.

Ricevo un messaggio di errore che dice "Claude Max o Pro è richiesto per connettersi a Claude Code" ma dovrei avere accesso tramite il piano Team o Enterprise della mia organizzazione. Come posso risolvere i problemi?

Questo indica che hai selezionato il metodo di accesso sbagliato dalla schermata di configurazione di Claude Code. Prova a eseguire di nuovo /login e seleziona l'account associato al tuo indirizzo email di lavoro principale. Se non riesci ancora a connetterti, consulta Hai problemi a utilizzare il tuo account Team o Enterprise per accedere a Claude Code?

Quali dati vengono inviati ad Anthropic quando si utilizza Claude Code con le chiavi API Bedrock/Vertex?

Quando configurato con Bedrock/Vertex e CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC è impostato, viene inviata solo la telemetria essenziale. Tutte le richieste API del modello vanno direttamente ai tuoi endpoint Bedrock/Vertex. Consulta la documentazione del flusso di dati per i dettagli completi.

C'è un modo per accedere a Claude Code tramite Bedrock/Vertex senza esporre una chiave segreta/chiave di accesso?

Sì. Le nostre guide di configurazione per Bedrock e Vertex mostrano come puoi abilitare questa funzione. Ad esempio, nel caso di Bedrock puoi eseguire `aws configure` per configurare l'AWS CLI prima di aggiungere i config necessari ed eseguire Claude Code con Bedrock, oppure puoi utilizzare le chiavi API Bedrock, che è una nuova funzione di AWS che abilita le chiavi API per l'utilizzo di Bedrock che non richiedono credenziali AWS complete.

La finestra di contesto di 1M è disponibile in Claude Code e gli utenti verranno avvertiti dei prezzi più elevati?

Il supporto del contesto lungo è attualmente limitato ad alcuni utenti di Claude Code sui piani Max 20x, quindi è disponibile solo per un piccolo numero di utenti. La finestra di contesto di 1M non è ancora generalmente disponibile per tutti gli utenti di Claude Code, inclusi quelli che accedono a Claude tramite l'API.

Come possiamo distribuire Claude Code con variabili di ambiente personalizzate e autorizzazioni in tutta l'organizzazione?

Crea script wrapper che impostano le variabili di ambiente prima di eseguire Claude Code. Per le autorizzazioni, utilizza file .claude/settings.json con elenchi di consentimento/rifiuto. Nota che i pattern con caratteri jolly (*) non sempre corrispondono come previsto - testa accuratamente le autorizzazioni. I team Enterprise spesso iniettano file Claude.md standardizzati per configurazioni coerenti.

Claude Code ha il filtraggio del codice pubblico o le capacità di attribuzione nella roadmap?

No, il filtraggio del codice pubblico e le capacità di attribuzione non sono attualmente nella roadmap. Alcuni clienti utilizzano BlackDuck per la scansione del codice, anche se i feedback su costi e falsi positivi sono stati contrastanti. Siamo consapevoli che questo è un ostacolo per il ridimensionamento di Claude Code a più utenti e stiamo cercando soluzioni.

I subagent sono disponibili in Claude Code SDK e GitHub Actions?

I subagent sono disponibili tramite l'SDK di Claude Code. Non sono ancora integrati in GitHub Actions, ma lo stiamo considerando. L'UX comprime gli output quando più di tre subagent vengono eseguiti in parallelo per gestire la complessità.

I subagent possono essere configurati per utilizzare strumenti MCP specifici?

Sì, quando crei un subagent, puoi specificare a quali strumenti ha accesso utilizzando il campo `tools` nella configurazione. Nel file di configurazione del subagent, puoi omettere il campo tools per ereditare tutti gli strumenti dal thread principale, oppure puoi specificare singoli strumenti come elenco separato da virgole per un controllo più granulare. Scopri di più su questo nella nostra documentazione Claude: Subagent - Strumenti disponibili.

Come possiamo gestire i costi di Claude Code, soprattutto per i flussi di lavoro automatizzati?

Per i flussi di lavoro automatizzati come le revisioni della sicurezza, passa da Opus a Sonnet utilizzando l'opzione di configurazione claude --model <alias|name> per risparmiare sui costi. Puoi anche monitorare l'utilizzo tramite il dashboard della console e impostare limiti di velocità appropriati. Nota che puoi utilizzare Workspaces per impostare limiti di spesa più granulari per diversi gruppi di utenti. Leggi di più su Workspaces qui: Creazione e gestione di Workspaces in Claude Console. Ti consentiamo anche di visualizzare la spesa per chiave API nella Console. Consulta questo articolo per ulteriori informazioni: Rapporto su costi e utilizzo in Claude Console.

Claude Code può funzionare attraverso proxy aziendali come LiteLLM?

Sì, Claude Code supporta configurazioni di proxy aziendali purché supportino la specifica API di Anthropic. Segui le istruzioni di configurazione del proxy nella nostra documentazione Claude: Configurazione del proxy. I problemi comuni derivano da restrizioni di porta in ambienti limitati.

Come aggiungiamo utenti a Claude Code quando utilizziamo un account Console?

Aggiungi utenti direttamente alla tua organizzazione Console con un ruolo Claude Code User o Developer - è tutto ciò che serve. Gli utenti quindi eseguono /login da Claude Code e selezionano l'account Console desiderato. Non tentare di creare manualmente chiavi API nello spazio di lavoro di Claude Code.

Esiste una memoria basata su team o condivisione di conoscenze oltre i file Claude.md?

Attualmente, i file Claude.md sono il meccanismo principale. I team IT possono iniettare file Claude.md standardizzati nella directory .claude di ogni macchina per configurazioni a livello di organizzazione. Funzioni di memoria di team più avanzate sono in fase di esplorazione ma non ancora disponibili.

Come funzionano le autorizzazioni in Claude Code e perché i miei elenchi di consentimento non vengono rispettati?

Le autorizzazioni utilizzano la corrispondenza di pattern in .claude/settings.json o settings.local.json. La sintassi dei caratteri jolly può essere complicata - "Bash(atlassian-api:*)" dovrebbe funzionare ma potrebbe richiedere una corrispondenza esatta dei comandi. Utilizza "Sì, e non chiedere di nuovo per comandi simili" per costruire le autorizzazioni in modo incrementale. Controlla sia i file di impostazioni globali (~/.claude/settings.json) che quelli locali.

Claude Code indicizza l'intero codebase o utilizza un database vettoriale per archiviare informazioni sul mio codebase?

No. Claude Code ha accesso a un prompt di sistema e a una serie di strumenti che può utilizzare per navigare il tuo codebase su comando. Ad esempio, se Claude Code ha bisogno di comprendere qualcosa sul tuo codebase, utilizzerà uno strumento di ricerca per cercare nel tuo codebase e leggere i file su comando. Riteniamo che questo sia più efficace e flessibile dell'indicizzazione completa del codebase: Claude Code è davvero bravo a sapere come setacciare un codebase per raccogliere il contesto di cui ha bisogno al volo!

Claude Code può integrarsi con piattaforme CI/CD, controllo versione e osservabilità?

Sì, Claude Code si integra con GitHub Actions per CI/CD, supporta operazioni git e può connettersi a varie piattaforme tramite server MCP. Consulta la nostra documentazione Claude per ulteriori informazioni:

Perché vedo errori "Workflow validation failed" in GitHub Actions?

Questo si verifica in genere con flussi di lavoro riutilizzabili. Verifica che la sintassi del flusso di lavoro sia corretta e che tutti i parametri richiesti siano passati. Se l'errore persiste, segnala un problema qui con la configurazione del tuo flusso di lavoro: github.com/anthropics/claude-code-action.

Hai ricevuto la risposta alla tua domanda?