Dépannage
La plupart des problèmes se règlent vite. Si le vôtre n’est pas listé ici, écrivez à l’assistance en indiquant votre OS, votre version de PATerminal (Réglages → Mises à jour) et ce que vous avez essayé.
Rédigé pour PATerminal v1.8.3
Installation et ouverture
- Windows : « Windows a protégé votre ordinateur »
- Cliquez sur Informations complémentaires, puis sur Exécuter quand même. SmartScreen avertit pour les nouvelles apps ; comparez le SHA-256 indiqué dans le guide d’installation Windows si vous voulez en être sûr.
- macOS demande confirmation avant l’ouverture
- Choisissez Ouvrir. L’app est signée avec un Developer ID et notariée par Apple.
Git affiche une erreur
Quand quelque chose sur votre ordinateur empêche git de fonctionner, PATerminal affiche Git ne peut pas s'exécuter sur cet ordinateur avec le correctif. Les cas les plus courants :
| Cause | Correctif |
|---|---|
| macOS : licence Xcode non acceptée (souvent juste après une mise à jour d’Xcode) | sudo xcodebuild -license accept |
| macOS : Command Line Tools manquants ou endommagés | xcode-select --install |
| Git non installé | Installez-le (Windows : winget install Git.Git) ; PATerminal le détecte automatiquement. |
| « Dubious ownership » sur un autre disque ou un partage réseau | git config --global --add safe.directory <path> — uniquement pour des dossiers de confiance. |
| Windows : chemin trop long | git config --global core.longpaths true |
Les pull requests ou issues ne se chargent pas
Vérifiez que gh est installé et connecté (gh auth status), et que le dépôt a un dépôt distant GitHub. Appuyez sur Réessayer une fois le problème corrigé.
Une session reste sur « En cours »
- Quelque chose y affiche encore du texte — un serveur de dev, un watcher ou un indicateur d’activité. C’est une vraie sortie : l’état est donc correct.
- Codex 0.154.0 ou ultérieur a été lancé avant que PATerminal n’enregistre
tui.whimsy = false: redémarrez cette session Codex. Un réglage explicite au niveau du projet ou de la ligne de commande peut prendre le dessus. Voir Remarque pour les utilisateurs de Codex.
Aucune notification
- Vérifiez que Réglages → Notifications est activé.
- Autorisez les notifications pour PATerminal dans les réglages de votre OS, et vérifiez les modes Concentration / Ne pas déranger.
- Les notifications ne sont envoyées que pour les sessions que vous ne regardez pas.
Une conversation ne reprend pas
- L’agent s’est peut-être fermé avant d’enregistrer la conversation. Ouvrez-la plutôt depuis l’Historique.
- Déplacer Claude Code vers un dossier sans rapport nécessite Claude Code v2.1.223 ou ultérieur.
- Les options passées uniquement sur la ligne de commande d’origine ne sont pas rejouées.
Une mise à jour échoue
Si la mise à jour signée ne peut pas être installée, PATerminal ne redémarre pas et rien ne change. Réessayez plus tard, ou téléchargez le dernier programme d’installation depuis la page de téléchargement et installez-le par-dessus la version actuelle — vos sessions et réglages sont conservés.
Où sont mes données ?
Les sessions, groupes, notes, phrases et réglages sont stockés dans des fichiers locaux sur votre ordinateur ; les conversations des agents restent dans les dossiers propres aux agents (par exemple ~/.claude et ~/.codex). Rien n’est synchronisé avec un serveur, et PATerminal n’a aucune télémétrie.
Toujours bloqué ?
Consultez la FAQ, ou écrivez-nous en indiquant votre OS, votre version de PATerminal et ce que vous avez essayé. Nous répondons à chaque message.