Passaggio 1: ottieni l'errore effettivo
claude --version # is the CLI there at all?
claude # start it directly: the real error prints here
claude doctor # install health checkSe il terminale funziona e solo l'estensione o l'app non funziona, il problema è l'ambiente da cui viene avviato il wrapper (PATH, versione di Node, variabili del proxy), non Claude Code stesso. Se anche il terminale non funziona, il messaggio che mostra è quello da cercare.
Cause note (dal sistema di tracciamento delle segnalazioni)
- Ripresa di una sessione in background in VS Code. L'apertura di una sessione avviata con
claude --bggenera esattamente questo errore — segnalato su macOS, Windows e Linux (#77162). Interrompi prima l'agente in background oppure apri una nuova sessione. - Windows: processo orfano dopo un arresto anomalo. L'app non riesce a riavviarsi perché un vecchio processo mantiene ancora un blocco (#42776, #53247). Termina i processi
clauderimasti in Gestione attività; la soluzione affidabile segnalata è un riavvio completo di Windows. - App desktop su Apple Silicon che non funziona a ogni avvio di sessione, mentre la CLI funziona (#59866, un duplicato di un problema noto) — aggiorna l'app; nel frattempo usa la CLI in un terminale.
- Node.js precedente a 18 o un PATH danneggiato dopo un'installazione tramite npm — il wrapper non riesce ad avviare la CLI.
node -v; passa al programma di installazione nativo per eliminare la dipendenza da Node. - `~/.claude/settings.json` non valido. Una virgola fuori posto in un blocco di hook o autorizzazioni fa terminare immediatamente la CLI. Verifica la validità di JSON.
- Shell non corrispondente su Windows — uno strumento PowerShell che non funziona da Git Bash con un modello specifico (#87980); prova l'altra shell.
Se nessuno dei casi precedenti si applica
- Aggiorna tutto:
claude update, e aggiorna l'estensione VS Code o l'app desktop. - Reinstalla con il programma di installazione nativo (
curl -fsSL https://claude.ai/install.sh | bash, oppure i comandi su una sola riga per PowerShell / CMD nella guida all'installazione). - Avvia VS Code da un terminale affinché erediti lo stesso ambiente della CLI funzionante.
- Apri una nuova segnalazione con l'output di
claude doctor— il sistema di tracciamento valuta rapidamente gli arresti anomali.
Contenuti correlati
Se Claude Code si avvia ma poi si interrompe con un errore API, si tratta di un problema diverso: vedi Errore API 500, sovraccarico / 529, Errore API 400 o Errori OAuth. Per l'estensione in particolare, vedi Claude Code in VS Code.
Stanco di lottare con questo problema?
Esegui invece Claude Code tramite il gateway di AI Prime Tech: gli stessi modelli Claude sugli account a monte del gateway, due variabili d'ambiente per passare al gateway, e i nuovi account ricevono $5 di credito API gratuito con il codice FIXIT — senza carta.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyDomande frequenti
Che cosa significa 'Il processo Claude Code è terminato con il codice 1'?
L'estensione VS Code o l'app desktop ha avviato la CLI di Claude Code, che è terminata con un errore. Esegui claude in un terminale per vedere il messaggio di errore effettivo.
Come risolvo la terminazione di Claude Code con il codice 1 su Windows?
Termina i processi claude rimasti (oppure riavvia Windows se l'app non si riavvia), controlla node -v e PATH, verifica la validità di ~/.claude/settings.json e, se necessario, reinstalla con il programma di installazione nativo.
Perché Claude Code funziona nel terminale ma non in VS Code?
VS Code è stato avviato con un ambiente diverso (PATH, Node, variabili del proxy). Avvia VS Code dal terminale in cui claude funziona oppure correggi le variabili nel profilo della shell.
Esegui Claude Code sul gateway
Stessi modelli, due variabili d'ambiente, crediti pari a 7.69231× il valore nominale — oppure un piano illimitato a tariffa fissa. Nuovi account: $5 di credito API gratuito con il codice FIXIT.
Ottieni una chiave API Scopri i piani illimitatiAI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway.