Code Mode 是什麼?Claude Code 實驗功能的啟用步驟與限制

Claude Code 2.1.323 加入實驗性 Code Mode,讓 Claude 用 JavaScript 呼叫工具。本文依官方文件整理啟用步驟、需求、權限與限制,並對照 X 貼文的版本說法。

Share
Claude Code 官方文件 Code Mode 頁面的分享用標題卡:深色背景,左上是 Claude Code Docs 標誌,中間小字分類 Model and responses,下方是頁面標題 Run tool calls from code with Code Mode,與被截斷的兩行英文簡介
Claude Code 官方文件 Code Mode 頁面的分享用標題卡,圖中只有頁面標題與簡介,不是產品操作畫面,未經修改。 圖片來源:官方原文。

第三方帳號 @dani_avila7 在 2026 年 11 月 15 日貼文稱,Code Mode 已在 Claude Code 2.1.325 實驗性提供,Claude 會寫 JavaScript,在單一步驟執行多個工具呼叫。

這項功能有官方來源。Claude Code 的 CHANGELOG 把 Code Mode 列在 2.1.323,官方文件也有專頁,所以貼文的核心說法可以確認。

不過貼文只寫了 2.1.325。依 CHANGELOG,功能是 2.1.323 加入。另外,這項功能預設關閉,適用範圍也很窄。

Code Mode 是 Claude 使用工具的另一種方式。沒開時,Claude 逐一要求 Claude Code 執行指令、讀檔或改檔,這些動作稱為工具呼叫。

開啟後,Claude 先寫一段 JavaScript,再由 Claude Code 在你的工作階段裡執行。

官方文件稱它是實驗功能,可能在任何版本更改或移除。它只支援終端機裡的互動式 claude 工作階段,所以用 VS Code 面板與桌面版的人用不到。

本文不是實測。啟用步驟、限制與權限說明,全部依 Anthropic 官方文件與 CHANGELOG 整理,查詢日期是 2026 年 11 月 16 日。

我的判斷是,這項功能值得先當成觀察對象,不適合直接寫進團隊的標準流程,因為文件列的限制很多。

Code Mode 是什麼?Claude 先寫 JavaScript 再呼叫工具

Code Mode 的重點,是改變 Claude 呼叫工具的方式:由 Claude 寫一段程式碼,再用程式碼去呼叫工具。

依官方文件,沒開 Code Mode 時,Claude 直接要求執行 Bash、Read 或 Edit,讀完每次結果後,再決定下一步。

開啟後,Claude 改寫一段 JavaScript 來呼叫這些工具,Claude Code 在你的工作階段裡執行這段程式碼。

文件說,一段程式碼可以平行執行多個指令,也可以把上一個結果用在下一次呼叫,只回傳 Claude 需要讀的那部分輸出。

例如文件的範例是調高重試次數上限。Claude 寫的程式碼先用 ripgrep 找出定義重試政策的檔案,再把 maxAttempts 從 3 改成 5,接著跑相關測試。

最後一行把檔案路徑與測試輸出回傳給 Claude。ripgrep 是搜尋程式碼的指令列工具。

你在對話裡看到的是各個工具呼叫,例如編輯的差異內容,看不到程式碼本身。要讀程式碼,就按 Ctrl+O 開啟逐字稿檢視器,每段程式碼會以收合的 Code 列顯示。

官方把適用情境寫成需要許多相關工具呼叫的任務,但沒有提供速度或用量的實測數字。弄清楚它做什麼之後,先確認貼文講的版本對不對。

Claude Code 官方文件 Code Mode 頁面的分享用標題卡:深色背景,左上是 Claude Code Docs 標誌,中間小字分類 Model and responses,下方是頁面標題 Run tool calls from code with Code Mode,與被截斷的兩行英文簡介
Claude Code 官方文件 Code Mode 頁面的分享用標題卡,圖中只有頁面標題與簡介,不是產品操作畫面,未經修改。 圖片來源:官方原文。

Code Mode 從哪一版開始?2.1.323 加入,2.1.325 修正

Code Mode 在 Claude Code 2.1.323 加入,2.1.325 是後續的修正版。

CHANGELOG 在 2.1.323 的第一條新增 Code Mode,並形容它是 "an experimental opt-in in which Claude writes JavaScript to call its tools"。

意思是一項實驗性的選用功能,由 Claude 寫 JavaScript 來呼叫工具,中文為本文翻譯。

GitHub Releases 頁面標示,v2.1.323 發布於 2026 年 11 月 12 日,v2.1.325 發布於 11 月 13 日,時間均為 UTC。CHANGELOG 與 Releases 清單都沒有 2.1.324 的條目。

2.1.325 的 CHANGELOG 列了三條跟 Code Mode 直接相關的修正。

第一條處理三件事。Code Mode 腳本忽略用 EnterWorktree 切進的 git 工作目錄,也會把 ~ 開頭的路徑寫進專案。

