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/10 の公式ドキュメント更新:権限評価の順序と設定の適用条件

1
Posted at

2026-11-10 に検知した 15 ページの追加文は、Claude Code と Agent SDK で「どの設定やフックが最終的な許可判断に効くのか」を説明する記述に集中していました。あわせて、ツール利用の課金の内訳、Google Cloud の Agent Platform 向けのモデル別リージョン指定、OpenTelemetry の属性制御にも追記があります。ただし 15 ページのうち複数は、ページ説明文やナビゲーションの更新が中心で、挙動の変更を示すものとは限りません。この記事では、読み取れる範囲の更新に絞って整理します。

フックの allow は deny と ask の評価を飛ばさない:Agent SDK の権限評価

Agent SDK の権限ページに、許可判断が決まるまでの流れを補う 3 文が加わりました。1 つ目は、フックが allow を返した場合の扱いです。

A hook that returns allow doesn't skip the deny-rule and ask-rule steps

(出典 [1])

(訳:allow を返すフックは、deny ルールと ask ルールのステップを飛ばしません。)

追加文は続けて、これらのステップがフックの結果にかかわらず評価されると述べています。フックで allow を返す実装でも、deny ルールや ask ルールに該当すれば、そこで止まる可能性が残ります。

2 つ目は、番号付きの評価手順の 6 番目に canUseTool コールバックが置かれているという記述です。それ以前のステップで決まらなかった場合に、このコールバックが判断を求められます。1〜5 番目の内容は今回の追加文に含まれておらず、ここからは分かりません。

3 つ目は、allowedTools と disallowedTools(Python では allowed_tools と disallowed_tools)の扱いです。これらを設定すると、エントリは allow ルールと deny ルールの一覧に追加され、同じ評価フローに入ります。評価の外側で特別扱いされるわけではない、という点が明文化されました。

サブエージェントの permissionMode が無視される条件

サブエージェントのページには、permissionMode を未設定にした場合の挙動が追記されています。未設定のサブエージェントは、メイン会話の permission mode を継承します。

メイン会話が bypassPermissions、acceptEdits、auto mode のいずれかであるときは、サブエージェントも同じモードで動き、サブエージェント側に書いた permissionMode は無視されます。つまり、サブエージェント定義でモードを厳しく指定していても、メイン会話がこれらのモードなら効きません。

bypassPermissions 下で確認が出たときの手がかりも示されています。

check whether its tool call is one of the actions no mode auto-approves

(出典 [4])

(訳:そのツール呼び出しが、どのモードでも自動承認されない操作の 1 つかどうかを確認してください。)

どの操作が該当するかは参照先のページにあり、今回の追加文には含まれていません。

設定元ごとに有効になる条件が並ぶ settings ページ

settings ページには、設定キーごとに「どの設定元の値が尊重されるか」を示す記述が追加されました。たとえば、バージョン要件の表記(v2.1.314、v2.1.319 以降)の後に、次のような項目が続きます。

permissions.denyInsteadOfPrompting true from ~/.claude/settings.json or --settings Honored even when a managed source sets false

(出典 [12])

(訳:permissions.denyInsteadOfPrompting は、~/.claude/settings.json または --settings で true にした場合、管理設定の側が false でも尊重されます。)

同様の記述は autoMode.classifyAllShell、remoteControlAtStartup、crossSessionInbound、useAutoModeDuringPlan にもあります。設定元によって扱いが分かれる点に注意が必要です。

  • remoteControlAtStartup は、project または local で true にしても無視されると記載されています。
  • useAutoModeDuringPlan は、.claude/settings.json の false が無視されると記載されています。
  • crossSessionInbound は、accept < hold < refuse の段階で、より厳しい値のときに尊重されると記載されています。

見出しや前後の説明は追加文に含まれていません。この一覧全体の位置付けは、今回の情報からは判断できません。バージョン要件の表記がどのキーにかかるかも、並びからの読み取りです。利用前に原文の表を確認してください。

組み込みツールと MCP ツールの出力を差し替える updatedToolOutput

Agent SDK のフックのページには、ツールの出力を Claude に渡す前に差し替える方法が追記されています。

To replace the tool's output before Claude sees it, set updatedToolOutput

(出典 [15])

(訳:Claude がツールの出力を見る前に差し替えるには、updatedToolOutput を設定します。)

追加文には、この指定が組み込みツールと MCP ツールの両方で、両方の SDK で使えるとあります。どのフックイベントで返すかは、今回の追加文からは分かりません。

ツール利用の課金は入力・出力・サーバーサイドツールの 3 要素

Tool use の概要ページに、課金の内訳を示す節が加わりました。課金の基準は次の 3 つです。

  • モデルに送った入力トークンの総数(tools パラメータ内の分を含む)
  • 生成された出力トークン数
  • サーバーサイドツールの追加の従量課金

3 つ目については、次のように書かれています。

For server-side tools, additional usage-based pricing (for example, web search charges per search performed)

(出典 [2])

(訳:サーバーサイドツールには、使用量に応じた追加料金がかかります(たとえば Web 検索は、実行した検索ごとに課金されます)。)

