Claude Code v2.1.326 の主要アップデート - auto mode の allow ルールとサンドボックスの書き込み先の変更

Claude Code v2.1.326 の主要アップデート - auto mode の allow ルールとサンドボックスの書き込み先の変更

Claude Code v2.1.326 の主要アップデートを解説します。auto mode の allow ルールやサンドボックスの書き込み先など、動作が変わる変更を before/after で紹介。本日は、agent teams を有効にしたまま Code Mode を試し、チームメイトも Code Mode で動くことを確認しました。
2026.11.17

クラウド事業統括本部の石川です。Claude Code の v2.1.326(2026-11-16)のアップデートをご紹介します。auto mode の allow ルールやサンドボックスの書き込み先など、今の設定のままでは動作が変わる変更も含まれます。前回は併用できなかった agent teams を有効にして Code Mode を試し、チームメイトも Code Mode で動くことを確認しました。

前回のアップデート記事はこちらです。

https://dev.classmethod.jp/articles/20261114-cc-updates-v2-1-325/

アップデートサマリー

v2.1.326 の CHANGELOG の記載は 367 件です。本記事の分類では修正 223 件、開発者体験 43 件、セキュリティ 36 件、破壊的変更 27 件、改善 14 件、新機能 12 件、パフォーマンス 11 件、内部変更 1 件です。権限チェックとサンドボックスに関する項目が多く、auto mode、bypass permissions mode、PowerShell ツールなどで、以前は実行できた操作が確認や拒否に変わる変更が含まれています。

注目のアップデート

auto mode で一部のワイルドカードの allow ルールを無視するよう変更

auto mode で、プログラムを指定していないものや $HOME で始まるものなど、一部のワイルドカードのシェルの allow ルールが無視され、安全チェックで判定されるようになりました。あわせて、プログラムが Windows のバックスラッシュのパスであるワイルドカードの allow ルールも判定の対象になり、その呼び出しがブロックされる場合があります。完全一致のルールは許可のままで、.\ で始まるルールは元に戻す予定と記載されています。

auto mode で、$HOME で始まるものなど一部のワイルドカードの allow ルールを使っている方は、アップデート後もふだんの操作が確認なしで実行できるかを確認しておくのがよいと感じます。

サンドボックス内のコマンドが一部の機密性の高いホームフォルダに書き込まないよう変更

macOS・Linux・WSL のサンドボックス内のコマンドが、既定で一部の機密性の高いホームフォルダに書き込まなくなりました。一部はユーザー設定か管理設定の sandbox.filesystem.allowWrite で許可できます。CHANGELOG には対象のフォルダ名は記載されていません。

サンドボックスからホームフォルダの配下に書き込むツールを使っている方は、アップデート後に動作を確認し、必要に応じて sandbox.filesystem.allowWrite で許可できるかを確認するのがよいと感じます。

agent teams を有効にしたまま Code Mode を使えるように

エージェントチーム(agent teams)を有効にしたまま Code Mode をオンにできるようになりました。前回のブログでは出鼻をくじかれたので、個人的にこのアップデートは嬉しいです。既に Code Mode をオンにしていた場合、チームを有効にしたセッションは Code Mode で開始します。

ユーザー設定の env で Code Mode をオンにしている方は、agent teams を有効にしたセッションも Code Mode で始まるようになるため、アップデート後に起動時の表示を一度確認しておくのがよいと感じます。

Claude Code のサインイン用ファイルへの書き込みを拒否

Claude のファイルツールが .credentials.json など Claude Code のサインイン用ファイルへの書き込みを拒否するようになりました。Bash の権限チェックもサインイン用ファイルに触れるより多くのコマンドで先に確認を求めます。

Claude のファイルツールやシェルコマンドによるサインイン用ファイルの誤った書き換えを防ぐ変更で、auto mode や bypass permissions mode で無人実行させている方には安心材料になると感じます。

Bash の grep と並列の MCP ツール呼び出しの不具合を修正

