AIエージェント開発

Claude CodeのCode Mode|条件・設定・停止【2026年11月】

Claude CodeのCode Mode|条件・設定・停止【2026年11月】

この記事の結論

Claude CodeのCode Modeは、ClaudeがツールをJavaScriptでまとめて呼ぶ実験的な機能で、v2.1.323で追加され既定はオフです。使える条件、有効にする設定、組織で止める方法を公式の記載で整理しました。

2026年11月17日時点で、Claude Code の Code Mode(コードモード)は、Claude が Bash・Read・Edit などのツールを 1 回ずつ呼ぶ代わりに、その呼び出しを行う JavaScript を書き、Claude Code がそのコードを利用者のセッションの中で動かす実験的な機能です。日本時間 2026年11月13日公開の v2.1.323 で入り、既定はオフで、使える条件を満たす環境で環境変数 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を 1 にすると始められます(公式ドキュメント「Run tool calls from code with Code Mode」・GitHub のリリース v2.1.323)。公式ドキュメントは、どのリリースでも変わる、またはなくなる可能性があると書いています。

最終更新:2026年11月17日(Claude Code の公式ドキュメントと GitHub のリリース v2.1.323・v2.1.325・v2.1.326 を確認)

この記事の要点(2026年11月17日時点)

  • 何をする機能か: 1 つのコードでコマンドを並列に走らせ、前の結果を次の呼び出しに渡し、要る部分だけを Claude に返します。コードは Ctrl+O で開く画面で読めます。
  • いつから: v2.1.323(日本時間 11月13日)で追加。v2.1.326(11月17日)から agent teams(複数の Claude Code のセッションを組にして動かす機能)と一緒に使えます。
  • 使える条件: ネイティブ版の v2.1.323 以上、Claude のサブスクか Console のアカウント、Opus 5.5・Sonnet 5.5・Haiku 5.5・Fable 5.2、ターミナルの対話の claude(Windows は Git for Windows も要る)。HIPAA の構成(米国の医療情報の規則に合わせた構成)かゼロデータ保持(ZDR)を使う組織では使えません。条件は全部で 8 つで、全体は「使える条件と使えない場面」の表にあります。
  • 使えない場面: -p(非対話の実行)・Agent SDK(Claude Code と同じ仕組みでエージェントを組む SDK)・VS Code のパネル・Desktop アプリ・クラウドのセッション(ブラウザやスマホなどからクラウドの環境で動かす Claude Code のセッション)では動かず、Amazon Bedrock などクラウドの事業者を通す経路やゲートウェイ経由でも使えません。API key helper(認証の値を自分のコマンドで作る設定)・OpenTelemetry の送出(利用の記録を外部の集計先へ送る設定)・DISABLE_TELEMETRY など一部の設定がオンの時も始まりません。
  • 有効にする場所: シェルか ~/.claude/settings.json の env(ほかに --settings で渡すファイル)。プロジェクトの設定ファイルの値は無視されます。
  • 止め方: 変数を消すか 0 にします。組織は managed settings(組織が claude.ai の管理画面・MDM(端末を一括で管理する仕組み)・設定ファイルのどれかで届け、ほかの設定より上に掛かる設定)の 0 で止められますが、managed settings から有効にはできません。
  • 気をつける点: auto mode(別のモデルが操作を実行前に判定し、確認を減らす権限のモード)の判定はコードごとで、実行時に決まる値は見ません。deny・ask の許可のルールと PreToolUse フック(ツールを使う直前に動く利用者の処理)は、コードの中の呼び出し 1 回ずつに掛かります。

この記事は、リリースノートで Code Mode を見かけた Claude Code の CLI の利用者(特に MCP=外部のツールやデータにつなぐ仕組みや、agent teams を多く使う開発者)と、組織の設定を管理する人に向けて、2026年11月17日時点で公式のページを確認した内容をまとめたものです。編集部は Code Mode を動かしておらず、コードと設定の例は公式ドキュメントに載っている物だけです。

Claude CodeのCode Modeとは|従来のツールの呼び出しとの違い

Code Mode を使わない時、Claude は Bash・Read・Edit といったツールの呼び出しを直接頼み、結果を 1 つ読むたびに次に何をするかを決めます。Code Mode では、Claude がツールを呼び出す JavaScript を書き、Claude Code がそのコードをセッションの中で動かします。利用者はこれまでどおり、作業をプロンプトで伝えます(公式ドキュメント)。

従来の流れと Code Mode の流れ。従来はツールの呼び出しを 1 回ずつ頼み、結果を 1 つ読んで次を決める。Code Mode は JavaScript を書き、セッションの中で動かし、要る部分だけを返す(Claude Code の公式ドキュメントをもとに作成)

