⚙️Impostazioni e chiavi

Tutto si configura da Impostazioni; non serve modificare nessun file.

Cambiare qui il fuso orario non cambia l'orologio del server: esegui anche timedatectl set-timezone <Zone> && systemctl restart cron, così le attività pianificate lo seguono (vedi Cron).

Installare l'app

Harness Maxxing si installa come un'app (con una finestra propria, un'icona nel Dock, nella barra delle applicazioni o nella schermata Home, a schermo intero su un telefono). Due posti: Installa l'app nel menu dell'account (l'icona della persona in fondo alla barra laterale; su un telefono, nel menu ⊞) e Impostazioni -> Generale -> App.

• Chrome, Edge (computer o Android): un clic quando il browser lo propone; altrimenti il pulsante mostra i passaggi (l'icona di installazione in fondo alla barra degli indirizzi, o il menu del browser).
• Safari su Mac (macOS 14 o successivo): File -> Aggiungi al Dock.
• iPhone / iPad: pulsante Condividi di Safari -> Aggiungi alla schermata Home.
• Firefox non può installare app web su un computer: usa Chrome, Edge o Safari.
• La scheda App mostra un codice QR dell'indirizzo: inquadralo con il telefono, accedi, poi aggiungilo alla schermata Home.
• Per installare serve l'indirizzo https (accesso tramite dominio). Con Tailscale (http://100.x.y.z:8787) i browser non la propongono.

Su un telefono o un tablet

Telefoni e tablet usano il layout touch (Impostazioni -> Generale -> Layout lo cambia per ogni dispositivo): niente barra laterale, niente barra in basso, la conversazione riempie lo schermo. Due pulsanti stanno in alto in ogni schermata: - ☰ (in alto a sinistra) apre le tue sessioni - vedi Sessioni. Il suo contatore mostra le risposte non lette. - ⊞ (in alto a destra) apre tutto il resto: un campo di ricerca (lo stesso di ⌘K), tutte le pagine (Dashboard, Sessioni, File, Attività, Cron, Notifiche, Git e Infra quando attivati, Estensioni e pagine fissate), l'aggiornamento in attesa, lo stato di salute del server, l'utilizzo del tuo piano Claude, il tema, la modalità presentazione, Impostazioni, Aiuto (tour, tutorial, documentazione) e Esci. Un puntino su ⊞ indica che c'è un aggiornamento in attesa o che il server richiede attenzione.

Inoltre: - Nell'app installata, scorri dal bordo sinistro per aprire le sessioni, dal bordo destro per aprire il menu; scorri un pannello laterale verso il suo bordo per chiuderlo. - I pannelli che salgono dal basso si chiudono con uno scorrimento verso il basso (dalla loro maniglia, dal titolo, o dal contenuto quando è scorso fino in cima), oppure con un tocco sull'area oscurata sopra di essi. - I pulsanti del microfono e di invio sono più grandi; mentre scrivi, i pannelli restano sopra la tastiera. - La pagina non fa zoom (niente pizzico, niente doppio tocco), come un'app nativa; i campi non fanno mai ingrandire la pagina su iPhone.

Autenticazione di Claude

Tre modi, dal migliore: 1. Token di lunga durata: esegui claude setup-token su un computer qualsiasi con un browser, incolla il token. 2. Chiave API dalla console di Anthropic (fatturata a consumo). 3. Accesso CLI fatto sul server (claude, poi /login): rilevato automaticamente.

Test fa una vera chiamata di una riga e mostra il modello e la latenza.

I turni avviano Claude senza il controllo degli aggiornamenti, senza telemetria e senza il download dei feature flag (avvio più rapido, prompt più corto); "claude_quiet_start": false in config.json lo disattiva.

Claude esegue i suoi agenti di supporto in primo piano: ricevi il loro risultato nello stesso turno (più agenti girano comunque in parallelo). L'abitudine di Claude Code è invece di mandarli in background, con il turno che aspetta che riferiscano, il che è più lento; "background_agents": true in config.json torna a quel comportamento. Puoi sempre chiedere a Claude un agente in background nel tuo messaggio.

Aggiornamenti di Claude Code

Aggiorna Claude Code automaticamente (disattivato per impostazione predefinita): ogni 6 ore il server cerca una nuova versione stable di Claude Code (quella che Anthropic segna come stabile: già in uso da alcuni giorni, non l'ultimissima). Quando ce n'è una, la installa da solo - ma solo quando non sta girando nulla: nessun turno di conversazione, nessun messaggio in attesa in una coda, nessun job pianificato, e l'ultimo turno è finito da più di 10 minuti. Altrimenti aspetta e riprova qualche minuto dopo, così un aggiornamento non interrompe mai un turno, e un turno che parte durante l'aggiornamento lo aspetta (la conversazione lo dice; al massimo 7 minuti). Lo fa solo il server installato: un secondo Harness Maxxing avviato sulla stessa macchina per sviluppo o test non aggiorna mai il Claude Code della macchina. Funziona con l'installer ufficiale e con un'installazione npm globale (altri tipi di installazione vengono lasciati stare). Se la nuova versione non si avvia, viene rimessa quella precedente.

Ogni aggiornamento compare nelle notifiche ("Claude Code aggiornato a 2.1.5"), e l'interruttore mostra l'ultimo (2.1.4 -> 2.1.5 e la sua data). Anche un errore viene notificato, una volta per versione, con il motivo; il server riprova 6 ore dopo. Lascia l'interruttore disattivato per aggiornare a mano (claude update in un terminale); maxxing doctor allora elenca Claude Code sotto claude_version quando è indietro.

Modalità dei permessi

Un argomento può avere una modalità propria (elenco delle sessioni -> menu dell'argomento -> Permessi), e lo stesso vale per un job Claude pianificato (Modalità dei permessi nell'editor del job): usa una modalità più rigida dove Claude legge contenuti dall'esterno - pagine web, e-mail, messaggi inoltrati - così le istruzioni nascoste in quei contenuti non possono fargli fare qualsiasi cosa. Ordine: la modalità del job, altrimenti quella dell'argomento, altrimenti questa globale.

Proteggi i segreti (attivo per impostazione predefinita): in ogni modalità, gli strumenti di Claude si rifiutano di leggere o modificare i segreti del server (secrets.json) e le chiavi SSH (~/.ssh). Impedisce a un'istruzione nascosta di leggerli semplicemente; uno script scritto apposta per aprire il file non viene fermato, quindi non sostituisce una modalità più rigida. Altre regole: claude_deny in config.json (sintassi delle regole di Claude Code, per esempio "Bash(rm -rf:*)").

Vedi Sicurezza.

Chiavi (archivio dei segreti)

Conserva le chiavi API e i token di cui hanno bisogno i tuoi progetti (per esempio OPENAI_API_KEY, SHOP_TOKEN):

• i nomi sono MAIUSCOLI (A-Z, cifre, _), i valori sono nascosti e si mostrano solo con Mostra;
• aggiungi una nota (a cosa serve, da dove viene);
• Esponi rende il segreto disponibile come variabile d'ambiente a ogni sessione Claude e a ogni job cron di shell – comodo per gli script, e Claude non ha mai bisogno di vedere il valore in una chat;
• alcuni nomi sono riservati (variabili di sistema, variabili che fanno caricare codice a shell, Node, Python o git - NODE_OPTIONS, BASH_ENV, GIT_SSH_COMMAND... -, ANTHROPIC_BASE_URL, qualsiasi nome che inizi con MAXXING_); una chiave esistente con uno di questi nomi viene conservata ma non è più esposta.

Da script e sessioni: maxxing keys list|get|set|delete (il valore di set viene letto da stdin) - uno script che rinnova un token riscrive così il nuovo valore. Gli script leggono le chiavi dall'ambiente (os.environ["NAME"]), mai da un file proprio.

Scrivi nei file di memoria solo il nome della chiave ("API del negozio: chiave SHOP_TOKEN"). Le estensioni leggono le chiavi con ctx["secret"]("NAME").

Le chiavi si trovano in /var/lib/claude-maxxing/secrets.json (modalità 600) e non sono incluse nel backup.