Bash ツールの grep が、一部のテキストファイルを通知なしにスキップしていた問題が修正されました。また、2 つの長い結果が同じミリ秒に届いた場合に、並列の MCP ツール呼び出しが別の呼び出しの保存済みの結果を読み込んでいた問題も修正されています(anthropics/claude-code#105138)。

grep の検索漏れや、並列の MCP ツール呼び出しでの結果の取り違えに関わる修正のため、これらを使う方は早めにアップデートする価値があると感じます。

Bedrock・Vertex・Foundry でのコンパクションの不具合を修正

Bedrock・Vertex・Foundry の利用時と、テレメトリをオフにしているときに、コンパクションが要約ではなくユーザーのメッセージに返信したり、Claude の最後の応答を要約から漏らしたりすることがあった問題が修正されました。

Amazon Bedrock 経由で Claude Code を使っていて、コンパクションで要約されずにメッセージへ応答される、または最後の応答が要約から抜けるといった現象に当たっていた方は、改善されているかを確認する価値があると感じます。

アップデート内容

新機能

  • --allowedTools・--disallowedTools・--tools の値に、完全なルールに見えないエントリがあると、起動時に警告を表示するようになりました
  • OpenTelemetry のリソース属性に host.name と host.id を含める OTEL_RESOURCE_INCLUDE_HOST が追加されました(既定はオフ)
  • /help <command> が追加されました。あわせて、/clear --help などの組み込みコマンドが使い方を表示せずにアイドルのプロンプトで実行されていた問題が修正されています
  • /status に、プロバイダーや DISABLE_TELEMETRY などの環境変数によって機能がオフになっていることを示す行が追加されました
  • 非表示になった起動時の通知を Ctrl+O で表示できるようになりました
  • セッション中に管理者が managed-mcp.json を追加したときに、MCP サーバーの読み込みが止まる理由を説明するメッセージが追加されました
  • このほか、リクエストが失敗した後の空のプロンプトのヒント、サブエージェントのビューの esc to stop のヒント、不正な形式の plugin.json フィールドが無視されたときの注記、mod の Box の overflowX="scroll" と Text の maxLines・wrap="clip" が追加されています

VS Code 拡張機能の新機能は「VS Code 拡張機能」で紹介します。

改善

  • Remote Control で、claude remote-control・Claude Desktop・VS Code のセッションからの応答が、書かれるそばからスマートフォンやブラウザにストリーミングされるようになりました
  • ターミナルの /update-config が使うコンテキストが約 93,000 トークンから約 13,000 トークンに減り、拒否された設定の編集では変更した設定だけを引用するようになりました
  • 複数のフックがツール呼び出しに回答する場合に、PreToolUse フックの updatedInput を保持する処理が改善され、より多くのケースで書き換えが実行されるようになりました
  • PreToolUse フックが終了コード 127 で終了したときに、チェックが実行されなかった可能性を示すようになりました
  • トランスクリプトでのフックの表示が変わり、失敗はグレーではなく赤、Claude を止めるフックは黄色で表示され、理由がその下に表示されるようになりました
  • Claude in Chrome の長い browser_batch の呼び出しで、応答を待つ時間の上限が 90 秒から 150 秒に延び、失われる完了済みの結果が減りました
  • JSON が壊れた設定ファイルや .mcp.json のエラーで、行と列を示すようになりました
  • プロバイダー、サインイン、DISABLE_TELEMETRY などの環境変数でオフになっているコマンドが、「Unknown command」ではなく理由を示すようになりました
  • plan モードの自動コンパクションが、opusplan での Opus など応答しているモデルを使うよう変更されました。そのため、コストが増える場合があります
  • /claude-api スキルが、エージェントループを自分でホストしたい場合を除き、既定で Managed Agents の上にエージェントを構築するよう変更されました
  • パフォーマンスでは長いセッションでの入力・ストリーミング・リサイズの応答性、ファイルの読み取り・編集後の応答時間(特に Windows)、20 を超えるサブエージェントの実行時の CPU 使用が改善され、Windows ではセッションの最初の Bash コマンドが約 1 秒速くなりました
  • このほか、/plugin の各画面、サインイン画面、ダイアログとキーのヒントの表示、/doctor の途中経過の表示、Monitor の期限切れ時の通知、/plugin のアンインストールなどの質問への回答方法(y・n・u では回答できなくなりました)などが変わっています

セキュリティ

注目のアップデートで紹介した項目のほかに、次の修正と変更があります。

権限チェック

  • Bash の権限チェックが改善され、一部のコマンドは先に確認を求め、誰も回答できない場面では拒否されるようになりました
  • Code Mode の権限チェックが改善され、より多くのサンドボックス内のコマンドが確認を求めるか、拒否されるようになりました。Code Mode の $ シェルヘルパーは一部の値をエラーで拒否します(何も実行されません)
  • ファイルを削除・上書きする Bash コマンド(find -delete、cat a > b、sort -o)が、トランスクリプト上で検索や読み取りとして要約されていた問題を修正
  • ワークツリーで隔離されたサブエージェントが、どのリポジトリでも、チェックアウトと共有するブランチを書き換え得る一部の git コマンドを Bash で拒否するよう変更(セッション本体には影響しません)
  • ツールを正確な名前で要求したときに、ツール検索が別の MCP サーバーのツールを読み込むことがあった問題を修正。そのツールについて改めて確認されることがあります
  • 一部のクラウドセッションで、disallowedTools に Artifact を指定したサブエージェントに Artifact のツールが提供されていた問題を修正
  • 管理設定の PreToolUse フックが直接のツール呼び出しを拒否した際に、OpenTelemetry の tool_decision イベントと permission_denials エントリが残らなかった問題を修正

フォルダの信頼確認と auto mode の提案

  • 起動時と /cd のフォルダの信頼確認で、Claude Code が読み込むプロジェクトの設定ファイルの名前を示すようになりました。起動時は、コマンドを実行するファイルに印が付きます
  • 既に信頼済みの親フォルダの配下で表示されるフォルダの信頼確認で、↑ を押してから Enter を押すと Yes と回答されていた問題を修正
  • セットアップの最後に余分な Enter を押すと auto mode を既定にする提案が承認されていた問題と、起動時の auto mode の提案の上で入力したメッセージが失われ、その Enter で提案が承認されていた問題を修正

サンドボックス

  • macOS・Linux・WSL での Bash サンドボックスの保護が改善されました
  • Bash サンドボックスがコマンドの実行後にリポジトリの .git フォルダにある想定外のエントリを退避するよう変更
  • セッションの mods フォルダでの編集でより頻繁に確認を求め、サンドボックス内のコマンドが書き込めるフォルダを減らすよう変更。すべての編集で確認される場合は、そこにある読み取れないパスやネットワークパスへのリンクを削除します

認証情報・シークレット

  • Remote Control とクラウドセッションからのプッシュ通知で、シークレットのマスキングが改善されました
  • ターミナルの /logout と claude auth logout が、ログインの失効を再試行し、サーバーが確認しない場合は失効させる場所を示すようになりました
  • クラッシュ後や別フォルダからの再オープン時などに、シェルがエクスポートした LLM ゲートウェイをバックグラウンドセッションが失っていた問題を修正。モデルへのリクエストの前に停止するようになりました
  • Remote Control 経由のターミナルセッションからの Claude in Chrome の権限リクエストで、claude.ai に Claude が操作しようとしているサイトが表示されるようになりました(既に許可済みの場合も含む)
  • このほか、一部のデバイスファイルとプロセスファイルの拒否、一部の cp と mv の確認、チェックしきれない非常に長い値を含むコマンドの確認、不正な形式の PowerShell コマンドの拒否、ExitWorktree によるバックグラウンドの処理が実行中の可能性があるワークツリーの削除の拒否(Claude が discard_changes を渡す場合を除く)、HTTP フックでの Content-Length と Transfer-Encoding の無視などの変更があります

修正

安定性・操作性に関わる修正を中心に抜粋します。

  • 標準出力をリダイレクトしていると claude purge の確認が表示されず、見えないまま Enter を 1 回押すとプロジェクトのデータが削除され得た問題を修正。確認はターミナルに表示されます
  • /permissions やメイン会話のツールの確認で追加した権限ルールと /add-dir のフォルダが、設定ファイルに書き込めなかった場合でも保存されたように見えていた問題を修正。ターミナルが警告し、ファイル名を示します
  • --add-dir や --allowedTools などリストを受け取るオプションの後に入力したプロンプトが、メッセージなしで破棄されていた問題を修正
  • 再開したセッションで、前のターンが空の応答で終わっていた場合はクラッシュ後に直近のターンが、Claude Code のメモリが不足した際は以前の会話履歴が失われていた問題を修正
  • 画像の多い Vertex AI のセッションが、リクエストサイズが 30 MB の上限を超えるという 400 エラーで止まり、コンパクションと再試行が行われなかった問題を修正
  • max_tokens がモデルの上限を超えたときのエラーを修正。Anthropic API が報告する最大値でリクエストを再試行します
  • 古い Claude Code が保存した値などが原因で、auto mode が使用量にカウントされるローカルの分類器を使い続けていた問題を修正
  • 支出上限のメニューを開いた直後に Backspace と Enter を押すと、確認なしで月間上限が削除されていた問題を修正
  • MCP の設定と表示について、ルートに anyOf や oneOf を持つ MCP ツールで Claude に最初の分岐の引数の形しか見せていなかった問題、ローカル(stdio)の MCP サーバーが起動に失敗した理由を /mcp が表示しなかった問題、claude mcp add-json がほとんどの誤りに「Invalid configuration: : Invalid input」と返していた問題を修正
  • 過負荷や失敗した API リクエストを再試行している間や、テキスト出力をリダイレクト・キャプチャした状態で失敗したときに、claude -p がターミナルに何も表示しなかった問題を修正
  • 折りたたまれたツールの行で、失敗・ブロック・拒否されたコマンドが成功したように見えていた問題を修正。「· 1 failed」と表示するか、実行されなかったことを示します
  • /resume・/plugin・/permissions・/config の検索が、IME の入力、音声入力、すばやい入力を無視していた問題が修正されました。日本語で検索する方には地味に嬉しい修正と感じます
  • このほか、フルスクリーン表示とストリーミング中の描画、サインインと /privacy-settings、Remote Control とクラウドセッション、バックグラウンドのエージェントの表示、/rewind など、多数の細かな不具合が修正されています

VS Code 拡張機能

  • プロンプトの提案をオフにする claudeCode.promptSuggestions 設定が追加されました
  • Edit と Write の速度が改善されました。タブで開いていないファイルについてエディタが問題を報告していない場合、新しい問題を待ちません
  • フォークした会話で「Rewind code to here」が 1 ターン多く元に戻し、そのターンで作成したファイルを削除することがあった問題を修正
  • このほか、サインイン、Memory ダイアログ、/ide の接続、実行中のコマンドのライブ出力、ハイコントラストのテーマの表示などの修正と変更があります

破壊的変更

auto mode のワイルドカードの allow ルール

変更前(〜v2.1.325): auto mode でも、次のような allow ルールに一致するシェルコマンドは、ルールに従って許可されていました。以下は設定例です(~/.claude/settings.json)。

{
  "permissions": {
    "defaultMode": "auto",
    "allow": ["Bash($HOME/scripts/*)"]
  }
}

変更後(v2.1.326〜): 同じ設定でも、auto mode では $HOME で始まるこのルールは無視され、安全チェックで判定されます。CHANGELOG には、代わりの書き方は記載されていません。

サンドボックスの書き込み先

変更前(〜v2.1.325): 次の設定で、サンドボックス内のコマンドから一部の機密性の高いホームフォルダへの書き込みは、既定では拒否されていませんでした。

{
  "sandbox": {
    "enabled": true
  }
}

変更後(v2.1.326〜): 同じ設定では既定でそれらのフォルダに書き込みません。一部はユーザー設定か管理設定の sandbox.filesystem.allowWrite で許可できます。以下は設定例です(フォルダ名は仮のものです)。

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "allowWrite": ["~/<書き込みを許可するフォルダ>"]
    }
  }
}

