MemoryLake
すべての記事に戻る
News2026年11月18日·12 分で読了

Claude CodeのCode Modeとは?実行コードから読み取られる内容、Code Modeオンでのみセッションが再開できる理由、およびブロックするフックについて (2026年版)

クリーンアップ作業を試すためにClaude CodeでCode Modeをオンにしたところ、非常にうまく機能しました。Claudeはすべての呼び出し箇所を見つけ、編集し、テストを実行するという一連の流れを、まるで1つのステップのように完了させました。翌朝、作業を再開しようと新しいターミナルから claude --resume を実行しましたが、Claude Codeはセッションの開始を拒否しました。ログに問題があったわけではありません。単に、新しいターミナルで環境変数を設定せずに開始してしまっただけでした。

この挙動は仕様として明記されています。Anthropicの機能紹介ページには、「Code Modeがオフの場合、Claude Codeはセッションの再開を拒否する」と記載されています。これは、Code Modeが長期的なワークフローにどのように適合するかを決定するいくつかの詳細事項の1つです。他にも、コード実行後にClaudeが実際に何を読み取るのか、どのフックが実行を停止させるのかといった点も重要です。

AnthropicのClaude Code開発者アカウントは、11月17日にCode Modeを発表しました。このガイドでは、Code Modeとは何か、Claudeが読み取る内容がどう変わるのか、オン・オフの切り替え方法、セッションがモードに紐付けられる理由、権限とフックの適用方法、現時点での制限事項、そして長期タスクのコンテキストがセッションの開始方法に依存しないようにする方法について解説します。

Code Modeとは何か

Anthropicのドキュメントでは、その違いを2つの文で説明しています。「Code Modeを使用しない場合、ClaudeはBash、Read、Editなどのツール呼び出しを直接要求し、次の行動を決定する前に各結果を読み取ります。Code Modeを使用すると、Claudeはツール呼び出しを行うJavaScriptコードを記述し、Claude Codeがそのコードをセッション内で実行します。」

この機能には明確な警告が添えられています。「Code Modeは実験的な機能であり、デフォルトではオフになっています。将来のリリースで変更または削除される可能性があります。」

ドキュメントでは、関連する多くのツール呼び出しを必要とするタスクで試すことを推奨しています:

  • 多数のファイルにまたがる繰り返しの変更。
  • Claudeが読み取る前に結果をフィルタリングする必要がある検索。
  • 同時に実行可能な複数の独立したコマンド。

developersdigestのウォークスルーなどの初期の解説記事では、切り替え方法が説明されています。長期的な作業において重要なのは、Claudeが何を読み戻すのか、そしてその後のセッションがどうなるのかという点です。

実行されたコードからClaudeが読み取る内容

これは、Claudeのコンテキストに残る内容を変化させるCode Modeの核心部分です。

通常の動作では、各ツール呼び出しの結果が次の判断の前にClaudeに返されます。Code Modeでは、ドキュメントによると「1つのコードでコマンドを並列実行し、ある結果を次の呼び出しで使用し、Claudeが読み取る必要のある出力部分だけを返すことができる」ようになります。

ドキュメントの例では、リトライ制限を引き上げるリクエストが挙げられています。Claudeは、関数を検索し、最初に一致したファイルを編集し、関連するテストを実行し、ファイルのパスとテスト出力を返すコードを記述します。この例では、検索結果はコード内でファイルを選択するために使用され、検索結果そのものが個別にClaudeに返されることはありません。

この設計から、以下の3つのことが導かれます:

  • Claudeが読み取る内容を選択する。 コードの最終行が、何が返されるかを決定します。中間結果はスクリプト内に留めることができます。
  • 読み取り前にフィルタリングが行われる。 何百もの一致がある検索でも、会話に届く前にコード内で絞り込むことができます。
  • 記録が2箇所に分かれる。 会話にはツール呼び出しが表示され、コード自体はトランスクリプト(履歴)に記録されます。