ツール定義が入力トークンに数えられるため、定義の数や長さがそのまま入力側の量に反映されます。具体的な単価は今回の追加文には含まれていません。

Google Cloud の Agent Platform で使うモデル別リージョン変数

環境変数のページには、Google Cloud の Agent Platform 経由でモデルを使うときのリージョン上書き用変数が追記されています。Claude Fable 5.2 用の VERTEX_REGION_CLAUDE_FABLE_5_2 と、Claude Haiku 5.5 用の次の変数です。

VERTEX_REGION_CLAUDE_HAIKU_5_5 Override region for Claude Haiku 5.5 when using Google Cloud's Agent Platform

(出典 [10])

(訳:VERTEX_REGION_CLAUDE_HAIKU_5_5:Google Cloud の Agent Platform を使うとき、Claude Haiku 5.5 のリージョンを上書きします。)

Claude Haiku 4.5 用の VERTEX_REGION_CLAUDE_HAIKU_4_5 も同じ並びに載っています。モデルごとに変数が分かれているため、モデルを切り替える際はリージョン指定も確認する必要があります。バージョン表記(Added in v2.1.257、v2.1.321)が隣接していますが、どの変数に対応するかは追加文からは判別できないため、ここでは触れません。

OpenTelemetry の属性をどこまで付けるか:カーディナリティ制御

監視のページには、メトリクスとイベントに付く属性を環境変数で制御する表が追加されています。表の記載から読み取れる既定値は次のとおりです。

  • OTEL_METRICS_INCLUDE_SESSION_ID、OTEL_METRICS_INCLUDE_ACCOUNT_UUID、OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES:既定は true
  • OTEL_METRICS_INCLUDE_VERSION、OTEL_METRICS_INCLUDE_ENTRYPOINT:既定は false

リポジトリ識別に関する変数も載っています。

OTEL_METRICS_INCLUDE_REPOSITORY Include vcs.* repository identity attributes on metrics and events

(出典 [14])

(訳:OTEL_METRICS_INCLUDE_REPOSITORY:メトリクスとイベントに vcs.* のリポジトリ識別属性を含めます。)

この変数の既定値は、追加文の範囲では確認できません。app.entrypoint を有効にした場合、Claude Tag のセッションでは値が claude-in-slack になると記載されています。

その他の更新

  • スキルとスラッシュコマンドのページ:説明文に「カスタムコマンドと同梱スキルを含む」旨が入り、同梱スキルは / に続けてスキル名を入力して呼び出す、という記述が追加されました。
  • サンドボックスのページ:説明文に、ファイルとネットワークホストの制限を有効化し、境界を設定して、壊れる箇所を直す流れが示されています。
  • 構造化出力のページ:説明文に、JSON Schema、Zod、Pydantic で検証済み JSON を返す旨が入りました。
  • worktree のページ:説明文に、--worktree フラグ、サブエージェントの分離、.worktreeinclude、クリーンアップ、git 以外の VCS 向けフックを扱う旨が入りました。
  • 権限モードのページ:説明文に、CLI、VS Code、Desktop でのモード切り替え方法が入りました。
  • CLI リファレンス:claude purge の dry-run 例と、claude remote-control の説明が追加されました。
  • フックのリファレンス:追加文の大半は目次で、本文は /dev/tty がない Windows でも動く旨の 1 文のみです。何の方法を指すかは追加文からは不明です。
  • サブエージェントのページ:エージェントビューへのリンク文が追加されました。

まとめ

この日の更新で運用に影響し得るのは、Agent SDK でフックや allowedTools による許可制御を組んでいる開発者です。フックで allow を返しても deny ルールと ask ルールは評価されること、allowedTools はルール一覧への追加として扱われることが、文章で確認できるようになりました。サブエージェントを使う場合は、メイン会話が bypassPermissions、acceptEdits、auto mode のときに自分で指定した permissionMode が効かない点を押さえておく必要があります。settings ページの記述は、管理設定がある環境で、どの設定元の値が尊重されるかを確かめる手がかりになります。Google Cloud の Agent Platform 経由でモデルを使う場合はモデル別のリージョン変数が、テレメトリを集計している場合は属性の既定値が、それぞれ確認対象です。いずれも、ドキュメントの追加文から読み取れる範囲の話で、実際の挙動は利用前に原文で確かめてください。

出典

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

[1] https://code.claude.com/docs/en/agent-sdk/permissions
[2] https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview
[3] https://code.claude.com/docs/en/hooks
[4] https://code.claude.com/docs/en/sub-agents
[5] https://code.claude.com/docs/en/slash-commands
[6] https://code.claude.com/docs/en/skills
[7] https://code.claude.com/docs/en/sandboxing
[8] https://code.claude.com/docs/en/agent-sdk/structured-outputs
[9] https://code.claude.com/docs/en/worktrees
[10] https://code.claude.com/docs/en/env-vars
[11] https://code.claude.com/docs/en/permission-modes
[12] https://code.claude.com/docs/en/settings
[13] https://code.claude.com/docs/en/cli-reference
[14] https://code.claude.com/docs/en/monitoring-usage
[15] https://code.claude.com/docs/en/agent-sdk/hooks

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?