allowWrite の書き方は公式ドキュメント(sandboxing)の例に合わせています。CHANGELOG には対象のフォルダ名と、どのフォルダが allowWrite で許可できるかは記載されていません。

管理設定の autoMode.environment と "$defaults"

公式ドキュメント(auto-mode-config)によると、autoMode.environment の配列に "$defaults" を含めないと、組み込みのエントリがすべて置き換わります。v2.1.326 からは、管理設定のこの一覧が Claude Desktop と Agent SDK のアプリでも組み込みのエントリをすべて置き換えます。

変更前(〜v2.1.325): 次のような "$defaults" を含まない管理設定は、Claude Desktop と Agent SDK のアプリでは組み込みのエントリをすべて置き換える扱いではありませんでした。以下は設定例です(エントリの文言はドキュメントの例です)。

{
  "autoMode": {
    "environment": [
      "Source control: github.example.com/acme-corp and all repos under it"
    ]
  }
}

変更後(v2.1.326〜): 組み込みのエントリを残すには "$defaults" を追加するか、機密性の高い対象のエントリをコピーします。

{
  "autoMode": {
    "environment": [
      "$defaults",
      "Source control: github.example.com/acme-corp and all repos under it"
    ]
  }
}

セルフホストランナーの組み込みの gh api

gh のない Linux と macOS のセッションに、既定で組み込みの gh api が提供されるようになりました。リクエストは Anthropic を経由し、GitHub へのサインインがあれば Anthropic がその認証情報を付加します。--help の説明は次のとおりです。

