【2026 最新】Claude Code 在 VS Code 卡住怎麼辦？四步排查、Session 復原與漏送訊息核對

Claude Code 在 VS Code 卡住，你按了送出，游標卻一直轉；重新開啟後，又不確定最後那句「改完就部署」有沒有送達。此時最有用的第一步，是把畫面、對話與實際工作分開核對。

這篇專為第一次排查擴充故障、願意照著選單和短指令操作的讀者寫。用四步判斷問題偏向編輯器、特定 Session（一次對話及其紀錄），還是服務與連線，再找回工作。操作查核截至 2026 年 10 月 18 日；下文是文件整理的診斷流程與假設案例。

先說結論：Claude Code 在 VS Code 卡住，先留證據再恢復

安全恢復＝找回對話＋核對訊息＋驗收已做的工作。把它想成電話斷線：通話紀錄能幫你找到同一個人，卻還要問清楚最後一句是否聽到、交辦的事是否辦完。

• 先保存錯誤、時間、版本和最後指令，暫停連續重送。
• 用一個無附件、無工具要求的新短對話做對照，再測乾淨 Profile。
• 從歷史找回原 Session；切換 CLI 前，先處理原處仍在執行的工作。
• 最後查檔案、背景工作與外部平台，只補做已確認缺少的下一步。

原理：卡住的可能是三個不同環節

第一層是 VS Code 的面板與 Extension Host，後者是執行擴充功能的程序。第二層是 Claude Code 對話和執行程序。第三層是它操作的工作：檔案、測試、部署或外部服務。這是本文用來排查的分層；畫面不更新時，逐層找可觀察的證據，比直接猜模型壞了更有用。

同樣地，「輸入框還留著文字」「歷史裡出現使用者訊息」「工具回報成功」「外部平台真的完成」各回答不同問題。尤其是 官方連線中斷說明：程序尚未確認或完成訊息，連線就結束時，擴充端會無法判定是否處理。官方建議重送；若原指令含部署、傳送或建立資源，本文增加一道操作上的核對：先查結果，再決定重送什麼。

Claude Code 在 VS Code 卡住：四步排查與恢復

①「先拍現場」：記錄錯誤、版本與最後動作

不知道該從哪裡查？先留下同一段時間的紀錄。複製錯誤完整文字、發生時間與時區、最後指令，以及當時是否讀圖片、等待授權或執行命令。只截到轉圈圈，往往看不出前一個失敗環節。未送出的文字先另存，截圖時遮住專案名稱與機密。

在 VS Code 的 Help > About 記編輯器版本，再到 Extensions 搜尋 Claude Code，記下擴充版本。若終端機本來已能使用 CLI，再執行 claude --version；把兩者分開記，避免把終端機版本誤當擴充版本。

出現 Claude Code process exited with code N 時，點錯誤旁的 View output logs，保存該時間附近的輸出。官方錯誤參考指出，結束碼本身不足以判定原因，要讀程序的實際輸出；已安裝 CLI 的讀者也可用 claude doctor 查安裝與設定。它若提出修正，先讀內容，別一口氣接受所有變更。

另外打開 Claude 官方狀態頁，比對發生時間和相關服務。狀態頁有事件，是值得記錄的共同線索；頁面顯示正常，也先保留本機、網路與帳號問題的排查空間。若畫面明確寫用量到限，改走 額度中斷與續跑教學，本篇先處理 IDE 與訊息傳遞。

②「換一通短電話」：新對話、乾淨 Profile，一次只換一項

只有原對話卡，還是任何對話都卡？先做最小對照。保留原對話名稱，另開新對話，只送「請只回答 OK，不讀取檔案、不執行工具」。確認當時面板沒有自動附帶選取文字或開啟檔案；這是一個很小的服務請求，仍會使用帳號用量。記錄它是否回覆及錯誤文字，不替等待時間預設成功門檻。

