開発・技術公開

Claude Code の Code Mode とは|有効化の手順・使える条件・使えないときの対処【v2.1.323〜】

Claude Code v2.1.323(2026年11月12日 UTC 公開)で追加された実験的な機能「Code Mode」を、公式ドキュメントと v2.1.325 の実機確認で解説します。Claude がツール呼び出しを JavaScript で書く仕組み、使える条件、CLAUDE_CODE_EXPERIMENTAL_CODE_MODE での有効化、組織で止める方法、auto モード・hooks との関係、「isn't available」と出たときの理由別の対処までまとめました。

Claude Code の Code Mode とは|有効化の手順・使える条件・使えないときの対処【v2.1.323〜】

Claude Code v2.1.323(2026年11月12日 UTC 公開)から、「Code Mode」という実験的な機能を試せるようになりました。 Code Mode をオンにすると、Claude はコマンド実行やファイル編集を1回ずつ頼む代わりに、複数のツール呼び出しをまとめた JavaScript を書き、Claude Code がそのコードを実行します。既定はオフなので、試したい人は環境変数 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 を付けて起動します。逆に社内で使わせたくない管理者は、managed settings(管理者が社内の PC に配り、利用者が上書きできない設定)でこの変数を 0 にします。

本記事は、2026年11月14日に取得した Anthropic 公式ドキュメント「Run tool calls from code with Code Mode」と Claude Code の CHANGELOG を原典にしています。あわせて、執筆時点の最新版 v2.1.325 を手元に入れ、ログインせずに確かめられる範囲を確認しました。実機で確認した内容と、ドキュメントに書かれている内容は書き分けています。 Code Mode の画面表示(確認ダイアログやオンになったときの表示)は、ログインしないと出せないため、ドキュメントの記載として紹介します。

この記事を読むとわかること

  • Code Mode で何が変わるのか(これまでのツール呼び出しとの違い)
  • 自分の環境で Code Mode が使えるかどうか(版・アカウント・モデル・起動方法の条件)
  • 有効化の手順と、オフにする方法・組織で止める方法
  • 権限ルール・auto モード・hooks が Code Mode でどう働くか
  • 「Code Mode (experimental) isn't available」と出たときの理由別の直し方
  • いま試すべきか、待つべきかの判断のしかた

結論:Code Mode の要点

Code Mode とは、Claude がツールを直接呼ぶ代わりに、ツールを呼ぶ JavaScript を書き、Claude Code がそのコードをセッションの中で実行する仕組みです。 押さえるべき点は次の4つです。

  1. 実験的で、既定はオフ:公式ドキュメントは、今後どのリリースでも変更・削除されうると明記しています。使うには自分でオンにします
  2. 使える環境は狭い:v2.1.323 以降のネイティブ版を、ターミナルの対話セッションで、Claude のサブスクリプションか Console アカウント、対応モデル(Opus 5.5・Sonnet 5.5・Haiku 5.5・Fable 5.2)で使う場合に限られます(詳しくは「使える条件」)
  3. 権限ルールと hooks はツール呼び出しごとに効く:deny・ask ルールと PreToolUse hooks(ツールの実行前に自動で走らせる確認用のスクリプト)は、コードの中の一つひとつのツール呼び出しに適用されます。ただし auto モードの分類器(操作が安全かを判定する別の AI)が審査するのは、ツール呼び出しではなくコード単位です
  4. 組織は止められるが、オンにはできない:managed settings で CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を "0" にすると組織全体で使えなくなります。逆に、管理者が利用者の代わりにオンにすることはできません

Code Mode とは

Code Mode とは、Claude Code の「ツールの使い方」を変える実験的な機能です。権限モード(Manual・auto など)のような「何を確認なしで実行するか」の切り替えではなく、Claude が作業を進める手順そのものが変わります。