% claude self-hosted-runner --help | sed -n '/--use-anthropic-gh/,/^  --[a-z]/p'
  --use-anthropic-gh [bool]   Offer Claude Code's built-in `gh api` to sessions on this runner where
                              no gh is installed. It reaches github.com's REST API only (no GraphQL,
                              no other gh command, no GitHub Enterprise host). Its requests go
                              through Anthropic, which adds the GitHub credential, if any, that
                              Anthropic holds for the session, for that session's repositories: in
                              a person's own session, that person's GitHub sign-in. git is untouched,
                              and an installed gh is left alone. A session that Anthropic-managed git
                              serves is not affected. Withheld (with true, the log says why) on
                              Windows, at --capacity above 1, with --agent-proxy-url, with
                              --exec-path or a command hook, while nonessential traffic is
                              disabled, with a model provider other than Anthropic's own API, on a
                              runner started from a Claude Code session's shell, in code reviews,
                              in tools-only sessions, and where the older git proxy carries a
                              session's git. With true, the runner's log says for each session
                              whether it was offered and whether Claude Code set it up. By default it
                              says so once at start-up, and where Claude Code set it up.
                              Default: on. false, 0, no or off turns it off.
                              [env: SELF_HOSTED_RUNNER_USE_ANTHROPIC_GH=1]

