讓 Claude 一次做完整串事情的功能,我的看法是,最該先學的不是怎麼開,是怎麼審。

沒開的時候是這樣。改一個設定值,Claude 要先找檔案,再讀,再改,再跑測試,每一步都是一次工具呼叫,而且每一步它都得讀完上一步的結果才決定下一步。官方文件對這件事的描述很直接:沒有 Code Mode 的時候,Claude 直接要求 Bash、Read、Edit 這類工具呼叫,並在每個結果出來之後才決定接下來做什麼。

Code Mode 換了一種做法。Claude 改成寫一段 JavaScript,由 Claude Code 在你的 session 裡執行,工具呼叫都寫在這段程式裡。文件說這一段程式可以平行跑指令、把上一個結果餵給下一個呼叫,最後只回傳 Claude 需要讀的那部分輸出。

這是實驗功能,預設關閉。文件原文是「It may change or be removed in any release」,任何一版都可能改動或移除。另外它要求 v2.1.323 以上;2026-11-16 查 npm dist-tags,stable 通道是 2.1.311,低於 2.1.323,所以 stable 使用者目前拿不到。文件的建議是等 stable 追上,或切到 latest。

官方範例長什麼樣

文件給了一段 Claude 會寫的程式,我原樣貼過來:

1
2
3
4
const files = await $`rg -l "function retryPolicy" src`.text();
const target = files.trim().split("\n")[0];
await edit(target, "maxAttempts: 3", "maxAttempts: 5");
({ edited: target, tests: $`npm test -- retryPolicy`.nothrow() });

四行做完了找檔、改檔、跑測試三件事,最後一行把改了哪個檔、測試輸出是什麼交還給 Claude。以往要一步一步來回的流程,被收成一趟。文件列出的適合情境也都是這個形狀:同一個改動重複套在很多檔案上、搜尋結果要先過濾才值得讀、幾個互不相依的指令可以同時跑。

至於這樣到底省多少 token 或時間,文件沒有給數字,我就不印。

你看到的,比以前少

接下來是我覺得整篇最值得停下來的地方。開了 Code Mode 之後,對話畫面裡你看到的是工具呼叫,例如 edit 的 diff,看不到那段 JavaScript。想讀程式碼要按 Ctrl+O 打開 transcript viewer,每段程式在裡面是一列收合的 Code,旁邊有提示告訴你怎麼展開。

所以效率是拿「可見度」換的。以前每個工具呼叫都攤在你眼前,現在一整串動作壓進一段你得主動去翻的程式裡。文件沒有說這樣不好,但它專門交代了權限怎麼審。我的讀法是,這個配置本身就說明了重點在哪。

審查的規則是這樣分的:

  • Claude 的程式碼每發出一個工具呼叫,仍然要過你設定的 deny、ask 權限規則和 PreToolUse hook。
  • 在 auto mode 下,分類器審的是整段程式碼,不是每個工具呼叫。文件特別提醒:它看不到執行時才算出來的值,例如從搜尋輸出裡拿到的路徑,所以必須管住的呼叫,要留給規則或 hook。
  • 在其他模式下,程式碼啟動時沒有審查,但會對「這個模式下本來就會問你」的每個工具呼叫逐一詢問。
  • 想直接審程式碼本身,文件的做法是寫一個 PreToolUse hook,比對 REPL(執行 Claude 程式碼的那個工具),從 tool_input.code 讀出 JavaScript。

我的立場

如果我要試,我會把「擋什麼」寫進 deny、ask 規則和 hook,不靠 auto mode 的分類器替我把關。理由就在上面那句:分類器審的是程式碼的字面,看不到執行時才算出來的路徑。規則是對每個工具呼叫生效的,這一層不會因為工具呼叫被包進程式碼就消失,我寧可把防線放在這一層。

會讓我改變想法的條件有兩個。第一,如果我自己實際跑過,發現分類器對這類計算出來的路徑其實攔得住,我會放寬。第二,如果日後文件改寫了權限檢查的描述,例如規則不再逐一套用在程式碼裡的工具呼叫,那我這條立場的根基就沒了,要重想。

兩個文件載明、會讓人愣一下的行為

第一個前面講過:畫面上沒有程式碼,要 Ctrl+O。

第二個和 session 有關。Code Mode 的 session 是綁定它的:要用 claude --continue 或 claude --resume 接回來,必須保持 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE 設為 1。Code Mode 關著的時候,Claude Code 會拒絕續接那個 session。反過來,沒開 Code Mode 開始的 session,就算變數設了 1,續接時也還是不開。開啟之後,session 頂端附近會出現這行字,也是在提醒這件事:

1
Code Mode (experimental) is on · this session can be resumed only with Code Mode on

文件另外寫了,Code Mode 的 session 只能在終端機、而且開著 Code Mode 的情況下續接。這代表如果你習慣在不同介面之間搬 session,這功能目前不適合你:它不能把 session 移到 Desktop app,也不能轉成 background session,/fork 也開不了背景副本。

怎麼開、怎麼關

環境變數 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE 設為 1。macOS、Linux、WSL 這樣開:

1
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

Windows PowerShell 先 $env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1" 再執行 claude。要永久開,寫進 ~/.claude/settings.json:

1
2
3
4
5
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}

專案層的 settings 檔裡設這個變數會被忽略,文件的說法是這樣 clone 下來的 repo 沒辦法替你打開 Code Mode。第一次使用前,Claude Code 會要你確認,選 Yes, turn on Code Mode 之後它會重新啟動。

關閉的方式是移除變數,或把值改成 0。兩個地方只要有一處是 0,就算另一處設 1 也關著。組織要封鎖,在 managed settings 放 {"env": {"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0"}};但文件明說,你沒辦法用 managed settings 替使用者把它打開。

開不起來的時候

需求清單不短,我只挑最容易撞牆的幾項:要 Claude 訂閱或 Console 帳號,經過 gateway、Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 都不行;要用互動式終端的 claude,-p、Agent SDK、VS Code 面板、Desktop app、雲端 session 都不支援;模型限定在文件列的那幾個。設了 API key helper、agent teams、OpenTelemetry 匯出或 DISABLE_TELEMETRY 也會讓它起不來。

起不來的時候,session 開頭會出現 Code Mode (experimental) isn't available,同一行附上原因,/status 也看得到。文件的原因例子像是 it only works with the Anthropic API、OpenTelemetry is on。

還有幾條執行上的限制:程式碼不能在背景跑的話,你得等它跑完,而且十分鐘後會被停掉,包含你停在權限提問上的時間;要背景執行,得用 auto 或 bypassPermissions mode 開始 session,這時程式碼最多可以跑兩小時。Remote Control、Claude in Chrome、computer use 在 Code Mode 下都不能用。

我沒跑過

這篇我只讀了官方文件和 changelog,沒有實際執行過 Code Mode。文件裡出現的 $、edit 這些函式,我也只在範例裡看過,完整 API 文件沒讀。所以上面講功能行為的每一句都是「文件這樣寫」,不是「我試出來是這樣」;「我的立場」那段是我自己的判斷。它又是實驗功能,細節隨時可能不同。

如果真要試,文件給了一句現成的提示詞:Read every Markdown file in this project and list the links that point to local files that don't exist.。我想在動手前先把 permission modes、hooks 和 sandboxing 的文件讀過一遍,因為這個功能要你做的決定,其實都在那三處。

Claude 一次做的事越多,畫面上露出的就越少。所以我會先決定規則寫在哪一層,再談要不要開。

原文來源:Code Mode - Claude Code Docs、Changelog(2.1.323);版本號取自 2026-11-16 的 npm dist-tags 查詢