1 つのコードの中では、コマンドを並列に走らせることも、ある結果を次の呼び出しに使うことも、出力のうち Claude が読む必要のある部分だけを返すこともできます。公式ドキュメントには、リトライの上限を上げる依頼に Claude が書くかもしれないコードが載っています。ファイルを探して編集し、テストを走らせ、最後の行でファイルのパスとテストの出力を Claude に返す形です(Claude が書くコードで、利用者が書く物ではありません)。

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() });

会話の画面には編集の差分のようなツールの呼び出しが出て、コードは出ません。コードを読むには Ctrl+O で transcript viewer(会話の記録を見る画面)を開きます。コードは 1 つずつ畳まれた「Code」の行として並びます。公式ドキュメントは、関連するツールの呼び出しが多い作業で試すよう勧め、例として、多くのファイルにわたる同じ変更、Claude が読む前に絞り込みたい検索の結果、同時に走らせられる互いに関わらない複数のコマンドを挙げています。

従来との違いを、公式ドキュメントと permission modes のページの記載で並べると次のとおりです。

項目 Code Mode なし(従来) Code Mode
呼び出しの組み立て Claude がツールの呼び出しを 1 回ずつ頼む Claude が呼び出しを行う JavaScript を書き、Claude Code がセッションの中で動かす
結果の扱い 結果を 1 つ読んでから次を決める 前の結果をコードの中で次の呼び出しに渡し、要る部分だけを返せる
会話の画面 ツールの呼び出しが出る ツールの呼び出しが出る。コードは Ctrl+O の画面の「Code」の行で読む
auto mode の判定 ルールなどで決まらない操作を、実行の前に 1 つずつ判定する コードを実行の前に 1 回判定し、中の呼び出しは判定しない
deny・ask のルールと PreToolUse フック 呼び出しごとに掛かる コードの中の呼び出し 1 回ずつに、いつものツール名(Bash など)で掛かる

待つ時は 10 分・バックグラウンドなら 2 時間

長いビルドやテストをコードが走らせる間、Claude は終わるのを待つか、バックグラウンドで続けさせます。待つ場合は、コードが終わってから Claude が答え、コードは 10 分で止まります。この 10 分には、許可の確認に答えている時間も入ります。バックグラウンドの場合は、その間も Claude に話しかけられ、コードは最長 2 時間動けます。バックグラウンドで動かすには、会話を auto か bypassPermissions(ほとんどの確認と安全のチェックを止めるモード。公式はコンテナや VM などの隔離した環境だけで使うよう警告している)で始めます。それでも Claude が待つ時の確かめ方を、公式ドキュメントは 3 つの場合に分けて案内しています。途中でモードを替えたなら、Shift+Tab で始めた時のモードに戻します。別のモードで始めたか claude --resume の一覧から会話を選んだなら、auto mode を使える場合に、いったん終了してから Code Mode をオンにしたまま claude --continue --permission-mode auto で始め直します。--tools にツール名を渡して始めたなら、そのフラグを外して auto mode で始め直します。

使える条件と使えない場面|版・アカウント・モデル・画面

公式ドキュメントの「Requirements」には 8 つの条件が並びます。条件に合わない時、Claude Code は Code Mode なしで始まります(Code Mode の Requirements)。

Code Mode を使える 8 つの条件。v2.1.323 以上、サブスクか Console のアカウント、HIPAA・ZDR を使っていない、Opus 5.5・Sonnet 5.5・Haiku 5.5・Fable 5.2、ターミナルの対話の claude、agent teams なら v2.1.326 以上、ネイティブ版、Windows は Git for Windows。合わなければ Code Mode なしで始まる(Claude Code の公式ドキュメントをもとに作成)

項目 条件(公式ドキュメント) 使えない場面・補足
版 Claude Code v2.1.323 以上。latest と stable のどちらのリリースチャンネルでもよい 古い版は Code Mode なしで始まる。理由として it isn't open to your account yet が出ることも、出ないこともある
アカウント Claude のサブスクか、Console(Claude Console)のアカウント ゲートウェイ(要求を中継する仕組み)・Amazon Bedrock・Claude Platform on AWS・Google Cloud の Agent Platform・Microsoft Foundry・Claude Models on Google Cloud (Anthropic managed) 経由では使えない
組織 HIPAA の構成(米国の医療情報の規則に合わせた構成)と、ゼロデータ保持(ZDR)を使っていない どちらかを使う組織では使えない
モデル Claude Opus 5.5・Sonnet 5.5・Haiku 5.5・Fable 5.2 一覧にないモデルでは Code Mode なしで始まる。--model opus のように対応モデルで始める
画面 ターミナルで動かす対話の claude セッション -p・Agent SDK・VS Code のパネル・Desktop アプリ・クラウドのセッションでは動かない
agent teams agent teams をオンにしたまま使うなら v2.1.326 以上 既定の in-process の表示(全員を 1 つのターミナルで動かす)では仲間(teammates)も Code Mode で動き、split panes(仲間ごとにペインを分ける)では Code Mode なしで始まる
入れ方 Claude Code の native build(ネイティブ版) 入れ方は setup のページで確かめる
Windows Git for Windows が入っている —

