1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

11/18 の公式ドキュメント更新:auto mode の判定理由の可視化とスクリプト実行の記述

1
Posted at

2026-11-18 の Claude Code ドキュメントでは、auto mode の分類器が操作を止めた理由をフック、テレメトリ、CLI の各面で確認できる記述が増えました。あわせて、非対話(スクリプト)実行の起動条件と、メモリや規則の適用範囲に関する説明も追加されています。

auto mode の判定理由を、フック・テレメトリ・CLI で確認する

monitoring-usage ページでは、claude_code.safety_event イベントの属性一覧に classifier_category が載りました。OTEL_LOG_TOOL_DETAILS=1 を設定したとき、分類器がブロックの根拠として挙げたルール名が入る属性です。

The name of the policy or built-in rule the classifier named when it blocked the call

(出典 [5])

(訳:分類器が呼び出しをブロックしたときに挙げた、ポリシーまたは組み込みルールの名前。)

属性が付く条件は、classifier_verdict が "block" であることと、分類器が名前をちょうど 1 つだけ返し、Claude Code がそれをポリシーか組み込みルールとして認識できることです。履歴として、v2.1.323 より前はポリシー名を挙げたブロックでこの属性が欠けていたとも書かれています。

hooks ページの PermissionDenied の説明にも、拒否理由に関する追加があります。入力例には reason フィールドがあり、ログに出る reason の例として、一致したポリシーやルール名が角括弧付きで入ると記載されています(例は [Destructive or Unwanted Actions])。

cli-reference ページには、組み込みの分類器ルールを JSON で出力する claude auto-mode defaults が追加されました。設定を反映した状態で見たい場合は claude auto-mode config を使います。

拒否の記録(フック入力)、集計(テレメトリ)、ルールの中身(CLI)が同じルール名でつながる構成です。ただし、3 つの出力のルール名の表記が完全に一致するかどうかは、ドキュメントからは確認できません。

非対話実行:標準入力、--bare、最小構成

headless ページでは、非対話モードが標準入力を読むことが明記されました。ビルドログを claude -p にパイプして結果をファイルへ出す例も載っています。

Non-interactive mode reads stdin, so you can pipe data in and redirect the response out.

(出典 [3])

(訳:非対話モードは標準入力を読むため、データをパイプで渡し、応答をリダイレクトで書き出せます。)

CI などの環境向けには --bare の案内があります。ホスト側の hooks、プラグイン、auto memory、CLAUDE.md を読み込まずに起動する指定です。cli-reference では --bare の説明に、skills、カスタムコマンド、サブエージェント、MCP サーバーの自動探索も省略すると書かれています。

env-vars ページでは、CLAUDE_CODE_SIMPLE を 1 にすると、最小のシステムプロンプトと、Bash・ファイル読み取り・ファイル編集のツールだけで動くと追加されました。同じページには、OAuth トークンとキーチェーンの認証情報は読まれないため、Anthropic API では ANTHROPIC_API_KEY か、--settings 内の apiKeyHelper を設定する、という文もあります。この文がどの設定に付く記述なのかは、追加文だけでは特定できません。

メモリと規則の適用範囲:サブエージェントの memory と paths の glob

sub-agents ページには、サブエージェント用のメモリ機能の説明が増えました。frontmatter に memory: user を指定する例があり、サブエージェントがメモリディレクトリに知識を蓄積すると説明されています。

build up knowledge over time, such as your preferences, your corrections, and project decisions

(出典 [1])

(訳:好み、修正内容、プロジェクト上の決定事項といった知識を、時間をかけて蓄積する。)

サブエージェントの markdown ファイル内にメモリの指示を書いておくと、自分で知識ベースを更新させられるとも書かれています。memory に指定できる値は、追加文の例にある user 以外は確認できません。

memory ページでは、paths フィールドの glob 表の追加が中心です。/*.ts や src//* などのパターンが、基準ディレクトリに対してどこまで一致するかが整理されました。波括弧展開では、src/.{ts,tsx} が 2 パターン、{a,b}/{c,d}/.{ts,tsx} が 8 パターンに展開されると書かれています。ファイル名に [ を含む場合は単一引用符で囲んでエスケープします。シンボリックリンク経由でプロジェクトに到達した場合も一致する、という記述もあります。

その他の更新

  • hooks:allowedHttpHookUrls と httpHookAllowedEnvVars の説明が追加。HTTP フックの URL と、ヘッダーに展開できる環境変数を許可リストで絞れる。
  • headless:Bash(git diff *) のように末尾に * を付けると、git diff が引数の有無にかかわらず一致する。
  • headless:--resume にセッション ID の代わりに、.jsonl のトランスクリプトファイルの絶対パスを渡せる。
  • permission-modes:PowerShell コマンドの扱いと、拒否されたときに Claude へ言い換えを依頼する案内が追加。

まとめ

この日の更新で運用が変わるのは、主に 2 つのグループです。1 つは auto mode を使う組織の管理者で、拒否の理由をフック入力、テレメトリ属性、CLI の出力でルール名として追えるようになりました。もう 1 つは CI やスクリプトから Claude Code を呼ぶ開発者で、標準入力、--bare、最小構成、認証情報の渡し方の記述がそろいました。メモリと paths の glob は、プロジェクトの規則やサブエージェントの設定を書く人向けの追加です。いずれも 2026-11-18 時点のドキュメント記述の範囲であり、挙動の詳細は各ページで確認する必要があります。

出典

本稿の引用はすべて一次資料と逐語照合(verify_article 通過)のうえ掲載しています(2026-11-19 検証)。

[1] https://code.claude.com/docs/en/sub-agents
[2] https://code.claude.com/docs/en/memory
[3] https://code.claude.com/docs/en/headless
[4] https://code.claude.com/docs/en/hooks
[5] https://code.claude.com/docs/en/monitoring-usage
[6] https://code.claude.com/docs/en/env-vars
[7] https://code.claude.com/docs/en/permission-modes
[8] https://code.claude.com/docs/en/cli-reference

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?