開発・技術Claude 公開 2026年11月16日

Claude Codeの実験機能「Code Mode」とは?仕組み・使える条件・オン/オフの方法

関連: Claude Code ・ Code Mode ・ 実験機能

✔ 事実確認済み(2026-11-15):記事中の事実 30 件を出典の本文と照合しています。

Claude Code v2.1.323 で、実験機能「Code Mode」が追加されました。Claudeが JavaScript を書き、そのコードで複数のツール呼び出しをまとめて行う機能です。Claude Code を日常的に使い、同じ作業の繰り返しを減らしたい方や、組織で設定を管理している方に向けた記事です。仕組み、使える条件、オン/オフの方法、制限を整理します。

要点

  • Code Mode は実験機能で、初期状態ではオフです
  • 有効にするには、環境変数 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を 1 にします
  • 組織の管理設定で 0 を指定すると、組織全体で使えなくできます

Code Mode とは何か

公式ドキュメントによると、Code Mode はClaudeのツールの使い方を変える機能です。ツールとは、Bash(コマンド実行)、Read(読み取り)、Edit(編集)などのことです。

Code Mode がないときは、Claudeがツール呼び出しを1つずつ依頼します。そして、結果を読んでから次の手を決めます。

Code Mode があるときは、Claudeが JavaScript のコードを書きます。そのコードがツールを呼び出し、Claude Code があなたのセッション内でコードを実行します。

Code Mode は実験機能で、初期状態ではオフです。どのリリースでも、変更または削除される可能性があると公式ドキュメントに書かれています。

リリースノートでも、v2.1.323 の項目として「実験的に選んで使う(opt-in)機能」と説明されています。

仕組み:1つのコードで何ができるか

あなたはこれまでどおり、プロンプトで作業を頼みます。Claudeはそれを実行する JavaScript を書きます。公式ドキュメントによると、1つのコードで次のことができます。

  • コマンドを並行して実行する
  • ある結果を次の呼び出しで使う
  • Claudeが読む必要のある出力だけを返す

公式の例は、「再試行の上限を上げて」と頼む場面です。Claudeはコードで、ファイルを探し、編集し、テストを実行します。最後の行で、ファイルのパスとテスト結果だけをClaudeに返します。

会話画面には、編集の差分などのツール呼び出しが表示され、コードそのものは表示されません。コードを読むには Ctrl+O でトランスクリプト(やりとりの記録)の表示を開きます。コードは、折りたたまれた「Code」の行として並びます。

向いている作業

公式ドキュメントは、関連するツール呼び出しが多い作業で試すよう案内しています。

  • 多くのファイルに同じ変更を繰り返す作業
  • 結果を絞り込んでから読みたい検索
  • 同時に実行できる、独立した複数のコマンド

使える条件

Code Mode は、すべての環境で使えるわけではありません。公式ドキュメントが挙げる条件を、表に整理します(2026年11月時点)。

項目 条件
バージョン Claude Code v2.1.323 以降
アカウント Claude のサブスクリプション、または Console アカウント
使えない接続先 ゲートウェイ、Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry
組織の設定 HIPAA 構成やゼロデータ保持を使っていないこと
モデル Claude Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.2
画面 ターミナルで開く対話型の claude セッション
インストール Claude Code のネイティブ版
Windows Git for Windows が入っていること

次の場面では動かない、とも書かれています。-p(1回だけ実行する形式)、Agent SDK、VS Code のパネル、デスクトップアプリ、クラウドセッションです。

また、APIキーヘルパー、エージェントチーム、OpenTelemetry のエクスポート、DISABLE_TELEMETRY などの設定がオンだと、起動できません。

動かないときは、セッション冒頭に「Code Mode (experimental) isn’t available」と理由が表示されます。/status でも確認できます。公式ドキュメントに、理由ごとの対処の表があります。

オンにする手順

公式ドキュメントの手順を、1本の流れにまとめます。

  1. claude --version でバージョンを確認します。v2.1.323 より古ければ claude update を実行します。
  2. 環境変数 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を 1 にして、claude を起動します。
  3. 初回は確認が出ます。「Yes, turn on Code Mode」を選ぶと、Claude Code が再起動します。
  4. 多くのツール呼び出しが要る作業を頼みます。公式の例は「このプロジェクトのMarkdownファイルをすべて読み、存在しないローカルファイルへのリンクを挙げて」です。
  5. Ctrl+O を押して、「Code」の行を開き、Claudeが書いたコードを確認します。

