CLACOROO
EN IT
Scarica

Risoluzione problemi e FAQ

Questa è la pagina catch-all. Se qualcosa non funziona come ti aspetti, cerca il sintomo qui prima — poi salta alla pagina della funzionalità rilevante per il contesto.

Installazione

”Windows ha protetto il PC” sull’installer

Clicca Ulteriori informazioni, poi Esegui comunque. CLACOROO è firmato con un certificato ad-hoc, non un Developer ID Microsoft / Apple a pagamento. Il warning del primo avvio è l’unico attrito; i lanci successivi sono silenziosi.

macOS: “CLACOROO non può essere aperto perché lo sviluppatore non può essere verificato”

Chiudi il dialog, click destro su CLACOROO in Applicazioni, scegli Apri. Clicca Apri di nuovo nel dialog successivo. Da qui in poi, si apre normalmente.

Se non vedi “Apri” sul click destro, vai a Impostazioni di sistema → Privacy e sicurezza; vicino al fondo trovi una sezione che elenca l’app bloccata con un bottone Apri comunque.

Linux: l’AppImage non parte

Rendila eseguibile: chmod +x CLACOROO-x.y.z-arm64.AppImage. Se il tuo file manager rifiuta di aprirla col doppio click, lanciala da terminale: ./CLACOROO-x.y.z-arm64.AppImage. O installa AppImageLauncher per l’integrazione col desktop.

Se vedi un errore libfuse, installa FUSE 2 (sudo apt install libfuse2 su Ubuntu).

Primo avvio

Toast “claude not found”

CLACOROO non trova il binario claude nel tuo PATH di shell.

  • macOS / Linux: apri un terminale, lancia which claude. Se non torna nulla, Claude Code non è installato (ancora). Installalo da claude.com/claude-code.
  • Windows: apri PowerShell, lancia where.exe claude. Se non torna nulla, Claude Code manca o non è nel tuo PATH. CLACOROO cerca claude.exe specificamente in %USERPROFILE%\.local\bin; assicurati che quella cartella esista e contenga claude.exe, poi riavvia CLACOROO.

Dopo aver sistemato questo, clicca Aggiorna nella topbar di CLACOROO — il toast dovrebbe sparire e la Dashboard popolarsi.

La Dashboard è vuota

O:

  • Claude Code è appena installato (nessuna sessione, nessun plugin) — è atteso; quando inizi a usarlo, i numeri appariranno
  • CLACOROO non ha accesso in lettura a ~/.claude/ (o %APPDATA%\Claude\ su Windows) — controlla i permessi della cartella

Il tour di onboarding non è apparso

Parte una sola volta al primo lancio. Riavvialo da Impostazioni → Onboarding o Cmd/Ctrl + K → “Riavvia tour”.

Account e quote

”Login a claude.ai” non fa nulla

CLACOROO apre il terminale integrato con claude login precaricato — se non vedi il drawer del terminale aprirsi, è nascosto. Premi il tasto backtick (Cmd / Ctrl + backtick, il tasto sopra al Tab) per farlo apparire.

Se il comando parte ma il flusso OAuth si blocca, l’URL di callback potrebbe non raggiungere la tua macchina. Usa la variante device-code: nel terminale, scrivi claude login --headless e segui l’URL stampato.

Le quote mostrano — anche se sono loggato

Claude Code non ha ancora ricevuto una risposta di quota fresca. Manda un messaggio in una sessione Claude Code, poi clicca Aggiorna nel pannello account.

La chiave API funziona al test ma Claude Code non la usa

Verifica cosa Claude Code è configurato per usare: nel terminale integrato, lancia claude config get apiKeyHelper. Il path dovrebbe puntare al file helper di CLACOROO. Se punta altrove, lancia Test connessione poi Salva chiave di nuovo per ri-registrare.

Le notifiche non appaiono

Vedi Notifiche quota · Casi limite. La causa più comune è “Non disturbare” o focus mode. Testa col bottone Test notifica; se il toast in-app appare ma nessuna notifica di sistema segue, è un problema di permessi a livello OS.

Plugin, marketplace, skill, agent

Toast “Aggiornamento plugin fallito”

Apri il terminale integrato e lancia lo stesso comando che CLACOROO ha provato (visibile nel toast di errore al hover). La CLI stampa l’errore completo: di solito un problema di raggiungibilità del marketplace o un conflitto di versione.

Un plugin riappare dopo Rimuovi

È fissato dal settings.json o da un CLAUDE.md padre. Apri Claude Config per ispezionare, o leggi ~/.claude/settings.json direttamente.

”Marketplace già esistente” all’aggiunta

Hai già aggiunto questa sorgente sotto un alias diverso. Apri la card esistente invece di provare ad aggiungere un duplicato.

Una skill o un agent mostra health: error

Il suo front matter o uno dei suoi blocchi Markdown è malformato. Apri la sezione Skill o Agent, clicca il titolo dell’elemento; il modal di anteprima mostra la riga dell’errore di parse.

Server MCP

