Manuale utente di Claush

Per iniziare

Claush è un'app che ti permette di controllare Claude Code — l'agente di programmazione AI più avanzato al mondo — dal tuo iPhone. Chatta semplicemente con l'AI usando un'interfaccia in stile messaggistica e gestisci tutto, dalla programmazione al deployment, direttamente dal tuo telefono.

Requisiti

Prima di iniziare a usare Claush, segui le istruzioni nella sezione Configurazione del server remoto per completare la preparazione del server.

Configurazione del server remoto

Prima di iniziare a usare Claush, completa le seguenti preparazioni sul server. Tutte le operazioni vengono eseguite dal terminale del tuo PC.

Metodi di connessione

Claush supporta due metodi di autenticazione: Password e Chiave SSH.

Procedura di configurazione dell'autenticazione con chiave SSH

Se non hai ancora chiavi SSH, esegui i seguenti comandi nel terminale del tuo PC per crearle.

ssh-keygen -t ed25519 -C "your-email@example.com"

ssh-copy-id -i ~/.ssh/id_ed25519.pub username@server-ip-address

cat ~/.ssh/id_ed25519

Creazione di un utente dedicato (Consigliato)

Accedi al tuo server via SSH come root dal terminale del tuo PC ed esegui i seguenti comandi.

sudo adduser claude

sudo usermod -aG sudo claude

sudo mkdir -p /home/claude/.ssh
sudo cp ~/.ssh/authorized_keys /home/claude/.ssh/
sudo chown -R claude:claude /home/claude/.ssh
sudo chmod 700 /home/claude/.ssh
sudo chmod 600 /home/claude/.ssh/authorized_keys

sudo sh -c "echo 'claude ALL=(ALL) NOPASSWD:ALL' > /etc/sudoers.d/claude"

Installazione di Claude Code

Accedi con l'utente creato e installa Node.js e Claude Code.

su - claude

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install --lts

npm install -g @anthropic-ai/claude-code

Autenticazione di Claude Code

Claude Code richiede l'autenticazione tramite browser al primo avvio.

1

Accedere a Claude Code

claude login

Per prima cosa verrà visualizzata la schermata di selezione del tema. Scegli il tema che preferisci.

2

Selezionare il metodo di autenticazione

Successivamente verrà visualizzata la schermata di selezione del metodo di accesso. Il metodo di fatturazione è determinato dall'account con cui si effettua l'accesso.

Opzione	Destinazione di accesso	Metodo di fatturazione
1. Claude account with subscription	claude.ai	Piano Max / Pro / Teams (abbonamento)
2. Anthropic Console account	platform.claude.com	Piano API (fatturazione a consumo)

3

Autenticarsi nel browser

Dopo la selezione, verrà visualizzato un URL di autenticazione. Se il browser non si apre automaticamente, premere c per copiare l'URL e aprirlo nel browser del PC. Dopo aver completato l'autenticazione nel browser, verrà visualizzato un codice — incollarlo nel terminale su Paste code here if prompted > e premere Invio.

Una volta completato, registra il server dalla schermata Aggiungere un server nell'app Claush. Specifica il nome dell'utente dedicato creato (ad es. claude) come nome utente.

Elenco server

Quando apri l'app, viene visualizzata la schermata dell'elenco server. Ogni server ha due pulsanti.

L'icona dell'ingranaggio (⚙️) in alto a sinistra apre la schermata delle impostazioni generali dell'app. Il pulsante + in alto a destra permette di aggiungere un server.

Impostazioni

Tocca l'icona dell'ingranaggio ⚙️ in alto a sinistra dell'elenco server per aprire la schermata delle impostazioni. Le impostazioni sono organizzate come un hub con quattro categorie.

Profilo

Vai su Impostazioni > Profilo per configurare le seguenti informazioni. Le risposte dell'AI saranno personalizzate in base al tuo profilo.

• Nome (cognome, nome)
• Soprannome
• Età virtuale
• Genere
• Esperienza di programmazione: selezionando "Nessuna esperienza", l'AI eviterà il gergo tecnico e fornirà una guida più gentile

Generazione immagini AI

Vai su Impostazioni > Personaggio AI > sezione "Generazione immagini AI" per registrare una chiave API per la generazione automatica di immagini dei personaggi.

Una volta registrata e testata con successo una chiave API, puoi alternare tra "Seleziona immagine" e "Genera con AI" nella schermata di creazione del personaggio. Scegliendo "Genera con AI" vengono visualizzate le impostazioni dell'aspetto (genere, carnagione, corporatura, età, colore dei capelli, acconciatura) e un pulsante di anteprima.

Impostazioni lingua