すべての新しいセッションでオンにしたいときは、~/.claude/settings.json の env に同じ変数を書きます。ただし、プロジェクトの設定ファイルに書いた値は無視されます。クローンしたリポジトリが、勝手に Code Mode をオンにすることはできません。

つまずきやすい点:再開

Code Mode で始めたセッションを後で再開するときは、claude --continue や claude --resume でも、この変数を 1 にしたままにします。オフの状態では、再開を断られます。逆に、Code Mode なしで始めたセッションは、変数が 1 でも Code Mode なしのまま再開します。

オフにする方法と、組織で止める方法

自分でオフにするには、シェルと ~/.claude/settings.json から変数を消して、新しいセッションを始めます。値を 0 に変える方法もあります。どちらか一方が 0 なら、もう一方が 1 でもオフのままです。

組織で止めたいときは、管理設定(managed settings)の env に、この変数を 0 で書きます。公式ドキュメントによると、そうすれば組織内の誰も使えなくなります。すでに Code Mode のセッション中の人は、終了か再起動までそのままです。その後は Code Mode なしで始まり、Code Mode のセッションは再開できません。なお、管理設定から、全員の Code Mode をオンにすることはできません。

権限チェックと制限

権限のチェック

Claudeのコードが行うツール呼び出しは、1つずつ、deny(拒否)と ask(確認)の権限ルール、および PreToolUse フックを通ります。Bash などのルールを書き換える必要はありません。

自動モード(auto mode)では、分類器(自動で安全性を判断する仕組み)が、ツール呼び出しごとではなく、コードを実行する前にコードを確認します。実行時に決まる値(検索結果から取ったパスなど)は、分類器からは見えません。だから、止めたい呼び出しには、ルールやフックを残しておくよう書かれています。

自動モード以外では、コードは確認なしで始まります。その代わり、そのモードで確認が出る呼び出しごとに、あなたに確認が出ます。

長く動くコード

長いビルドやテストの間、Claudeは、待つか、バックグラウンドで続けさせるかのどちらかです。

動き方 内容
待つ コードが終わってからClaudeが答える。10分で止まる(確認の待ち時間を含む)
バックグラウンド Claudeと話し続けられる。コードは最長2時間動く

バックグラウンドで動かすには、auto か bypassPermissions モードでセッションを始めます。

使えない機能

公式ドキュメントが挙げる制限は次のとおりです。

  • セッションの再開は、Code Mode をオンにしたターミナルでだけできます
  • Remote Control、Claude in Chrome、コンピューター操作(computer use)は使えません
  • セッションをデスクトップアプリに移したり、バックグラウンドセッションにしたりできません
  • フックが起動しない、または時間切れになると、ツール呼び出しが拒否されることがあります

よくある質問

Q. 普段の作業で、すぐオンにしたほうがよいですか。

A. 公式ドキュメントは、実験機能で変更や削除があり得ると明記しています。多くの呼び出しが要る作業で試したい場合に、上の条件と制限を確認してからオンにする使い方が、公式の案内に沿っています。

Q. 社内でフックや権限ルールを使っています。影響はありますか。

A. ツール呼び出しは、deny・ask のルールと PreToolUse フックを通ります。ただし、フックが時間切れになると呼び出しが拒否される場合があります。実行前に、フックの timeout などを確認してください。

Q. フィードバックはどう送りますか。

A. 公式ドキュメントでは、/feedback を実行するよう案内されています。

関連して、直近の Claude Code の更新はClaude Fable 5.2とClaude Code v2.1.321・v2.1.322の変更点でも整理しています。

まとめ

  • Code Mode は、Claudeが JavaScript を書いて複数のツール呼び出しをまとめて行う実験機能で、初期状態ではオフです
  • 使うには v2.1.323 以降と、対応するアカウント・モデル・画面が必要です
  • 環境変数 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を 1 でオン、0 でオフにできます
  • 組織は、管理設定で 0 を指定すると、全員の利用を止められます
  • 実験機能のため、変更・削除の可能性や、使えない機能があります

次の一歩として、まず自分の環境が条件に合うか、公式ドキュメントの「Requirements」で確認してください。内容は変わる可能性があるため、利用前に最新の公式ドキュメントを見てください。

参考・出典