Doctor

Il bottone rosso Doctor nell’header, accanto ad Aggiorna, controlla la tua configurazione di Claude Code e mostra in una finestra cosa sistemare. Parte solo quando lo premi: nessun controllo automatico in background.

Cosa controlla

• claude doctor: il controllo ufficiale di Claude Code, lanciato nella tua home e nei progetti tracciati che hanno una cartella .claude o un file .mcp.json (fino a 8). Installazione, PATH, versione e aggiornamenti automatici, file settings.json e .mcp.json non validi, Portachiavi su macOS. Le voci restano nel testo originale di Claude Code, in inglese.
• Link rotti in ~/.claude/skills, agents e commands.
• Front matter di skill e agent: nome o descrizione mancanti. Contano sia le tue voci sia quelle dei plugin attivi (queste le corregge l’autore del plugin: puoi aprirle o ignorarle). Le voci di un plugin spento non contano, perché Claude Code non le carica.

Skill, agent e comandi con un problema sono gli stessi che trovi nel filtro Warning della sezione Skill e nel KPI Health issues della Dashboard: un click sul KPI apre il Doctor.

• Server MCP in errore o da autenticare.
• Hook che richiedono un programma non installato.

Dopo il controllo il bottone mostra un badge con il numero di problemi. Riaprendo la finestra vedi subito l’ultimo risultato, che si aggiorna in sottofondo (compare “Aggiornamento…”).

Quali cartelle controlla

claude doctor legge le impostazioni della cartella in cui gira. Per questo CLACOROO lo lancia nella tua cartella personale e in ogni progetto tracciato (fino a 8) che ha una cartella .claude o un file .mcp.json. I progetti tracciati sono quelli che hai aggiunto tu con il bottone Progetto nell’header: non sono ricavati da cosa hai fatto in passato, e un progetto non tracciato non viene controllato.

In fondo alla finestra, Cartelle controllate mostra dove è girato:

• la cartella personale e i progetti tracciati, ciascuno con l’esito: controllata, saltata (non ha configurazione, oppure oltre il limite di 8) o la cartella non esiste più. Il bottone Rimuovi toglie il progetto dall’elenco;
• Progetti con configurazione non controllati: i progetti che Claude Code ha usato di recente e che non sono tracciati, dal più recente, con le sessioni e l’ultimo uso. Aggiungi li include nei prossimi controlli. Non compaiono la cartella personale, le cartelle temporanee e quelle nascoste nella home, come le sessioni di servizio di altri strumenti.

I progetti tracciati si gestiscono anche dal bottone Progetti nell’header: la finestra li elenca, permette di aggiungerli o rimuoverli e, cliccando un progetto, mostra solo plugin, skill, agent, comandi e server MCP che ha in locale. Un link Gestisci progetti è anche in Impostazioni.

Per caricare skill e plugin solo nei progetti che li usano vedi Progetti.

Cosa puoi fare per ogni voce

Azione	Quando
Correggi	Correzioni sicure e reversibili, con conferma. Oggi sposta nel Cestino un link rotto
Apri file	Un file di impostazioni non valido da correggere a mano
Copia comando	Un comando di shell suggerito da Claude Code, per esempio la riga del PATH. CLACOROO non lo esegue al posto tuo
Esegui	Un comando claude suggerito, per esempio claude install: parte nel terminale integrato, dove vedi cosa succede
Apri / Vai a	Apre la skill da sistemare, oppure la sezione MCP o Hook
Ignora	Nasconde la voce e la toglie dal conteggio, anche nel KPI della Dashboard; la scelta resta salvata. Quando il problema sparisce, la voce ignorata viene tolta da sola, così se torna la rivedi. Mostra ignorati le fa ricomparire, con Ripristina

Correggi tutto applica insieme le correzioni sicure, dopo una conferma che le elenca. Non modifica file di configurazione, CLAUDE.md o la shell. Lascia così chiude la finestra senza cambiare niente.

Con Claude

Il comando /doctor dentro una sessione di Claude Code fa un checkup più ampio (estensioni non usate, CLAUDE.md da snellire, permessi) e propone correzioni che approvi una per una. Usa il modello, quindi consuma quota.

Con Claude apre una sessione nel terminale integrato e mette /doctor negli appunti: incollalo quando la sessione è pronta e premi Invio. CLACOROO non lo lancia da solo perché Claude Code può prima chiederti se ti fidi della cartella.

Casi limite

• claude doctor non risponde. CLACOROO non trova il binario di Claude Code: imposta il percorso in Impostazioni.
• Il controllo richiede qualche secondo. Verifica anche lo stato dei server MCP, che vengono avviati per il test.
• Compare «output non riconosciuto». Il formato di claude doctor è cambiato in una nuova versione di Claude Code: guarda Output completo per il testo originale.
• Una voce non è chiara. Output completo mostra il testo originale di claude doctor per ogni cartella controllata.

Correlati

• Skill e Agent: front matter, link rotti, eliminazione
• Server MCP: autenticazione e cause degli errori
• Hook: programmi richiesti dagli hook
• Claude Config: impostazioni e permessi