これまで(Code Mode なし)Code Mode あり
Claude が頼むものBash・Read・Edit などのツール呼び出しを1回ずつツール呼び出しをまとめた JavaScript のコード
結果の読み方1回ごとに結果を読み、次に何をするか決めるコードの中で結果を次の呼び出しに渡し、必要な部分だけを読む。1つのコードで複数のコマンドを同時に走らせることもできる
会話に見えるもの各ツール呼び出し各ツール呼び出し(コード本体は Ctrl+O で開く画面で見る)

出典:Run tool calls from code with Code Mode(Claude Code Docs)(2026年11月14日取得)

たとえば「100個のファイルから同じ書き方を探して直し、テストを流す」という作業では、これまでは検索・読み取り・編集・テストの呼び出しが何往復も続き、そのたびに結果が会話に積み上がっていました。Code Mode では、Claude が検索結果を絞り込み、編集し、テストを流すところまでを1つのコードに書き、最後に必要な結果だけを受け取ります。

同じ名前の「別物」と混同しない

「Code Mode」で検索すると、Claude Code の機能ではないページが多く出てきます。2026年11月14日時点で目にしやすいのは次の3つです。

  • Cloudflare の Code Mode:Cloudflare が提案した、MCP のツールを TypeScript の API に変換し、それを呼ぶコードを LLM に書かせる手法(出典:Code Mode: the better way to use MCP(Cloudflare Blog))
  • code-mode-mcp などの非公式 MCP サーバー:コードを書いて実行させる仕組みを、MCP サーバーとして後付けするもの
  • Anthropic Engineering の記事「Code execution with MCP」(2025年11月4日):MCP のツールを直接呼ぶ代わりにコードから呼ぶ設計の解説。記事内の例では、必要なツールの定義だけを読み込むようにしたことで、使うトークンが15万から2,000に減った(98.7%減)と説明しています

最後の記事は考え方の背景として参考になりますが、98.7%という数字は記事内の MCP の例の値で、Claude Code の Code Mode で測った値ではありません。Code Mode の公式ドキュメントには、トークンや料金がどれだけ減るかの数字は載っていません。

仕組み:Claude が書くコードと、画面に見えるもの

Code Mode のセッションでも、あなたがすることは変わりません。プロンプトで作業を頼むと、Claude がそれを進める JavaScript を書きます。公式ドキュメントは、リトライ回数の上限を上げる依頼の例として、次のようなコードを示しています。

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

1行目でファイルを検索し、2行目で最初の1件を取り出し、3行目で編集し、最後の行で「編集したファイル」と「テストの出力」を Claude に返しています。検索結果のうち使わない部分は、Claude が読む必要がありません。

会話の画面に表示されるのは、編集の差分などのツール呼び出しで、コード本体ではありません。コードを読みたいときは Ctrl+O でトランスクリプト表示を開きます。 コードは折りたたまれた Code という行として並び、展開のしかたのヒントが添えられています。もう一度 Ctrl+O を押すと会話に戻ります。

向いている作業・向かない作業

公式ドキュメントが「試してほしい」と挙げているのは、関連するツール呼び出しが多い作業です。

向いている作業(公式の例)理由
多くのファイルに同じ変更を入れる検索・編集を1つのコードでくり返せる
結果を読む前に絞り込みが要る検索不要な結果を会話に流さずに済む
同時に走らせられる独立したコマンドが複数ある1つのコードの中で並列に実行できる

一方で、公式ドキュメントは Code Mode の制限として次の点を挙げています(出典:Code Mode の limitations)。これらを日常的に使う人には向きません。

  • Code Mode のセッションを再開できるのは、ターミナルから、Code Mode をオンにしたときだけ
  • Code Mode のセッションでは Remote Control(スマートフォンなどから手元のセッションを操作する機能)、Claude in Chrome(ブラウザを Claude に操作させる拡張機能)、computer use(画面を見てマウスやキーボードを操作させる機能)が使えない
  • セッションをデスクトップアプリへ移したり、バックグラウンドセッションに変えたりできず、/fork でバックグラウンドのコピーも作れない
  • 結果を待つコードは10分で止まる(詳しくは後述)

