Claude Code の Code Mode とは？使い方と条件

公開 2026-11-14更新 2026-11-14著者永上裕之導入とルール

この記事の要点

Code Mode は、Claude が道具の呼び出しを JavaScript にまとめて1回で動かす実験的な機能。最初はオフ
向いているのは、多くのファイルに同じ変更をする・検索結果を絞り込む・独立したコマンドを同時に動かす作業
オンにするには環境変数を1にして起動する。使えるのは手元のターミナルの claude と新しいモデルだけ

Claude Code はふだん、コマンドを1つ動かし、結果を読んでから次を決める、という往復をくり返して作業します。Code Mode（コードモード） は、この往復をまとめる実験的な機能です。Claude が道具の呼び出しを JavaScript のコードにまとめて書き、Claude Code がそれを一度に動かします。

この記事では、公式ドキュメント「Run tool calls from code with Code Mode」（2026年11月14日確認）にもとづいて、仕組み・向いている作業・オンにする手順・使えない条件を整理します。実験的な機能なので、今後変わったりなくなったりすることがある点は先に押さえておきます。

何が変わるのか

変わるのは「頼み方」ではなく、Claude の中での作業の進め方です。 人はこれまでどおり、やりたいことを文章で頼みます。

	ふだんの動き	Code Mode
道具の呼び出し	1回ずつ頼み、結果を読んでから次へ	コードの中でまとめて呼ぶ
結果の受け取り	毎回すべての結果を読む	必要な部分だけを返す
同時に動かす	1つずつ	独立したコマンドは同時に動かせる
会話に見えるもの	道具の呼び出し	道具の呼び出し（コードは記録画面で見る）

公式の例では、「リトライの上限を上げて」と頼むと、Claude はファイルを探し、書き換え、テストを動かすところまでを1つのコードにまとめ、書き換えたファイルの場所とテストの結果だけ を受け取ります。読み込む量が減るぶん、長い作業でも会話の容量（コンテキスト）を節約しやすくなります。容量の考え方は Claude Codeのコンテキストウィンドウとは？で解説しています。

会話の画面には、編集の差分など道具の呼び出しが出ます。Claude が書いたコードそのものを読みたいときは Ctrl+O で記録の画面を開き、「Code」の行を開きます。

向いている作業

同じような道具の呼び出しが何十回も続く作業ほど、効果が出やすくなります。 公式ドキュメントが挙げているのは次の3つです。

多くのファイルにまたがる、同じ形の変更（呼び名の統一、設定値の一括変更など）
検索の結果を絞り込んでから読みたい調べもの（大量の検索結果から必要な行だけを拾う）
互いに関係のないコマンドを同時に動かす作業（複数のチェックをまとめて回す）

試すときの頼み方の例として、公式は「このプロジェクトのすべての Markdown ファイルを読み、存在しないローカルのファイルを指しているリンクを一覧にして」を挙げています。ファイルを1つずつ開く往復が多い作業なので、違いが分かりやすい題材です。

オンにする手順

環境変数 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を 1 にして起動します。

claude --version で版を確かめる。v2.1.323 より古ければ claude update で上げる
次のように起動する

CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

最初の1回だけ確認が出るので「Yes, turn on Code Mode」を選ぶ
画面の上の方に「Code Mode (experimental) is on」と出れば成功

毎回オンにしたいときは、自分の設定ファイル（ホームフォルダの .claude の中の settings.json）の env に同じ値を書きます。プロジェクトの設定ファイルに書いても効きません。 ダウンロードしたリポジトリが勝手に Code Mode をオンにできないようにするためです。設定ファイルの置き場所の違いは Claude Codeの設定ファイルの場所と優先順位でまとめています。

止めるときは、変数を消すか 0 にして新しい会話を始めます。0 がどこか1か所にあれば、ほかで 1 にしていてもオフ になります。

使えない条件

使えるのは、手元のターミナルで動かす対話の claude だけです。 公式ドキュメントの条件を、つまずきやすい順に並べます。

条件	内容
動かす場所	ターミナルの `claude` のみ。`-p` の自動実行・Agent SDK・VS Code の画面・デスクトップアプリ・クラウドの会話では使えない
アカウント	Claude のサブスクリプションか Console のアカウント。Amazon Bedrock などのクラウド経由や中継サーバー経由では使えない
モデル	Opus 5.5・Sonnet 5.5・Haiku 5.5・Fable 5.2
組織	HIPAA の設定やゼロデータ保持（ZDR）を使っている組織では使えない
入れ方	ネイティブ版（公式のインストーラーで入れた版）。Windows は Git for Windows が必要

ほかに、Remote Control・Chrome 連携・コンピューター操作とは同時に使えません。会話をデスクトップアプリへ移したり、裏で動く会話にしたりもできません。Code Mode で始めた会話を再開するときも、変数を 1 にしたまま claude --continue で開く必要があります。ゼロデータ保持の条件は Claude Code のゼロデータ保持（ZDR）とは？で解説しています。

権限とオートモードとの関係

禁止ルールや確認ルール、実行前のフックは、コードの中の1回1回の呼び出しにもそのまま効きます。 設定を書き直す必要はありません。

違いが出るのはオートモードです。オートモードの判定は コードの1回1回の呼び出しではなく、コード全体を実行前に見て 判断します。検索の結果から決まるファイルの場所のように、動かしてみるまで分からない値は判定に入りません。どうしても止めたい操作は、禁止ルールやフックに書いておくのが安全です。考え方はオートモードとは？と Claude Codeのフックで解説しています。

長い処理は、ふだんは終わるまで待ち、10分で止まります。オートモードか確認なしのモードで始めた会話なら、裏で最大2時間動かしながら話を続けられます。

「isn't available」と出たときは

画面の上に「Code Mode (experimental) isn't available」と出たら、同じ行に理由が書かれています。/status でも確かめられます。よくある理由と直し方は次のとおりです。

理由に含まれる言葉	直し方
it isn't open to your account yet	版が古ければ更新する。新しければ別の日にもう一度試す
it only works with the Anthropic API	クラウド経由・中継サーバー経由の設定を外す
it only works with Opus 5.5, Sonnet 5.5 and later models	対応するモデルで起動する（例 `--model opus`）
it can't be used together with agent teams yet	エージェントチームの変数を外す
your organization's settings don't allow it	会社の管理者に確認する

会社として使わせたくない場合は、管理者が管理設定で変数を 0 にすると、全員がオフになります。逆に、管理設定から全員をオンにすることはできません。

まとめ

Code Mode は、Claude が 道具の呼び出しをコードにまとめて一度に動かす 実験的な機能
向いているのは 同じ形の変更が多い作業・絞り込みが要る調べもの・同時に回せるコマンド
オンは CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1。手元のターミナルと新しいモデルだけで使える
止めたい操作は、禁止ルールやフックに書いておく のが安全

出典

永上裕之

ユニコスクール株式会社代表取締役。AIエージェント専門のスクール＆コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。