Installazione
CLACOROO esce con installer nativi per macOS, Windows e Linux. Questa pagina copre il download del file giusto e l’installazione. CLACOROO è firmata con un certificato Apple Developer, quindi macOS chiede conferma solo la prima volta. Windows SmartScreen può mostrare un avviso perché l’installer non ha ancora un certificato EV.
Prima di installare
Servono:
- Claude Code installato e raggiungibile dalla tua shell
PATH. CLACOROO è una UI sopra Claude Code, non un sostituto. - Node.js 18 o successivo. Lo richiede Claude Code stesso; CLACOROO lo usa per invocare la CLI per tuo conto.
Se non hai ancora Claude Code, installalo prima da claude.com/claude-code.
Download
Apri la pagina Download. Scegli l’installer per la tua piattaforma e architettura:
| Piattaforma | File |
|---|---|
| macOS Apple Silicon | CLACOROO-x.y.z-arm64.dmg |
| macOS Intel | CLACOROO-x.y.z-x64.dmg |
| Windows installer | CLACOROO Setup x.y.z.exe (x64 + arm64) |
| Windows portable | CLACOROO x.y.z.exe (x64, senza installer) |
| Linux universale | CLACOROO-x.y.z.AppImage |
| Debian / Ubuntu | clacoroo_x.y.z_amd64.deb |
| Fedora / RHEL | clacoroo-x.y.z.x86_64.rpm |
Ogni bottone di download punta all’ultima release GitHub, così ottieni sempre una build aggiornata.
macOS
Homebrew (consigliato)
Se usi Homebrew, un solo comando installa CLACOROO e gestisce per te il blocco di sicurezza al primo avvio:
brew install --cask maxymize/clacoroo/clacoroo
Aggiunge il tap maxymize/clacoroo e installa automaticamente la build più recente per la tua architettura (Apple Silicon o Intel). Aggiorni in seguito con:
brew update && brew upgrade --cask clacoroo
brew update aggiorna prima la definizione del cask (così Homebrew vede la nuova versione), poi brew upgrade la installa.
Poiché il cask rimuove il flag di quarantena durante l’installazione, eviti del tutto l’avviso “sviluppatore non identificato”. Se preferisci il download manuale, usa il .dmg — vedi sotto.
Installazione manuale (.dmg)
- Doppio click sul
.dmgscaricato - Trascina CLACOROO nella cartella Applicazioni
- Doppio click su CLACOROO per aprirla
- macOS mostra una finestra una tantum: “CLACOROO” è un’app scaricata da internet. Confermi di volerla aprire? — clicca Apri
- Da qui in poi, CLACOROO si apre come qualsiasi altra app
Apple Silicon vs Intel
Se hai un Mac con chip Apple (M1 e successivi), scegli la build arm64. Su un Mac Intel, scegli x64. Quello sbagliato rifiuterà di partire o girerà sotto Rosetta 2 senza benefici.
Windows
Installer (consigliato)
- Doppio click su
CLACOROO Setup x.y.z.exe - Windows SmartScreen mostra “Windows ha protetto il PC” — clicca Ulteriori informazioni poi Esegui comunque
- Scegli la posizione di installazione (o accetta il default) e clicca Installa
- CLACOROO si apre al primo avvio e la scorciatoia arriva nel menu Start e sul desktop
Portable
- Doppio click su
CLACOROO x.y.z.exe - Stesso warning SmartScreen — Ulteriori informazioni poi Esegui comunque
- L’app gira senza installare nulla; nessuna voce nel menu Start, niente in Aggiungi/Rimuovi programmi
La build portable è utile quando non puoi installare software sulla macchina, o quando vuoi tenere CLACOROO su una chiavetta USB.
x64 vs arm64
L’installer contiene sia binari x64 che arm64 e sceglie quello giusto per la tua macchina in automatico. La build portable è solo x64.
Linux
AppImage (universale)
- Rendi il file eseguibile:
chmod +x CLACOROO-x.y.z.AppImage - Doppio click, o lancialo da terminale:
./CLACOROO-x.y.z.AppImage - Opzionalmente integralo col desktop usando uno strumento come AppImageLauncher
.deb (Debian, Ubuntu, derivati)
sudo dpkg -i clacoroo_x.y.z_amd64.deb
sudo apt -f install # in caso di dipendenze mancanti
Dopo l’install trovi CLACOROO nel tuo launcher di applicazioni.
.rpm (Fedora, RHEL, openSUSE)
sudo rpm -i clacoroo-x.y.z.x86_64.rpm
# o, su Fedora:
sudo dnf install ./clacoroo-x.y.z.x86_64.rpm
Dopo l’install
- Apri CLACOROO
- Il tour di onboarding ti accompagna per le sezioni principali
- Collega il tuo account Claude dalle Impostazioni (o, in alternativa, aggiungi una chiave API Anthropic) — vedi Account Claude
- Aggiungi il tuo primo marketplace — vedi Quick start · 3 · Aggiungi un marketplace
Aggiornamenti
CLACOROO controlla gli aggiornamenti all’avvio e mostra un banner quando una nuova versione è disponibile.
- macOS / Windows: scarica il nuovo installer dalla pagina Download e lancialo — le tue impostazioni e lo stato di CLACOROO sono preservati.
- Linux: stessa idea — scarica il nuovo
.AppImage/.deb/.rpme sostituisci il precedente.
CLACOROO non si aggiorna mai in silenzio; resti in controllo di quando arriva la nuova versione.
Disinstallazione
- macOS — trascina CLACOROO da Applicazioni nel Cestino. Pulizia opzionale: rimuovi
~/Library/Application Support/CLACOROO/. - Windows — Impostazioni → App → CLACOROO → Disinstalla (o lancia di nuovo l’installer e scegli Disinstalla). La build portable non richiede disinstallazione; cancella semplicemente l’
.exe. - Linux (.deb) —
sudo apt remove clacoroo - Linux (.rpm) —
sudo rpm -e clacoroo(osudo dnf remove clacoroo) - Linux (AppImage) — cancella semplicemente l’
.AppImage
Disinstallare CLACOROO non tocca la tua configurazione Claude Code — ogni file in ~/.claude/ resta dov’è, esattamente come Claude Code se lo aspetta.
Risoluzione problemi
- Toast “claude not found” al primo avvio. CLACOROO non trova il binario
claudenel tuoPATH. Vedi Risoluzione problemi. - macOS continua a rifiutare di aprire dopo aver cliccato Apri. Controlla Impostazioni di sistema → Privacy e sicurezza; c’è un bottone Apri comunque in fondo.
- Windows SmartScreen blocca l’installer senza il link “Esegui comunque”. Una group policy l’ha disabilitato. Disabilita SmartScreen temporaneamente in Impostazioni → Privacy e sicurezza → Sicurezza di Windows, o contatta l’admin IT.
- L’AppImage Linux non si apre col doppio click. Alcuni desktop richiedono AppImageLauncher; installalo e riprova.
Correlati
- Download — link diretti agli ultimi installer
- Quick start — primo avvio e introduzione
- Risoluzione problemi — problemi comuni e fix