Claude Code「Code Mode」の使い方と有効化|「37%削減」の真相
「何か問題が起きたら、まずClaudeが書いたスクリプトを理解するところから始めなきゃいけない」。
Claude CodeのCode Modeが話題になった週、X上でこう書いた開発者がいる(@tangmian。2026年11月15日のi10x記事が引用した投稿を筆者が訳した)。
Code Modeは、2026年11月12日のClaude Code v2.1.323で入った実験機能だ。ClaudeがBashやReadを1回ずつ呼ぶのをやめ、ツール呼び出しをまとめたJavaScriptを書いて一気に実行する。CellCogによれば、Anthropicの開発者向けXアカウントの告知は11月18日(UTC)時点で78万回以上表示されたという。
ただ、一緒に語られがちな「トークン37%削減」という数字は、Code Modeについて測定された値ではない。何が本当で、誰が使うべきか。PMとして「使う側」の目線で整理した。なお、本記事は公式ドキュメントと第三者の検証報告をもとにした整理で、筆者自身がCode Modeを動かして測った結果ではない。
- Claude Codeを日常的にターミナルで使っていて、トークン消費や待ち時間が気になる人
- 「Code Modeって結局オンにすべき?」の判断材料がほしい人
- チームのClaude Code設定を管理していて、実験機能の扱いを決めたい人
- Code ModeはClaudeがJavaScriptでツールをまとめて呼ぶ実験機能。既定はオフで、いつ変更・削除されてもおかしくない
- 効くのは「多数のファイルに同じ変更」「大量の検索結果を絞り込む」など、ツール呼び出しが多い作業。2回程度の呼び出しで終わる作業には向かない
- 「37%削減」はAPI機能の数字。Code Modeの削減率は、2026年11月18日時点で公式ドキュメントに記載がない
- 自分なら、慣れたリポジトリの単発作業で試すだけにして、常時オンにはしない
有効化の手順だけ知りたい人は、有効化手順と使えない環境へ。
Code Modeとは何か:通常のClaude Codeとの違い
通常のClaude Codeは、ツールを1回呼ぶたびに結果を読み、次の一手を決める。10ファイルを調べるなら、呼び出しと読み込みの往復が10回前後発生する。
Code Modeではこれが変わる。公式ドキュメントの説明はこうだ。
With Code Mode, Claude writes a piece of JavaScript that makes the tool calls, and Claude Code runs that code in your session. (出典:Claude Code Docs: Code Mode)
ドキュメントに載っている例の前半は次のようなものだ(実際の例は、このあとテストを走らせて結果をClaudeに返す行が続く)。
const files = await $`rg -l "function retryPolicy" src`.text();
const target = files.trim().split("\n")[0];
await edit(target, "maxAttempts: 3", "maxAttempts: 5");
検索して、結果から対象ファイルを選び、書き換え、テストを走らせる。この一連の手順を1つのコードで済ませる。ドキュメントが挙げる用途は3つ。多数のファイルにまたがる同じ変更、Claudeが読む前に絞り込みたい検索、同時に走らせられる独立したコマンド群だ。
PMとしての理解では、「部下に1件ずつ指示を出して報告を待つ」のをやめ、「手順書を渡してまとめて片付けてもらう」方式に近い。手順書が正しければ速い。間違っていれば、手順書を読み解くところから始めることになる。冒頭の懸念はここにある。
ちなみに、この発想自体はAnthropic独自ではない。Cloudflareが2025年9月に「Code Mode: the better way to use MCP」という記事で、MCPツールをTypeScriptのAPIに変換してLLMにコードを書かせる方式を提案していた(出典:Cloudflare Blog)。
Code Modeの有効化手順と使えない環境
オンにする
環境変数を1つ設定して起動する。
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
常に使うなら~/.claude/settings.jsonのenvに次のように書く(ただし、後述するとおり筆者は常時オンをすすめない)。
{ "env": { "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1" } }
初回は確認画面が出るので「Yes, turn on Code Mode」を選ぶ。有効になるとCode Mode (experimental) is onと表示される。
ここで安全面の配慮が1つある。この変数はプロジェクトの設定ファイルに書いても無視される。クローンしたリポジトリが勝手にCode Modeを有効化する事態を防ぐためだ。wmedia.esの検証記事は、プロジェクト側の.claude/settings.jsonに書いた設定が「何の警告もなく」無視されたと書いている(出典:wmedia.es、2026年11月13日)。設定したのに効かない、と悩む前に知っておきたい。
使えない環境が多い
ここが一番の落とし穴だ。公式ドキュメントによると、2026年11月18日時点で次の条件がある。
| 項目 | 条件 |
|---|---|
| バージョン | v2.1.323以降(複数のClaudeを並行稼働させるagent teamsとの併用はv2.1.326以降) |
| 動く場所 | 対話型ターミナルのclaudeのみ。-p、Agent SDK、VS Codeパネル、デスクトップアプリ、クラウドセッションは不可 |
| モデル | Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.2 |
| アカウント | ClaudeサブスクリプションかConsoleアカウント。Amazon Bedrock、Claude Platform on AWS、Google Cloud、Microsoft Foundry、ゲートウェイ経由は不可。HIPAA構成やゼロデータ保持(ZDR)の組織も不可 |
| 併用できない機能 | Remote Control、Claude in Chrome、computer use |
| ブロックされる設定 | APIキーヘルパー、OpenTelemetryエクスポート、DISABLE_TELEMETRY |
Code Modeで始めたセッションは、Code Modeをオンにしたままでないと--resumeで再開できない点も注意したい。スマホから操作するためにRemote Controlを使っている人は、そもそも併用できない。
実際、Flavio Copes氏は最初の起動で「isn’t available」と表示され、原因は環境変数CIが設定されていたことだったと書いている(出典:flaviocopes.com、2026年11月18日)。動かないときは、表示される理由の文言を読むのが早い。
「37%削減」はどこから来たのか
Code Modeの話題と一緒に「トークン37%削減」という数字が広く出回った。これはAnthropicが2025年11月24日に公開したエンジニアリング記事の数字だ。
Average usage dropped from 43,588 to 27,297 tokens, a 37% reduction on complex research tasks. (出典:Anthropic: Introducing advanced tool use)
対象はClaude Developer PlatformのAPI機能「Programmatic Tool Calling」で、Claude CodeのCode Modeではない。考え方は似ているが、別の機能の、別の条件での測定値だ。i10xのChristopher Ort氏は「話題の数字は間違っていたが、方向性は正しかった」という趣旨でまとめている(筆者訳)(出典:i10x)。
Code Modeの公式ドキュメントには、削減率も速度の数字も載っていない。
実際に試した人たちの結果
では個人の検証はどうか。集めた範囲では、結果ははっきり割れている。以下の引用は筆者による日本語訳(一部要約)なので、原文は各出典で確認してほしい。
トークンは減ったが、遅くなった例。wmedia.esは、40日分の注文JSONから上位顧客3人を出す同じ依頼を、Opus 5.5でCode Modeあり・なし1回ずつ実行した。入力トークンの合計は150,364から94,659へ約37%減った。一方で所要時間は15秒から37秒に延びた。答えは同じだった。著者自身が「1回ずつではベンチマークにならないし、今回はCode Modeのほうが遅かった」と認めている(出典:wmedia.es)。
興味深いのは、削減の理由だ。往復の回数はどちらも4回で変わらなかった。/context(コンテキストの内訳を表示するコマンド)で見ると、システムツールの固定分が24.6kから11.1kトークンに減っており、これが削減の主な要因とみられる。
速くなった例。Flavio Copes氏は、Markdown8ファイルを持つAstroプロジェクトでリンク切れ探しを実行し、Code Modeなしの35秒に対してありで15秒だった。ビルドと型チェックとnpm outdatedをまとめた作業では17秒が14秒で、差は小さかった。もともとClaudeは独立したコマンドを並列で呼べるので、Code Modeの上積みが小さかったと本人は分析している(出典:flaviocopes.com)。
呼び出し回数が劇的に減った例。Daniel Ávila氏は同様のリンク切れ探しをFable 5.2で試し、「2回のモデルターンで13回のツール呼び出しを済ませ、3つのリンク切れをすべて見つけた」と報告した(出典:DEV Community、2026年11月16日)。
検索が多い作業で大きく効いた例。Shrey Shah氏はMCP経由のWeb検索を20回以上行うリサーチ課題で、「トークンは63%少なく、29%速く終わった」と書いている。ただし使用モデルや試行回数、トークンの数え方は書かれていない(出典:DEV Community、2026年11月16日)。
懐疑的な声もある。i10xは、Xに「Claudeはもともと長いシェルコマンドを書いているのに、なぜCode Modeの出力が劇的に良くなるのか」という趣旨の疑問が出ていたと紹介している。Ávila氏も、2回程度の呼び出しで終わる作業では、すでに1往復で済んでいたところにコード生成の手間を足すだけだという趣旨を書き、Code Mode前提のワークフローは組まないよう勧めている(DEV Community)。
影の部分:権限とレビューの変化
性能以上に気をつけたいのが、権限確認の仕組みが変わる点だ。
Auto modeは、承認ダイアログの代わりに分類器が安全性を自動判定するモードだ。Code Modeでは、この分類器がツール呼び出し1回ごとではなく、コード全体を実行前に1回だけ審査する。ドキュメントは、実行時に計算された値は分類器から見えないと明記している。つまり「どのファイルを消すか」が実行中に決まるコードは、事前審査で中身を見通せない。
Auto mode以外では、コードは審査なしで走り始め、各ツール呼び出しで通常どおり確認が出る。許可・確認ルール(deny/ask)や、ツール実行の直前に自作スクリプトを挟めるPreToolUseフックは、中のツール呼び出しにもBashなど本来の名前で適用される。フックでコード自体を検査したい場合は、Code Modeがコードを実行するときの内部ツールREPLにマッチさせてtool_input.codeを読む。Modsやフックで独自のガードを組んでいる人は、ここを一度確認しておくべきだ。
ほかにも制約がある。コードの完了を待つ通常の使い方では、10分で打ち切られる。バックグラウンド実行なら最長2時間まで走らせられるが、auto modeか、確認をすべて省くbypassPermissionsモードが必要になる。リリース後も修正が続いており、v2.1.326では、コード内でシェルコマンドを呼ぶ$ヘルパーが一部の値をエラーで拒否する(何も実行しない)変更が入った。v2.1.327では、auto modeでスクリプトの実行中に、auto modeが許可した2本目のスクリプトを始めると、1本目に権限確認や拒否が出るバグが修正された(出典:Claude Code Changelog)。仕様はまだ動いている。
組織で使わせたくない場合は、管理者が配布する管理設定(managed settings)のenvで止められる。
{ "env": { "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0" } }
電脳狐影ならこう判断する
繰り返しになるが、筆者はまだCode Modeを自分で検証していない。そのうえで、自分なら常時オンにはしない。使うのは次のような場面に限る。
- 何十ファイルにまたがる機械的な置換や、リンク切れ・TODOの棚卸し
- 検索結果が大量に返ってきて、Claudeに全部読ませたくない調査
逆に、日々の小さな修正、本番に近いリポジトリでの作業、Remote Controlやデスクトップアプリと組み合わせる運用では使わない。理由は、判断材料がまだ個人による少数の試行(条件の記載が不十分なものもある)に限られ、遅くなった例も報告されているからだ。プランの利用枠を気にしているなら、プロンプトキャッシュの設定の見直しも、使い方によっては節約の選択肢になる。
試すなら、勝手を知っているリポジトリで、同じ依頼をCode Modeあり・なしで1回ずつ流し、/contextと所要時間を見比べるのがいい。数字を他人の記事に頼らず、自分の作業で測る。Fixterの記事も、ドキュメントに数字がない以上は自分の作業で測るべきだという趣旨を書いていた(出典:Fixter)。PMとして言えば、実験機能は「効くかもしれない」ではなく「自分の業務で効いた」を確認してから運用に組み込むものだ。
正直なところ、Code Modeがいずれ既定になるのか、このまま消えるのかはわからない。ドキュメント自身が「いつ変更・削除されてもおかしくない」と書いている以上、今は触って感触をつかむ段階だ。
Code Modeを試す前に、権限の仕組みを押さえる
Code Modeはauto modeの審査単位を変える。承認まわりの設計を先に理解しておくと、試すときに慌てずに済む。
関連記事
- Claude Code Auto Mode完全ガイド|1日47回の承認地獄から解放される新機能
- Claude Code Remote Controlの使い方|スマホ操作の設定と安全策
- Claude Codeのキャッシュを1時間に戻す方法、ENABLE_PROMPT_CACHING_1Hの全て
- Claude Code Modsとは何か|TypeScriptでAgentの動作を書き換える新機構
- Claude Fable 5.2とMythos 5.2が登場
本記事の情報は2026年11月18日時点のものだ。Code Modeは実験機能で、仕様・対応環境・設定名は予告なく変わる可能性がある。紹介した性能の数字は各著者の個別検証で、同じ結果を保証するものではない。最新情報はClaude Code公式ドキュメントとChangelogで確認してほしい。本記事は筆者による実機検証ではなく、公式ドキュメントと第三者の報告を整理したものである。記事中の製品名・サービス名は各社の商標または登録商標であり、本サイトは各社と提携関係にない。