你的代理 CLI 啟動即掛。
這就是確切的原因。
代理 CLI 起不來，是 AI 編碼裡最讓人洩氣的一種失敗：沒有輸出，沒有堆疊跟蹤，有時只是提示符又跳了回來。CLI Doctor 抓住那個瞬間，讀懂真正發生了什麼，然後回答唯一重要的問題：哪裡壞了，我現在該做什麼。
它知道 AgentsRoom 實際執行的那條命令，知道哪個引數來自哪項設定，也知道 CLI 在放棄之前列印了什麼。這些上下文，是搜尋引擎結果永遠拿不到的。
一次失敗的啟動、真實的錯誤，以及一份點名該負責設定項的診斷。
代理 CLI 迭代很快。一個引數在小版本里被刪掉，一個二進位制檔案在 Node 升級之後從 PATH 裡消失，一次登入過期，一個沙盒拒絕啟動，一份為別的工具寫的配置檔案被讀了進來。落到你這邊，結果永遠一樣：你發出一條提示詞，然後什麼都沒發生。
難的從來不是修復本身，而是搞清楚啟動命令裡那二十來個東西到底是哪一個出了問題，以及它是來自應用、來自你的供應商設定、來自你三週前給那一個代理設的覆蓋項，還是來自 CLI 自己在你腳下變了。
CLI Doctor 補上了這個缺口。它儲存實際啟動的那條命令，為每一個引數標出注入它的設定項，捕獲 CLI 列印的內容，再把這一切變成一份簡短的診斷加上具體步驟。確定性檢查永遠先跑，並且優先順序更高：只有在應用自己答不上來時，AI 才開口。
你得到的不再是一個空白終端
一段大白話的失敗說明，而不是一串等你破譯的堆疊跟蹤。一兩句話，直接點出真正的原因。
具體的下一步，按順序排好。每一步都可以帶上快捷入口：直達對應的設定面板、重灌命令或重新啟動，你不用再滿世界找那個選項藏在哪裡。
引數溯源：啟動命令裡的每一個詞都會被歸到它的來源，因此答案可以直接說「這個引數來自設定裡的 Autonomous mode」，而不是靠猜。
開發命令享受同樣的待遇。當建置、測試或伺服器命令在終端裡失敗時，診斷只有一次點選的距離，你還能從那裡把整件事交給一個 DevOps 代理。
一次診斷是怎麼發生的
分層是刻意的：便宜又確定的檢查先跑，AI 是最後手段。
AgentsRoom 記錄真實的啟動
終端被派生的那一刻，完整命令就被記錄下來：二進位制檔案、引數、模型、選項。正是這份記錄，讓之後的準確診斷成為可能；而且它覆蓋代理能被啟動的每一條路徑，包括從你手機上或從一張 backlog 工單觸發的啟動。
確定性檢查先說話
二進位制檔案缺失、CLI 不再接受的引數、未登入的會話、過時的版本：這些都是已知且確定的結論。它們會直接以一條橫幅加一個修復按鈕給出。不呼叫 AI，不用等待。
可疑的啟動要被佐證，而不是被假定
如果這次失敗不屬於已知情形，AgentsRoom 會在最初幾秒裡尋找錯誤特徵，然後檢查終端裡實際在跑的是什麼。只是啟動慢，或者首次執行時正忙著安裝自己的 MCP 伺服器的 CLI，並不算失敗，會被排除。
被診斷的是脫敏之後的上下文
只有到這一步，AI 才帶著錯誤片段、清理過的命令和引數溯源表介入。系統提示詞、看起來像金鑰的值和長引號引數，會在任何東西發出之前先在你的機器上被脫敏。
給你一份摘要和步驟，決定權在你
診斷出現在終端裡。任何東西都不會替你執行：一個操作按鈕會開啟相關設定、提議重新啟動或顯示安裝命令，而按下它的人始終是你。
答案從哪裡來
CLI Doctor 讀的就是你親手配置的那些地方。以下三處貢獻了大部分啟動失敗。
帶著顯而易見的邊界來設計
FAQ
CLI Doctor 覆蓋哪些代理 CLI？
全部覆蓋。啟動記錄寫在 AgentsRoom 派生終端的那唯一一處，所以 Claude Code、Codex CLI、GitHub Copilot CLI、Antigravity CLI、OpenCode、Aider、Grok Build、Mistral Vibe 和 Kimi Code 都在其中，從移動伴侶應用或從一張 backlog 工單啟動的代理也一樣。
它會把我的終端輸出發到伺服器嗎？
它傳送的是脫敏後的啟動錯誤片段、清理過的啟動命令和引數溯源表，而且只在真的要生成診斷時才發。系統提示詞、看起來像金鑰的環境變數值和長引號引數，會先在你的機器上被剔除。你的原始碼從不在其中，自動診斷也可以在設定的 Privacy and data 裡徹底關閉。
它會自己執行命令或改動我的設定嗎？
不會。某個步驟可以帶一個快捷入口，開啟對應的設定面板、提議重新啟動代理，或顯示可複製的安裝命令。執行動作永遠由你來做。
引數溯源具體是什麼？
AgentsRoom 的啟動命令由好幾層拼裝而成：供應商預設值、自主模式、你選的模型、推理強度、按代理設定的 CLI 覆蓋項，等等。引數溯源會給最終命令裡的每個詞標上是哪一層放進去的，於是診斷能直接指出該撥哪個開關，而不是泛泛地描述那個引數。
每次報錯它都會觸發嗎？
不會，這是刻意的。在代理終端裡，每一次啟動失敗只觸發一次，而且必須先被佐證：只是啟動慢，或者首次執行時正忙著安裝自己的 MCP 伺服器的 CLI，會被排除而不是被診斷。開發命令終端裡的診斷只能手動點選觸發，因為失敗的 watch 迴圈會不停地重複輸出同一個錯誤。
免費方案能用嗎？
可以，有每月額度。Plus 會提高額度，Pro 在實際使用中不設上限。確定性結論覆蓋了最常見的失敗，比如二進位制檔案缺失或引數被拒絕，它們完全不計入額度：因為從不呼叫模型。
代理透過 SSH 跑在遠端機器上時會怎樣？
在你這一側，前臺程序是 SSH 客戶端本身，因此遠端掛掉的 CLI 從這裡看仍然是健康的，這一次就會被跳過。這是刻意的取捨：漏掉一次診斷，好過給出一個自信的錯誤結論。在連線的遠端那一側，確定性檢查依然生效。
這和把報錯貼上給聊天機器人有什麼不同？
聊天機器人只看得到你貼上過去的那段文字。CLI Doctor 還握有實際執行的那條命令、其中每個引數的來源、正在使用的供應商和模型，以及程序的狀態，而這些都不需要你自己拼湊。正是這些上下文，把一個泛泛的回答變成一個該改哪項設定的具體名字。
你可能還會喜歡
多供應商
AgentsRoom支援9個AI編碼供應商：Claude、Codex、GitHub Copilot CLI、OpenCode、Antigravity CLI、Aider、Grok Build、Mistral Vibe和Kimi Code。為每個代理分配不同的供應商，在對話中途切換供應商，透過自動交接保持完整上下文。最好用的多供應商AI編碼工具。
狀態追蹤
一目瞭然地追蹤每個Claude Code代理的狀態。為思考中、已完成、空閒和等待輸入狀態提供顏色編碼的指示器。計時器、活動摘要和專案級計數器。
開發終端
在同一個視窗裡執行建置、測試和開發伺服器，和你的代理並肩：長命令結束時有鈴聲提醒，失敗時給出診斷。
恢復代理與終端
重新開啟應用，代理和開發終端還在你離開時的位置，還可以選擇接著上一次的 CLI 對話繼續。
AI 提交訊息
內建於 AgentsRoom 的 AI 提交訊息生成器。點選提交欄位上的閃光點，它讀取真實的 git 差異並寫入一條幹淨的Conventional Commits 格式的提交訊息。輸入一個粗略草稿，獲取重寫。您團隊的格式規則在每次生成時都會應用。
代理建議
不確定使用哪個 AI 代理？用簡單的語言描述您的任務，AgentsRoom 會建議合適的代理：來自您的房間、14 個內建角色或 260 多個目錄專家，並附上一行理由。一次點選即可分配任務。
別再猜你的代理為什麼起不來
AgentsRoom 讀取這次啟動，點名罪魁禍首，把修復方案遞到你手上。macOS、Windows 和 Linux 上均可免費下載。
配套應用：隨時隨地監控你的 Agent
使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。
把 Bug 和需求直接傳送到您的公開待辦清單。
AgentsRoom 實際執行一瞥。