> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Guida all'uso di Claude Code per VS Code > Claude Code 集成指南 - Ace Data Cloud Claude Code è uno strumento di **Agentic Coding** lanciato da Anthropic, ed è considerato uno dei più potenti agenti di programmazione al mondo. L'estensione di Claude Code per VS Code offre un'interfaccia grafica nativa, supporta la visualizzazione inline dei Diff, le citazioni con `@`-mentions, le revisioni pianificate e altre funzionalità, ed è il modo consigliato per utilizzare Claude Code in VS Code. Questo documento descrive principalmente come configurare e utilizzare l'estensione Claude Code in VS Code tramite il servizio proxy di AceData Cloud. ## Processo di richiesta Per utilizzare Claude Code, puoi prima andare alla [pagina del servizio Claude Messages](https://platform.acedata.cloud/documents/claude-messages) e cliccare sul pulsante "Acquire" per ottenere le credenziali necessarie per la richiesta: ![](https://cdn.acedata.cloud/nyq0xz.png) Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di login che ti invita a registrarti e accedere; dopo aver effettuato il login, verrai riportato automaticamente alla pagina corrente. Alla prima richiesta, verrà offerto un credito gratuito per provare il servizio Claude Code. ## Installazione del plugin ### Requisiti di sistema * VS Code 1.98.0 o versione superiore (supporta anche Cursor) ### Passaggi di installazione Nel marketplace delle estensioni di VS Code / Cursor, premi `Cmd+Shift+X` (Mac) o `Ctrl+Shift+X` (Windows/Linux) per aprire la vista delle estensioni, cerca **Claude Code**, trova il plugin ufficiale di Anthropic e clicca su "Install" per installarlo: ![Plugin Claude Code nel Marketplace di VS Code](https://cdn.acedata.cloud/10ddf71320.png) Puoi anche installarlo direttamente tramite i seguenti link: * [Link di installazione per VS Code](vscode:extension/anthropic.claude-code) * [Link di installazione per Cursor](cursor:extension/anthropic.claude-code) Dopo l'installazione, seleziona "Trust" nel messaggio di avviso per completare l'installazione. > Se l'estensione non appare dopo l'installazione, riavvia VS Code o esegui "Developer: Reload Window" nel pannello dei comandi. ## Configurazione dell'API di AceData Cloud La prima volta che apri il plugin, verrà richiesto di accedere all'account ufficiale di Anthropic. Possiamo saltare il login ufficiale e utilizzare l'API proxy di AceData Cloud, **senza necessità di abbonamento ufficiale**. ### Passo 1: Configurazione delle variabili d'ambiente Puoi scegliere di configurare le variabili d'ambiente in uno dei seguenti luoghi: **Opzione A: Configurazione a livello utente (applicabile a tutti i progetti)** Modifica `~/.claude/settings.json` (crealo se non esiste) e aggiungi la configurazione `env`, sostituendo `{token}` con il token API ottenuto dalla console di AceData Cloud: ```json theme={null} { "env": { "ANTHROPIC_AUTH_TOKEN": "{token}", "ANTHROPIC_BASE_URL": "https://api.acedata.cloud" } } ``` **Opzione B: Configurazione a livello di progetto (solo per il progetto corrente)** Crea `.claude/settings.json` nella directory principale del progetto (configurazione condivisa) o `.claude/settings.local.json` (configurazione personale, gitignored): ```json theme={null} { "env": { "ANTHROPIC_AUTH_TOKEN": "{token}", "ANTHROPIC_BASE_URL": "https://api.acedata.cloud" } } ``` > **Nota**: Il token API può essere visualizzato nella [console di AceData Cloud](https://platform.acedata.cloud/console). Il valore di `ANTHROPIC_AUTH_TOKEN` verrà automaticamente preceduto dal prefisso `Bearer` e inviato al server. La configurazione a livello di progetto ha la priorità su quella a livello utente. Si consiglia di utilizzare la configurazione condivisa `.claude/settings.json` per progetti di team, mentre le informazioni sensibili personali dovrebbero essere collocate in `.claude/settings.local.json`. ### Passo 2: Disabilitare il messaggio di login (opzionale) Se non desideri vedere il messaggio di login ogni volta che apri, puoi selezionare **Disable Login Prompt** nelle impostazioni di VS Code: Cerca "Claude Code login" nelle impostazioni, trova l'opzione **Disable Login Prompt** e selezionala. Dopo aver completato la configurazione, riapri il pannello del plugin Claude Code per iniziare a usarlo normalmente. ## Aprire il pannello di Claude Code Dopo aver installato e configurato, ci sono diversi modi per aprire Claude Code: | Metodo | Azione | | ------------------------------------- | -------------------------------------------------------------------------------------------------- | | **Barra degli strumenti dell'editor** | Clicca sull'icona ✦ Spark in alto a destra dell'editor (è necessario aprire un file) | | **Barra di stato** | Clicca su "✱ Claude Code" a destra della barra di stato in basso (non è necessario aprire un file) | | **Pannello comandi** | `Cmd+Shift+P` / `Ctrl+Shift+P`, cerca "Claude Code" | | **Scorciatoia** | `Cmd+Esc` (Mac) / `Ctrl+Esc` (Windows/Linux) per cambiare il focus | A differenza di strumenti come Cursor / Copilot che utilizzano una barra laterale, Claude Code utilizza per impostazione predefinita una **visualizzazione dell'area di editing** come area di chat, offrendo un'area visibile più ampia e una presentazione dei contenuti più ricca. Puoi anche trascinare il pannello nella barra laterale o in altre posizioni. ![Pannello di Claude Code in VS Code](https://cdn.acedata.cloud/b84b878420.jpg) ## Uso di base ### Interazione conversazionale Puoi interagire con Claude semplicemente digitando in linguaggio naturale nel pannello di Claude Code. Ad esempio: * "Aiutami ad analizzare l'architettura complessiva di questo progetto" * "Questo codice ha un bug, aiutami a sistemarlo" * "Rifattorizza questa funzione per migliorarne la leggibilità" * "Scrivi test unitari per questo modulo" Claude Code comprenderà automaticamente il contesto del tuo codice, analizzando e modificando attraverso i file. Quando Claude deve modificare un file, verrà visualizzata una vista di confronto Diff, e potrai scegliere di accettare o rifiutare la modifica. ![Conversazione e suggerimenti di Claude Code in VS Code](https://cdn.acedata.cloud/650377f5cc.png) ### Riferimenti contestuali Utilizzando il simbolo `@` nella conversazione, puoi fare riferimento a file o contesti specifici: * `@filename.py` — Riferimento a un file specifico (supporta il matching fuzzy) * `@src/components/` — Riferimento all'intera directory (richiede la barra finale) * `@terminal:name` — Riferimento all'output del terminale Selezionando il codice nell'editor e premendo `Option+K` (Mac) / `Alt+K` (Windows/Linux) puoi inserire rapidamente un riferimento `@` (ad esempio `@app.ts#5-10`). ### Comandi con barra Cliccando sull'icona `/` nella finestra di dialogo, o digitando direttamente `/`, puoi utilizzare una ricca gamma di funzionalità integrate: I comandi più comuni includono: | Comando | Funzione | | ---------- | ----------------------------- | | `/new` | Crea una nuova conversazione | | `/model` | Cambia modello | | `/compact` | Comprimi il contesto | | `/mcp` | Configura il servizio MCP | | `/config` | Apri le impostazioni | | `/usage` | Visualizza l'uso | | `/memory` | Gestisci la memoria di Claude | | `/help` | Mostra informazioni di aiuto | ### Visualizzare la cronologia delle conversazioni Cliccando sul menu a discesa in cima al pannello puoi visualizzare la cronologia delle conversazioni, supportando la ricerca per parole chiave e la navigazione per intervallo di tempo (Oggi, Ieri, Ultimi 7 giorni, ecc.), facilitando il recupero dei contenuti delle interazioni precedenti. Cliccando su qualsiasi conversazione puoi ripristinare l'intera cronologia dei messaggi. ### Revisionare le modifiche al codice Quando Claude deve modificare un file, verrà visualizzata una vista di confronto Diff, mostrando il confronto tra il codice originale e quello modificato. Puoi scegliere di accettare o rifiutare ogni modifica, oppure puoi dire a Claude quale approccio diverso desideri: ![Vista di confronto Diff in VS Code](https://cdn.acedata.cloud/c42381ea9f.png) ### Modalità di autorizzazione Puoi cambiare diverse modalità di autorizzazione tramite l'indicatore di modalità in fondo al pannello: | Modalità | Descrizione | | ----------------------- | -------------------------------------------------------------------------------------------------------- | | **Default (Chiedi)** | Chiede conferma prima di ogni operazione (predefinito) | | **Piano** | Claude prima elabora un piano in attesa di approvazione, esegue solo dopo conferma | | **accettaModifiche** | Accetta automaticamente le modifiche ai file, ma i comandi del terminale devono ancora essere confermati | | **saltaAutorizzazioni** | Salta tutti i messaggi di autorizzazione, completamente automatizzato (usare con cautela) | ### Sessioni multiple in parallelo Utilizzando **Apri in nuova scheda** o **Apri in nuova finestra** nel pannello comandi, puoi avviare più conversazioni indipendenti, ognuna delle quali mantiene una propria cronologia e contesto, permettendo di gestire compiti diversi in parallelo. ## Altre impostazioni ### Cambiare modello Claude Code supporta il cambio di diversi modelli, come Claude Sonnet, Claude Opus, ecc. Puoi configurarlo tramite il comando `/model` o nelle impostazioni del plugin sotto **Modello Selezionato**. ### Modalità automatica Nelle impostazioni del plugin puoi impostare **Modalità di Autorizzazione Iniziale** su `saltaAutorizzazioni`, attivandola Claude Code eseguirà modifiche ai file, comandi del terminale e altre operazioni senza conferma pop-up, realizzando un flusso di lavoro completamente automatizzato. Puoi anche impostarlo su `accettaModifiche` per ottenere una modalità semi-automatica che accetta automaticamente le modifiche ma richiede ancora conferma per i comandi del terminale. > **Nota**: Prima di attivare la modalità automatica, assicurati di comprendere i rischi, si consiglia di utilizzarla in ambienti di progetto fidati. ### Utilizzare CLI nel terminale Se preferisci uno stile da riga di comando, puoi selezionare **Usa Terminale** nelle impostazioni di VS Code, Claude Code verrà eseguito in modalità CLI nel terminale integrato. Puoi anche aprire direttamente il terminale integrato di VS Code e eseguire il comando `claude`. ## Domande frequenti ### Cosa fare se la connessione fallisce? 1. Assicurati che la configurazione delle variabili ambientali in `~/.claude/settings.json` o `.claude/settings.json` sia corretta, in particolare `ANTHROPIC_AUTH_TOKEN` e `ANTHROPIC_BASE_URL` 2. Verifica che il token API sia valido (puoi controllarlo nella [console](https://platform.acedata.cloud/console)) 3. Controlla che la connessione di rete sia normale, assicurati di poter accedere a `https://api.acedata.cloud` 4. Riavvia VS Code e riprova ### L'icona Spark non appare? 1. Assicurati di aver aperto un file (aprire solo una cartella non è sufficiente) 2. Verifica che la versione di VS Code sia 1.98.0 o superiore 3. Esegui "Developer: Ricarica Finestra" nel pannello comandi 4. Oppure clicca direttamente sull'icona "✱ Claude Code" nella barra di stato in basso ### Come vedere il credito rimanente? Accedi alla [console di AceData Cloud](https://platform.acedata.cloud/console) per visualizzare il credito rimanente e l'utilizzo attuale del tuo account. ## Scopri di più * 📖 [Documentazione ufficiale di Claude Code per VS Code](https://code.claude.com/docs/en/vs-code) * ⌨️ [Riferimento ai comandi e scorciatoie di VS Code](https://code.claude.com/docs/en/vs-code#vs-code-commands-and-shortcuts) * 🔧 [Servizio Claude Code di AceData Cloud](https://platform.acedata.cloud/documents/claude-messages) * 💬 Se hai domande, non esitare a contattarci tramite il servizio clienti della piattaforma