Claude Code｜常見問題排除大全

排錯先從症狀出發，不要一開始就刪除所有設定或重新安裝。本篇把常見問題分成安裝、登入、目錄、設定、連線、工具與結果驗證，提供最小檢查路線。你會整理一份包含版本、重現步驟與原始錯誤的紀錄，讓下一次求助能直接進入問題。

請在出問題的同一環境操作。原生 Windows、WSL、桌面 App、IDE 與遠端主機可能使用不同程式、PATH 和帳號；在另一個環境執行成功，不代表原本的問題已修好。先記下正在使用的入口與專案路徑。

找不到 claude 或無法啟動

閱讀完整文字說明

常見問題排除大全，以流程和文件圖形呈現教學重點。

Get-Command claude
claude --version
claude doctor

command -v claude
claude --version
claude doctor

如果命令不存在，先重開終端機讓 PATH 更新，再核對平台安裝篇的實際安裝位置。不要同時安裝多種版本而不記錄來源，否則更新了其中一份，終端機可能仍執行另一份。

claude doctor 是環境診斷入口；對話中的 /doctor 可能是可提出修正的內建技能，兩者的操作範圍不同。需要只查看問題時，先使用終端機診斷並閱讀結果，再決定要套用哪些修正。

登入成功卻不能使用功能

先使用 /status 查看帳號與環境，不回顯權杖。訂閱登入、API key、第三方雲端供應者與組織身份，可能支援不同功能。Chrome、Remote Control、Computer Use 與雲端任務各有資格，不是一般聊天可用就全部可用。

/status

如果切換過帳號，確認目前組織與所需專案一致。遇到額度限制，查看 /usage 的限制與時間；遇到功能停用，核對管理者政策。不要把權限不足當成程式壞掉而反覆重裝。

Claude 讀不到正確專案

查看目前工作目錄，確認入口檔案真的存在。從家目錄啟動卻要求修改某個專案，可能缺少路徑與存取範圍；桌面工作也可能位於 worktree，與你編輯器打開的資料夾不同。

請回報目前工作目錄、Git 分支與最近提交。
列出根目錄的主要檔案，確認 package.json 與 index.html 是否存在。
先不要搜尋其他私人資料夾或修改任何檔案。

找到檔案後再確認分支與未提交差異。若畫面顯示舊內容，還要核對開發伺服器來自哪個目錄與連接埠；讀對檔案不代表瀏覽器正在使用同一份版本。

MD、Skill 或設定沒有生效

CLAUDE.md 的載入位置、子目錄規則與 settings.json 的優先順序不同。先看檔名、路徑與格式，再確認實際載入狀態。把 AGENTS.md 放在專案裡並不代表 Claude 會自動讀取，需依規則引用篇建立引用。

設定修改後若仍沒刷新，開新 session 做一次最小驗證。不要在不同範圍複製多份相同設定來碰運氣，這會增加覆蓋問題。需要整理時先保存原始設定與差異，逐一移除不必要的重複來源。

連線與跨裝置問題

MCP 設定存在不等於連線成功，登入成功也不等於有指定資料權限。依MCP 排錯篇逐層檢查。Remote Control 則要確認原電腦、session 與網路仍在運作，手機只是一個接續入口。

Dispatch 與雲端任務不是相同執行方式。手機送出後沒有產出時，先看任務狀態與執行位置，不要假設所有資料已同步到手機。要把雲端工作帶回本機，核對儲存庫、分支與接續流程，而不是只找相同對話標題。

命令失敗與結果不正確

保存第一個有意義的錯誤，而不是只貼最後一行「失敗」。記錄命令、所在目錄、退出碼、預期結果與實際結果。若是測試失敗，指出失敗案例與重現資料，讓 Claude 先定位原因，再提出最小修改。

平台、入口與版本：
專案目錄與分支：
我想完成的操作：
重現步驟：
預期結果：
實際結果與第一個錯誤：
已嘗試的單一修正：
修正後重測結果：

如果 Claude 說已完成但畫面不對，回到實際檔案與工具紀錄。確認是否真的修改、是否真正執行測試、是否看過正確版本的頁面。把「已提出方案」「已改檔」「測試通過」「公開發布」分開，通常就能找到缺少的那一步。

同一個錯誤若重試後偶爾消失，先記錄成功與失敗時的環境差異，包括網路、分支、程序與資料。暫時成功不一定表示根因已修好；找到可重現條件與對應修正，才能判斷問題是否真正結束。

恢復與求助

需要回復時先確認有哪些工作必須保留。/rewind 只涵蓋相應檢查點與受追蹤檔案，不會撤銷所有 shell 或外部操作；Git 也不能自動回收已發出的訊息或憑證。先看還原篇，選擇符合實際範圍的方法。

小練習是故意在練習專案使用不存在的檔名，寫出完整排錯紀錄，再修正路徑並重測。完成判準是修正前能穩定重現、修正後同一步驟成功，而且沒有為了解決小問題而刪除不相關設定或成果。

若仍需向維護者求助，提供最小可分享材料與已查證層級。沒有資格、外部服務故障或環境缺失時，清楚寫出限制，比回報模糊的「Claude 壞了」更容易獲得有效協助。

回 Claude Code 教學總目錄

• AI 工具
• 教學
• Claude Code