使える画面や起動方法の条件は、次の「使える条件」で説明します。

使える条件

Code Mode は、次の条件をすべて満たすときに使えます。1つでも外れると Code Mode は使えません。

項目条件
版Claude Code v2.1.323 以降(latest・stable のどちらのリリースチャネルでも可)
アカウントClaude のサブスクリプションか Console アカウント。LLM ゲートウェイ、Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry 経由は不可
組織HIPAA 向けの構成や、ゼロデータ保持(ZDR)を使っていない
モデルClaude Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.2
起動方法ターミナルの対話セッション(claude)。claude -p、Agent SDK、VS Code 拡張のパネル、デスクトップアプリ、クラウドセッションは不可
インストールネイティブ版(ネイティブインストーラーで入れた Claude Code)
WindowsGit for Windows がインストールされている

出典:Run tool calls from code with Code Mode(Claude Code Docs)の「Requirements」(2026年11月14日取得)

さらに、次のような設定がオンのときも Code Mode は始まりません(ほかの理由は後述の「理由別の対処表」を参照)。

  • API キーヘルパー(apiKeyHelper)
  • agent teams(CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS)
  • OpenTelemetry へのエクスポート
  • DISABLE_TELEMETRY など、Anthropic から機能のオン・オフの設定(機能フラグ)を受け取らないようにする設定

どのモデルが選べるかや、モデルの選び方は Claude Code のモデル比較で整理しています。版が古い場合のアップデート方法は Claude Code のアップデート方法を参照してください。

有効化の手順

公式ドキュメントの「Try Code Mode」に沿って、5つのステップで試せます。

1. 版を確認する

claude --version を実行し、v2.1.323 より古ければ claude update で更新します。stable チャネルを使っていて更新しても v2.1.323 に届かない場合は、stable に来るまで待つか、latest に切り替えます。

2. 環境変数を付けて起動する

CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を 1 にして claude を起動します。試すだけならシェルで指定し、毎回オンにしたいならユーザー設定に書きます。

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"
  }
}

この変数は、プロジェクトの設定ファイル(リポジトリ内の .claude/settings.json など)に書いても無視されます。 クローンしたリポジトリが勝手に Code Mode をオンにできないようにするためです。設定ファイルの置き場所と優先順位は Claude Code の settings.json 解説で詳しく説明しています。

3. 確認画面で「Yes, turn on Code Mode」を選ぶ

初めて Code Mode のセッションを始めるときは確認が出ます。Yes, turn on Code Mode を選ぶと Claude Code が再起動し、セッションの上部に次の1行が表示されます(ドキュメント記載)。

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

この行が出ない、または別の行が出た場合は、後述の「使えないとき・途中で止まるときの対処」を見てください。

4. ツール呼び出しが多い作業を頼む

よく知っているプロジェクトで、たとえば次のように頼みます(公式ドキュメントの例を和訳)。

このプロジェクトのすべての Markdown ファイルを読み、存在しないローカルファイルを指しているリンクを一覧にして

5. Claude が書いたコードを読む

Ctrl+O を押し、Code の行を展開すると、ツール呼び出しの裏にある JavaScript が読めます。もう一度 Ctrl+O で会話に戻ります。

あとで再開するときの注意

Code Mode のセッションを claude --continue や claude --resume で再開するときは、CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 を付けたままにします。Code Mode をオフにした状態では、Claude Code はそのセッションの再開を拒否します。 反対に、Code Mode なしで始めたセッションは、変数を付けていても Code Mode なしで再開されます。また、Code Mode のセッションを再開できるのはターミナルからだけです。

オフにする・組織で止める

自分の環境でオフにする

シェルと ~/.claude/settings.json の両方から CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を消し、新しいセッションを始めます。変数を残したまま値を 0 にしてもかまいません。どちらか一方に 0 があれば、もう一方が 1 でもオフになります。

組織全体で止める