Un server resta su “Connessione…”

Il transport potrebbe essere sbagliato, o l’endpoint è irraggiungibile. Clicca il badge di stato sulla card per vedere l’ultimo errore grezzo di Claude Code. Spesso: URL sbagliato, header di auth mancante, o hai scelto http quando il server parla solo stdio.

”Auth richiesta” non sparisce dopo l’autenticazione

Clicca Pulisci auth cache sulla card, poi Aggiorna. Se lo stato resta incollato:

  • Per server OAuth, fai logout e login di nuovo a claude.ai
  • Per server token-based, modifica la registrazione (in claude_desktop_config.json) per assicurarti che il token giusto sia nell’header giusto

Non riesco a rimuovere un server

Puoi rimuovere solo server aggiunti dall’utente. I server built-in o forniti da plugin sono gestiti altrove — disabilita il plugin che li possiede invece.

Hook

Un hook continua a dire “dep mancante”

Claude Code risolve i tool via PATH. Se hai installato il tool ma il badge resta giallo:

  • Riavvia CLACOROO così il nuovo PATH è recepito
  • Verifica che il nome del tool matchi esattamente (jq vs JQ è significativo su filesystem case-sensitive)
  • Apri il terminale integrato e lancia which <tool> per verificare

Un hook si attiva più volte

Due plugin forniscono lo stesso matcher sullo stesso evento. Filtra la sezione Hook per evento per vedere i duplicati affiancati; disattiva uno dei plugin contributori se non vuoi entrambi.

Hook elencati ma niente sembra girare

Controlla il badge dipendenze prima (dep mancante = no-op silenzioso). Poi verifica che il plugin che possiede l’hook sia attivo in Gestione plugin — i plugin disattivati elencano comunque i loro hook, ma non si attivano.

Terminale

Le tab dicono “exited” subito

La tua shell di default non è disponibile, o la tua variabile env $SHELL punta a un binario inesistente. Apri un terminale di sistema, controlla echo $SHELL, e sistemalo (/bin/zsh, /bin/bash, ecc.).

L’input non arriva alla shell

Clicca dentro l’area del terminale per dargli focus. Se non è quello, la shell potrebbe essere uscita — apri una nuova tab.

La paste è troncata

Alcune shell limitano la dimensione della paste o interpretano i newline in modo scorretto. Usa la modalità bracketed paste (la maggior parte delle shell moderne: printf '\e[?2004h' per abilitarla), o salva lo snippet in un file e cat da lì.

Impostazioni e config

Cambiare un’impostazione non sembra avere effetto

La maggior parte delle impostazioni si applica all’inizio della prossima sessione Claude Code. Inizia una sessione fresca in Claude Code e riprova.

settings.json ha un errore di parse

CLACOROO mostrerà l’errore nella sezione Claude Config. Apri il file nell’editor di tua scelta (il path è mostrato nella descrizione di ogni riga), sistema il JSON, salva. CLACOROO lo recepisce al prossimo refresh.

Aggiornamenti

CLACOROO offre una nuova versione, ma non voglio aggiornare ora

Chiudi il banner. La prossima volta che lanci l’app, riapparirà — non c’è un toggle “salta questa versione”, per design.

Dopo l’update, le mie impostazioni sono sparite

Gli update di CLACOROO preservano tutto lo stato (database, impostazioni, snapshot). Se tutto sembra resettato, controlla:

  • Hai aperto il binario giusto (specialmente su Linux dove gli AppImage non sostituiscono automaticamente il precedente)
  • La tua cartella dati CLACOROO esiste ancora (~/Library/Application Support/CLACOROO/ su macOS, %APPDATA%\CLACOROO\ su Windows, ~/.config/clacoroo/ su Linux)

Come torno a una versione precedente?

Scarica l’installer più vecchio dalla pagina release GitHub e lancialo. Lo stato di CLACOROO è backward-compatible tra le versioni recenti.

Dove chiedere aiuto

  • GitHub issues: github.com/Maxymize/clacoroo/issues — il posto migliore per bug report e feature request
  • CLAUDE.md (nel repo): i contributor trovano architettura e convenzioni documentate lì

Quando segnali un problema, includi:

  • Il tuo OS e la versione di CLACOROO (visibile in fondo alla sidebar)
  • I passi esatti che hai fatto
  • Il messaggio d’errore (testo completo o screenshot)
  • Se la stessa operazione funziona da CLI (claude ... nel terminale integrato)

Inviare feedback dall’app

Dalla v1.1.23 c’è un bottone Feedback nel footer della sidebar, vicino al numero di versione. Cliccandolo si apre il modulo di feedback sul sito nel tuo browser, già impostato sulla lingua dell’app. Scegli un tipo — Bug, Nuova funzione, Domanda o Altro — e descrivi cosa hai riscontrato. Le segnalazioni tecniche diventano issue pubbliche anonime su GitHub: nome ed email vengono usati in privato solo per poterti rispondere, e non compaiono mai nella issue pubblica.

Correlati