Risoluzione dei problemi
La maggior parte dei problemi si risolve in fretta. Se il tuo non è qui, scrivi al supporto indicando il sistema operativo, la versione di PATerminal (Impostazioni → Aggiornamenti) e cosa hai già provato.
Scritto per PATerminal v1.8.3
Installazione e apertura
- Windows: “PC protetto da Windows”
- Fai clic su Ulteriori informazioni, poi su Esegui comunque. SmartScreen avvisa per le app nuove; se vuoi esserne sicuro, confronta lo SHA-256 nella guida all’installazione per Windows.
- macOS chiede conferma prima di aprire
- Scegli Apri. L’app è firmata con un Developer ID e notarizzata da Apple.
Git mostra un errore
Quando qualcosa sul tuo computer impedisce a git di funzionare, PATerminal mostra Git non può essere eseguito su questo computer con la correzione. I casi più comuni:
| Causa | Soluzione |
|---|---|
| macOS: licenza di Xcode non accettata (spesso subito dopo un aggiornamento di Xcode) | sudo xcodebuild -license accept |
| macOS: Command Line Tools mancanti o danneggiati | xcode-select --install |
| Git non installato | Installalo (Windows: winget install Git.Git); PATerminal lo rileva automaticamente. |
| “Dubious ownership” su un altro disco o una condivisione di rete | git config --global --add safe.directory <path> — solo per cartelle di cui ti fidi. |
| Windows: percorso troppo lungo | git config --global core.longpaths true |
Le pull request o le issue non si caricano
Assicurati che gh sia installato e che tu abbia effettuato l’accesso (gh auth status), e che il repository abbia un remoto su GitHub. Dopo aver risolto, premi Riprova.
Una sessione resta su “In esecuzione”
- Qualcosa al suo interno sta ancora stampando output — un server di sviluppo, un watcher o un indicatore di attività. È output reale, quindi lo stato è corretto.
- Codex 0.154.0 o successivo è stato avviato prima che PATerminal salvasse
tui.whimsy = false: riavvia quella sessione Codex. Un’impostazione esplicita a livello di progetto o da riga di comando può avere la precedenza. Vedi Nota per chi usa Codex.
Nessuna notifica
- Verifica che Impostazioni → Notifiche sia attivo.
- Consenti le notifiche per PATerminal nelle impostazioni del sistema operativo e controlla Full immersion / Non disturbare.
- Le notifiche vengono inviate solo per le sessioni che non stai guardando.
Una conversazione non riprende
- L’agente potrebbe essere terminato prima di salvare la conversazione. Aprila invece dalla Cronologia.
- Per spostare Claude Code in una cartella non correlata serve Claude Code v2.1.223 o successivo.
- Le opzioni passate solo sulla riga di comando originale non vengono riapplicate.
Un aggiornamento non va a buon fine
Se l’aggiornamento firmato non può essere installato, PATerminal non viene riavviato e non cambia nulla. Riprova più tardi, oppure scarica l’ultimo programma di installazione dalla pagina di download e installalo sopra la versione attuale — sessioni e impostazioni vengono mantenute.
Dove sono i miei dati?
Sessioni, gruppi, note, frasi e impostazioni sono salvati come file locali sul tuo computer; le conversazioni degli agenti restano nelle cartelle degli agenti stessi (ad esempio ~/.claude e ~/.codex). Nulla viene sincronizzato con un server e PATerminal non ha telemetria.
Ancora bloccato?
Consulta le FAQ oppure scrivici indicando il sistema operativo, la versione di PATerminal e cosa hai già provato. Rispondiamo a ogni messaggio.