情シスや開発責任者が、社内の利用者に Code Mode を使わせたくない場合は、managed settings に次の設定を入れます。

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

この設定を配っても、すでに Code Mode のセッションにいる人は、終了するか再起動するまでそのまま使えます。その後は Code Mode なしで起動し、0 が入っている間は Code Mode のセッションを再開できません。この設定で止められるのはオフの方向だけで、managed settings から利用者の Code Mode をオンにすることはできません。

公式ドキュメントのトラブルシュート表では、Code Mode が始まらない理由が「your organization's settings don't allow it」のとき、管理者にこの設定を確認するよう案内しています。

権限・auto モード・hooks との関係

Code Mode を試す前にいちばん確認しておきたいのが、権限の扱いです。結論から言うと、ルールと hooks はこれまでどおり効きますが、auto モードの審査の単位が変わります。

deny・ask ルールと PreToolUse hooks

Claude のコードが行う一つひとつのツール呼び出しは、deny・ask の権限ルールと PreToolUse hooks を通ります。Bash などのルールやマッチャーを Code Mode 用に書き換える必要はありません。

権限モードによる違い

権限モードコードの扱い
auto モード分類器が、実行前にコード単位で審査する(ツール呼び出しごとではない)
そのほかのモード(Manual など)コードは審査なしで始まり、そのモードで確認が出るツール呼び出しのたびに確認される

ここで注意したいのは、auto モードの分類器は、実行時に計算される値を見ないという点です。たとえば「検索結果から取り出したパスのファイルを消す」コードでは、どのパスになるかは実行してみないとわかりません。公式ドキュメントは、どうしても制御したい呼び出しにはルールか hooks を残しておくよう勧めています。auto モードそのものの仕組みは Claude Code の auto モード完全ガイドで解説しています。

コードそのものを hooks で確かめる

Claude が書いたコードの中身を検査したい場合は、REPL にマッチする PreToolUse hook を書き、tool_input.code から JavaScript を読みます。REPL は、Claude のコードを実行するツールの名前です。hooks の書き方は Claude Code の hooks 活用ガイドを参照してください。

Bash ルールの限界は Code Mode でも同じ

Bash の権限ルールはコマンドの文字列で照合するため、ルールに一致しない形で同じことを実行されることがあります。これは Code Mode の有無に関係ない、もともとの限界です。コマンドの書き方に左右されない制限が必要なら、Claude Code のサンドボックスを組み合わせます。

長く走るコード:待つ場合は10分、バックグラウンドなら2時間

ビルドやテストのように時間のかかるコードを走らせるとき、Claude は終わるのを待つか、バックグラウンドで続けさせます。

動き方できること時間の上限
待つコードが終わってから Claude が答える10分で停止(権限の確認に使った時間を含む)
バックグラウンドコードが走っている間も Claude と会話できる最大2時間

バックグラウンドで走らせるには、auto モードか bypassPermissions モード(権限の確認をほぼ出さずに実行するモード。deny ルールは効く。公式はコンテナや VM での利用を想定)でセッションを始めます。それでも Claude が待ってしまう場合は、次を確認します。

  • 途中で別のモードに切り替えた:Shift+Tab で、始めたときのモードに戻す
  • 別のモードで始めた、または claude --resume の一覧から選んだ:auto モードが使える環境なら、いったん終了し、Code Mode をオンにしたまま claude --continue --permission-mode auto で開き直す
  • --tools でツール名を指定した:そのフラグを外し、auto モードで始め直す

使えないとき・途中で止まるときの対処

「Code Mode (experimental) isn't available」と出る

セッションの上部にこの行が出たら、Claude Code は Code Mode なしで起動しています。同じ行に理由が続き、/status にも表示されます。理由に合わせて直し、新しいセッションを始めます。

