# トラブルシューティング（参照インデックス）

同一内容はここに書かず、既存資料へ誘導する。

| 症状・状況 | 参照先 |
|------------|--------|
| **429 / MODEL_CAPACITY_EXHAUSTED** | [agent-behavior.md](agent-behavior.md) 5（失敗時分岐）・7.1（Plan Mode fallback） |
| **Unauthorized tool call**（Plan Mode 中） | まず [trusted-folder.md](trusted-folder.md) 5（切り分け順序）。次に [agent-behavior.md](agent-behavior.md) 7.1（通常モードへ切り替え） |
| **write がブロックされる** | [manual-for-agent.md](manual-for-agent.md) 7（権限・`--approval-mode=yolo`・信頼フォルダ）。信頼設定は [trusted-folder.md](trusted-folder.md) |
| **Plan が返らない / 実装に進んではいけない** | [agent-behavior.md](agent-behavior.md) 4.1・7.1（Plan 精査ゲート） |
| **Directory mismatch（IDE）** | [reference.md](reference.md) IDE 連携。カレントをワークスペースルートに合わせる。 |
| **プロンプトやパスが文字化けする**（日本語が `�` になる） | 推奨は **Git Bash**。[terminal-recommendation.md](terminal-recommendation.md)。CMD のときだけ `chcp 65001` を実行（Git Bash で chcp するとエラー）。[manual-for-agent.md](manual-for-agent.md) 2。 |
| **`chcp 65001` でエラーになる** | Git Bash では `chcp` は存在しない。Git Bash では不要。[terminal-recommendation.md](terminal-recommendation.md)。 |
| **終了コードの意味** | [reference.md](reference.md) 終了コード |

詳細は各資料を参照すること。
