Claude Codeの「Code Mode」は、Anthropicが発表したClaude Code向けの実験的機能で、ツール呼び出しを1つずつ直接行う代わりに、複数のツール呼び出しをまとめたJavaScriptをClaudeが書き、Claude Codeがそれをセッション内で実行する仕組みです。
室谷代表取締役Claude CodeのCode Mode、これけっこう本質的な変更なんですよね。ツール呼び出しのやり方そのものが変わる話なので、MYUUUでもエージェント運用をしている立場としては見逃せません。
テキトー教師DotAI 認定講師そうですね。単に「新機能が出た」という話じゃないんですよ。
ClaudeがBashやReadを1回ずつ呼んで結果を読む、という従来のループを、JavaScriptのスクリプト生成に置き換えるという構造の変化です。
ClaudeがBashやReadを1回ずつ呼んで結果を読む、という従来のループを、JavaScriptのスクリプト生成に置き換えるという構造の変化です。
Claude CodeのCode Modeとは?何が発表されたか
まとめ
Claude CodeのCode Modeとは(発表内容の要点)
- Anthropicが発表したClaude Codeの実験的機能
- Claudeがツール呼び出しを1つずつ直接行う代わりに、複数のツール呼び出しをまとめたJavaScriptを書き、Claude Codeがセッション内で実行する
- 公式ドキュメントの一行定義:「Claude writes JavaScript that makes several tool calls in one step」(1ステップで複数のツール呼び出しを行うJavaScriptをClaudeが書く)
- 既定はオフ。環境変数 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 でオプトインする
- 実験的機能のため、予告なく変更・削除される可能性があると明記されている
- Claude Code自体はターミナル・IDE拡張・デスクトップアプリ・ブラウザで使えるエージェント型コーディングツールだが、Code Modeはその中の限られた環境でしか動かない
室谷代表取締役まず前提として、Code ModeはAnthropicが発表したClaude Codeの実験的機能です。Claudeがツール呼び出しを直接1つずつ行う代わりに、複数のツール呼び出しをまとめたJavaScriptを書き、Claude Codeがそれをセッション内で実行します。
テキトー教師DotAI 認定講師公式ドキュメントにも「Claude writes JavaScript that makes several tool calls in one step」とあります。1ステップで複数のツール呼び出しを行うJavaScriptをClaudeが書く、というのが一行定義ですね。
室谷代表取締役で、これ既定はオフなんですよ。環境変数
しかも実験的機能なので、予告なく変更・削除される可能性があると明記されています。ここは実務で使う前に絶対押さえておきたいところです。
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 でオプトインする。しかも実験的機能なので、予告なく変更・削除される可能性があると明記されています。ここは実務で使う前に絶対押さえておきたいところです。
テキトー教師DotAI 認定講師講座でも受講生さんに「実験的機能は“試す”と“頼る”を分けて考えましょう」と伝えているんですが、まさにその典型例ですね。既定オフ、オプトイン、予告なく変更・削除の可能性あり。
この3点セットは本番依存を前提にしないというサインです。
この3点セットは本番依存を前提にしないというサインです。
室谷代表取締役Claude Code自体はターミナル、IDE拡張、デスクトップアプリ、ブラウザで使えるエージェント型コーディングツールですが、Code Modeはその中の限られた環境でしか動かないんですよね。この辺は後半で制約として整理します。
まずは仕組みから。
まずは仕組みから。
Code Modeでできること ― ツール呼び出しがJavaScript実行に変わる仕組み
Code Modeでのツール実行の流れ(「リトライ上限を上げて」の例)
- 01ファイルを探すrg -l "function retryPolicy" src で対象ファイルを検索
- 02対象を編集edit(target, "maxAttempts: 3", "maxAttempts: 5") で書き換え
- 03テストを実行npm test -- retryPolicy を実行(nothrow)
- 04結果をClaudeに返すファイルパスとテスト出力だけを返す
テキトー教師DotAI 認定講師公式ドキュメントの例が分かりやすいんですよ。たとえば「リトライ上限を上げて」と頼むと、Claudeはファイルを探し、編集し、テストを実行するコードを書きます。
最後の行でファイルパスとテスト出力をClaudeに返す、という流れです。
最後の行でファイルパスとテスト出力をClaudeに返す、という流れです。
室谷代表取締役コードで言うとこういう形ですね。
js
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() });
テキトー教師DotAI 認定講師ポイントは3つあって、1つのコードが並列にコマンドを実行できること、前の結果を次の呼び出しに渡せること、そしてClaudeが読む必要のある出力だけを返せることです。
室谷代表取締役これ、地味に大きいのが「必要な出力だけを返す」ところなんですよね。従来はコマンドの出力がそのままコンテキストに流れ込むので、長いログなんかだとトークンをかなり食う。
Code Modeならスクリプト側で絞り込んでから返せる。
Code Modeならスクリプト側で絞り込んでから返せる。
テキトー教師DotAI 認定講師会話画面にはツール呼び出し、たとえば編集のdiffなどが表示されて、書かれたコード自体は表示されません。コードを読みたいときはCtrl+Oでトランスクリプトビューアを開くと、各コードが折りたたまれたCode行として出てくる仕組みです。
室谷代表取締役つまりユーザー体験としては今まで通り会話とdiffを見ていて、裏で何が起きているかを見たい人だけCtrl+Oを押す、と。この設計は実務者にはありがたいですね。
ログがコードで埋まらないので。
ログがコードで埋まらないので。
テキトー教師DotAI 認定講師もう1つ、公式が特徴として挙げているのが「長時間コマンドの実行中にも応答できる」点です。ビルドやテストが走っている間にClaudeが答えられる。
これは体感がけっこう変わるんじゃないでしょうか。
これは体感がけっこう変わるんじゃないでしょうか。
従来のツールコールとの違い ― Bash・Read・Editを1つずつ呼ぶ方式から何が変わるか
従来のツールコールとCode Modeの違い
| 観点 | 従来のツールコール | Code Mode |
|---|---|---|
| 呼び出し方 | Bash・Read・Editを1回ずつ要求 | 複数呼び出しをまとめたJavaScriptを生成 |
| 結果の扱い | 各結果を読んでから次を決める | 前の結果を次の呼び出しに渡せる |
| 並列実行 | 基本は逐次 | 並列に実行できる |
| 出力 | そのまま返る | 必要な部分だけを返せる |
| コードの確認 | 不要 | Ctrl+Oのトランスクリプトビューアで確認 |
室谷代表取締役ここが一番伝えたいところなんですけど、Code Modeなしの場合、ClaudeはBash、Read、Editといったツール呼び出しを都度要求し、各結果を読んでから次の行動を決めていました。1手ずつですね。
テキトー教師DotAI 認定講師それがCode Modeでは、呼び出し群をJavaScriptコードとして一括生成・実行する。整理するとこうです。
| 観点 | 従来のツールコール | Code Mode |
|---|---|---|
| 呼び出し方 | Bash・Read・Editを1回ずつ要求 | 複数呼び出しをまとめたJavaScriptを生成 |
| 結果の扱い | 各結果を読んでから次を決める | 前の結果を次の呼び出しに渡せる |
| 並列実行 | 基本は逐次 | 並列に実行できる |
| 出力 | そのまま返る | 必要な部分だけを返せる |
| コードの確認 | 不要 | Ctrl+Oのトランスクリプトビューアで確認 |
室谷代表取締役表にすると分かりやすいですね。要は「1手ずつ会話しながら進む」から「段取りをコードに書いて一気に走らせる」への変化です。
テキトー教師DotAI 認定講師ここで注意したいのが、コード自体は会話画面に出ないという点です。diffなどのツール呼び出しは見えますが、書かれたJavaScriptを見るにはCtrl+Oを押してCode行を展開する必要があります。
室谷代表取締役従来の感覚で「何をやったか会話で全部追える」と思うと、ちょっと面食らうかもしれません。ただ、裏で何が動いたかを確認できる手段が用意されているのは安心材料です。
テキトー教師DotAI 認定講師あと、これは誤解しやすいんですが、Code Modeはあくまでツール呼び出しのまとめ方の話で、Claude Codeという製品自体の使い方が根本から変わるわけではありません。プロンプトでタスクを伝える点は同じです。
Code Modeの使い方・始め方 ― CLAUDE_CODE_EXPERIMENTAL_CODE_MODEの設定手順とバージョン要件
室谷代表取締役ここは実務者向けに手順をきっちり整理しておきましょう。まずバージョン確認です。
claude --version を実行して、v2.1.323より古ければ claude update を実行します。
テキトー教師DotAI 認定講師公式ドキュメントでは、stableチャンネルでv2.1.323に届かない場合はstableが追いつくのを待つか、latestに切り替える、と案内されています。アップデート周りはClaude Codeのアップデート方法完全ガイドでも詳しく解説していますので、チャンネルの考え方はそちらが参考になります。
室谷代表取締役次が環境変数の設定ですね。macOS、Linux、WSLならシェルでこうです。
bash
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
テキトー教師DotAI 認定講師Windows PowerShellならこうですね。
powershell
$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude
室谷代表取締役毎回のセッションで有効にしたいなら、
~/.claude/settings.json にenvブロックを保存しておく方法があります。json
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}
テキトー教師DotAI 認定講師ここで重要な注意点があって、Claude Codeはプロジェクトの設定ファイルにあるこの変数は無視するんですよ。つまり、クローンしてきたリポジトリ側からCode Modeを勝手にオンにされることはない、という安全設計になっています。
室谷代表取締役これは良い設計ですよね。リポジトリを開いただけで知らないうちに実験的機能が有効になっていた、という事故を防げる。
テキトー教師DotAI 認定講師設定したら初回のCode Modeセッション前に確認を求められます。「Yes, turn on Code Mode」を選ぶとClaude Codeが再起動して、セッション上部に「Code Mode (experimental) is on · this session can be resumed only with Code Mode on」と表示されます。
この行が出ない場合は起動していないので、トラブルシューティングを確認することになります。
この行が出ない場合は起動していないので、トラブルシューティングを確認することになります。
室谷代表取締役試すなら、慣れているプロジェクトで「このプロジェクトの全Markdownファイルを読んで、存在しないローカルファイルを指しているリンクを列挙して」のような、ツール呼び出しが多くなるプロンプトを投げるのが公式の推奨例ですね。
テキトー教師DotAI 認定講師そしてCtrl+OでCode行を展開して、Claudeが書いたJavaScriptを確認する。ここまでが一連の流れです。
室谷代表取締役あと、セッションを再開するときも注意が必要です。
逆に、Code Modeなしで始めたセッションは、変数が設定されていてもCode Modeなしで再開されます。
claude --continue や claude --resume を使う際に CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を1にしておかないと、Claude CodeはCode Modeのセッションの再開を拒否します。逆に、Code Modeなしで始めたセッションは、変数が設定されていてもCode Modeなしで再開されます。
テキトー教師DotAI 認定講師オフにしたいときは、シェルと
~/.claude/settings.json から変数を削除するか、値を0にします。片方に0が入っていれば、もう片方に1が入っていてもCode Modeはオフのままです。
室谷代表取締役組織側で全面ブロックしたい場合は、管理設定に
ただし、すでにCode Modeセッションに入っているユーザーは、終了または再起動するまでそのままセッションに残る点は覚えておきたいですね。
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を0で入れる。すると組織内の誰も使えなくなります。ただし、すでにCode Modeセッションに入っているユーザーは、終了または再起動するまでそのままセッションに残る点は覚えておきたいですね。
テキトー教師DotAI 認定講師管理設定からユーザーに対してCode Modeをオンにすることはできない、というのも公式に明記されています。あくまでオプトインの機能だということです。
室谷代表取締役Code Modeが効くユースケース ― どんな作業で効果を発揮するか
室谷代表取締役公式が挙げているのは「多くの関連するツール呼び出しを伴うタスク」です。具体的には3つ。
多数ファイルにまたがる繰り返し変更、読む前に結果を絞り込む必要がある検索、同時実行できる複数の独立コマンドですね。
多数ファイルにまたがる繰り返し変更、読む前に結果を絞り込む必要がある検索、同時実行できる複数の独立コマンドですね。
テキトー教師DotAI 認定講師順番に整理するとこうです。
- 多数ファイルにまたがる繰り返し変更:同じ修正を何十ファイルにも当てるような作業
- 結果を絞り込んでから読む検索:出力が大量になる検索をスクリプト側でフィルタ
- 同時実行できる独立コマンド:並列で走らせられるビルドやテスト
室谷代表取締役MYUUUでも、リポジトリ全体に同じリネームを当てるとか、リンク切れを洗い出すとか、そういう“数が多いだけの作業”はよく発生するんですよね。これを1手ずつ会話で往復するのは正直もったいない。
テキトー教師DotAI 認定講師講座で受講生さんを見ていても、ツール呼び出しが多くなるタスクほど待ち時間が気になるという声が多いんですよ。Code Modeはまさにそこに効く、という位置づけですね。
室谷代表取締役あと「長時間コマンドの実行中にも応答できる」という特徴は、テストが長いプロジェクトでは効いてきます。テストを走らせながら別の相談ができるわけですから。
テキトー教師DotAI 認定講師ただし、これはあくまで公式が挙げている用途であって、すべてのタスクで速くなるという話ではありません。単発の小さな修正なら従来の方式で十分ですし、そちらの方が見通しが良いことも多いです。
室谷代表取締役そうそう。「Code Modeありき」で考えるんじゃなくて、ツール呼び出しが多くなるタスクだな、と感じたときにオンにする、くらいの距離感がちょうどいいと思います。
使う前に知るべき制約 ― 対応環境・実行時間・実験的機能ゆえの注意点
室谷代表取締役ここからが本番です。Code Modeは使える環境がかなり限られています。
まずバージョンはv2.1.323以降、リリースチャンネルはどちらでも可。それより古いバージョンだとCode Modeなしで起動します。
まずバージョンはv2.1.323以降、リリースチャンネルはどちらでも可。それより古いバージョンだとCode Modeなしで起動します。
テキトー教師DotAI 認定講師アカウントはClaudeサブスクリプションまたはConsoleアカウントが必要です。ゲートウェイ、Amazon Bedrock、AWS上のClaude Platform、Google CloudのAgent Platform、Microsoft Foundry、Google Cloud上のClaude Models(Anthropic管理)経由では使えません。
室谷代表取締役組織側の条件もあって、HIPAA構成やゼロデータ保持を使っている組織では使えないんですね。
テキトー教師DotAI 認定講師モデルはClaude Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.2です。そして対応サーフェスはターミナルでの対話的なclaudeセッション限定。
-p、Agent SDK、VS Codeパネル、デスクトップアプリ、クラウドセッションでは動作しません。
室谷代表取締役ここ、けっこう大きいですよね。VS Codeパネルやデスクトップアプリで使っている人は、ターミナルに移らないと試せないということですから。
テキトー教師DotAI 認定講師エージェントチームと併用する場合はv2.1.326以降が必要で、チームメイトはデフォルトのインプロセス表示モードではCode Modeで動きますが、分割ペインではCode Modeなしで開始する、という違いがあります。
室谷代表取締役インストールはネイティブビルドであること、WindowsではGit for Windowsがインストールされていることが条件です。あと、APIキーヘルパーやOpenTelemetryエクスポート、DISABLE_TELEMETRYといった一部の設定がオンの状態ではCode Modeを開始できません。
テキトー教師DotAI 認定講師実行時間の制約も見逃せません。待機時は10分で停止します。
これはパーミッションプロンプトで待っている時間も含みます。バックグラウンド時は最大2時間で、こちらはautoまたはbypassPermissionsモードでセッションを開始した場合です。
これはパーミッションプロンプトで待っている時間も含みます。バックグラウンド時は最大2時間で、こちらはautoまたはbypassPermissionsモードでセッションを開始した場合です。
室谷代表取締役バックグラウンドで走らせるには、セッションの開始モードが重要なんですね。途中で別モードに切り替えていた場合はShift+Tabで戻すか、
claude --continue --permission-mode auto でCode Modeをオンにして再開する、といった対処が公式に示されています。
テキトー教師DotAI 認定講師使えない機能も明確です。Remote Control、Claude in Chrome、computer useは利用不可。
セッションをデスクトップアプリに移動したり、バックグラウンドセッション化したりもできません。
セッションをデスクトップアプリに移動したり、バックグラウンドセッション化したりもできません。
/fork でバックグラウンドコピーを開始することもできません。
室谷代表取締役パーミッション周りも従来と挙動が変わります。autoモードでは分類器がツール呼び出しごとではなくコードのまとまりごとにレビューします。
しかも実行時に計算された値、たとえば検索出力から取ったパスなどは分類器から見えない。だから制御したい呼び出しについてはルールやフックを残しておく必要がある、と公式が明記しています。
しかも実行時に計算された値、たとえば検索出力から取ったパスなどは分類器から見えない。だから制御したい呼び出しについてはルールやフックを残しておく必要がある、と公式が明記しています。
テキトー教師DotAI 認定講師これは講座でも強調したいところですね。autoモードの分類器はコード単位でレビューするので、個々のツール呼び出しを全部見ているわけではない。
制御したいものはルールかフックで担保する、という設計思想です。
制御したいものはルールかフックで担保する、という設計思想です。
室谷代表取締役PreToolUseフックでシェルコマンドを許可・ブロックしている場合は、コマンドの各部分をチェックするようにする必要があります。Code Modeでは
app フォルダ内の git push が cd 'app' && git push という形でフックに届くことがあるからです。
テキトー教師DotAI 認定講師コード自体をチェックしたいなら、コードを実行するREPLツールにマッチするPreToolUseフックを書いて、
tool_input.code からJavaScriptを読む、という方法が示されています。
室谷代表取締役あと地味にハマりやすいのが、autoモードで前のコードが走っている最中に新しいコードを開始すると、前のコードが分類器のレビューを失うことです。その場合、レビューが必要な残りの呼び出しについて確認を求められ、IDE未接続だとカウントダウン付きのプロンプトが出ます。
テキトー教師DotAI 認定講師カウントダウンが終わるとその呼び出しは拒否され、以降のカウントダウン対象の呼び出しはプロンプトなしで拒否されます。プロンプトを再表示したいときはClaudeにメッセージを送る、と。
室谷代表取締役フックが関与するケースも整理されています。PreToolUseフックが判断を返さなかった場合、呼び出しは拒否されます。
フックが起動できなかった、強制終了された、126・127・128超のコードで終了した、HTTPエラーや不正な出力を返した、といったケースです。
フックが起動できなかった、強制終了された、126・127・128超のコードで終了した、HTTPエラーや不正な出力を返した、といったケースです。
テキトー教師DotAI 認定講師フックがタイムアウトした場合も同様ですね。コマンドやhttpフックが失敗・タイムアウトしても呼び出しを進めたいなら、
逆に、終了コード1のような通常のコードで止めたいなら
"onFailure": "continue" を設定します。逆に、終了コード1のような通常のコードで止めたいなら
"onFailure": "block" を設定する、という整理です。
室谷代表取締役まとめると、Code Modeは「便利そう」で飛びつく前に、自分の環境が要件を満たしているか、フックやパーミッションの設計がコード実行前提になっているかを確認する必要がある、ということですね。
テキトー教師DotAI 認定講師実験的機能ですから、公式ドキュメントのトラブルシューティング表を片手に、まずは慣れたプロジェクトで小さく試すのが現実的です。フィードバックは
/feedback で送れると案内されています。
室谷代表取締役よくある質問
室谷代表取締役ここからは、よく聞かれそうな点を整理しておきます。
テキトー教師DotAI 認定講師まず「Code Modeとは何か」ですが、Claudeが複数のツール呼び出しをまとめたJavaScriptを書き、Claude Codeがそれをセッション内で実行する実験的機能です。ツール呼び出しを1つずつ直接行う方式の置き換えになります。
室谷代表取締役「有効化方法は?」については、環境変数
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 をシェルか ~/.claude/settings.json に設定し、初回の確認で「Yes, turn on Code Mode」を選ぶ流れです。プロジェクトの設定ファイルにある値は無視される点も押さえておきましょう。
テキトー教師DotAI 認定講師「バージョン要件は?」はv2.1.323以降です。エージェントチームと併用する場合はv2.1.326以降が必要です。
室谷代表取締役「どんな環境で使えるか」は、ターミナルの対話的セッション限定です。
-p、Agent SDK、VS Codeパネル、デスクトップアプリ、クラウドセッションでは動きません。
テキトー教師DotAI 認定講師「料金は?」については、公式ドキュメントの抜粋にCode Mode固有の料金記載はありません。ClaudeサブスクリプションまたはConsoleアカウントが必要という条件が示されている範囲で、現時点では明らかにされていません。
室谷代表取締役「本番利用は可能か」については、実験的機能で既定オフ、予告なく変更・削除される可能性があると明記されている以上、依存を前提にした本番運用は避けるのが妥当です。組織側は管理設定で0を入れて全面ブロックすることもできます。
テキトー教師DotAI 認定講師「従来のツールコールと何が違うか」は、Bash・Read・Editを1つずつ呼ぶ代わりに、複数呼び出しをまとめたJavaScriptを生成して実行する点です。並列実行、前の結果を次の呼び出しに渡す、必要な出力だけを返す、といったことができます。
室谷代表取締役「コードはどこで確認できるか」は、会話画面にはツール呼び出しが表示され、コード自体はCtrl+Oのトランスクリプトビューアで折りたたまれたCode行を展開して確認します。
テキトー教師DotAI 認定講師「長時間の処理はどうなるか」は、待機時は10分で停止し、バックグラウンド時は最大2時間です。バックグラウンドはautoまたはbypassPermissionsモードで開始した場合に可能です。
室谷代表取締役「オフに戻すには」は、シェルと
~/.claude/settings.json から変数を削除するか、値を0にします。片方に0があればオフのままです。
テキトー教師DotAI 認定講師最後に「Cloudflare由来のCode Mode概念との関係は」という点ですが、今回の公式スレッドおよび公式ドキュメントの抜粋には、その出自や経緯についての記載はありません。現時点では明らかにされていません、というのが正確なところです。
室谷代表取締役ここは憶測で埋めずに、Anthropicの公式情報が出てきたら追いかけましょう。まずは手元のターミナルで、慣れたプロジェクトの小さなタスクから試してみるのが良さそうです。
