Claude Code｜說明、狀態與診斷

遇到 Claude Code 問題時，先取得能縮小原因的資訊，通常比直接重裝更有效。本篇會用 /help、/status 與 claude doctor 建立一份簡短診斷紀錄，分清楚指令用法、帳號狀態和安裝設定問題，並示範如何提出可處理的求助內容。

請準備已安裝的 CLI 和一個你熟悉的練習資料夾。即使 Claude 無法完成登入，部分終端機診斷仍可先執行。這篇主要使用只讀工具；目前 /doctor 與 claude doctor 的功能分類不同，執行前務必看清楚有沒有斜線，以及目前輸入位置。

先把症狀寫成一句話

閱讀完整文字說明

說明、狀態與診斷，以流程和文件圖形呈現教學重點。

「不能用」可能代表找不到程式、登入失敗、某個設定沒生效，或只有專案測試失敗。先記錄你在哪個介面、做了什麼、第一個相關錯誤是什麼。例如「PowerShell 執行 claude --version 顯示找不到命令」，就能直接把焦點放在安裝與路徑。

用 help 查正確入口

在終端機輸入 claude --help，查看啟動命令與參數。進入 Claude 對話後輸入 /help，查看目前可用的對話指令。這兩份說明回答不同層次的問題，不能拿對話選單沒有某個參數，就判斷 CLI 不支援它。

claude --version
claude --help

/help

核對範例中的參數拼字、連字號數量與是否需要值。教學中的可選中括號不應原樣輸入。若查不到某個新功能，記下你的版本與官方文件的版本條件，再決定是否更新；不要用猜測替代查證。

用 status 確認工作階段

在已開啟的 CLI 對話輸入 /status，查看目前版本、模型、帳號與連線等資訊。設定來源行能指出讀入了哪些範圍的檔案，對排查「我改了 JSON 卻沒作用」特別有用。它不會逐鍵列出每個最終值來自哪份檔案，仍需配合設定優先順序閱讀。

/status

如果本來想用訂閱，卻看見其他計費或供應商來源，先回到帳號教學查清楚。不要把完整環境變數清單貼到公開討論區；通常只需說明登入類型、設定來源和是否有相關變數，就能開始排查。

用 claude doctor 做只讀診斷

先離開或另開一個終端機，在相同專案環境執行 claude doctor。它會檢查安裝與設定狀態，包含可能的多份安裝、設定驗證問題或功能資格。閱讀第一個與症狀直接相關的項目，再依建議修正一個變因。

claude doctor

目前官方把對話內 /doctor 列為附帶 Skill，可以整理問題並在確認後協助修改；它不是上述命令的完全等價寫法。如果你只是要收集資訊，本篇先用終端機命令即可。之後選擇使用修正流程，也要閱讀它提出的具體變更。

依症狀做最小修正

如果提示找不到指令，Windows 可用 Get-Command claude，macOS／Linux 可用 command -v claude 檢查解析路徑。若 PATH 更新後舊視窗仍不認得，先開新終端機。若設定 JSON 有錯，依錯誤位置修正引號、逗號或資料型態，不必刪除整個設定目錄。

Get-Command claude -All

command -v claude

修正後重跑原本失敗的命令，而不是只跑一個不相關檢查。假設原本錯的是 npm test，doctor 通過只能證明工具設定沒有指出問題，不能代替測試通過。把安裝診斷、登入測試、專案測試分開，才能誠實說明問題到底修到哪裡。

寫一份有用的診斷紀錄

若問題只在公司網路出現，可以比較同一命令在已允許的另一個網路環境是否重現，但不要繞過公司要求的代理或存取政策。先確認錯誤發生在 DNS、連線、授權還是模型回應階段，並把第一個相關訊息保留下來。網路能開一般網站，不代表所有 CLI 需要的端點都能正常使用。

修正過程一次改一個變因，並在紀錄標明修改前後的差異。若同時更新程式、換帳號又改 JSON，即使問題消失，也很難知道真正原因；之後同樣症狀再出現時，就無法沿用這次經驗。

介面與系統：例如 Windows PowerShell／macOS Terminal
Claude Code 版本：填 claude --version 結果
安裝方式：原生／Homebrew／WinGet／其他已確認方式
專案位置：填可供自己辨認的位置，公開分享時隱去私人部分
重現步驟：從哪個資料夾輸入哪個命令
預期結果：應該看到什麼
實際結果：第一個相關錯誤
已做檢查：help、status、doctor 的必要摘要
修正後驗證：重跑同一個命令的結果

紀錄要保留錯誤碼與必要訊息，但先移除憑證、私人網址參數和無關個人資訊。分享之前自己讀一遍，確認別人能用這些步驟理解問題，而不是只看到幾百行混雜日誌。若要使用產品內回報功能，也先閱讀將附上的內容與送出範圍。

小練習是在正常環境建立一份基準紀錄，再於暫存設定檔故意留一個多餘逗號，觀察 JSON 檢查如何指出問題，修正後重新驗證。不要拿團隊正式設定做實驗。完成判準是能分辨症狀層級、找到相應工具、修正單一原因並重跑原步驟；更完整的症狀索引可看常見問題排除。

回 Claude Code 教學總目錄

• AI 工具
• 教學
• Claude Code