Claude Code 的 /doctor：幫你的設定做一次全身體檢

打完 /doctor 按下 enter，畫面唰一下跳出十幾行帶顏色的檢查結果——綠的、黃的、紅的。大部分人瞄一眼「喔沒事」就關掉了。

但你有沒有想過，這短短一兩秒裡，它到底跑進你的電腦翻了哪些東西？

先別管它能幫你修什麼。先看它收到指令之後，第一件事去看哪裡——把這個黑盒一層一層打開，你才會知道那幾行綠黃紅到底在講什麼，也才知道什麼時候該認真看它。

它做的第一件事：搞清楚你這台是怎麼裝的

/doctor 開場不看你的程式碼，先看你自己。你這個 Claude Code 是用 npm 全域裝的、本地裝的、還是原生安裝？

這像醫生問診第一句不是「哪裡痛」，而是「你平常怎麼過日子」。因為安裝方式決定了後面一整串事情：怎麼升級、權限怎麼管、更新頻道走哪條。用錯方式硬修，等於感冒吃錯藥。

緊接著它會做一件很多人沒注意的事——數一數你到底裝了幾個。你以為只有一個 Claude Code，結果 npm 全域一個、~/.claude/local 一個、Homebrew 又偷偷塞一個。這就像家裡三支長得一模一樣的遙控器，你手上按的那支到底控哪台電視，自己都說不準。/doctor 會把它們全列出來，然後提醒你：欸，你這邊有三個喔。

中間這幾層：設定跟現實對不對得上

打開下一層，它開始比對「你以為的」跟「實際上的」是不是同一件事。

設定檔裡記著你是 npm-local，但你上個月其實已經換成原生安裝了——這種對不上的地方，/doctor 會抓出來叫你更新。你沒改，它就一直用舊資訊猜你的環境，猜錯了當然出怪事。

再往裡是 MCP 設定。這塊最容易炸。少一個逗號、路徑打錯一個字、指令根本不存在——這些手殘小錯平常不會報，等你真的要用那個 MCP server 才發現連不上，然後你在那邊 debug 半天。/doctor 直接幫你掃過一遍，哪個設定壞了、壞在哪，一次講清楚。

還有一個很不起眼但沒了會要命的東西：ripgrep。Claude Code 的搜尋（那個 Grep 工具）整個靠它。ripgrep 一旦不在，搜尋功能直接瞎掉，而且錯誤訊息通常讓你摸不著頭緒。/doctor 會確認它在不在、能不能跑，不行的話告訴你確切原因跟修法。

等等，先插一句怎麼看報告。別從最上面一項一項想修。綠色的是正常的，跳過；你要看的只有黃字（警告）跟紅字（錯誤）。一份體檢報告，健康的項目瞄過就好，真正要停下來的是那幾條紅的。

最有感的一層：你的 CLAUDE.md 是不是胖了

再打開一層，它去量你的 CLAUDE.md 有多大。超過四萬個字元，它就會跳警告。

為什麼要管這個？因為 CLAUDE.md 是每次對話都會整份載入的東西。想像你每次開會，主席都要先把整本員工手冊從第一頁念到最後一頁才准講正題——手冊越厚，你能拿來講真正重要的事的時間就越少。CLAUDE.md 塞太多，等於每次都先拿一大塊 context window 去讀那本手冊，能留給實際工作的空間就被擠掉了。

最後它還會非同步去網路上問一聲：有沒有新版？然後把你現在的版本、最新的版本、你走的更新頻道（stable 還是 latest）一起顯示出來。這步要等一下下，因為它得連出去查，剛跳出來時可能還是空的，等兩秒才會填上。

2026 年那次升級：從「會講」變成「會修」

如果你上次認真用 /doctor 是好幾個月前，那你認識的可能是舊版的它。

7 月 8 日的 v2.1.205 給它動了一次不小的手術。以前的 /doctor 比較像個只會搖頭的醫生——把問題指給你看，剩下你自己想辦法。現在它變成一次完整的 setup 體檢，而且能動手幫你修，順帶多了個別名 /checkup，打哪個都一樣。

真正有意思的是它新長出來的一項掃描：那些你載入了卻從來沒用過的 skills、MCP server、plugin。這些東西是最陰的一種負擔——它們不會報錯、不會炸，只是安靜地佔著你的 context，每次對話都陪跑一份，你還完全沒感覺。連同那些重複、灌水的 CLAUDE.md（寫了一堆其實 Claude 看你的 code 就能自己推斷的規則），它現在都會一併揪出來。

不過它不會自作主張。找到問題會先攤開來給你看，問過你才動手——你在結果畫面按 f，它才會去修它報告的那些項目。

用之前，先知道這幾件事

/doctor 很好用，但有幾個邊界值得先講清楚，不然容易誤會。

第一，session 裡的 /doctor 跟終端機的 claude doctor 不是同一個東西。前面講的死重量掃描、先問過你再修的流程，是你在 Claude Code session 裡打 /doctor 才有的。如果哪天 Claude 連開都開不起來，你得從 shell 直接跑 claude doctor——那個是經典的安裝檢查（安裝型態、版本、PATH、ripgrep、自動更新），專門對付「連不進去」的狀況。它跑完還會貼心提醒你：想要完整體檢，請進 session 打 /doctor。

第二，按 f 一鍵修之前，先把它列的內容看過一遍。它偶爾比較會「指路」而不是「修路」——把它當成告訴你「該去哪看」的工具，比當成「一鍵解決全部」的按鈕更接近實情。

第三個是安全問題，別忽略：/doctor 為了健檢會略過工作區的信任確認、還會去啟動 MCP server。所以只在你信得過的目錄跑它。在一個來路不明、剛 clone 下來的專案資料夾隨手 /doctor，等於在陌生人家裡隨便按牆上的開關，你不知道會啟動到什麼。

體檢報告不是拿來嚇你的

把黑盒拆到這裡，/doctor 到底在幹嘛就很清楚了：它把你散落在安裝路徑、設定檔、MCP、CLAUDE.md 各處的狀態，收攏成一張帶顏色的清單。

而這件事之所以值得每隔一陣子做一次，是因為開發環境跟人的身體一樣——它會在你沒注意的時候慢慢長出東西。多裝的那個 plugin、半年前試一次就忘的 MCP、CLAUDE.md 裡越疊越厚的規則。這些不會跳出來喊「我在拖慢你」，它們只是安靜地佔著位置。/doctor 真正的價值，是把這種看不見的累積，變成一份看得見的清單。

看懂它之後，下一站可以接著摸 /context。/doctor 回答的是「我的設定有沒有病」，/context 回答的是「我這次對話的 context 到底被誰吃掉」。一個管環境健康，一個管當下的資源分配，兩個湊起來，你對「Claude Code 現在到底在想什麼」才算有了完整的儀表板。

下次卡住，先別急著上網搜錯誤訊息。打個 /doctor，讓它先幫你把身體檢查一遍——很多時候答案就在那幾行紅字裡。