変更前(〜v2.1.325):

% claude self-hosted-runner

変更後(v2.1.326〜): 同じコマンドで組み込みの gh api が提供されます。提供しない場合は --use-anthropic-gh false を付けます。

% claude self-hosted-runner --use-anthropic-gh false

破壊的変更の一覧

対象 変更前 変更後・必要な対応
auto mode のワイルドカードのシェルの allow ルール(プログラムを指定していないもの、$HOME で始まるものなど) ルールに従って許可 無視され、安全チェックで判定される
auto mode の、プログラムが Windows のバックスラッシュのパスであるワイルドカードの allow ルール — 判定の対象になり、その呼び出しがブロックされる場合がある。完全一致のルールは許可のまま。.\ で始まるルールは元に戻す予定
auto mode での一部のシェルコマンド 実行されていた 止められる
macOS の一部の Bash コマンド 実行されていた 確認を求めるか、拒否される
bypass permissions mode の一部のツール呼び出し — 承認を求めるか、確認できる人がいない場合は拒否される
PowerShell ツールの一部のコマンド — 先に確認を求める。無人の実行では、allow ルール、auto mode、bypass permissions mode で許可されていない限り拒否される
bypass permissions mode での PowerShell ツールの一部のコマンド — bypass permissions mode でも確認を求め、一部は拒否される
auto-allow がオフのときの、環境変数を設定する一部の行(Bash サンドボックス) — 先に確認を求める。無人の実行では拒否されることがある
サンドボックス内のコマンドからの一部の機密性の高いホームフォルダへの書き込み(macOS・Linux・WSL) — 既定で書き込まない。一部はユーザー設定か管理設定の sandbox.filesystem.allowWrite で許可できる
権限フックや SDK ホストが承認時に書き換えたコマンド — 元のコマンドがサンドボックス内と判定されていれば、サンドボックス内で実行される。承認する側は dangerouslyDisableSandbox: true を追加できる
claude mcp serve の sandbox.excludedCommands — 無視される
Linux・WSL の存在しない一部の --add-dir のフォルダ — サンドボックス内の各コマンドの前に作成される。そのフォルダを作成するコマンドが失敗・スキップしたり、その中に作成したりする場合がある
フックの "decision": "block" — より多くのケースで有効になる。常にこれを出力するフックは、呼び出しをブロックし始める可能性がある
"$defaults" を含まない管理設定の autoMode.environment — Claude Desktop と Agent SDK のアプリでも組み込みのエントリをすべて置き換える。"$defaults" を追加するか、機密性の高い対象のエントリをコピーする
Claude Code + Cowork の HIPAA 構成を使う組織のターミナルと VS Code のセッション — 既定で auto mode で開始する。disableAutoMode でオフにできる
モードを設定していないターミナルと VS Code のセッション(組織のポリシーが読み込まれていないとき) Manual mode で開始 auto mode で開始する
既定で auto mode で開始するセッション — 設定の読み込み後はサーバー管理の defaultMode を使う。設定の読み込みに失敗して保存済みのコピーがなく、ポリシーの読み込みが失敗するかポリシーが求める場合は Manual になる
ローカルのターミナルセッションの --add-dir と /add-dir — まだ信頼していないフォルダに信頼の確認を表示する。claude --bg はそのようなフォルダを拒否する
--trust-workspace false のセルフホストランナー — より多くのリポジトリの設定を無視する。そうした値はユーザー設定か管理設定で指定する
セルフホストランナーの、gh のない Linux と macOS のセッション — 既定で組み込みの gh api を提供する。--use-anthropic-gh false でオフにできる
plugin.json の表示用フィールドの形式が不正な、有効なプラグイン 拒否されていた フックと MCP サーバーとともに読み込まれる。管理者は配布しているプラグインを確認する
Remote Control のプロキシ経由の接続 — CONNECT トンネルを使う。CONNECT を拒否するプロキシでは、Remote Control がエラーで停止する
Remote Control の --verbose で書き出すセッションのデバッグログ — ~/.claude/child-logs/ に出力する
承認されていない API キーでの --bare セッション — ほとんどの構成でバックグラウンドへの移行を拒否する。バックグラウンドサービスがキーを持っていない場合、claude --bare --bg はエラーで終了する
--bg や --worktree --tmux と組み合わせた --await-initialize 初期化リクエストが運ぶフィールドなしで起動 拒否される
ワークツリーの作成、/teleport、IDE のチェックアウトでの git — より厳格な PATH で実行する。git のフィルターやヘルパーはフルパスの指定が必要になる場合がある
claude のサブコマンドが出力する一部のメッセージ — 文言が変わる(JSON の出力は変更なし)

