トラブルシューティング
たいていの問題はすぐに解決できます。ここに載っていない場合は、お使いのOS、PATerminalのバージョン（設定 → アップデート）、試したことを添えてサポートにメールでお問い合わせください。
PATerminal v1.8.3 時点の内容です
インストールと起動
- Windows:「WindowsによってPCが保護されました」
- 詳細情報をクリックしてから実行をクリックします。SmartScreenは新しいアプリに対して警告を表示します。確実に確かめたい場合は、WindowsインストールガイドでSHA-256を照合してください。
- macOSで開く前に確認される
- 開くを選びます。アプリはDeveloper IDで署名され、Appleの公証を受けています。
Gitでエラーが表示される
コンピューターの環境が原因でgitが動かない場合、PATerminalはこのPCでGitを実行できませんと表示し、解決方法を案内します。よくあるケースは次のとおりです。
| 原因 | 解決方法 |
|---|---|
| macOS: Xcodeのライセンスに同意していない（Xcodeの更新直後によく起きます） | sudo xcodebuild -license accept |
| macOS: Command Line Toolsがない、または壊れている | xcode-select --install |
| Gitがインストールされていない | インストールしてください（Windows: winget install Git.Git）。PATerminalが自動で認識します。 |
| 別のドライブやネットワーク共有での“dubious ownership” | git config --global --add safe.directory <path> — 信頼できるフォルダーに対してのみ実行してください。 |
| Windows: パスが長すぎる | git config --global core.longpaths true |
プルリクエストやIssueが読み込まれない
ghがインストールされてサインイン済みであること（gh auth status）と、リポジトリにGitHubのリモートがあることを確認してください。修正したら再試行を押します。
セッションが「実行中」のままになる
- 開発サーバー、ファイル監視、スピナーなど、セッション内で何かが出力を続けています。実際の出力なので、状態表示は正しい動作です。
- PATerminalが
tui.whimsy = falseを保存する前に、Codex 0.154.0以降を起動していた場合は、そのCodexセッションを再起動してください。プロジェクト単位やコマンドラインで明示的に設定していると、そちらが優先されることがあります。Codexをお使いの方へをご覧ください。
通知が届かない
- 設定 → 通知がオンになっているか確認してください。
- OSの設定でPATerminalの通知を許可し、集中モードや応答不可がオンになっていないか確認してください。
- 通知は、見ていないセッションについてだけ送られます。
会話が再開されない
- 会話を保存する前にエージェントが終了した可能性があります。代わりに履歴から開いてください。
- Claude Codeを無関係なフォルダーへ移動するには、Claude Code v2.1.223以降が必要です。
- 元のコマンドラインでだけ指定したオプションは再現されません。
アップデートに失敗する
署名付きのアップデートをインストールできなかった場合、PATerminalは再起動せず、何も変更されません。時間をおいてもう一度試すか、ダウンロードページから最新のインストーラーを入手して上書きインストールしてください。セッションと設定はそのまま残ります。
データはどこに保存されますか？
セッション、グループ、メモ、定型文、設定は、コンピューター上のローカルファイルとして保存されます。エージェントの会話は、各エージェント自身のフォルダー（たとえば~/.claudeや~/.codex）に残ります。サーバーへ同期されることはなく、PATerminalにはテレメトリーもありません。