CodePilot
Torna alla home

Supporto

Siamo un team piccolo — leggiamo ogni email. In genere rispondiamo entro un giorno lavorativo.

Scrivici

Il modo più rapido per parlare con un umano. Includi l'email del tuo account CodePilot e il nome del dispositivo che vedi nell'app per iPad.

support@smartapibox.com

Per iniziare

Installa l'agente sul computer, accoppia l'iPad e lancia il primo prompt.

Agente su GitHub

Codice sorgente della CLI codepilot-agent. Apri qui le issue per bug dell'agente.

Segnala un bug

Trovato qualcosa che non va? Mandaci una mail con i passi per riprodurlo e la versione iOS.

Privacy & dati

Cosa salviamo, dove, e come chiedere la cancellazione.

Per iniziare

  1. Installa l'agente su Mac, Linux o Windows. Richiede Node.js 18+:
    npm install -g codepilot-agent
  2. Accedi nell'app CodePilot per iPad (o scaricala dall'App Store) con la tua email.
  3. Accoppia l'agente con l'iPad. Da un terminale sul computer dove gira l'agente:
    codepilot-agent pair
    Inserisci il codice mostrato nell'app per iPad per confermare.
  4. Avvia l'agente puntando alla cartella che contiene i tuoi progetti:
    WORKSPACE=~/projects CODEPILOT_MODE=relay codepilot-agent
  5. Dall'app per iPad tocca il dispositivo, scegli un repository e chiedi qualcosa a Claude — ad esempio «Quali file ci sono in questo repo?»

Vuoi una demo già pronta? Vedi la pagina dell'agente su npm e il repository GitHub.

Domande frequenti

Mi serve un account Claude o Anthropic?›
Sì. CodePilot ha bisogno di accedere a Claude. Puoi accedere col tuo abbonamento Claude Pro/Max (modalità CLI) oppure incollare la tua API key Anthropic (modalità SDK). La scelta avviene durante l'onboarding e si può cambiare dopo.
L'agente funziona senza connessione internet sul computer?›
No. L'agente deve raggiungere il relay (relay.codepilot.it) per ricevere i prompt dall'iPad. L'iPad non si connette direttamente al computer — passa per il relay, così non devi aprire porte né conoscere il tuo IP.
L'app per iPad può modificare file sul mio computer?›
Sì — ma ogni modifica richiede la tua approvazione esplicita tramite il dialog dei permessi sull'iPad. Puoi approvare una volta, per tutta la sessione, negare, oppure premere «Reimposta permessi approvati» dalle impostazioni del workspace per resettare le approvazioni in cache. Le operazioni ad alto rischio (rm -rf, sudo, git push --force, npm publish) chiedono sempre conferma. CodePilot non è una sandbox — vedi la nota nella sezione prezzi.
Qual è la differenza tra Free e Pro?›
Free ti fa lavorare su un repository alla volta. Pro sblocca il workspace completo per passare tra repository senza riavviare l'agente. Entrambi i piani includono tutte le funzionalità di editor e AI.
L'agente risulta OFFLINE sull'iPad. E adesso?›
Verifica che il processo dell'agente stia girando sul computer (un terminale con codepilot-agent in primo piano). Se è crashato, riavvialo. Se l'iPad continua a dirti offline dopo 30 secondi, controlla che il computer abbia accesso a internet e prova il bottone «Aggiorna» sul selettore dispositivi.
Posso usare CodePilot con repository privati?›
Sì. I repo restano sul tuo computer; l'agente non li carica mai. Solo il testo del prompt e i path/contenuti dei file di cui Claude ha bisogno per rispondere transitano dal relay (cifrati in transito).

Permessi & sicurezza

Ogni volta che Claude vuole scrivere un file, eseguire un comando o cambiare lo stato git, l'iPad mostra un dialog di permesso. Puoi:

  • Consenti — esegue questa singola azione.
  • Consenti per la sessione — non chiede più finché la sessione resta attiva o reimposti le approvazioni. Disabilitato sulle operazioni ad alto rischio.
  • Nega — a Claude verrà detto di no e proverà un approccio diverso.