agent teams を有効にしたまま Code Mode を試してみた

前回の記事では、筆者のユーザー設定(~/.claude/settings.json の env)で CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 を設定していたため Code Mode が起動せず、agent teams の環境変数を外して検証しました。v2.1.326 で、agent teams を有効にしたまま Code Mode が起動するかと、チームメイトも Code Mode で動くか(ここが重要)を確認しました。

ドキュメントの記載

公式ドキュメント(Code Mode)には、次のように記載されています。

  • agent teams を有効にしたまま Code Mode を使うには v2.1.326 以降が必要です。チームメイトは既定の in-process 表示モードでは Code Mode で動き、split panes では Code Mode なしで起動します
  • それより前のバージョンではセッションの上部に Code Mode (experimental) isn't available と、理由の it can't be used together with agent teams yet が表示されます。対処として、v2.1.326 以降への更新か、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS の解除が案内されています
  • Code Mode は対話の claude セッションでのみ動き、-p では使えません。また、Code Mode のセッションでは Remote Control、Claude in Chrome、コンピューター操作(computer use)を使えません

agent teams のドキュメントには、teammateMode 設定を変更するまで、チームメイトは in-process で動くと記載されています。

検証環境

検証環境は macOS(Darwin 25.6.0、arm64)、Claude Code v2.1.326 です。

% claude --version
2.1.326 (Claude Code)

ユーザー設定は次のとおりです。前回の記事と同じく env で agent teams を有効にしており、既定の権限モードは auto mode、表示は fullscreen です。teammateMode は設定していません。

% jq '{env, permissions: {defaultMode: .permissions.defaultMode}, tui}' ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
    "ENABLE_TOOL_SEARCH": "true"
  },
  "permissions": {
    "defaultMode": "auto"
  },
  "tui": "fullscreen"
}

テスト用のプロジェクトを作る

検証に使うファイルは、現在のディレクトリの直下に作る検証用のフォルダ(codemode-handson)にまとめます。その中の docs-site に、前回の記事と同じ Markdown ファイル 5 件のプロジェクトを作ります。ローカルファイルへのリンクのうち 5 件は、存在しないファイルを指しています。

検証用のフォルダの作成

検証用のフォルダの場所は、絶対パスで変数 WORK に入れます。以降の手順は、この変数を使います。新しいターミナルを開いたときは、同じディレクトリに移動してから WORK を設定し直してください。

検証用のフォルダを作るディレクトリは、Git リポジトリの外で、上の階層に CLAUDE.md がない場所を選んでください。公式ドキュメントによると、起動したディレクトリより上の階層にある CLAUDE.md は起動時に読み込まれるため、結果が変わる可能性があります。

% cd <検証用のフォルダを作るディレクトリ>
% WORK="$PWD/codemode-handson"
% mkdir -p "$WORK/docs-site/docs" "$WORK/docs-site/examples" "$WORK/transcripts" "$WORK/screenshots"
% cd "$WORK/docs-site"

% cat > README.md <<'EOF'
# Sample Docs

