11月12日、Claude Code 2.1.323 に Code Mode が入りました。3日後、Telegram のチャンネルにこんな投稿が回ってきました。「壊れたリンクの検索が13ターンではなく2ターンで終わった」「消費が15万トークンから2千トークンに減った」。私は Claude Code を更新して、同じ課題を6回走らせました。Claude Code Code Mode を使う実行と使わない実行を3回ずつ、同じリポジトリのコピーと同じモデルでです。結論から言うと、Code Mode は確かに減らしますが、投稿が言う場所ではなく、毎回でもありません。
要点:
- Code Mode では開始時点のコンテキストが29%小さくなります。44.4K トークンに対して62.7K トークンで、全実行で一定でした。
- ターン数はほとんど変わりませんでした。Code Mode なしでも Sonnet 5.5 は自分でスクリプトを書き、Bash を1回呼ぶだけで済ませました。
- 中央値の実行では入力が28%減りました。3回の平均では差がありません。Code Mode の1回が自分のスクリプトで3回続けて失敗し、削減分を食いつぶしたからです。
- API 料金で見ると、課題1回の平均は $0.155 と $0.182 でした。精度は同じで、6回すべてで22件中22件の壊れたリンクを見つけました。
- 「15万 → 2千」は、2025年の別の Anthropic 記事の数字です。「13ターン対2ターン」はドキュメントに載っていません。
Claude Code Code Mode とは#
通常、Claude はツールを1つずつ頼みます。ファイルを読み、コマンドを実行し、結果を読み、次を決める、という流れです。Code Mode では Claude が JavaScript を書き、Claude Code がそれをセッション内で実行します。コードの中では普段と同じツールが使えます。シェルコマンドは $、読み取りは file()、編集は edit() です。モデルから見えるツールは REPL と Poll の2つだけになります。
次は、私の実行で Claude が実際に書いたコードです。正規表現とコードブロックの判定は短くしましたが、ロジックは同じです。
const files = (await $`git ls-files '*.md'`.text()).trim().split('\n')
const missing = []
for (const f of files) {
const dir = f.includes('/') ? f.slice(0, f.lastIndexOf('/')) : '.'
for (const m of (await file(f).text()).matchAll(/\]\(([^)\s#]+)/g)) {
const link = m[1]
if (/^[a-z]+:/i.test(link)) continue
const path = link.startsWith('/') ? link.slice(1) : `${dir}/${link}`
const r = await $`test -e ${path}`.nothrow()
if (r.exitCode !== 0) missing.push(`${f} -> ${link}`)
}
}
;({ files: files.length, missing })最後の行の値がモデルに返ります。スクリプトは58ファイルを読み、シェルを46回呼びましたが、モデルのコンテキストに入ったのは最終的なリストだけです。画面にはツール呼び出し自体が表示され、コードはトランスクリプトで Ctrl+O を押すと開けます。
発想そのものは新しくありません。2025年11月に Anthropic が MCP サーバー向けに同じ手法を書いていて、API では programmatic tool calling と呼ばれています。Code Mode はそれをターミナルに持ち込んだものです。
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE で有効にする#
バージョンは 2.1.323 以降が必要です。確認と更新はこうします。
claude --version
claude update次に、環境変数を付けて起動します。
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude常に有効にしたいなら、Claude Code の環境変数の設定として ~/.claude/settings.json に書きます。
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}プロジェクトの設定にある同名の変数は無視されます。他人のリポジトリがあなたの Code Mode を勝手に有効にすることはできません。
初回起動時は、モードの説明ダイアログが出て、カーソルは「No, start without it」にあります。「Yes, turn on Code Mode」を選ぶと Claude Code が再起動します。セッションの先頭に Code Mode (experimental) is on · this session can be resumed only with Code Mode on という行が出ます。チャンネルに出回っているスクリーンショットに写っているのはこの行です。
ドキュメントにある条件のうち、投稿が触れていないものは次のとおりです。
- ターミナルの対話型
claudeのみ。-p、Agent SDK、VS Code パネル、Desktop アプリ、クラウドセッションでは動きません。 - モデルは Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.2。
- Claude のサブスクリプションか Console アカウントが必要で、Bedrock、Vertex、Foundry、ゲートウェイ経由は対象外です。
apiKeyHelper、agent teams、OpenTelemetry のエクスポート、DISABLE_TELEMETRYがあると起動しません。
計測の方法#
課題は Code Mode のドキュメントにあるものをそのまま使いました。「Read every Markdown file in this project and list the links that point to local files that don't exist」です。テスト環境は、このサイトのリポジトリにある Markdown 59ファイル、545 KB のテキストです。正解は事前に別のスクリプトで数えてあり、壊れたリンクは23件、重複を除くと22件でした。
6回とも条件は同じです。Claude Code 2.1.325、Sonnet 5.5、effort は medium、auto モード、実行ごとに新しいコピーを使いました。-p では Code Mode が動かないので、対話セッションは expect から起動しています。数字はセッションログの message.usage フィールドから取りました。
ログには1つ癖があります。Code Mode では、スクリプトの中から呼んだツール1回ごとに、isVirtual の印が付いた別レコードが書かれます。これをモデルへのリクエストとして数えると、2ターンのはずが106ターンになります。本物のリクエストには requestId フィールドがあります。
結果:トークン削減を数字で見る#
| 実行 | モデルへのリクエスト | 開始時のコンテキスト | 課題全体の入力 | 出力 | ≈ $(API) | 検出 |
|---|---|---|---|---|---|---|
| Code Mode 1 | 2 | 44,371 | 90,549 | 2,178 | 0.10 | 22/22 |
| Code Mode 2 | 2 | 44,368 | 91,732 | 2,353 | 0.16 | 22/22 |
| Code Mode 3 | 7 | 44,368 | 327,604 | 3,617 | 0.21 | 22/22 |
| なし 1 | 2 | 62,665 | 127,175 | 2,242 | 0.17 | 22/22 |
| なし 2 | 4 | 62,662 | 255,190 | 3,022 | 0.20 | 22/22 |
| なし 3 | 2 | 62,662 | 127,336 | 2,488 | 0.18 | 22/22 |
「課題全体の入力」は、全リクエストの合計です。新規トークン、キャッシュ読み取り、キャッシュ書き込みを含みます。金額は2026年11月15日時点の Sonnet 5.5 の料金で計算しました。100万トークンあたり、入力 $2、1時間キャッシュへの書き込み $4、キャッシュ読み取り $0.10、出力 $10 です。サブスクリプションでは課金されませんが、同じトークンが利用上限を消費します。
Code Mode の1回目が他より安いのは、モードだけが理由ではありません。直前に起動の失敗があり、キャッシュの一部が温まったままでした。キャッシュ書き込みが32〜35K トークンではなく18K トークンで済んでいます。この運がなければ、2回目と同じくらいの費用になっていたはずです。
削減が生まれる場所、生まれない場所#
常に載っている部分が小さくなる。 これが唯一の安定した効果です。Code Mode なしだと、モデルは全ツールの説明を完全な形で受け取ります。Code Mode では REPL と Poll が前に出て、残りは JavaScript の関数として短く書かれます。差は1リクエストあたり18K トークンです。同じ効果は wmedia.es も Opus 5.5 で別々に確認しています。最初のリクエストが22K トークン対36K トークン、合計が94.7K 対150.4K でした。
ターンは減らなかった。 投稿は「1ファイルずつ13ステップ対2ステップ」という絵を描いています。私の環境では、Code Mode なしのモデルも、3回中2回は自分で Python スクリプトを書いて Bash を1回呼びました。リクエスト数は同じ2です。いまのモデルは、課題が許すなら同種の作業を自分でスクリプトにまとめます。wmedia.es でもリクエスト数は4対4で同じでした。
スクリプトのミスは高くつく。 Code Mode の3回目は裏の面を見せました。1つ目のスクリプトはパーサーでつまずきました。2つ目には、サンドボックスに存在しない require が入っていました。3つ目では zsh が find コマンドの括弧を食べました。ミスのたびにリクエストが1つ増え、そのリクエストごとに44K トークンのコンテキストと、伸びていく履歴がついてきます。結果は7リクエスト、入力328K トークンで、Code Mode なしのどの実行よりも悪い数字でした。
Claude Code の消費を決めるのは、各リクエストが毎回運ぶコンテキストの大きさです。リクエスト数はそれを掛け算するだけです。詳しくはClaude Code のトークン消費の記事で分析しました。モデルの返答はコストの約2%でした。
15万、2千、13ターンはどこから来たのか#
「15万から2千へ」。 2025年11月4日の Anthropic の記事 Code execution with MCP の数字です。例は別のものです。エージェントが Google Drive から会議の文字起こしを取得し、Salesforce のリードに添付します。文字起こしがモデルのコンテキストを通らないため、「from 150,000 tokens to 2,000 tokens」になります。Claude Code の Code Mode とは関係がなく、そのドキュメントには削減率の数字が1つもありません。
「13ターンではなく2ターン」。 出典は見つかりませんでした。ドキュメントにも changelog にも Anthropic の記事にもありません。壊れたリンクの同じ課題はドキュメントにありますが、計測値は載っていません。
「37%」。 この数字も転載記事の間を回っています。出典は Anthropic の Introducing advanced tool use(2025年11月24日)で、API の programmatic tool calling の話です。「from 43,588 to 27,297 tokens, a 37% reduction」。これも Code Mode ではありません。
先に知っておきたい制約#
- 再開。 Code Mode で始めたセッションは、ターミナルで、かつモードを有効にしたときだけ続けられます。変数がなければ
claude --resumeでは開けません。 - Chrome と computer use が使えなくなる。 Code Mode では Claude in Chrome、Remote Control、computer use が動きません。Claude Code は起動時にはっきり書きます。「No Chrome or computer use」。ブラウザを自動操作しているなら、モードを切る必要があります。
- auto モードが審査するのはコードで、呼び出しではない。 分類器は実行前に JavaScript を1回読むだけで、コードが途中で計算する値、たとえば検索結果から得たパスは見えません。
denyルールとPreToolUseフックは呼び出しごとに働くので、重要な禁止事項はそちらに置いてください。 - 10分。 結果を待つコードは10分で止まります。権限ダイアログへの返答にかかる時間も含みます。バックグラウンドでは最大2時間動きますが、セッションが auto か
bypassPermissionsで始まっている場合に限ります。 - フック。
PreToolUseフックが失敗したり、時間内に応答しなかったりすると、onFailureを指定していなくても、コードからの呼び出しは拒否されます。 - セッションを移せない。 Desktop アプリに移したり、バックグラウンドセッションに変えたりはできません。
会社は全従業員に対してこのモードを禁止できます。managed settings に "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0" を入れます。
今 Code Mode を有効にすべきか#
同種の呼び出しが多い課題なら試す価値があります。多数のファイルに同じ修正を入れる作業、結果を絞り込む検索、互いに独立したコマンドの並列実行などです。安定して得られるのは、リクエストごとに開始時のコンテキストが約18K トークン減ることで、長いセッションでは積み上がります。
「75倍安くなる」という奇跡は存在しないので、それを目当てに有効にするのはやめてください。Claude in Chrome を使っている人や、スクリプトで -p から Claude Code を動かしている人には、今のところ向きません。JavaScript から多数のエージェントを統括する用途も置き換えません。そちらは Claude Code の workflow の役目で、agent teams とは同時に起動できません。
私の計測は小さいです。課題は1つ、モデルは1つ、モードごとに3回です。次は、多数のファイルを編集する課題で同じことを繰り返します。スクリプトなしのモデルが本当に1ファイルずつ回るのは、そちらのはずです。



