Claude Code Troubleshooting 索引：第 33-35 篇安裝、執行期與設定診斷

🌏 English version

原本這一頁預計收錄 Claude Code 的所有疑難排解情境，寫作時發現三類問題的排查路徑差太多——裝不起來要看安裝日誌、跑到一半掛掉要看網路與 API 錯誤、設定了沒生效要比對各層設定檔——硬塞在同一頁只會互相干擾。所以這組 troubleshooting 被拆成系列第 33-35 篇，每篇各自展開症狀、診斷工具與修法：

• 第 33 篇：Claude Code 裝不起來、登不進去怎麼排：PATH、安裝來源、proxy、OAuth callback：command not found、PATH 問題、認證失敗、連不上 API——還沒能用起來的都看這篇（English）
• 第 34 篇：Claude Code 執行期問題怎麼解：CPU 記憶體、session hang、auto-compact thrashing、搜尋失效：回應中斷、效能異常、搜尋與 context 相關的卡關——用得起來但跑不順的看這篇（English）
• 第 35 篇：Claude Code 設定了卻沒生效怎麼診斷：/context、/doctor、/mcp 與常見錯誤對照：CLAUDE.md 沒被遵守、hook 不觸發、MCP 連不上、設定被覆蓋——「設定了但沒生效」看這篇，附 /context、/doctor、/mcp 用法與常見錯誤訊息對照表（English）

系列全貌與底層機制從入口篇開始。

參考資料

• Debug your configuration — Claude Code Docs — 設定診斷篇的主要依據：診斷指令、safe mode 與常見設定地雷
• Error reference — Claude Code Docs — 執行期錯誤對照表的來源：每條錯誤訊息的意思與復原步驟
• Troubleshooting 索引（英文版）

更新紀錄

• 2026-08-26：合集拆分為第 33-35 篇專文，本頁轉為索引。