このほか、API key helper(apiKeyHelper など、モデルへの要求に付ける認証の値を自分のコマンドで作る設定)、OpenTelemetry の送出(利用の記録を外部の集計先へ送る設定)、DISABLE_TELEMETRY(テレメトリーを送らない設定)などがオンだと Code Mode は始まりません。直し方は次の節の「起動しない時」の表にあります。モデルの条件にある Opus 5.5 を Claude Code で使う時の公式の勧めは、Opus 5.5使いこなし|Claude Code公式7策 で扱っています。

v2.1.323 に上がらない時や、入れた直後・上げた直後に出ない時の手がかりは 2 つです。まず、claude update で v2.1.323 に届かないことがあります。stable のチャンネルは「たいてい 1 週間ほど前の版」を使うため(setup のページ)、公式ドキュメントは、届かない時は追いつくのを待つか latest に替えるよう案内しています。また 環境変数のページは、Code Mode を、Anthropic から取得する機能フラグが要る機能の 1 つに挙げ、入れた直後や更新した直後の最初のセッションではフラグで入る機能が出ないことがある(取得したフラグは次のセッションのために保存される)と書いています。

有効にした会話でできなくなること

公式ドキュメントは、オンにする前に次の 6 つの制限を受け入れられるか確かめるよう書いています。

  • 再開: Code Mode の会話を再開できるのは、ターミナルで Code Mode をオンにしている時だけ
  • auto mode: 判定するのはコードで、ツールの呼び出し 1 回ずつではない
  • 長く動くコード: バックグラウンドで動かせない時は終わるまで待ち、10 分で止まる
  • フック: PreToolUse フックが動かない・時間切れの時に呼び出しが拒まれる。UserPromptSubmit フック(プロンプトを送った時に動くフック)がコードの出力を止めることがある
  • 使えない機能: Remote Control(ほかの端末から会話を続ける機能)・Claude in Chrome(Claude Code に Chrome を操作させる機能)・computer use(macOS でアプリや画面を操作させる機能)
  • 会話の移動: Desktop アプリへ移す、バックグラウンドのセッションにする、/fork でバックグラウンドの写しを始める、ができない

有効にする手順と止め方|環境変数とsettings.json

Code Mode は、環境変数 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を 1 にして有効にします。1 で有効にできるのはシェル・ユーザー設定・--settings のファイルの 3 か所で、プロジェクトの設定(共有・ローカル)と managed settings では有効になりません(settings reference)。

1 で Code Mode を有効にできる場所はシェル、ユーザー設定の ~/.claude/settings.json、--settings のファイル。有効にできないのは共有のプロジェクト設定 .claude/settings.json、ローカル設定 .claude/settings.local.json、managed settings(0 で止めるだけ)(Claude Code の settings reference をもとに作成)

公式ドキュメントの「Try Code Mode」の 5 段です。よく知っているプロジェクトで試す形になっています(Try Code Mode)。

  1. 版を確かめる: claude --version を実行し、v2.1.323 より古ければ claude update を実行します。stable のチャンネルで v2.1.323 に届かない時は、追いつくのを待つか latest に替えます(/config の Auto-update channel か、settings.json の autoUpdatesChannel・setup のページ)。
  2. Code Mode をオンにして起動する: 環境変数 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を 1 にします。試すだけならシェルで、新しいセッションを毎回 Code Mode で始めるならユーザー設定に入れます(下のコード)。
  3. 確認に答える: 最初の Code Mode のセッションの前に出る確認で「Yes, turn on Code Mode」を選びます。Claude Code が再起動し、セッションの上の方に Code Mode (experimental) is on · this session can be resumed only with Code Mode on と出ます。違う行が出た時や何も出ない時は、この節の「起動しない時」を見ます。
  4. ツールの呼び出しが多い作業を頼む: よく知っているプロジェクトで、下の公式の例のようなプロンプトを送ります。
  5. Claude が書いたコードを読む: Ctrl+O を押して「Code」の行を開き、ツールの呼び出しの元になった JavaScript を見ます。もう一度 Ctrl+O で会話に戻ります。

macOS・Linux・WSL で、シェルから起動する例(公式の例):

CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