Vai su Impostazioni > Lingua per cambiare la lingua di visualizzazione. Sono supportate le seguenti 10 lingue.

• Giapponese, Inglese, Cinese, Coreano, Spagnolo
• Francese, Tedesco, Portoghese, Italiano, Arabo

Il cambio di lingua viene immediatamente applicato a tutta l'interfaccia. Puoi dare istruzioni all'AI in qualsiasi lingua.

Personaggi AI

In Claush puoi dare all'AI un nome, uno stile di conversazione e una personalità per creare "il tuo compagno personale". I personaggi ricordano le conversazioni e regolano naturalmente la distanza emotiva in base al livello di affinità.

Creazione personaggio

Vai su Impostazioni > Personaggio AI > "Aggiungi personaggio" per aprire la schermata di creazione.

Dettagli personaggio

Vai su Impostazioni > Personaggio AI > tocca il nome di un personaggio per aprire la schermata dei dettagli.

Informazioni visualizzate

• Immagine del personaggio (caricata manualmente / icona predefinita. Può essere cambiata tramite "Cambia immagine")
• Nome e tipo
• Affinità: 4 cuori (♡♡♡♡ a ❤️❤️❤️❤️) + punteggio (0-100)
• Inventario: Oggetti posseduti e un pulsante "Regala"

Fare regali

Seleziona un oggetto dall'inventario e tocca "Regala" per regalarlo al personaggio. Fare regali aumenta l'affinità.

Negozio

Vai su Impostazioni > Personaggio AI > "Negozio" per aprire la schermata di acquisto oggetti.

Punti

Guadagni 1 punto per ogni messaggio di chat inviato. I punti sono una valuta condivisa tra tutti i personaggi. Non ci sono acquisti in-app.

Oggetti

Ci sono 30 oggetti in totale suddivisi in 6 categorie (5 per categoria). I prezzi variano da 10 a 100 punti.

Sistema affinità

Regalare oggetti a un personaggio aumenta la sua affinità. Man mano che l'affinità cresce, la distanza emotiva nelle risposte di Claude cambia naturalmente.

Aggiungere un server

Tocca il pulsante + in alto a destra nella schermata dell'elenco server per aggiungere un server.

Impostazioni server

Tocca il pulsante ⚙️ nell'elenco server per aprire la schermata delle impostazioni. È composta da 4 sezioni a fisarmonica.

Tocca il pulsante rotondo sul lato destro di ogni sezione per espanderla o comprimerla. Dopo aver apportato modifiche, tocca "Salva" in alto a destra per applicarle.

Impostazioni memoria

La funzionalità di memoria permette all'AI di ricordare il contenuto delle conversazioni tra le sessioni. Consente richieste come "continua da dove ci siamo fermati ieri".

Tipi di database

Passaggi di configurazione

Impostazioni Claude

Selezione del modello

Seleziona il modello Claude da utilizzare. Ogni modello differisce per prestazioni, velocità e costo. Il modello attualmente selezionato è indicato con un segno di spunta.

Accesso ai file sensibili

Usa l'interruttore per controllare l'accesso dell'AI ai file sensibili come .env. L'impostazione predefinita è OFF (accesso negato).

Assegnazione personaggio AI

Se sono stati creati personaggi personalizzati, puoi selezionare quale personaggio assegnare a questo server. Una volta assegnato, Claude risponderà con lo stile di conversazione e la personalità di quel personaggio.

Impostazioni notifiche

Ricevi una notifica quando Claude termina di rispondere tramite servizi esterni. Questo ti permette di passare ad altre attività mentre le operazioni lunghe sono in corso.

Piattaforme supportate

È necessario ottenere un URL Webhook da ciascun servizio in anticipo.

Nozioni di base sessione

Toccando il pulsante chat ci si connette al server e si apre una schermata con tre schede.

Layout a tre schede

Cambio schede

Tocca il pulsante ◀ in alto a destra per espandere il selettore di schede. Seleziona Chat / Terminale / Claude per cambiare scheda.

Tocca l'icona del server a sinistra delle schede per tornare all'elenco server. La sessione tmux sul server continua a funzionare in background, quindi puoi riprendere il lavoro riconnettendoti.

Stato connessione

Controlla lo stato della connessione tramite l'indicatore in alto a sinistra.

Scheda Chat

Questa è la schermata principale di Claush. Invia un messaggio e Claude Code risponde, visualizzato come bolle di chat.

Invio messaggi

Inserisci un messaggio nel campo di input in fondo allo schermo e tocca il pulsante di invio ✈ sulla destra. Un indicatore animato appare mentre Claude sta elaborando.