ドキュメントには、ユーザーに見えるものについてこう記されています。「会話では、編集のdiffなどのツール呼び出しが表示され、コード自体は見えません。」 コードを確認するには、Ctrl+O を押してトランスクリプトビューアーを開きます。各コードは折りたたまれた「Code」行として表示されます。このビューアーの表示内容やビューの違いについては、Claude Codeのトランスクリプトビューに関するガイドで詳しく解説しています。

実務上の影響として、ステップ実行後にClaudeが把握している内容は、コードが何を返したかに依存します。後の質問でコードがフィルタリングして捨てた詳細が必要になった場合、Claudeは再度調査を行う必要があるかもしれません。

Code Modeをオンにする方法

設定は短時間で済みますが、各ステップには知っておくべき詳細があります。

バージョンの確認。 Code Modeには、いずれかのリリースチャネルで Claude Code v2.1.323 以降が必要です。古いバージョンではCode Modeなしで起動します。

環境変数の設定。 Code Modeは CLAUDE_CODE_EXPERIMENTAL_CODE_MODE によって制御されます。試用する場合はシェルで 1 に設定し、すべての新しいセッションで有効にする場合はユーザー設定ファイルの env ブロックに設定します。

ここには安全上の詳細があります。ドキュメントによると、Claude Codeはプロジェクトの設定ファイル内のこの変数を無視します。「これにより、クローンしたリポジトリが勝手にCode Modeをオンにすることを防ぎます。」 自分のシェルとユーザー設定のみが有効です。

一度だけ確認する。 最初のCode Modeセッションの前に、Claude Codeから確認を求められます。オンにするオプションを選択すると、Claude Codeが再起動し、セッションの上部付近に「Code Modeがオンであること」と「このセッションはCode Modeがオンの状態でのみ再開できること」を示す行が表示されます。

多くのツール呼び出しを伴うタスクを試す。 ドキュメントのサンプルプロンプトでは、プロジェクト内のすべてのMarkdownファイルを読み取り、存在しないローカルファイルへのリンクをリストアップするようClaudeに求めています。

Code ModeセッションがCode Modeオンでのみ再開できる理由

これが冒頭の例の背後にある詳細です。

ドキュメントには警告が含まれています。「後でCode Modeセッションを再開するには、claude --continue または claude --resume を実行する際、CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を 1 に設定したままにしてください。Code Modeがオフの場合、Claude Codeはセッションの再開を拒否します。」

逆も同様です。「Code Modeなしで開始したセッションは、変数が設定されていてもCode Modeなしで再開されます。」

つまり、モードはセッション開始時に固定されます。これには長期的な作業においていくつかの影響があります:

  • 常に利用可能な場所で変数を設定する。 1つのシェルだけで設定すると、新しいターミナルでは設定が反映されません。ユーザー設定ファイルに記述するのが最も確実です。
  • オフにすると古いセッションに影響する。 変数を削除すると、再度設定するまでCode Modeセッションは再開できなくなります。
  • セッションの変換はできない。 Code Modeなしで開始したセッションを途中でCode Modeに変更することはできません。

制限事項リストには、Code Modeセッションの移行先についても記載されています。再開できるのはターミナル内のみです。デスクトップアプリに移動したり、バックグラウンドセッションに変換したりすることはできず、/fork でバックグラウンドコピーを開始することもできません。

オフにする方法と、組織によるブロック方法

Code Modeをオフにするには、シェルとユーザー設定から変数を削除し、新しいセッションを開始します。また、値を 0 に設定することもできます。ドキュメントには「一箇所で 0 に設定されていると、もう一方で 1 を設定していてもCode Modeはオフのままになります」とあります。

管理者は、管理設定で変数を 0 に設定することで、全員に対してブロックできます。ドキュメントにはユーザーの体験がこう記されています。「Code Modeセッション中のユーザーは、終了または再起動するまでそのまま継続できます。その後、ユーザーはCode Modeなしで開始され、0 が設定されている間はCode Modeセッションを再開できなくなります。」

