遇到問題
最後更新
新手流程中最常遇到的問題與解法。
| 症狀 | 處理 |
|---|---|
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 沙箱內。沙箱 說明它擋掉什麼、以及如何放寬 |