Claude Code Code Mode:Claude 改成寫 JavaScript 一次做完整串工具呼叫,畫面上少了程式碼,審查要往前挪
讓 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 | const files = await $`rg -l "function retryPolicy" src`.text(); |
四行做完了找檔、改檔、跑測試三件事,最後一行把改了哪個檔、測試輸出是什麼交還給 Claude。以往要一步一步來回的流程,被收成一趟。文件列出的適合情境也都是這個形狀:同一個改動重複套在很多檔案上、搜尋結果要先過濾才值得讀、幾個互不相依的指令可以同時跑。
至於這樣到底省多少 token 或時間,文件沒有給數字,我就不印。
你看到的,比以前少
接下來是我覺得整篇最值得停下來的地方。開了 Code Mode 之後,對話畫面裡你看到的是工具呼叫,例如 edit 的 diff,看不到那段 JavaScript。想讀程式碼要按 Ctrl+O 打開 transcript viewer,每段程式在裡面是一列收合的 Code,旁邊有提示告訴你怎麼展開。
所以效率是拿「可見度」換的。以前每個工具呼叫都攤在你眼前,現在一整串動作壓進一段你得主動去翻的程式裡。文件沒有說這樣不好,但它專門交代了權限怎麼審。我的讀法是,這個配置本身就說明了重點在哪。
審查的規則是這樣分的:
- Claude 的程式碼每發出一個工具呼叫,仍然要過你設定的
deny、ask權限規則和PreToolUsehook。 - 在 auto mode 下,分類器審的是整段程式碼,不是每個工具呼叫。文件特別提醒:它看不到執行時才算出來的值,例如從搜尋輸出裡拿到的路徑,所以必須管住的呼叫,要留給規則或 hook。
- 在其他模式下,程式碼啟動時沒有審查,但會對「這個模式下本來就會問你」的每個工具呼叫逐一詢問。
- 想直接審程式碼本身,文件的做法是寫一個
PreToolUsehook,比對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 | { |
專案層的 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 查詢


