逆の設定はできません。「管理設定からユーザーに対してCode Modeを強制的にオンにすることはできません。」

利用後に組織がCode Modeをブロックした場合、そのブロックが解除されるまで、Code Modeで開始したセッションは再開できなくなります。

コードへの権限の適用方法

コードがルールをバイパスすることはありません。ドキュメントによると、Claudeがコードを実行する際、その中の各ツール呼び出しは、Bash などの通常のツール名の下で、設定された deny(拒否)および ask(確認)の権限ルール、および PreToolUse フックを通過します。

変化するのは、現在のモードがどのように作業をレビューするかです:

  • auto(自動)モードでは、 分類器は各ツール呼び出しではなく、実行前の各コードの断片をレビューします。ドキュメントには注意点が記されています。「検索出力から取得したパスなど、実行時に計算される値は見えません。そのため、制御が必要な呼び出しについてはルールやフックを維持してください。」
  • その他の権限モードでは、 コードはレビューなしで開始され、そのモードで通常プロンプトが表示される各ツール呼び出しに対して確認が求められます。

ドキュメントはコマンドのマッチングについても警告しています。app という名前のフォルダでの git push は、最初にディレクトリを変更する複合コマンドとしてフックに届く可能性があるため、シェルコマンドを許可またはブロックする PreToolUse フックは、コマンドの各部分をチェックする必要があります。コード自体を検査するには、コードを実行するツールである REPL に一致する PreToolUse フックを記述し、tool_input.code からJavaScriptを読み取ることができます。

どのフックがブロックできるか

フックはCode Modeでの作業を停止させることもできます。ドキュメントには2つのケースが挙げられています。

失敗した PreToolUse フック。 Claudeがツール呼び出しの拒否を報告した場合、エラーテキストに理由が表示されます。ドキュメントには2つのメッセージが記載されています。「hook failed(フックが失敗した)」は、開始できなかった、強制終了された、または特定のコードで終了したことを意味し、「hook did not finish(フックが終了しなかった)」はタイムアウトを意味します。どちらの場合も、onFailure が未設定であれば呼び出しは拒否されます。フックが失敗またはタイムアウトしても呼び出しを続行させるには、onFailure を continue に設定するようドキュメントに記されています。

コード出力を受け取る UserPromptSubmit フック。 コードがバックグラウンドで実行可能な場合、そのイベントの command、http、mcp_tool フックもコード出力に対して実行されます。いずれかがブロックすると、Claudeは出力が期待される場所にフックのブロック理由を報告します。解決策は、入力の source が poll_event である場合にフックを通過させることです。

この2番目のケースは、UserPromptSubmit フックを使用してコンテキストを追加したり、Claudeに届く内容をフィルタリングしたりする場合に重要です。Code Modeでは、同じフックがプロンプト以上のものを目にすることになります。どのフックがClaudeにコンテキストを追加できるか、またその出力がセッションをまたいでどのように動作するかについては、Claude Codeフックに関するガイドで解説しています。

アドオンに関する注意点もあります。ドキュメントのトラブルシューティング表には、ツール呼び出しをチェックするインストール済みModがCode Modeの起動を妨げる理由として挙げられています。Claude Code v2.1.327の変更ログによると、インストール済みModがツール呼び出しをフックしていてもCode Modeの起動を拒否しなくなり、管理者は引き続き管理設定でオフにできるようになったとのことです。古いメッセージが表示される場合は、バージョンを確認してください。

長時間実行されるコード

長時間のビルドやテストを実行するコードは、Claudeを待機させるか、バックグラウンドで実行されます。

  • 待機: Claudeはコード終了後に回答します。コードは、権限プロンプトで費やした時間を含め、10分後に停止します。
  • バックグラウンド: Claudeとの対話を継続でき、コードは最大2時間実行可能です。

バックグラウンドコードの場合、ドキュメントではセッションを auto または bypassPermissions モードで開始することを推奨しています。