Windows PowerShell の例(公式の例):

$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude

~/.claude/settings.json に入れる env の例(公式の例):

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
  }
}

手順 4 の公式の例のプロンプト(Markdown のファイルを全部読み、存在しないローカルのファイルを指すリンクを挙げさせる依頼):

Read every Markdown file in this project and list the links that point to local files that don't exist.

有効にできる場所・できない場所

この変数は、置く場所によって効く所と無視される所があります(settings reference の「Variables Claude Code ignores in env」・settings のページ)。

置く場所 1 で有効にできるか 補足
シェル(起動する時の環境変数) できる managed settings に 1 がある時はシェルの 1 が無視されるので、自分の 1 はユーザー設定に入れる
ユーザー設定 ~/.claude/settings.json できる 新しいセッションを毎回 Code Mode で始める時の置き場所
--settings で渡すファイル できる ユーザー・プロジェクト・ローカルの設定より上、managed settings より下に掛かる
共有のプロジェクト設定 .claude/settings.json できない クローンしたリポジトリが Code Mode を有効にできないようにするため
プロジェクトのローカル設定 .claude/settings.local.json できない —
managed settings できない 0 を入れて止めるだけ(次の節)

自分で止める・続きから再開する

止めるには、シェルと ~/.claude/settings.json から変数を消して新しいセッションを始めます。値を 0 に替えてもよく、シェル・ユーザー設定・--settings のファイルのどれか、または managed settings に 0 があれば、ほかで 1 にしてもオフのままです(公式ドキュメント・settings reference)。

Code Mode の会話を後で再開する時は、claude --continue や claude --resume でも変数を 1 のままにします。オフにしていると、Claude Code はその会話の再開を断ります。逆に Code Mode なしで始めた会話は、変数が 1 でも Code Mode なしで再開します。

起動しない時の理由と直し方

セッションの上の方に Code Mode (experimental) isn't available と出たら、Code Mode なしで始まっています。理由は同じ行に続き、/status にも出ます。公式ドキュメントの表(13 行)を短くまとめました。直したら新しいセッションを始めます(Code Mode doesn’t start)。

理由に含まれる語 直し方
isn't open to your account v2.1.323 より古ければ更新。そうでなければ通信を確かめて始め直し、変わらなければ別の日に試す
with the Anthropic API クラウドの事業者・ゲートウェイ・独自の ANTHROPIC_BASE_URL を通す設定を外す
API key helper apiKeyHelper・ANTHROPIC_AUTH_TOKEN・ANTHROPIC_CUSTOM_HEADERS の Authorization と X-Api-Key を外し、サインインするか ANTHROPIC_API_KEY を設定する
only works with Opus 5.5, Sonnet 5.5 対応モデルで始める(例: --model opus。Haiku 5.5・Fable 5.2 も動く)
background jobs --remote-control なしで前面で始める。仲間の split pane に出たら in-process の表示にする
downloads from Anthropic 機能フラグの取得を止める変数(DISABLE_TELEMETRY など)を外す
OpenTelemetry is on 送出なしで済むなら CLAUDE_CODE_ENABLE_TELEMETRY と ENABLE_BETA_TRACING_DETAILED を外す
with the plugin /plugin で名前の出たプラグインを止める。組織が入れた物は管理者に頼む
installed mod ツールの呼び出しを点検する mod(Claude Code の中で動くプラグイン)を止める
together with agent teams v2.1.326 以上に更新する。今の版のままなら CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS を外す
this launch's tool options --restricted を外し、--tools に REPL(Claude の書いたコードを動かすツール)を足し、--disallowedTools と deny のルールから REPL を外す
couldn't save your answer ~/.claude.json を書き込めるようにする
organization's settings managed settings について管理者に聞く

Code Mode についての行がまったく出ない時は、版を見て古ければ更新し、シェルかユーザー設定で変数が 1 か、それらと --settings のファイルに 0 が残っていないかを確かめます(公式ドキュメント)。

組織で止める・許す|managed settingsと権限の確かめ方

組織の誰にも Code Mode を使わせない時は、managed settings に CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を 0 で入れます。入れた後の流れは次の図のとおりです。

managed settings に 0 を入れた後の流れ。今の会話は終了か再起動まで続き、その後は Code Mode なしで始まり、0 がある間は Code Mode の会話を再開できない。managed settings から利用者の代わりに有効にすることはできず、/status の Setting sources の行で効いているかを確かめる(Claude Code の公式ドキュメントをもとに作成)

managed settings に入れる env の例(公式の例):

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0"
  }
}