另外登入過期後,/mcp 仍顯示 MCP 伺服器已連線。MCP 是 Claude 連接外部工具與服務的協定。

第二條是在權限對話框或計畫核准時,跟著 Yes 一起輸入的文字,沒有送到 Claude。

第三條是工作階段在 Code Mode 腳本執行中結束,之後被恢復時,Claude 會自己開始工作,修正後改成等你的下一個提示。

這些修正在功能上線的隔天就列入。本文推論,這代表功能仍在處理邊角情況,與官方稱它為實驗功能一致。

貼文寫 2.1.325 並不算錯,因為 2.1.325 包含 Code Mode。X 的社群註記則寫 v2.1.323 以上,與文件的版本需求一致,但社群註記由 X 使用者撰寫,這裡只當線索。

版本對上之後,接著是啟用條件與步驟。

依官方文件,怎麼啟用 Code Mode?

官方文件給的啟用方式只有一個:把環境變數 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE 設成 1。環境變數是作業系統提供給程式讀取的設定值。

啟用前要符合哪些條件?

文件的需求清單如下。條件不符時,Claude Code 通常會在工作階段上方說明 Code Mode 沒有啟動,並寫出原因。版本太舊時,可能沒有原因,甚至完全沒有這一行。

  • 版本:Claude Code v2.1.323 以上,stable 與 latest 兩個發行通道都可以。
  • 帳號:Claude 訂閱或 Console 帳號。不能經由 gateway、Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 或 Microsoft Foundry 使用。
  • 組織:沒有套用 HIPAA 設定,也沒有使用零資料保留。
  • 模型:Claude Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 5.2。
  • 介面:終端機裡的互動式 claude 工作階段。-p、Agent SDK、VS Code 面板、桌面版與雲端工作階段都不行。
  • 安裝:Claude Code 的原生版本。Windows 要先安裝 Git for Windows。

文件另外說,API key helper、agent teams、OpenTelemetry 匯出與 DISABLE_TELEMETRY 這幾類設定開著時,也無法啟動 Code Mode。

依文件的啟用步驟

先檢查版本。執行 claude --version,若低於 v2.1.323 就執行 claude update。

文件說,如果你在 stable 通道,更新後仍到不了 v2.1.323,就等 stable 追上,或改用 latest 通道。

接著設定環境變數。macOS、Linux 與 WSL 的寫法是 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude。

Windows PowerShell 要先設定 $env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1",再執行 claude。

想讓每個新工作階段都開啟,就把這個變數放進 ~/.claude/settings.json 的 env 區塊。

但文件說,Claude Code 會忽略專案設定檔裡的這個變數,所以你複製下來的儲存庫無法替你開啟 Code Mode。

第一次啟動會要求確認。選 Yes, turn on Code Mode 之後,Claude Code 會重新啟動。

畫面上方會出現以 "Code Mode (experimental) is on" 開頭的一行,後半句說明這個工作階段只能在開著 Code Mode 時恢復。如果看到不同的訊息或沒有訊息,就要查文件的疑難排解表。

最後給一個多步驟任務,再按 Ctrl+O 讀程式碼。文件示範的提示詞,意思是讀取專案裡每個 Markdown 檔,列出指向不存在的本機檔案的連結,這是本文轉述,不是原文。

怎麼關閉,組織又怎麼阻擋?

關閉的方式,是把變數從 shell 與 ~/.claude/settings.json 移除,再開新的工作階段,或是把值改成 0。

只要任何一處是 0,另一處設成 1 也會維持關閉。

組織要阻擋,就在 managed settings 把同一個變數設成 0。managed settings 是管理員統一下發的組織設定。

已經在 Code Mode 裡的使用者,可以待到結束或重啟,之後就不能恢復原本的 Code Mode 工作階段。

文件也說,管理員無法用 managed settings 替使用者開啟 Code Mode。

啟用只是第一關,但更大的差異在權限檢查。

Code Mode 的權限怎麼算?auto mode 審整段程式碼

Code Mode 讓 auto mode 的審查單位,從單一工具呼叫變成一整段程式碼,但規則與 hook 仍逐一檢查每個工具呼叫。

auto mode 是 Claude Code 的權限模式之一,由第二個模型,也就是分類器,代替你審查操作。

依權限模式文件,v2.1.283 以上版本的互動式終端機工作階段,內建起始模式就是 auto mode,但條件不符時會改用手動模式。

官方文件說,Code Mode 裡每個工具呼叫,仍會經過你設定的 deny 與 ask 權限規則,也會經過 PreToolUse hook。

hook 是 Claude Code 在特定時機自動執行的設定,PreToolUse 發生在工具呼叫之前。

在 auto mode 下,分類器會在程式碼執行前,審查一次整段程式碼,不會逐一審查裡面的工具呼叫。

