# 遇到問題

新手流程中最常遇到的問題與解法。

| 症狀 | 處理 |
|---|---|
| `agen: command not found` | `/usr/local/bin` 不在 `PATH` 上。開新的 shell，或自行加入 |
| 授權 Copilot 後模型清單是空的 | 授權未完成或超過 15 分鐘失效。重跑 `/model` → add → GitHub Copilot，以新代碼重新授權 |
| 每個工具呼叫都停下來要確認 | TUI 處於 `safe`（`⏸ safe`）：工作目錄為 `$HOME`、在 `$HOME` 之外，或為禁止或敏感路徑時，啟動即為此模式。**Shift+Tab** 可切到 `auto`（`⏵⏵ auto`），但只在 `$HOME` 底下的子目錄生效；可用 **Shift+P** 設定工作目錄 |
| Agent 會回話但從不呼叫工具 | 小型開源權重模型常漏掉 tool call。改註冊較大的模型 —— 訂閱型 provider（`codex`、`grok-oauth`、`copilot`）不需按量計費 |
| 指令執行時出現權限錯誤 | 指令跑在 OS 沙箱內。[沙箱](/zh/sandbox) 說明它擋掉什麼、以及如何放寬 |