入れた時に Code Mode の会話にいる利用者は、終了するか Claude Code を再起動するまでその会話に留まります。その後は Code Mode なしで始まり、0 がある間は Code Mode の会話を再開できません。managed settings で利用者の代わりに有効にすることはできません(Block Code Mode for your organization)。

読み直しの間隔は届け方で違います。claude.ai の管理画面などから出す server-managed settings は起動時と 1 時間ごと、MDM(端末を一括で管理する仕組み)や OS の方針(Jamf・Intune・グループポリシーなど)は起動時と 30 分ごと、ファイルは起動時と変更した時です。ファイルの置き場は macOS が /Library/Application Support/ClaudeCode/managed-settings.json、Linux と WSL が /etc/claude-code/managed-settings.json、Windows が C:\Program Files\ClaudeCode\managed-settings.json で、効いているかは 1 台で /status の Setting sources の行を見ます(Deploy managed settings)。

許す時に確かめること|権限とフック

使わせる場合は、コードの中の呼び出しがどう確かめられるかを先に押さえます。公式ドキュメントの「Permission checks」の要点です。

  • deny・ask のルールと PreToolUse フックは、コードの中のツールの呼び出し 1 回ずつに、いつもの名前(Bash など)で掛かる
  • auto mode では、判定役(classifier)が実行の前にコードを見て、呼び出し 1 回ずつは見ない。検索の出力から取ったパスのような実行時に決まる値も見ないので、必ず押さえたい呼び出しはルールかフックで押さえる
  • ほかのモードでは、コードは判定なしで始まり、そのモードで確認が出る呼び出しのたびに確認が出る
  • シェルのコマンドを許す・止める PreToolUse フックがあるなら、Bash のルールと同じようにコマンドの各部分を確かめる作りにしておく。app というフォルダでの git push が cd 'app' && git push の形で届くことがある
  • コードそのものを確かめるなら、コードを動かすツール REPL に当てた PreToolUse フックで tool_input.code の JavaScript を読む
  • Bash のルールはコマンドの文字に当てるため、Code Mode のありなしにかかわらず、deny で止めたコマンドを Claude がルールに当たらない形で走らせることがある。文字に頼らない制限は sandboxing(コマンドを隔離した環境で動かす仕組み)で掛ける

permission modes のページによると、v2.1.283 以降、ターミナルで始める会話は、フラグや設定で別のモードを選ぶか auto mode を止めていない限り auto mode で始まります(auto mode を使えない時は Manual)。設定を変えていなければ、Code Mode の会話の判定もコード単位になります。v2.1.283 より前の版では、Pro・Max・Ultra・Team のプランで機能フラグを取得する会話だけが既定で auto mode で始まり、ほかは Manual でした。経緯は Claude Code Auto Modeが標準化|8月14日から何が変わる、フックの書き方は Claude Code Hooks使い方|33イベント設定例 で扱っています。

フックが失敗した時・カウントダウンが出た時

コードからの呼び出しで PreToolUse フックが判断を返さないと、onFailure(フックが失敗した時に操作を通すか止めるかの項目)を設定していなくても呼び出しは拒まれます。the hook failed は、フックが起動できない、止められた、終了コード 126 か 127、または 128 より大きい値で終わった、HTTP のエラーか不正な出力を返した時で、フックを直します。the hook did not finish は、コードからの呼び出しで時間切れになった時か、一度コードを動かした後のほかの呼び出しで時間切れになった時で、フックの timeout を上げます。失敗や時間切れでも通したい command・http のフックには "onFailure": "continue" を付けます。command のフックが 1 のような普通の終了コードで終わった時は、"onFailure": "block" がない限り呼び出しは通ります。

auto mode で前のコードが動いている間に次のコードが始まると、前のコードは判定を失い、残りの呼び出しで判定が要る物に確認が出ます。IDE がつながっていない時は Claude Code will automatically block this request in 1:59 のようなカウントダウンが付き、時間内に答えないとその呼び出しは拒まれ、後のカウントダウン付きの確認も出ずに拒まれます。もう一度確認を出すには Claude にメッセージを送ります。フックで通知を出す設定は Claude Code Hooks通知設定|macOS・Win・Slack にあります。コードがバックグラウンドで動ける時は、UserPromptSubmit の command・http・mcp_tool のフックがコードの出力にも動くので、入力の source が poll_event の時は止めないようにします(公式ドキュメント)。

気づいた後にやること

思わぬ呼び出しに気づいた時に公式ドキュメントの範囲で取れる手には、次のようなものがあります(このほか、「許す時に確かめること」で挙げた deny・ask のルールや、REPL に当てた PreToolUse フックで押さえる手もあります)。managed settings かユーザー設定に 0 を入れて新しい会話から止め、いま Code Mode で動いている会話は終了か再起動をしてもらう。Ctrl+O の画面の「Code」の行で、どのコードが何を呼んだかを読む。コマンドの文字に頼らない制限として sandboxing を見直す。コードがした変更を戻す手順は、2026年11月17日時点で Code Mode のページに記載を確かめられませんでした。