文件特別說明,分類器看不到執行時才算出的值,例如從搜尋結果取出的路徑。所以必須控管的呼叫,仍要靠規則或 hook。

在其他權限模式下,程式碼不經審查就開始執行,但每個在該模式會詢問你的工具呼叫,仍會逐一詢問。

想檢查程式碼本身,文件的做法是寫一個符合 REPL 的 PreToolUse hook,從 tool_input.code 讀 JavaScript。REPL 是文件中替 Claude 執行程式碼的工具名稱。

文件也提醒,Bash 規則比對的是指令文字,所以 Claude 可能用規則沒涵蓋的寫法執行被拒絕的指令,開不開 Code Mode 都一樣。

如果限制不能依賴指令文字,文件建議參考沙箱,也就是把指令隔離在受限環境裡執行的機制。

長時間執行的程式碼

Claude 可以等程式碼跑完,也可以讓它在背景執行。等待時,程式碼最長跑十分鐘,包含你停在權限提示的時間。

背景執行時,你可以繼續跟 Claude 對話,程式碼最長可跑兩小時。但文件說,背景執行要從 auto 或 bypassPermissions 模式啟動。

如果 Claude 仍然等待,文件要你檢查三件事:是否切換了權限模式、啟動時用的是不是別的模式,以及是否用 --tools 傳入了工具名稱。

權限差異看完,剩下的問題是哪些任務值得試。

哪些任務適合試,哪些限制要先接受?

官方建議把 Code Mode 用在需要許多相關工具呼叫的任務。

文件舉了三類例子,像是同一個改動要重複套用到許多檔案,搜尋結果要先過濾才輪到 Claude 讀,以及幾個互相獨立的指令可以同時執行。

另一方面,文件在啟用前列出幾項要先接受的限制。

  • 恢復工作階段:Code Mode 的工作階段只能在終端機恢復,而且要開著 Code Mode。
  • 其他功能:不能用 Remote Control、Claude in Chrome 與 computer use。
  • 移動工作階段:不能搬到桌面版,也不能轉成背景工作階段,/fork 也不能啟動背景副本。
  • hooks:PreToolUse hook 無法執行或逾時,工具呼叫會被拒絕。UserPromptSubmit hook 可能擋住程式碼輸出。

截至 2026 年 11 月 16 日,本文讀到的官方文件與 CHANGELOG,沒有提供 Code Mode 的速度、費用或用量比較數字,也沒有說明何時會轉為正式功能。

因此任何「省多少」的說法,都還沒有官方出處。文件反而寫明,Code Mode 可能在任何版本更改或移除,意見回饋用 /feedback 送出。

X 貼文的社群註記還提到,貼文建議的 npx claude-code-templates 指令,是貼文作者的第三方社群工具,不是官方軟體或文件。

本文沒有檢查該工具,而且官方啟用步驟用不到它。

Code Mode 常見問題

Code Mode 預設會開啟嗎?

不會。官方文件寫明 Code Mode 預設關閉,所以要把 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE 設成 1,並在第一次啟動時確認。

一定要升到 2.1.325 才能用 Code Mode 嗎?

不用。文件的版本需求是 v2.1.323 以上。本文推論,2.1.325 已列入三條 Code Mode 修正,想試用的人升到含修正的版本,比較不會碰到已知問題。

VS Code 面板或桌面版能用 Code Mode 嗎?

不能。文件列出,Code Mode 不支援 -p、Agent SDK、VS Code 面板、桌面版與雲端工作階段,只能在終端機的互動式工作階段使用。

公司可以禁止員工使用 Code Mode 嗎?

可以。管理員在 managed settings 把 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE 設成 0,員工就無法開啟 Code Mode。已在使用的人,到結束或重啟後才會停用,原本的 Code Mode 工作階段也不能再恢復。

延伸閱讀:Claude Code 2.1.317 更新:排程授權、工具斷線與長對話修正重點

結語:Code Mode 適合先觀察的人,不適合直接放進團隊流程

適合的是已在終端機使用 Claude Code、帳號與模型符合條件,又常做大量檔案重複修改或搜尋過濾的人。想提早理解 Claude Code 工作方式變化的人,也適合先看。

不適合的是透過 Amazon Bedrock、Google Cloud 或 gateway 使用的人,主要在 VS Code 面板與桌面版工作的人,以及依賴 auto mode 分類器逐一審查工具呼叫的團隊。

原因都在官方文件,因為它是可能更改或移除的實驗功能,auto mode 審的是整段程式碼,可用範圍也很窄。

我會先在不含機密的專案目錄試一次,按 Ctrl+O 讀 Claude 寫的程式碼,確認自己看得懂,再決定要不要在更大的專案開啟。

延伸閱讀:Claude Code 2.1.314 加入寫入目錄限制:讓代理改檔前,先畫清楚工作範圍

資料來源