Per revocare le approvazioni apri le impostazioni del workspace (⚙) e tocca Reimposta permessi approvati. Per smettere completamente di condividere il computer, esegui codepilot-agent unpair e rimuovi il dispositivo dal selettore dell'iPad (swipe a sinistra → cestino).

Importante: CodePilot non è una sandbox del filesystem. L'agente gira con i permessi del tuo utente. ScopeGuard blocca gli accessi accidentali tramite gli strumenti read/write, ma i comandi Bash che approvi possono fare qualsiasi cosa tu possa fare in un terminale. Approva con attenzione.

Risoluzione problemi

Nessun repository rilevato all'avvio dell'agente.›
L'agente non ha trovato cartelle git. Imposta una di queste:
# Consigliato: cartella padre con i tuoi repo
WORKSPACE=~/progetti codepilot-agent

# Singolo repo
REPO_PATH=~/lavoro/mia-app codepilot-agent

# Lista esplicita
REPO_PATHS=~/lavoro/api,~/personale/blog codepilot-agent
Codice di pairing scaduto o pairing fallito.›
I codici di pairing sono validi ~5 minuti. Esegui di nuovo «codepilot-agent pair» per generarne uno nuovo.
L'agente si disconnette ogni paio di minuti.›
Assicurati che il computer non vada in standby. Su macOS: Impostazioni di Sistema → Batteria / Risparmio Energia → Impedisci sospensione automatica. Il keepalive HEARTBEAT dell'agente (da v0.5) gestisce da solo le pause di rete.
Il dialog dei permessi non compare mai.›
Verifica che l'agente sia online (pallino verde nel selettore dispositivi). Se è online ma il dialog non compare, attiva il banner diagnostico dal menu ⋯ del workspace — mostra ogni messaggio del relay e ci dice dove si rompe la catena. Poi mandaci una mail con quello che vedi.

Account & fatturazione

Come cambio password?›
Esci dall'app iPad, poi usa il link «Password dimenticata» nella schermata di accesso, oppure scrivi a support@smartapibox.com.
Come disdico l'abbonamento?›
Gli abbonamenti sono fatturati tramite Apple In-App Purchase. Disdici quando vuoi da Impostazioni → [il tuo nome] → Abbonamenti su iPhone o iPad. L'accesso resta attivo fino alla fine del periodo di fatturazione corrente.
Rimborsi?›
I rimborsi In-App Purchase sono gestiti da Apple. Usa reportaproblem.apple.com oppure contatta direttamente il supporto Apple. Non possiamo emettere rimborsi al posto loro.

Cancella il tuo account

Puoi richiedere la cancellazione del tuo account CodePilot in qualsiasi momento. Tutte le opzioni sono equivalenti e la richiesta viene evasa entro 30 giorni come previsto dal GDPR.

  1. Dall'app per iPad (quando la cancellazione in-app sarà attiva, attualmente in sviluppo): vai in Altro → Account → Cancella account.
  2. Email privacy@smartapibox.com dall'indirizzo registrato su CodePilot. Oggetto: «Richiesta cancellazione account».

La cancellazione rimuove account, dispositivi accoppiati, device token e profilo personale. Log aggregati anonimi (numero di chiamate API, nessun contenuto) possono essere conservati per motivi di sicurezza e obblighi fiscali. Gli abbonamenti attivi vanno disdetti separatamente tramite Apple.

App iOS

CodePilot gira su iPhone (iOS 17+) e iPad (iPadOS 17+). Su iPad layout completo a più pannelli (sidebar + editor + terminale Claude); su iPhone le stesse funzioni sono raggiungibili dalla bottom bar a 5 tab (File / Cerca / Git / Terminale / Altro).

App StoreCodice agente

Ancora bloccato?

Mandaci una mail — includi l'email dell'account, il nome del dispositivo e uno screenshot se puoi. Rispondiamo entro un giorno lavorativo.

support@smartapibox.com

CodePilot è un prodotto di SmartApiBox S.r.l.s. — Via Dei Caniana, 38 · 24055 Cologno al Serio (BG), Italia · P.IVA 04871830164