Code Modeでまだできないこと

要件と制限事項は具体的であり、Code Modeが現在の環境に適合するかどうかを決定します。

  • インターフェース: ターミナルでの対話型 claude セッション。ドキュメントによると、-p、Agent SDK、VS Codeパネル、デスクトップアプリ、またはクラウドセッションでは動作しません。
  • アカウントとプロバイダー: ClaudeサブスクリプションまたはConsoleアカウント。ゲートウェイや、Amazon Bedrock、AWS上のClaude Platform、Google CloudのAgent Platform、Microsoft Foundryなどのプラットフォーム経由では動作しません。
  • 組織設定: HIPAA構成またはデータ保持ゼロの設定では利用できません。
  • モデル: Claude Opus 5.5、Sonnet 5.5、Haiku 5.5、またはFable 5.2。
  • 機能: Remote Control、ChromeでのClaude、コンピュータ使用(computer use)は利用できません。
  • エージェントチーム: v2.1.326からサポートされており、チームメイトはデフォルトのインプロセス表示モードでCode Modeで実行されます。

Code Modeが開始されない場合、Claude Codeはその理由とともに利用不可であることを示す行を表示し、/status でも確認できます。

よくある間違い

変数なしのターミナルからの再開。 Claude Codeは、Code Modeがオフの状態でのCode Modeセッションの再開を拒否します。

プロジェクト設定での有効化。 Claude Codeはプロジェクト設定ファイル内の変数を無視します。

コードが触れたすべてをClaudeが覚えていると期待すること。 Claudeはコードが返した内容のみを読み取ります。

失敗したフックが呼び出しを許可すると仮定すること。 Code Modeでは、onFailure を continue に設定しない限り、失敗またはタイムアウトしたフックは呼び出しを拒否します。

解決策:Code Modeセッションを継続しやすくする

ステップ 1: ユーザー設定に変数を設定する

~/.claude/settings.json の env ブロックに CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を記述し、どのターミナルからでも同じように再開できるようにします。

ステップ 2: フックを見直す

PreToolUse フックのタイムアウトと失敗処理を確認し、UserPromptSubmit フックが poll_event の際にパスするようにします。

ステップ 3: 後で必要になる出力を要求する

重要なステップでは、単なる要約ではなく、後で参照したくなる詳細を返すようClaudeに指示します。

ステップ 4: タスクで決定したことを書き留める

長時間のCode Modeセッションの結論は、セッションの再開に依存しない場所に記録しておきます。

MemoryLakeでのセットアップ

Code Modeセッションには、作業中にClaudeが学んだことが保持されますが、それは同じ設定で再度開ける場合に限られます。どのファイルが特定の挙動を制御しているか、なぜリファクタリングをそこで止めたのか、どのテストが変更を保護しているのかといった作業の結論は、1つのセッション設定に依存すべきではないプロジェクトのコンテキストです。

MemoryLake は、決定事項、規約、その背後にある理由などのプロジェクトコンテキストのための記憶レイヤーです。これらを1箇所で管理し、ChatGPT、Claude Code、Codexなどの接続されたアシスタントから利用できるようにします。

エントリーはあなた自身の言葉で記述します。Claude Codeのセッション、トランスクリプト、設定ファイル、フック、CLAUDE.md ファイル、またはベンダーのストレージから何かが読み取られたり、書き込まれたり、削除されたりすることはありません。Code ModeはAnthropicが説明している通りに動作します。

ステップ 1: APIキーを作成する

サインインしてダッシュボードからキーを生成します。他の認証情報と同様に、リポジトリの外に保存してください。

APIキー画面を表示しているMemoryLakeコンソール。新しいキーが作成され、エージェントで使用するためにコピーされている
APIキー画面を表示しているMemoryLakeコンソール。新しいキーが作成され、エージェントで使用するためにコピーされている

ステップ 2: 最初の記憶をアップロードする