理由に含まれる文言直し方
it isn't open to your account yet版が v2.1.323 より古ければ更新する。新しければ通信を確認して起動し直す。それでも出る場合は日を改めて試す
it only works with the Anthropic APIクラウド事業者・ゲートウェイ・独自の ANTHROPIC_BASE_URL を経由させる設定を外す
it doesn't work with an API key helperapiKeyHelper、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_CUSTOM_HEADERS 内の Authorization・X-Api-Key を外し、ログインするか ANTHROPIC_API_KEY を設定する
it only works with Opus 5.5, Sonnet 5.5 and later models対応モデルで起動する(例:--model opus)。Haiku 5.5 と Fable 5.2 も可
it doesn't work in background jobs--remote-control を付けず、フォアグラウンドで起動する
it needs settings that Claude Code downloads from AnthropicDISABLE_TELEMETRY など、機能フラグを受け取らないようにする変数を外す
OpenTelemetry is onOpenTelemetry のエクスポートが不要なら、CLAUDE_CODE_ENABLE_TELEMETRY と ENABLE_BETA_TRACING_DETAILED を外す
it doesn't yet work with an installed modツール呼び出しを検査する mod(Claude Code の画面や動きを変える追加機能)をオフにする
it can't be used together with agent teams yetCLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS を外す
this launch's tool options--restricted を外す。--tools に REPL を足し、--disallowedTools と deny ルールから REPL を外す
couldn't save your answer~/.claude.json を書き込めるようにする
your organization's settings don't allow it管理者に、組織での無効化の設定を確認する

出典:Run tool calls from code with Code Mode(Claude Code Docs)の「Code Mode doesn't start」(2026年11月14日取得。表は原文の理由と対処を和訳)

表に無い理由が出たときは、前述の「使える条件」を確かめます。Code Mode について何も表示されない場合は、まず claude --version で版を確かめます。v2.1.323 より古ければ更新し、そのうえで CLAUDE_CODE_EXPERIMENTAL_CODE_MODE がシェルかユーザー設定で 1 になっているか、どこか(--settings で渡したファイルを含む)に 0 が残っていないかを確認します。Claude Code 全般のエラーは Claude Code トラブルシューティング完全ガイドから逆引きできます。

カウントダウン付きの確認が出る

auto モードで、前のコードがまだ走っている間に Claude が次のコードを始めると、前のコードは分類器の審査を受けられなくなります。そのため、前のコードの残りの呼び出しのうち審査が必要なものについて、あなたに確認が出ます。IDE がつながっていないときは、次のようなカウントダウンが表示されます(ドキュメント記載)。

Claude Code will automatically block this request in 1:59, to avoid holding up an unattended session

時間内に答えないと、その呼び出しは拒否され、以後カウントダウンが出るはずの呼び出しは確認なしで拒否されます。もう一度確認を出したいときは、Claude にメッセージを送ります。

hooks が原因でツール呼び出しが拒否される

Claude が「ツール呼び出しが拒否された」と報告したら、エラーの文言を聞きます。次の2つは、PreToolUse hook が判断を返せなかったことを意味し、onFailure を設定していなくても呼び出しは拒否されます。

  • the hook failed:Claude のコードからの呼び出しで、hook が起動できない、強制終了された、終了コードが 126、127、または 128 より大きい値で終わった、HTTP エラーや不正な出力を返した。hook を直す
  • the hook did not finish:Claude のコードからの呼び出しで hook が時間切れになった(コードを一度実行したセッションでは、ほかのツール呼び出しでも同じ)。hook の timeout を延ばす

command か http の hook が失敗・時間切れになっても呼び出しを通したい場合は、その hook に "onFailure": "continue" を設定します。なお command hook が 1 などの通常の終了コードで終わった場合は、"onFailure": "block" を設定しない限り呼び出しは通ります。

コードの出力が hooks に止められる

コードの出力が届くはずのところで、hook のブロック理由が返ってくる場合は、UserPromptSubmit hooks を確認します。コードをバックグラウンドで走らせられる状態では、この event の command・http・mcp_tool hook がコードの出力にも走るためです。hook の入力の source が poll_event のときはブロックしないように直します。