Visualizzazione messaggi

• Messaggi dell'utente: Bolle blu allineate a destra
• Risposte di Claude: Bolle grigie allineate a sinistra (con avatar quando è impostato un personaggio AI)
• Supporto Markdown: I blocchi di codice includono evidenziazione della sintassi e pulsanti di copia

Menu allegati

Tocca il pulsante menu ≡ a sinistra del campo di input per visualizzare le seguenti opzioni.

Messaggi precedenti

Scorri fino all'inizio della chat e apparirà un pulsante "Carica messaggi precedenti". Toccandolo vengono caricati i messaggi passati in blocchi da 30.

Scheda Terminale

Un emulatore di terminale completo che fornisce accesso diretto alla shell. Usalo per controllare file, operazioni Git, eseguire comandi e altro.

Barra tasti speciali

I caratteri di controllo difficili da digitare sulla tastiera standard iOS possono essere inseriti con un singolo tocco dalla barra dei tasti in fondo allo schermo.

Scheda Claude

Mostra la TUI (Text User Interface) di Claude Code così com'è. Puoi vedere i dettagli dell'esecuzione degli strumenti e i processi di ragionamento in tempo reale che sono omessi nella scheda Chat.

Puoi anche digitare direttamente nella scheda Claude, così puoi eseguire manualmente i comandi slash di Claude Code (/clear, /cost, ecc.).

Trasferimento file

Caricamento

Dal menu allegati della chat, tocca "Seleziona file" o "Seleziona foto" per scegliere un file. Il file viene caricato nella cartella ~/claush-uploads/ sul server e Claude viene notificato di conseguenza.

Download

Tocca "Scarica file" nel menu allegati per vedere un elenco di file nella directory ~/claush-downloads/ del server. Tocca un file per scaricarlo sul tuo iPhone e apparirà un foglio di condivisione.

Suggerimenti e trucchi

Dividi il lavoro in piccole parti

Mantieni ogni istruzione a una singola user story. Questo rende più facile la revisione sullo schermo del telefono. Puoi verificare a livello di PR, mantenendo la qualità sviluppando a un buon ritmo.

Controlla l'avanzamento nella scheda Claude

Durante le operazioni lunghe, passa alla scheda Claude per vedere cosa sta succedendo in tempo reale. Torna alla scheda Chat per vedere i risultati come bolle di chat.

Usa le notifiche per il lavoro asincrono

Con le notifiche configurate, i completamenti delle risposte di Claude arrivano su Slack o Discord. Questo abilita uno stile di sviluppo asincrono: invia un'istruzione, chiudi l'app e fai qualcos'altro.

Porta avanti il contesto con la memoria

Con la funzionalità di memoria abilitata, l'AI ricorda i contenuti delle sessioni precedenti. Puoi goderti un'esperienza di sviluppo naturale con richieste come "continua da ieri" o "quella cosa di cui abbiamo parlato prima".

Il lavoro continua in background

Grazie alla gestione delle sessioni tmux, il lavoro lato server continua anche dopo aver chiuso l'app. I risultati vengono recuperati automaticamente alla prossima apertura dell'app.

Risoluzione problemi

Impossibile connettersi

• Verifica che host, porta e nome utente siano corretti
• Assicurati che la chiave privata sia copiata esattamente da -----BEGIN OPENSSH PRIVATE KEY----- a -----END OPENSSH PRIVATE KEY-----, incluse le interruzioni di riga
• Le connessioni con l'utente root non sono supportate. Crea un utente dedicato
• L'autenticazione keyboard-interactive non è supportata. Usa l'autenticazione basata su chiave

Claude Code non si avvia

• Verifica che claude login sia stato completato sul server. Puoi eseguirlo dalla scheda Terminale
• Verifica che l'utente abbia i privilegi sudo (senza password). Questo è necessario per l'installazione automatica

Nessuna risposta

• Passa alla scheda Claude per controllare lo stato della TUI di Claude Code
• Se lo stato della connessione in alto a sinistra mostra "Riconnessione", controlla la tua connessione di rete
• Se non c'è ancora risposta dopo molto tempo, controlla direttamente dalla scheda Claude o torna all'elenco server e riconnettiti

Configurazione memoria fallita

• Per PostgreSQL, verifica che la stringa di connessione inizi con postgresql:// o postgres://
• Verifica che Node.js sia installato sul server (solitamente viene installato automaticamente)
• Verifica che sudo possa essere eseguito senza password

Archiviazione personaggi

Le definizioni dei personaggi sono memorizzate sul tuo iPhone (archiviazione in-app). Quando cambi dispositivo, ripristina da un backup iPhone.