何が入ったか|v2.1.323〜v2.1.326とagent teams・mods

GitHub のリリースノートで Code Mode に触れた項を、日本時間の公開日時(published_at に 9 時間を足した値)で並べます。v2.1.324 はリリースの一覧にありません(v2.1.323・v2.1.325・v2.1.326)。

版 公開(日本時間) Code Mode に関わる項
v2.1.323 2026年11月13日 07:12 Code Mode を追加。Claude がツールを呼ぶ JavaScript を書く実験的な機能で、自分でオンにする。オンにする方法と組織で止める方法はドキュメントへ
v2.1.325 2026年11月14日 05:40 修正 3 件。Code Mode のスクリプトが EnterWorktree で入った worktree(Git の作業ツリー)を無視する・~ のパスをプロジェクトに書く・サインインの切れた MCP サーバーを /mcp に接続中と出したままにする/許可の確認やプランの承認で「Yes」と一緒に打った言葉が Claude に届かない/スクリプトの途中で終わった会話を再開すると Claude が勝手に作業を始める(次の指示を待つように)
v2.1.326 2026年11月17日 07:11 agent teams をオンにしたまま Code Mode をオンにできる(すでにオンなら teams ありの会話も Code Mode で始まる)/auto mode でインラインの ! コマンドに承認が要るとスキルとスラッシュコマンドが読み込めない不具合を修正/Code Mode で始めたバックグラウンドのサブエージェントが、インラインの ! コマンドを持つスキルを先に読み込むと失敗する不具合を修正/mods が $.tool.call・$.tool.check で Bash・Read などを使えない不具合を修正/権限の確かめ方を改善(サンドボックスで動くコマンドで、確認が出るか拒まれる物が増えた)/オンにできない時のメッセージを、できることを伝える形に/$ のシェルの補助が一部の値をエラーで拒む(何も実行しない)

日本時間の 11月13日から17日までの 5 日間に出た 3 回のリリースのすべてに Code Mode の変更が入っており、まだ動いている最中の機能です。使う前に、入れた版のリリースノートを見ておくと、記事や手元のメモとの食い違いに気づけます。

agent teams と一緒に使う

agent teams は、1 つのセッションがリードになり、複数の Claude Code のセッションを仲間として一緒に動かす機能で、それ自体も実験的で既定はオフです(CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 で有効・agent teams のページ)。Code Mode と一緒に使うには v2.1.326 以上が要ります。仲間の表示には、全員を 1 つのターミナルの中で動かす in-process と、仲間ごとにペインを分ける split panes(tmux か iTerm2 が要る)があり、既定は in-process です。Code Mode のページによると、in-process では仲間も Code Mode で動き、split panes では Code Mode なしで始まります。古い版で agent teams をオンにしていると、起動時に it can't be used together with agent teams yet が出ます。

mods・プラグインと一緒に使う