解決策のステップ4で書いた内容、つまり後のセッションが開始すべき結論から始めましょう。1つのエントリーにつき1つの決定事項を記述します。

最初のドキュメントがアップロードされたMemoryLakeワークスペース。各ファイルが検索可能な記憶になるにつれてリスト化されている
最初のドキュメントがアップロードされたMemoryLakeワークスペース。各ファイルが検索可能な記憶になるにつれてリスト化されている

ステップ 3: AIとエージェントを接続する

Claude Code、Codex、および使用している他のアシスタントを接続します。Code Modeであるかどうかにかかわらず、新しいセッションは同じ決定事項を参照できます。

記憶レイヤーに接続可能なAIクライアントとエージェントフレームワークがリストされているMemoryLakeの統合画面
記憶レイヤーに接続可能なAIクライアントとエージェントフレームワークがリストされているMemoryLakeの統合画面

実務で何が変わるか

第一の違いは、再開への依存度が下がることです。セッションが開けない場合でも、結論は引き続き利用可能です。

第二に、コンテキストがクリーンになります。Claudeはコードが返した内容を読み取り、必要な決定事項は長い履歴からではなく、短いエントリーから取得されます。

Code Modeのベストプラクティス

関連する多くのツール呼び出しに使用する。 繰り返しの編集、フィルタリングされた検索、並列コマンドが最適です。

変数はユーザー設定に保持する。 これにより、再開の挙動が予測可能になります。

Ctrl+O でコードを確認する。 会話にはツール呼び出しが表示され、コード自体は表示されません。

制御が必要な呼び出しのルールを維持する。 autoモードでは、分類器は実行時の値ではなくコードをレビューします。

フックの失敗時の挙動をチェックする。 失敗または低速な PreToolUse フックは呼び出しを拒否します。

結論を書き留める。 結論を回収するために、1つのセッションの再開に頼らないようにしましょう。

結論

Code Modeを使用すると、Claudeは1つのステップで複数のツール呼び出しを行うJavaScriptを記述でき、Claudeはコードが返した出力部分のみを読み取ります。これは実験的な機能で、デフォルトはオフ、最新モデルの対話型ターミナルセッションに限定されており、最小バージョンは v2.1.323 です。

モードはセッション開始時に固定されます。Code Modeセッションは変数が設定されている場合にのみ再開され、変数なしで開始されたセッションはそのままであり、組織全体のブロックにより以前のCode Modeセッションが再開できなくなることもあります。権限ルールと PreToolUse フックは引き続き各呼び出しに適用され、失敗またはタイムアウトしたフックは呼び出しを拒否します。変数はユーザー設定に保持し、フックを見直し、長いセッションの結論を書き留めておきましょう。

よくある質問

Claude CodeのCode Modeとは何ですか?

Claudeが1つのステップで複数のツール呼び出しを行うJavaScriptを記述し、Claude Codeがそのコードをセッション内で実行する実験的な機能です。

Code Modeをオンにするにはどうすればよいですか?

Claude Code v2.1.323以降で、シェルまたはユーザー設定で CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を 1 に設定し、プロンプトが表示されたら確認します。

Code Modeセッションを再開できないのはなぜですか?

Claude Codeは、Code Modeがオフの状態でのCode Modeセッションの再開を拒否します。claude --resume を実行する前に、変数を 1 に設定してください。

プロジェクトでCode Modeをオンにすることはできますか?

いいえ。Claude Codeはプロジェクトの設定ファイル内の変数を無視します。

Claudeが書いたコードはどこで見られますか?

Ctrl+O を押してトランスクリプトビューアーを開き、「Code」行を展開してください。

Code Modeでも権限ルールは適用されますか?

はい。コード内の各ツール呼び出しは、設定された deny および ask ルール、および PreToolUse フックを通過します。

Code ModeはVS Codeやデスクトップアプリで動作しますか?

いいえ。ターミナルでの対話型 claude セッションでのみ動作します。