若新對話可回覆，先記「舊 Session 特有的線索」，別直接宣告歷史已損壞；若新舊都失敗，再往共同環境查。下一個對照是 VS Code Empty Profile：從管理齒輪進入 Profiles，選 New Profile，名稱填 Claude Recovery Test，Copy from 選 Empty Profile（部分介面標為 None），再 Preview／Create。Microsoft 的 Profile 指南把它定義為不含使用者自訂設定、擴充等內容的起點。

在測試 Profile 只安裝官方 Claude Code 擴充；先開只有假資料的練習資料夾，做同一個短對話。之後若需要比對原專案，先結束原處的執行，再於相同專案重試。第一次換了 Profile 又換了專案，兩項差異都要記下；不能把結果全部歸因於擴充衝突。

Profile 也不等於隔離整台電腦或 Claude 帳號。專案設定、Claude 自身設定、網路及服務端條件，仍是另外的檢查面。若乾淨組可用，可逐一恢復原設定與其他擴充；每次只加一項、重做同一短題，找出可重現的差異。

③「先查自動接續」：重開視窗與原 Session

想直接重新載入？先核對是否會接續工作。截至查核日，官方 VS Code 指南記載，v2.1.274 起符合條件時，重載後會繼續被中斷的步驟。要先人工核對，可在 Extensions > Claude Code 設定搜尋 Continue After Reload 並取消勾選，再重新載入；把原設定記下，完成排查後自行決定是否恢復。

保存編輯中的檔案，並確認目前沒有要保留的執行中命令後，用 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows／Linux）開命令面板，選 Developer: Reload Window。需要針對擴充程序做一次對照時，可選 Developer: Restart Extension Host；它作用於擴充宿主，要先考慮其他擴充中的工作。Microsoft 的命令實作可核對重啟命令。這兩個動作是排查手段，效果要由同一短題確認。

接著從 Claude Code 面板上方 Session history 找原對話，核對名稱、時間與最後內容，再開啟。若出現對話已在別處開啟的提示，先找出原視窗或終端機，避免同一 Session 同時收指令。短暫空白也先看狀態文字；持續失去回應時，保存新錯誤，別連續重載同一個失敗狀態。

版本也可能影響恢復行為。查核當日的 官方更新紀錄最上方版本為 2.1.302；其中 2.1.301 記載了 VS Code 對話重開時的穩定性修正。把自己的版本、該修正與實際症狀對照，再更新並重做短題。一位 社群求助者 在 2.1.301 仍回報問題，因此「達到某版」與「你的故障已解除」要各自驗收。

④「換入口，不換案子」：CLI 接續與訊息核對

面板仍壞，但想找回同一工作？已具備獨立 CLI 時再走終端機。在原專案目錄開終端機，執行 claude --resume，從選單挑原對話；需要指定時，可用 claude --resume 你的會話ID，把中文占位換成真正 ID。官方 Session 文件提供這些入口。

若顯示找不到 claude，先完成 官方 CLI 安裝流程，再回來核對。擴充面板與獨立 CLI 是不同安裝入口。這裡不把安裝當作故障診斷結果，也不要求已有問題的讀者順便改模型、權限模式或整套工具鏈。

恢復後先找最後一則使用者訊息，再往後讀工具要求、工具結果與錯誤。最後指令完整出現，至少可對回這段保存的歷史；文字不見時，仍標為「未確認」。若同時見到磁碟已滿或 transcript 寫入失敗，先按 官方紀錄儲存錯誤處理，因為訊息可能未存進供恢復的紀錄。

同一 Session 避免在兩個終端機同時續跑；官方 Session 文件說這會把訊息交錯寫進同一紀錄。先關閉或停止原處的 Claude 執行，再移交另一個入口。接續對話後，也重新讀提示中的權限與工作目錄，確認現在接手的是你要的環境。

完整例子：讀圖時卡住，怎麼知道最後一句送到了沒？

假設你要求「看這張設計圖，把按鈕改成藍色，測試通過就部署」。面板停在讀圖。以下是供你套用的情境，沒有預填測試成績：先記最後指令與時間，在外部筆記標「圖片讀取未知、改檔未知、部署未知」。接著完成短對話對照和 Session 復原。