実機で確認したこと(v2.1.325)

2026年11月14日に、執筆時点の最新版 v2.1.325 を検証用のディレクトリに入れ、ログインせずに次を確かめました。

  • claude --version の出力は 2.1.325 (Claude Code)
  • claude --help には Code Mode を有効にするオプションが無い(code mode を含む行は0件)。公式ドキュメントが案内する有効化の方法も環境変数です
  • 実行ファイルの中に、環境変数 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE と、Code Mode (experimental) の表示、前述の表にある理由のうち6つ(it isn't open to your account yet、it only works with the Anthropic API、it doesn't work with an API key helper、it only works with Opus 5.5, Sonnet 5.5 and later models、it doesn't work in background jobs、it can't be used together with agent teams yet)の文言が入っている

Code Mode のセッションは対応アカウントでのログインが必要なため、確認ダイアログ、オンになったときの表示、Claude が実際に書くコードは確かめていません。

v2.1.325 で直った Code Mode の不具合

v2.1.325(2026年11月13日 UTC 公開)では、Code Mode について次の不具合が直っています(出典:CHANGELOG)。v2.1.323・v2.1.324 で試していて気になった人は、更新してから試し直すとよいでしょう。

  • Code Mode のスクリプトが、EnterWorktree で入った worktree を無視していた
  • Code Mode のスクリプトが、~ で始まるパスをプロジェクトの中に書いていた
  • Code Mode で、サインインが切れた MCP サーバーが /mcp に接続中と表示され続けていた
  • 権限の確認や計画の承認で「Yes」に添えて入力した文字が、Code Mode では Claude に届かなかった
  • Code Mode のスクリプトの途中で終わったセッションを再開すると、Claude が指示を待たずに作業を始めていた

試すべきか:判断の目安

Code Mode は実験的な機能で、仕様が変わる可能性があります。立場ごとの判断の目安をまとめました。

あなたの状況おすすめ
ターミナルで、多数のファイルにまたがる変更や大量の検索をよく頼む個人のプロジェクトで試す価値がある。まずシェルで一時的にオンにする
VS Code 拡張のパネル・デスクトップアプリ・claude -p・クラウド経由が中心現時点では対象外(対応予定は公表されていない)。VS Code でも、統合ターミナルで claude を起動すれば要件上は対象
社内の権限設計を auto モードの分類器に頼っている試す前に、守りたい操作を deny ルールか hooks で押さえる
情シス・開発責任者方針が決まるまで止めるなら、managed settings に "0" を配る。試させるなら、ルールと hooks の整備を先に

組織への導入方針は、auto モード完全ガイドの組織導入の章が参考になります。MCP サーバーを多く使っている場合は、Claude Code の MCP 統合ガイドもあわせて確認してください。

よくある質問

まとめ

  • Code Mode は、Claude がツール呼び出しを JavaScript でまとめて書き、Claude Code が実行する実験的な機能(v2.1.323〜、既定はオフ)
  • 使えるのは、ネイティブ版をターミナルの対話セッションで、Claude のサブスクリプションか Console アカウント・対応モデルで使う場合だけ
  • オンにするには CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1。プロジェクトの設定では有効にできず、再開するときもオンのままにする
  • 権限ルールと PreToolUse hooks はツール呼び出しごとに効くが、auto モードの分類器はコード単位で審査し、実行時に決まる値は見ない
  • 組織で止めるなら managed settings に "0"。使えないときは、セッション上部か /status に出る理由を表で引いて直す

Code Mode は今後のリリースで変わる可能性があります。本記事も、公式ドキュメントの更新にあわせて見直します。

この記事に合う資料

関連記事

資料で全体をつかんでから、御社の場合をご相談ください

  • 研修・稟議・外注の準備に使える資料を無料で
  • 見積書の確認は、登録なしで診断できます
  • 相談は 30 分無料。代表が直接お返事します
  • 要件が決まっていなくても大丈夫です