- [セットアップ](./docs/setup.md)
- [使い方](./docs/usage.md)
- [コントリビュートの方法](./CONTRIBUTING.md)
- [公式サイト](https://example.com)
EOF

% cat > docs/setup.md <<'EOF'
# セットアップ

[README に戻る](../README.md)

詳しいインストール手順は [install.md](./install.md) を参照してください。

![構成図](../images/arch.png)
EOF

% cat > docs/usage.md <<'EOF'
# 使い方

インストールは [セットアップ](./setup.md#install) を参照してください。

サンプルは [基本の例](../examples/basic.md) にあります。
EOF

% cat > examples/basic.md <<'EOF'
# 基本の例

API の詳細は [API リファレンス](../docs/api.md) を参照してください。

次は [応用の例](./advanced.md) です。
EOF

% cat > examples/advanced.md <<'EOF'
# 応用の例

[README](../README.md) / [よくある質問](../docs/faq.md)
EOF

検証用のフォルダ全体の構成は次のとおりです。

codemode-handson/
├── docs-site/
│   ├── README.md
│   ├── docs/
│   │   ├── setup.md
│   │   └── usage.md
│   └── examples/
│       ├── advanced.md
│       └── basic.md
├── transcripts/
└── screenshots/

transcripts/ は集計用にコピーするトランスクリプトを、screenshots/ は撮影した画像を置くフォルダです。どちらも、Claude Code を起動する docs-site の外に置いています。

存在しないファイルを指しているリンクは、次の 5 件です。

リンクがあるファイル 書かれているパス
README.md ./CONTRIBUTING.md
docs/setup.md ./install.md
docs/setup.md ../images/arch.png
examples/basic.md ../docs/api.md
examples/advanced.md ../docs/faq.md

起動する

Code Mode は対話セッションでしか動きません。ターミナルで直接試す場合は、tmux も env -i も不要で、前の手順で作ったテスト用プロジェクトで次のように起動します。

% cd "$WORK/docs-site"
% CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude --model opus

以降の画面とトランスクリプトは、筆者が前回の記事で作った ~/docs-site(中身は同じ Markdown ファイル 5 件)で実行したときのものです。そのため、画面に表示されるパスは ~/docs-site になっています。

筆者は別の Claude Code セッションの中から起動して撮影したため、前回の記事と同じく、tmux で起動したセッションを iTerm2 のウィンドウに表示しました。親セッションの環境変数を引き継がないよう、起動コマンドの先頭に env -i を付けて最小限の環境変数だけを渡しています。agent teams の環境変数は env -i では渡さず、ユーザー設定の env から読み込ませています。tmux new-session -d はセッションをバックグラウンドで起動するだけで、実行したウィンドウには何も表示されません。画面を表示するには、最後の tmux attach でセッションに接続します。

# Claude Code の中から起動する場合の手順
# tmux のサーバーを起動し、ステータスバーを消して、ウィンドウのタイトルを claude にする
% tmux -L cm326 new-session -d -s keep "cat"
% tmux -L cm326 set -g status off
% tmux -L cm326 set -g set-titles on
% tmux -L cm326 set -g set-titles-string "claude"

# env -i で最小限の環境変数だけを渡して、Code Mode のセッションをバックグラウンドで起動する
% CLEAN="env -i HOME=$HOME USER=$USER LOGNAME=$USER PATH=$PATH SHELL=/bin/zsh TERM=xterm-256color LANG=ja_JP.UTF-8 TMPDIR=$TMPDIR"
% tmux -L cm326 new-session -d -s cm -x 120 -y 40 -c "$WORK/docs-site" "$CLEAN CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude --model opus"

# iTerm2 のウィンドウ(120 列 × 40 行)でセッションに接続して、画面を表示する
% printf '\e[8;40;120t'
% tmux -L cm326 attach -t cm

筆者は AppleScript で 120 列 × 40 行の iTerm2 のウィンドウを開き、そのウィンドウで tmux -L cm326 attach -t cm を実行しました。接続をやめて元のシェルに戻るときは、Ctrl+b を押してから d を押します(セッションは動いたまま残ります)。撮影が終わったら、セッションで /exit を実行し、tmux -L cm326 kill-server で tmux のサーバーを終了します。

セッションの上部に、ドキュメントに記載されている行が表示されました。agent teams を有効にしたユーザー設定のまま、Code Mode で起動しています。Code Mode の確認ダイアログには前回の記事で回答済みのため、今回は表示されませんでした。

⚠ Code Mode (experimental) is on · this session can be resumed only with Code Mode on

agent teams を有効にしたまま Code Mode で起動した画面

起動直後は、画面の下部に次の案内も表示されていました。

  No Chrome or computer use: exit and run CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=0 claude for a new session without Code …

Markdown のリンクを確認する

前回の記事と同じプロンプトを送りました。

このプロジェクトの Markdown ファイルをすべて読み、存在しないローカルファイルを指しているリンクを一覧にしてください。

Claude は、前回の記事と同じく、存在しないファイルを指しているリンク 5 件を挙げました(26 秒)。

Markdown のリンクを確認した結果

今回はユーザー設定の defaultMode が auto のため、セッションは auto mode で動いています。ドキュメントによると、auto mode の安全チェックはツール呼び出しごとではなくコード単位で行われます。Ctrl+O で開いたトランスクリプトビューアでは、$ のシェルヘルパーで find と test -e を実行する 1 回目のコードが Blocked by auto mode となり、理由に Auto mode: [Undermining Oversight] と表示されていました。その後の Code(…) の行では、コードの中から実行された Search(Glob)と Read が並んでいます。

トランスクリプトビューアの Code(…) の行

2 回目以降のコードでは、Claude は tools.Glob、file().text()、file().exists() を使ってファイルの一覧・読み取り・存在確認を行っていました。集計には、セッションのトランスクリプト(~/.claude/projects/ 配下の JSONL)を検証用のフォルダの transcripts/ にコピーして使います。次は、筆者がコピーした cm326_transcript.jsonl を、メッセージのモデルとツール名で集計した結果です。コードの中から実行された呼び出しは、model が <synthetic> のメッセージとして記録されています。

% jq -r 'select(.type=="assistant") | [.message.model, ([.message.content[]? | select(.type=="tool_use") | .name] | join(","))] | @tsv' cm326_transcript.jsonl | uniq -c
   1 claude-opus-5-5	
   1 claude-opus-5-5	REPL
   1 claude-opus-5-5	
   1 claude-opus-5-5	REPL
   1 <synthetic>	Glob
   1 claude-opus-5-5	REPL
   1 claude-opus-5-5	Poll
   5 <synthetic>	Read
   1 claude-opus-5-5	
   1 claude-opus-5-5	REPL
   1 claude-opus-5-5	Poll
  10 <synthetic>	Read
   2 claude-opus-5-5	

モデルが要求したツール呼び出しは REPL(コードを実行するツール)4 回と Poll 2 回で、Glob 1 回と Read 15 回はコードの中から実行されています。

チームメイトも Code Mode で動くか

続けて、チームメイトを使うタスクを依頼しました。ファイルは変更しない内容にしています。

チームメイトを 2 人作成して、1 人には docs/ 配下、もう 1 人には examples/ 配下の Markdown ファイルを担当させ、存在しないローカルファイルを指しているリンクを報告させてください。ファイルは変更しないでください。

Claude は docs-checker と examples-checker の 2 人のチームメイトを作成し、プロンプトの下にエージェントの行(main、docs-checker、examples-checker)が表示されました。2 人はそれぞれ 2 件のリンク切れを報告し、Claude はどちらの担当にも入っていない README.md の 1 件を足して、全体で 5 件とまとめました。

in-process のチームメイトとエージェントの行

チームメイトのトランスクリプト(セッションのフォルダの subagents/ 配下)も同じ方法で集計しました。2 人とも REPL を使い、コードの中から Bash と Read を実行しています。

% jq -r 'select(.type=="assistant") | [.message.model, ([.message.content[]? | select(.type=="tool_use") | .name] | join(","))] | @tsv' agent-adocs-checker-e17dea8abc10bef0.jsonl | uniq -c
   1 claude-opus-5-5	
   1 claude-opus-5-5	REPL
   2 <synthetic>	Bash
   1 claude-opus-5-5	REPL
   2 <synthetic>	Read
   1 claude-opus-5-5	
   1 claude-opus-5-5	REPL
   5 <synthetic>	Read
   1 <synthetic>	Bash
   1 claude-opus-5-5	SendMessage
   1 claude-opus-5-5	
% jq -r 'select(.type=="assistant") | [.message.model, ([.message.content[]? | select(.type=="tool_use") | .name] | join(","))] | @tsv' agent-aexamples-checker-94a222227f860f62.jsonl | uniq -c
   1 claude-opus-5-5	
   1 claude-opus-5-5	REPL
   3 <synthetic>	Bash
   1 claude-opus-5-5	REPL
   2 <synthetic>	Read
   1 claude-opus-5-5	
   1 claude-opus-5-5	SendMessage
   1 claude-opus-5-5	

チームメイトのメタデータには、taskKind が in_process_teammate と記録されていました。

% cat agent-adocs-checker-e17dea8abc10bef0.meta.json
{"agentType":"docs-checker","isBuiltIn":false,"description":"docs 配下のリンク切れ確認","name":"docs-checker","spawnDepth":0,"requestShape":"background","requestNonInteractive":true,"model":"opus","pickedEffortModel":"opus","taskKind":"in_process_teammate","teamName":"session-6f174f97","color":"blue","planModeRequired":false,"spawnedAgentType":"Explore","permissionMode":"auto"}

ドキュメントの記載どおり、既定の in-process 表示モードのチームメイトも Code Mode で動いていました。

前回の記事では agent teams の環境変数を外して Code Mode を検証しました。v2.1.326 からは agent teams を有効にした環境のまま Code Mode を試せるため、併用を試す際の設定の切り替えが要らなくなる点がありがたいと感じます。

最後に

v2.1.326 は 367 件の多くが修正ですが、auto mode の allow ルールやサンドボックスの書き込み先など、権限の判定や書き込み制限の挙動を変える破壊的変更が目立つと感じます。無人実行や CI で Claude Code を使っている方は、アップデート後に一度動作を確認し、必要な設定を明示しておくのがよいと感じます。権限まわりの設定を確認したうえで、アップデートして試してみてはいかがでしょうか。

参考文献

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

https://code.claude.com/docs/en/changelog

https://code.claude.com/docs/en/code-mode

https://code.claude.com/docs/en/auto-mode-config

https://code.claude.com/docs/en/sandboxing

https://code.claude.com/docs/en/permission-modes

https://dev.classmethod.jp/articles/20261114-cc-updates-v2-1-325/


Claudeならクラスメソッドにお任せください

クラスメソッドは、Anthropic社とリセラー契約を締結しています。各種製品ガイドから、業種別の活用法、フェーズごとのお悩み解決などサービス支援ページにまとめております。まずはご覧いただき、お気軽にご相談ください。

サービス詳細を見る

この記事をシェアする

AI白書

関連記事