在專案根目錄依序執行 git status --short、git diff --stat、git diff、git diff --cached，必要時再用 git log -3 --oneline 查近期提交。Git status與 Git diff各自描述狀態及差異；未追蹤檔案要另開查看，已提交的變更也要看提交內容。

若按鈕已改色，把它記成「檔案有改動」，再對照任務前的基準，分清原本未提交的工作。終端機的測試輸出、Claude 工作列表和部署平台也各自核對；讓部署紀錄的時間、版本與本次修改對上。Git 差異很乾淨，也可能因變更已提交，或工作發生在外部服務。

• 訊息找不到，檔案和遠端狀態已查清：重新寫一個只涵蓋缺少步驟的指令。
• 訊息在、檔案已改、測試未知：先跑專案既有測試，按結果安排下一步。
• 部署平台已有對應版本：先驗收該部署，保留部署 ID。
• 外部結果仍未知：停在查詢與釐清，不把未知填成「尚未做」。

可貼給恢復後的 Claude：「先只讀核對：原指令、目前 Git 差異與近期提交、未追蹤檔案、背景工作及部署紀錄。把每項分成已證實、未完成、未知。先提出一個下一步；暫時不要改檔、部署或送出對外請求。」這段提示是交接要求，仍要檢查它實際提出的工具動作。

排查還原與回報：交出最小、可脫敏的重現

想讓維護者能追查？整理「版本＋時間＋最短操作＋預期／實際結果＋日誌片段」。例如只附一張自製、無私人內容的測試圖片，寫明純文字短題是否正常、原 Profile 與測試 Profile 是否不同。不要直接上傳完整私人 Repo、帳號資訊或整份對話紀錄。

從 Claude Code 的 /feedback 或 官方問題追蹤器回報時，先檢視要送出的內容；官方資料使用說明交代回饋資料的處理。保留錯誤碼與先後順序，把 token、Email、私人路徑、客戶資料及機密程式替換成一致占位符。

最後切回原本 Profile；逐項還原你在排查中調整的設定，重新做短題，再做一件可復原的小任務。一次正常可記為這次通過；若再發生，把新的時間和版本加到同一份私人紀錄，讓不同次的症狀能比較。

FAQ：Claude Code 在 VS Code 卡住的八個直接答案

1. 重裝擴充一定會修好嗎？

不一定。先用新對話和乾淨 Profile 留下對照結果；重裝後也用相同短題驗收。

2. Restart Extension Host 與 Reload Window 怎麼選？

先看要檢查哪一層。前者重啟擴充宿主，後者重載視窗；兩者前都先保存檔案、確認執行中工作。

3. 訊息留在輸入框，代表沒送到嗎？

先標未確認。對照恢復的歷史、日誌及工作結果，再決定要補送什麼。

4. Session 開啟了，工作就完成了嗎？

還要驗收。看見歷史代表找回了可讀紀錄；改檔、測試和外部操作各自查結果。

5. CLI 能用，代表 VS Code 有 bug 嗎？

它是縮小範圍的線索。比較相同專案、帳號、設定和短題，保留兩個入口的版本與錯誤。

6. 重載後，Claude 會自己繼續嗎？

符合官方條件時會。先讀 Continue After Reload 設定，外部動作未釐清時先取消勾選，再核對現況。

7. Git diff 沒內容，能直接重做嗎？

先查其他證據。暫存區、近期提交、未追蹤檔案和部署平台，都可能有需要確認的結果。

8. 我不會看程序和日誌，今天能做什麼？

先做最小紀錄。留下錯誤、時間、兩個版本、新短對話結果，以及最後一項工作是否完成；再把未知交給可協助的人追查。

給新手的三個重點

• 轉圈是現象；新短對話、乾淨 Profile、CLI 是對照工具。
• 歷史、訊息與實際工作分開核對，每個未知都保留到查清。
• 每次只改一項；恢復後只做一個已確認需要的下一步。