mod は、Claude Code の中で動く JavaScript か TypeScript のイベントハンドラーでできたプラグインで、ツールの呼び出しを見張ったり変えたりできます(Mods overview)。ツールの呼び出しを点検する mod を入れていると Code Mode は始まらず(it doesn't yet work with an installed mod)、その mod を止める必要があります。v2.1.326 では、mods が $.tool.call と $.tool.check を通して Bash や Read などを Code Mode の中で使えない不具合が直りました。これは mod の側からツールを使う時の修正で、ツールの呼び出しを点検する mod を入れていると Code Mode が始まらないという記載は、2026年11月17日時点の Code Mode のページに残っています。プラグインも、理由に名前の出た物は /plugin で止めます。mod の作り方は Claude Code Modsの作り方|3ファイル・フック・テストの手順 で扱っています。

MCP と一緒に使う

MCP のツールをコードから呼ぶ時の個別の決まりは、2026年11月17日時点で Code Mode のページに確かめられませんでした。リリースノートでは v2.1.325 で、Code Mode のスクリプトが、サインインの切れた MCP サーバーを /mcp に接続中と出したままにする不具合が直っています。フックの面では、前の節のとおり、コードがバックグラウンドで動ける時は UserPromptSubmit の mcp_tool フックもコードの出力に動きます。

似た名前の別の仕組みとの違い|Cloudflare・Claude API

モデルがコードを書いてツールを呼ぶ考え方は、Claude Code の外にもあります。名前が同じ Cloudflare の Code Mode と、Claude API の programmatic tool calling(code execution のツールの中からツールを呼ぶ機能)は、Claude Code の Code Mode とは別の製品の別の機能です。それぞれの公式ページの記載だけで並べます。

名前が近い 3 つの仕組み。Claude Code の Code Mode は JavaScript をセッションの中で動かす。Claude API の programmatic tool calling は Python を code execution のコンテナで動かす。Cloudflare の Code Mode は型付きのメソッドを呼ぶコードを sandbox の実行で動かす(各社の公式ドキュメントをもとに作成)

項目 Claude Code の Code Mode Claude API の programmatic tool calling Cloudflare の Code Mode
何か・状態 Claude Code(ターミナルの CLI)の機能。実験的で既定はオフ。どのリリースでも変わる、またはなくなる可能性があると公式に書かれている Claude API の機能。公式ページの状態は stable Cloudflare の Agents の道具。実験的で、破壊的な変更の可能性があり本番では注意と公式に書かれている
モデルが書くコード JavaScript Python 設定したツールを型付きのメソッドとして呼ぶコード
コードが動く所 利用者の Claude Code のセッションの中 code execution のコンテナ(サンドボックス) 1 回の sandbox の実行の中
呼ぶツール Bash・Read・Edit など Claude Code のツール 開発者が定義し、allowed_callers に code execution を入れたツール。ツールが呼ばれるとコードが止まり、開発者が結果を返す 設定したツール。Durable runtime・AI SDK・TanStack AI・ブラウザ・MCP・OpenAPI の組み込み口がある
使い始め方 環境変数 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 code execution のツール(code_execution_20260120 以降)を付け、ツールの定義に allowed_callers を書く 使う組み込み口ごとの手順

出典: Code Mode の公式ドキュメント・Programmatic tool calling・Cloudflare の Code Mode のドキュメント(2026年6月24日更新)。検索で「Code Mode」を調べると、ほかの製品の同じ名前の機能も出てきます。手順や設定を写す前に、そのページがどの製品の物かを確かめてください。

使う前に決めること|チェック表

試す前に、個人と組織で決めておくことを 8 つに分けました。根拠はこの記事の各節の公式ドキュメントです。

決めること 確かめ方・選べる手
自分のつなぎ方で使えるか サブスクか Console のアカウントで直接つないでいるか。クラウドの事業者・ゲートウェイ・独自の ANTHROPIC_BASE_URL を通していれば使えない。HIPAA の構成かゼロデータ保持(ZDR)の組織でも使えず、API key helper(apiKeyHelper・ANTHROPIC_AUTH_TOKEN など)・OpenTelemetry の送出・DISABLE_TELEMETRY などがオンだと始まらない
画面とモデル ターミナルの対話の claude で、Opus 5.5・Sonnet 5.5・Haiku 5.5・Fable 5.2 のどれかを使うか
版とチャンネル v2.1.323 以上か。stable で届かなければ待つか latest に替える。agent teams もオンなら v2.1.326 以上
有効にする場所 試すだけならシェル、毎回ならユーザー設定。プロジェクトの設定では有効にならない
組織の方針 止めるなら managed settings に 0。使わせる場合も、managed settings からは有効にできない
権限 auto mode の判定がコード単位なのを受け入れるか。必ず押さえたい呼び出しを deny・ask のルールと PreToolUse フックで押さえているか
フック PreToolUse がコマンドの各部分を見るか。失敗した時の onFailure、REPL のフックでコードを読むか、UserPromptSubmit が poll_event を止めないか
長い処理と再開 10 分を超える処理はバックグラウンド(auto か bypassPermissions で始める。bypassPermissions は公式が隔離した環境だけで使うよう警告している)。Code Mode の会話は、Code Mode をオンにしたターミナルでしか再開できない

【要注意】よくある失敗と回避策

失敗 1:プロジェクトの設定で有効にしたつもりになる

❌ リポジトリの .claude/settings.json の env に 1 を書き、チーム全員で Code Mode を使う
⭕ プロジェクトとローカルの設定の値は無視される。使う人がそれぞれ、シェルか ~/.claude/settings.json(か --settings のファイル)で 1 にする

失敗 2:managed settings で全員に有効にしようとする

❌ managed settings に 1 を入れて、組織の全員を Code Mode にする
⭕ managed settings からは有効にできず、できるのは 0 で止めることだけ。使わせるなら、使う人がそれぞれシェルかユーザー設定(か --settings のファイル)で 1 にする。0 を入れても、いま Code Mode で動いている会話は終了か再起動まで続く

失敗 3:auto mode が呼び出しを 1 つずつ見ていると思い込む

❌ auto mode に任せれば、コードの中の危ない呼び出しも 1 つずつ止まる
⭕ 判定はコード単位で、検索結果から取ったパスのような実行時の値は見ない。必ず押さえたい呼び出しは deny・ask のルールと PreToolUse フックで押さえ、コマンドの文字に頼らない制限は sandboxing で掛ける

失敗 4:Code Mode を切ってから会話を再開しようとする

❌ 変数を消した後に、Code Mode で始めた会話を claude --resume で開く
⭕ Code Mode がオフだと再開を断られる。再開する時も変数は 1 のままにし、ターミナルで開く

よくある質問

Code Mode は plan mode や auto mode と何が違いますか?

plan mode や auto mode は、操作をどう確かめるかを決める権限のモードです。Code Mode は、Claude がツールを呼ぶ方法を、コードを書いてまとめて動かす形に変える機能で、権限のモードとは別に決まります。公式ドキュメントは、権限のモードが、Claude の書いたコードの確かめ方と、コードが動く間に Claude と話せるかを決める、と書いています。

VS Code のパネルや Desktop アプリで使えますか?

VS Code の拡張のパネルと Desktop アプリでは使えません。対象はターミナルで動かす対話の claude セッションで、VS Code のパネル・Desktop アプリ・クラウドのセッションでは動きません。Code Mode の会話を Desktop アプリへ移すこともできず、再開もターミナルで Code Mode をオンにした時だけです(2026年11月17日時点の公式ドキュメント)。

claude -p や Agent SDK で使えますか?

使えません。公式ドキュメントは、-p(非対話の実行)と Agent SDK を、Code Mode が動かない場面に挙げています。

Amazon Bedrock や Google Cloud 経由でも使えますか?

使えません。Claude のサブスクか Console のアカウントで使う機能で、ゲートウェイ・Amazon Bedrock・Claude Platform on AWS・Google Cloud の Agent Platform・Microsoft Foundry・Claude Models on Google Cloud (Anthropic managed) 経由では使えません。HIPAA の構成かゼロデータ保持(ZDR)を使う組織でも使えません。

トークンや時間はどれだけ減りますか?

2026年11月17日時点で、Code Mode のページに減る量の数字は確かめられませんでした。公式ドキュメントが書いているのは、1 つのコードでコマンドを並列に走らせ、ある結果を次の呼び出しに使い、Claude が読む必要のある部分だけを返せる、ということです。

組織で全員に有効にできますか?

managed settings からはできません。managed settings でできるのは 0 で止めることだけで、使う人がそれぞれシェルかユーザー設定(か --settings のファイル)で 1 にし、最初の Code Mode のセッションの前に出る確認で「Yes, turn on Code Mode」を選びます。

まとめ

Code Mode は、Claude がツールの呼び出しを JavaScript にまとめて動かす、Claude Code の実験的な機能です。2026年11月17日時点の主な条件は、ネイティブ版の v2.1.323 以上・ターミナルの対話の claude・サブスクか Console のアカウント・対応モデル 4 つです。HIPAA の構成かゼロデータ保持(ZDR)を使う組織では使えず、API key helper・OpenTelemetry の送出などがオンだと始まりません(条件は全部で 8 つ・「使える条件と使えない場面」の表)。どのリリースでも変わる、またはなくなる可能性があります。

  • 今日: claude --version と、つなぎ方(クラウドの事業者やゲートウェイを通していないか)・画面・モデルを確かめる
  • 試す時: よく知っているプロジェクトで、シェルから CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude(macOS・Linux・WSL の例。Windows PowerShell は手順の節の例)で始め、最初の確認で「Yes, turn on Code Mode」を選び、Ctrl+O でコードを読む
  • 組織: 止めるなら managed settings に 0。使わせるなら、deny・ask のルール、PreToolUse フック(REPL を含む)、sandboxing を先に見直す
  • 続報: 5 日で 3 回変わっているので、更新のたびにリリースノートの Code Mode の項を見る

あわせて読みたい: Claude Code Hooks使い方|33イベント設定例(PreToolUse フックの書き方)/Claude Code Modsの作り方|3ファイル・フック・テストの手順(mod の作り方)

運営元 Uravation よりAIエージェントを構想から本番運用まで進める順番と、体制・KPIの決め方をまとめた資料を無料で公開しています。 AIエージェント導入ロードマップを受け取る(無料)

参考・出典

Need help moving from reading to rollout?

この記事を読んで導入イメージが固まってきた方へ

UravationではClaude Codeの法人研修と個別指導(マンツーマン)を提供しています。導入・定着まで実務ベースで伴走します。

この記事をシェア

X Facebook LINE

※ 本記事の情報は2026年11月時点のものです。サービスの料金・仕様は変更される可能性があります。最新情報は各サービスの公式サイトをご確認ください。

関連記事