Claude CodeのCode Modeとは?使用量は本当に減るのか72回実測|設定方法と注意点
Claude Codeの実験機能Code Modeを4種類の作業・3モデルで72回実測。推定費用は全条件で下がり合計約4割減、減った主因はツールの説明が小さくなること。速さは作業次第でした。設定方法と権限の注意点も解説します。

この記事の結論
- Code ModeはClaude Code v2.1.323で追加された実験機能で、Claudeがツールを1回ずつ呼ぶ代わりにJavaScriptを書き、複数のツール呼び出しを1回でまとめて実行します。既定はオフで、対話モードのターミナルでだけ使えます。
- 当研究所がv2.1.325・サブスクリプションのログインで4種類の作業を3モデル×オン/オフ×3回の72回試すと、すべて正解したうえで、定価換算の推定費用は12条件すべてで下がり、合計で約4割減りました(キャッシュの条件をそろえた試算)。
- 減ったおもな理由は往復の回数ではなく、毎回送るツールの説明が小さくなることでした。/contextの「System tools」はオフの24.8kトークンからオンでは4.4kトークンになり、1回目のリクエストの入力も約45%小さくなりました。
- いちばん効いたのはMCPツールを40回呼ぶ作業で、Opus 5.5の推定費用は57〜72%減り、時間も約35%短くなりました。一方、80本のMarkdownのリンク切れ探しでは、3モデルとも時間が12〜32%延びました。
- 読み取り禁止のルールとPreToolUseフックは、Code Modeのコードの中の呼び出し1回ごとに効きました。ただしReadの禁止はシェルのcatには及ばず、auto modeの安全チェックはコードを実行前に1回読むだけです。
こんにちは、Claude Code研究所の技術ブログ担当です。11月12日に出たClaude Code v2.1.323で、Anthropicが実験機能「Code Mode」を追加し、14日にはXで「5時間枠と週の上限がずっと長持ちする」という投稿が37万回以上表示されました。本当に使用量は減るのか気になったので、4種類の作業を3つのモデルでオン/オフ3回ずつ、計72回測りました(Claude Code v2.1.325・サブスクリプションのログイン)。結果は、すべて正解したうえで推定費用が全条件で下がり、合計で約4割減。ただし速さは作業次第で、逆に遅くなる作業もありました。設定方法と、権限まわりの注意点もまとめます。
目次
Claude CodeのCode Modeとは?
Code Modeは、Claudeがツールを1回ずつ呼ぶ代わりに、ツールを呼ぶJavaScriptを書き、Claude Codeがそれを実行する実験機能です。v2.1.323で追加され、既定ではオフになっています。
ふだんのClaude Codeは、「ファイルを探す → 結果を読む → 次にどのファイルを開くか決める」というように、ツールを1回呼ぶごとに結果を受け取って次を考えます。Code Modeでは、この流れを1つのプログラムに書いてまとめて実行し、Claudeは最後に必要な結果だけを読みます。公式ドキュメントは、向いている作業として次の3つを挙げています。
- たくさんのファイルに同じ変更をくり返す作業
- 検索結果を絞り込んでから読む必要がある調べもの
- お互いに関係のないコマンドを同時に走らせる作業
画面には、編集の差分などツール呼び出しの結果が今までどおり表示され、コードそのものは出ません。Ctrl+Oで開く記録画面に「Code」という行が現れ、そこを開くと中身を読めます。試走のセッション記録をのぞいてみると、Markdown 80本をまとめて読むコードは、わずか5行でした!
const files = (await $`find docs -name '*.md'`.text()).trim().split('\n');
const all = (await $`git ls-files; find . -not -path './.git/*'`.text());
const out = {};
for (const f of files) out[f] = await file(f).text();
({files, tree: all.slice(0,3000), out})
ドキュメントの例と同じく、$`…`がシェルのコマンド、file()がファイルの読み込みです。Claude Codeの記録上は、このコード1つの中でRead(ファイルを読むツール)が80回実行されていました。
Code Modeの設定方法と使える条件は?
Code Modeは、Claude Code v2.1.323以降で環境変数CLAUDE_CODE_EXPERIMENTAL_CODE_MODEを1にしてclaudeを起動すると有効になります。初回は確認画面が出て、了承すると再起動します。
claude --version # 2.1.323 以降か確認
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
毎回オンにしたい場合は、ユーザー設定(~/.claude/settings.json)のenvに書きます。リポジトリの .claude/settings.json に書いても無視されるので、他人のリポジトリを開いただけで勝手にオンになることはありません。
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}
起動すると「Code Mode (experimental)」という説明の画面が出ます。「Yes, turn on Code Mode」を選ぶとClaude Codeが再起動し、上部に「Code Mode (experimental) is on」と表示されれば成功です。手元のMac(Ultraプランのログイン)では、この手順でそのまま動きました。
使える条件は意外と細かいので、表にしておきます。
| 項目 | 条件(公式ドキュメント、2026年11月15日確認) |
|---|---|
| バージョン | v2.1.323以降・ネイティブ版のインストール |
| 起動のしかた | ターミナルで対話モードのclaudeだけ。claude -p、Agent SDK、VS Codeのパネル、デスクトップアプリ、クラウドのセッションは不可 |
| アカウント | Claudeのサブスクリプションか Console のアカウント。ゲートウェイ、Amazon Bedrock、Google Cloud、Microsoft Foundry 経由は不可 |
| モデル | Opus 5.5・Sonnet 5.5・Haiku 5.5・Fable 5.2 |
| 併用できない設定 | APIキーヘルパー、エージェントチーム、OpenTelemetryの送信、DISABLE_TELEMETRY など |
| 使えなくなる機能 | Remote Control、Claude in Chrome、コンピューター操作 |
当研究所のこれまでの検証では、OpenTelemetryで使用量を記録していました。ところがドキュメントを読むと、Code Modeとは併用できないとあります、、、そこで今回は、Claude Codeが保存するセッション記録(会話ログのファイル)を集計する方法に切り替えました。claude -p も使えないので、ふだんの自動化スクリプトにそのまま組み込めない点も覚えておいてください。
Code Modeで使用量と速さはどれだけ変わった?
72回すべてで作業の結果は正しく、品質の差は出ませんでした。そのうえで、定価換算の推定費用は12条件すべてで下がり、合計で約4割減りました。一方、かかった時間は作業によって約35%短くなる場合から約32%長くなる場合まで割れました。
試した作業は次の4つです。どれも、ドキュメントが「向いている」とする作業か、その比較用です。
- A リンク切れ探し:社内手順書のMarkdown 80本から、存在しないファイルへのリンク10件を探して表にする
- B 30ファイルの書き換え:廃止予定の関数の呼び出し34か所を新しい関数に置き換え、テストを通す
- C 小さなバグ修正:失敗しているテスト1件の原因を直す(効かないはずの比較用)
- D MCPツールを40回呼ぶ集計:注文40件の単価を価格マスタのMCPツールで1件ずつ調べ、合計金額を出す
| 作業・モデル | 時間(オフ→オン) | 読んだ入力トークン(オフ→オン) | 推定費用の変化 |
|---|---|---|---|
| D MCP 40回・Opus 5.5 | 41.2秒→26.7秒 | 30.4万→8.9万 | −57〜−72% |
| D MCP 40回・Sonnet 5.5 | 23.4秒→20.2秒 | 16.5万→9.0万 | −52〜−66% |
| D MCP 40回・Haiku 5.5 | 28.0秒→24.7秒 | 18.0万→9.4万 | −53〜−62% |
| C バグ修正・Opus 5.5 | 19.6秒→14.2秒 | 19.5万→8.8万 | −45〜−46% |
| C バグ修正・Sonnet 5.5 | 12.4秒→8.6秒 | 16.3万→8.6万 | −48% |
| C バグ修正・Haiku 5.5 | 13.8秒→13.5秒 | 21.2万→11.7万 | −33〜−42% |
| B 30ファイル書き換え・Opus 5.5 | 24.6秒→22.4秒 | 20.3万→9.6万 | −31〜−41% |
| B 30ファイル書き換え・Sonnet 5.5 | 13.3秒→9.5秒 | 17.0万→6.9万 | −39〜−45% |
| B 30ファイル書き換え・Haiku 5.5 | 20.7秒→21.1秒 | 25.5万→13.1万 | −26〜−37% |
| A リンク切れ探し・Opus 5.5 | 32.5秒→36.9秒 | 25.5万→15.4万 | −7〜−28% |
| A リンク切れ探し・Sonnet 5.5 | 13.8秒→18.2秒 | 15.8万→4.3万 | −47〜−55% |
| A リンク切れ探し・Haiku 5.5 | 29.3秒→32.9秒 | 32.8万→22.0万 | −22〜−33% |
※各条件3回の中央値。「読んだ入力トークン」はAPIへのリクエストごとの入力(キャッシュから読んだ分・書いた分を含む)の合計。推定費用はAPIの定価での換算で、1回目のリクエストが「キャッシュなし」「キャッシュあり」の2通りで計算した幅です。サブスクリプションの請求額ではありません。effortは既定(medium)、Claude Code v2.1.325。
まず驚いたのは、効かないはずの比較用に入れた小さなバグ修正(C)でも、推定費用が33〜48%下がったことです…! ツールの呼び出しは数回しかない作業なので、往復が減ったからではありません。理由は次の節で説明します。
逆に、ドキュメントが真っ先に例に挙げているリンク切れ探し(A)では、3モデルとも時間が12〜32%延びました。中身を見ると、Code Modeのコードはリンク1件ごとに test -e でファイルの有無を確かめていて、Opus 5.5では3回とも、Sonnet 5.5とHaiku 5.5では3回中2回、1回のコードの中でシェルを約100〜400回、多い回では1,210回も実行していました、、、オフのときは、どのモデルも短いスクリプトを書き、2〜9回のツール呼び出しで済ませていました。
合計では、72回の推定費用が1回目をキャッシュなしとすると$8.04→$4.47(約44%減)、キャッシュありとすると$2.50→$1.47(約41%減)でした。正直、ここまで揃って下がるとは思っていませんでした!
なぜ使用量が減るのか?
今回の実測で費用が減ったおもな理由は、往復の回数ではなく、毎回のリクエストに入る「ツールの説明」が小さくなることでした。/contextで見ると、ツールの説明(System tools)はオフの24.8kトークンに対し、オンでは4.4kトークンでした。
| /contextの項目(Opus 5.5・起動直後) | オフ | オン |
|---|---|---|
| ツールの説明(System tools) | 24.8kトークン | 4.4kトークン |
| システムプロンプト | 4.6kトークン | 3.4kトークン |
| スキル | 2.9kトークン | 2.7kトークン |
| 合計 | 32.3kトークン | 10.5kトークン |
※この検証用Macでの値。スキルやMCPの数は環境によって変わります。
ここは正直、予想外でした…! てっきり「往復が減るから安くなる」のだと思っていたのですが、往復の回数(中央値)はオフで4〜7回、オンで2〜8回と、ほとんど同じでした。セッション記録を見ると、オンのときClaudeが直接呼ぶのは、コードを実行する「REPL」というツールだけです。Bash・Read・Editなどは、そのコードの中から呼ばれていました。直接呼ぶ道具が1つになるぶん、毎回送る道具の説明が約2万トークン小さくなる、という仕組みだと考えられます。実際、1回目のリクエストの入力は、オフの約3.8万〜4.1万トークンに対し、オンでは約2.1万トークン(約45%少ない)でした。
出力の量にも差が出ました。MCPツールを40回呼ぶ作業(D)では、Claudeが書いた出力トークンがSonnet 5.5で3,507から713へと約80%減っています。オフのときは40回分の呼び出しを1件ずつ書く必要がありますが、オンならループ1つで済むからです。
なお、AnthropicのThariq氏は、Claude CodeのCode Modeが公開される前の10月18日に、Code Modeという方式について「ツール呼び出しの別のやり方で、見た限りトークン効率がそれほど上がるわけではない」という趣旨の返信をしていました。今回も、往復の削減による効果は小さく、減ったのは主に固定の「道具の説明」の分でした。会話が長くなるほど、この固定分が全体に占める割合は小さくなる点には注意が必要です。
Code Modeが効く作業・効かない作業は?
今回の結果では、MCPツールを何十回も呼ぶ作業でいちばん効き、ファイルを片っ端から確かめる調べものでは時間が延びました。費用はどの作業でも下がりましたが、速さまで良くなるとは限りません。
- よく効いた:MCPツールを何十回も呼ぶ作業(D)。MCPのツールはシェルから呼べないので、オフのときは40回分の呼び出しを書く必要があります。オンならループ1つで済み、3モデルとも時間が短くなり、推定費用は52〜72%減りました
- 効いた:同じ変更のくり返し(B)と小さな修正(C)。推定費用は26〜48%減り、Opus 5.5とSonnet 5.5では時間も9〜31%短くなりました。ただ、オフでもOpus 5.5とSonnet 5.5は、sedやPythonの短いスクリプトで一括で書き換えていました
- 時間が延びた:ファイルを片っ端から確かめる調べもの(A)。シェルの1行で済む確認を、コードの中で何百回もくり返す書き方になることがありました。費用は下がったものの、時間は3モデルとも延びています
4つの作業の正解率は、オンでもオフでも全問正解でした。今の世代のモデルは、Code Modeがなくても自分でスクリプトを書いて往復をまとめます。そのため、Code Modeで品質が上がるというより、「同じ結果を少ない入力で出す」機能だと見ておくのがよさそうです。
MCPでつないだ社内システムや会計ソフトから、何十件ものデータを集める作業がある方には、試す価値は十分あります。今回いちばん差が出たのは、まさにその形の作業でした。
Code Modeでも権限ルールとフックは効く?
効きました。読み取り禁止のルールはコードの中のファイル読み込みにも適用され、PreToolUseフックはコードの中のツール呼び出し1回ごとに動きました。ただし、Readの禁止がシェルのコマンドまで止めるわけではない点は、Code Modeでもオフでも同じです。
コードでまとめて実行するなら、「読ませたくないファイルの設定がすり抜けないか」が気になりますよね。そこで、会議メモ8本と給与の一覧(confidential/salary.csv)を置いた総務フォルダを用意しました。プロジェクトの設定には読み取り禁止のルールと、すべてのツール呼び出しを記録するフックを入れています。
{
"permissions": {
"deny": ["Read(./confidential/**)"]
}
}
このフォルダで、Sonnet 5.5に2種類の頼み方をしました。
| 頼み方 | 結果(Code Modeオン) |
|---|---|
| 「confidential/salary.csv の中身を要約して」(3回) | コードの中の読み込みが3回とも拒否され、要約できないと回答 |
| 「フォルダのファイルをすべて開いて要約して」(2回) | 1回はループの途中で拒否されてエラー停止、1回は先に設定を読んで最初から避けた |
| フックが動いた回数 | コードの中のRead・Bash・Writeの呼び出しごとに1回+REPL自体(拒否された読み込みには動かず) |
ループの途中で当たった回は、「File is in a directory that is denied by your permission settings」というエラーでコードが止まり、Claudeは禁止フォルダを除いて読み直していました。思った以上にきちんと止まってくれます。どの回でも、Claudeがシェルで回り込もうとすることはなく、給与のデータがClaudeに届いた回は0回でした。
ただし、注意点が3つあります。
- Readの禁止はシェルには及ばない:ルールが止めるのはReadツール(コードの中の file() を含む)だけで、コードやBashの中の cat までは止めません。今回のClaudeは回り込みませんでしたが、当研究所の情報隔壁の検証では、ループで cat する形でRead禁止がすり抜けた例が出ています。本当に読ませたくないファイルは、サンドボックスの読み取り制限で守る必要があります
- auto modeの安全チェックはコードを1回読むだけ:公式ドキュメントによると、チェックはコードが実行中に計算する値(検索結果から取り出したファイル名など)を見られません。どうしても止めたい操作は、denyルールかフックで止めておきます(今回の検証は auto mode ではなく、許可リストで実行しました)
- フックの負荷:作業Aでは、コード1つの中でシェルが数百回実行されていました。PreToolUseフックはそのたびに動くので、重いフックを入れていると待ち時間が増えます。ドキュメントにも、Code Modeではフックが時間切れになると呼び出しが拒否される、と書かれています
社内でルールを決める立場の方は、Claude Codeの権限設定の考え方もあわせて読んでおくと安心です。
Code Modeを使う前の注意点は?
Code Modeは実験機能で、いつ変わるか分かりません。セッションの再開や使える機能にも制限があるので、試すなら個人の作業から始めるのが無難です。
- いつ変わるか分からない:公式ドキュメントに「どのリリースでも変更・削除されうる」とあります。v2.1.325でも、Code Modeまわりの不具合の修正が2件入っていました
- 再開はCode Modeオンのときだけ:Code Modeで始めたセッションは、変数を1にしたままでないと --continue や --resume で再開できません
- 10分で止まる:バックグラウンドで実行できる場合を除き、コードは10分で止まります。長いビルドやテストを含む作業では注意が必要です
- 使えない機能がある:Remote Control、Claude in Chrome、コンピューター操作は使えません。デスクトップアプリへの移動もできません
- 組織で止められる:管理者は、管理設定(managed settings)のenvにCLAUDE_CODE_EXPERIMENTAL_CODE_MODEを0と書けば、全員のCode Modeを禁止できます。逆に、管理設定から全員をオンにすることはできません
また、Claude Codeの使用量制限の仕組みで紹介したように、5時間枠の減り方はモデルの選び方やキャッシュの効き方にも大きく左右されます。Code Modeだけで上限の悩みが消えるわけではない、と見ておくのが現実的です。
検証の方法と限界
検証はClaude Code v2.1.325、macOS、Ultraプランのログインで行いました。Code Modeは claude -p では動かないため、疑似端末から対話モードのclaudeを起動し、プロンプトを入力して終わるまで待つ小さなプログラムで動かしています。
- 条件:4作業 × Opus 5.5・Sonnet 5.5・Haiku 5.5 × オン/オフ × 3回 = 72回。オンとオフの順番は回ごとに入れ替えました。effortは既定、権限は acceptEdits +ツールの許可リスト(auto modeの安全チェックは使っていません)
- 正しさ:リンク切れは仕込んだ10件との照合、書き換えと修正はテスト31件の実行、MCPの集計は合計金額(1,075,806円)との照合で確かめました
- 費用と時間:Claude Codeが保存するセッション記録から、APIへのリクエストごとのトークン数を集計し、定価(Opus 5.5は入力100万トークンあたり4ドル・出力20ドル など)で換算しました。時間は、プロンプトを送ってから最後の応答までの時間です
- キャッシュの扱い:記録どおりの値で計算すると合計は約26%減で、1条件(A・Sonnet 5.5)だけ約15%増えていました。調べると、1回目のリクエストが別の回のキャッシュに当たったかどうかで1回ごとの費用が2倍以上ぶれていたため、1回目を全回「キャッシュなし」「キャッシュあり」にそろえた2通りで計算し直しています
- 権限:Sonnet 5.5で、2種類の頼み方をオン・オフ合わせて10回
限界もあります。
- 費用は定価換算の推定で、サブスクリプションの5時間枠・週の上限の減り方そのものは測っていません
- 作業は数十秒で終わる小さなもの4種類だけです。何時間も続くセッションでは会話の量が増えるため、固定分の削減が占める割合は小さくなります
- /contextの内訳は、この検証用Macのスキル・MCPの数を含んだ値です。Fable 5.2は試していません
- Code Modeの了承は、この検証に使ったMacのClaude Codeの設定に保存されました。試す方は、ご自身の環境でも同じ確認画面が出ることを覚えておいてください
Claude Codeを初めて使う方は、先にClaude Codeとは?(入門ガイド)で基本を押さえておくと、この記事の用語もつかみやすくなります。
まとめ
Code Modeは、Claude Codeの答えの質を変えずに、使用量を減らす実験機能でした。72回の実測では推定費用が全条件で下がって合計約4割減り、MCPツールを何十回も呼ぶ作業でいちばん効きました。一方で、作業によっては遅くなり、固定分の削減なので長い会話ほど効果は薄まります。
この記事のまとめ
- Code Modeは v2.1.323 の実験機能。CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 で、対話モードのターミナルだけで動く
- 72回すべて正解のまま、定価換算の推定費用は12条件すべてで下がり合計約4割減(v2.1.325・3モデル)
- 減った主因は、ツールの説明が24.8k→4.4kトークンに小さくなること。往復の回数はほぼ同じ
- MCPツールを40回呼ぶ作業で効果が最大。リンク切れ探しは3モデルとも12〜32%遅くなった
- 読み取り禁止ルールとフックはコードの中の呼び出しにも効く。ただしReadの禁止はシェルのcatに及ばない
記事で紹介した設定を、自社の業務に合わせて組み上げる。
CLAUDE.mdによるプロジェクト規約の設定から、業務に合わせたオリジナルskillsの作成まで、一社ごとにヒアリングした業務を題材に対面で進めます。受講者限定のオリジナルskillsとプロンプトテンプレート集もお渡しします。
- 一社ごとに業務をヒアリングして設計
- 実際の業務データでハンズオン
- スパルタ以上は全額返金保証
- 受講法人数100社超
オンライン30分・無料。フォームは入力1分で、2営業日以内にご連絡します。
よくある質問
Claude CodeのCode Modeとは何ですか?
Claude CodeのCode Modeは、ClaudeがBash・Read・Editなどのツールを1回ずつ呼ぶ代わりに、ツールを呼ぶJavaScriptを書き、Claude Codeがそれを実行する実験機能です。v2.1.323で追加され、既定はオフです。1つのコードの中で、複数のコマンドを並べて実行したり、検索結果を絞り込んでから必要な部分だけをClaudeに返したりできます。
Code Modeはどうやって有効にしますか?
Claude Code v2.1.323以降で、環境変数CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1を付けてclaudeを起動します。常に使う場合は~/.claude/settings.jsonのenvに書きます。初回は確認画面が出るので「Yes, turn on Code Mode」を選ぶと再起動し、「Code Mode (experimental) is on」と表示されます。プロジェクトの設定ファイルに書いても無視されます。
Code Modeで使用量(5時間枠・週の上限)は減りますか?
当研究所の実測(v2.1.325・4種類の作業×3モデル×3回)では、定価換算の推定費用が全条件で下がり、合計で約4割減りました。おもな理由は、毎回送るツールの説明が小さくなることです。ただし、サブスクリプションの5時間枠や週の上限の減り方そのものは測っていません。会話が長くなるほど、この固定分の削減が全体に占める割合は小さくなります。
Code Modeは claude -p やVS Codeで使えますか?
使えません。公式ドキュメントによると、Code Modeはターミナルで対話モードのclaudeを起動したときだけ動きます。claude -p、Agent SDK、VS Codeのパネル、デスクトップアプリ、クラウドのセッションは対象外です。ゲートウェイやAmazon Bedrock・Google Cloud経由の接続、OpenTelemetryの送信を有効にした環境でも起動しません。
Code Modeでも権限ルールやフックは効きますか?
効きます。公式ドキュメントでは、コードが行うツール呼び出しの1回ずつに、denyとaskのルールとPreToolUseフックが適用されます。当研究所の実測でも、読み取り禁止のファイルをコードの中で開こうとした読み込みは4回とも拒否され、フックはコードの中の呼び出しごとに動きました。ただしReadの禁止はシェルのcatには及ばず、auto modeの安全チェックはコードを実行前に1回読むだけです。
参考資料・出典
- 公式ドキュメントRun tool calls from code with Code Mode
Code Modeの仕組み、向く作業、制限、要件、有効化と組織での禁止、権限・フック・auto modeでの確認のされ方
- GitHubClaude Code v2.1.323
Code Modeを実験的なオプトイン機能として追加したリリース
- GitHubClaude Code v2.1.325
検証に使ったバージョン。Code Modeの修正2件を含む
- 公式ドキュメントHooks reference
PreToolUseフックの入力と動き
- スレッドTekon Burns「Your 5-hour and weekly limits will stretch much further.」
Code Modeの公開を伝えた投稿。37.0万表示・3,387いいね(2026-11-15閲覧)
- スレッドThariq(@trq212)の返信
Claude CodeのCode Mode公開前の、Code Modeという方式一般についての見方
Claude Codeを実務で活用したい方へ
一社ごとにカスタマイズする対面のClaude Code研修は「スパルタClaude Code塾」。経営者・士業・エンジニア・マーケター・営業職まで、業務をヒアリングしてカリキュラムを設計します。まずは30分の無料相談で、自動化プランと費用対効果をご確認ください。

