Claude Code 最新官方故障排除與常見卡住處理

1

先做這個：

Ctrl+C

如果只是卡住但程式還活著，這通常能中斷目前回合。Claude Code 的 session 可以直接續接，最實用的是重開後跑：claude --continue，它會延續目前目錄最近一次對話。官方也支援 claude --resume 用挑選器找回 session。(Claude API Docs)

直接照這個順序處理：

# 1) 先中斷
Ctrl+C

# 2) 若回到 shell prompt，直接續跑原 session
claude --continue

# 3) 若想手動選 session
claude --resume

如果 Ctrl+C 沒反應，就直接開新 terminal，進同一個專案資料夾後執行：

cd /path/to/project
claude --continue

因為 Claude Code 會把對話存在本機，resume 時會把之前的對話、工具狀態一起恢復。(Claude API Docs)

如果它不是單純卡住，而是這次 session 已經變得很重、很慢，先不要硬救當前畫面，直接重開後做兩件事：

claude --continue

進去後用：

  • /rewind 回到前一個正常點
  • 或按 Esc 兩下打開 rewind menu

Claude Code 會自動建立 checkpoints；每次 prompt 前都會留一個 checkpoint，所以可以回退 code、回退對話，或只做 summarize 來縮小 context。(Claude API Docs)

再來做版本排查。最近官方 release notes 確實有修過 CLI freeze 類問題，例如 /mcp reconnect 在不存在的 server name 下會把 CLI 凍住。先更新到最新版。(Claude API Docs)

claude update

如果你是 Homebrew 裝的：

brew upgrade claude-code
# 或
brew upgrade claude-code@latest

官方也寫明 Homebrew 不會自動更新。(Claude API Docs)

如果你常遇到「像卡住其實是在超長思考」的情況，先把 thinking 關掉或降到最低。官方文件寫得很明確，thinking 會吃輸出預算與更多上下文；在 Opus 4.6 / Sonnet 4.6 上則是 adaptive reasoning。(Claude API Docs)

實際上你現在先用這個最短恢復路徑：

# 新 terminal
cd /你的專案
claude --continue

然後：

  1. 能進去就先 /rewind
  2. 再 claude update
  3. 之後把重任務拆去另一個 worktree/session 跑，避免同一個 session 撐太久。官方推薦平行任務用 git worktrees。(Claude API Docs)

最短結論：
卡住就不要硬等。先 Ctrl+C，不行就開新 terminal 跑 claude --continue，回來後 /rewind，再更新 claude update。