2026-10-20 の公式ドキュメント更新：`claude -p` のデフォルトモード変更とフック仕様の詳細化

Posted at 2026-10-26

この日の更新は、v2.1.302 を境にした claude -p のパーミッション動作の変更と、フック・Auto モードの仕様詳細化が中心です。スケジュールタスクの包括的なドキュメント追加や、スキルのクラウドセッション対応の明確化も含まれています。

`claude -p` と Agent SDK のデフォルトが Manual モードに（v2.1.302 以降）

v2.1.302 以降、--permission-mode を指定しない claude -p 実行および Agent SDK 実行は Manual モード（設定値: default）で開始します。これ以前は条件によって Auto モードで始まることがありましたが、この変更により承認なしでは実行されないツール呼び出しが増えます。

claude -p runs start in Manual mode when nothing sets a permission mode .

（出典 [3]）

（訳：パーミッションモードが設定されていない場合、claude -p の実行は Manual モードで開始します。）

既存の CI スクリプトや Agent SDK アプリケーションでモードを明示していない場合、ツール呼び出しが拒否されるようになる可能性があります。対処としては、--allowedTools で個別ツールを列挙するか、--permission-mode auto を渡す方法がドキュメントに示されています。Agent SDK では Python の ClaudeAgentOptions に permission_mode="auto" を渡すことで同様の設定が可能です。

ロックダウンされたエージェントには allowedTools と permissionMode: "dontAsk" を組み合わせる構成が推奨されています。

pair allowedTools with permissionMode: "dontAsk"

（出典 [2]）

（訳：allowedTools と permissionMode: "dontAsk" を組み合わせてください。）

dontAsk モードでは承認が必要な呼び出しをすべて拒否しつつ、許可済みのツールや作業ディレクトリ内のファイル読み取りは通常通り実行されます。

Auto モードの分類器モデルが環境変数で選択可能に

Auto モードの分類器が使用するモデルのデフォルトが明示されました。デフォルトは Claude Sonnet 5 ですが、セッションの条件によって異なるモデルが選択されます。例えば claude-sonnet-4-6 上で動作するセッションでは Sonnet 4.6 が分類器に使われます。

Use a full model ID such as claude-sonnet-4-6 .

（出典 [4]）

（訳：claude-sonnet-4-6 のようなフルモデル ID を使用してください。）

v2.1.302 以降では CLAUDE_CODE_AUTO_MODE_MODEL 環境変数にフルモデル ID を設定することで、分類器を使用するモデルを変更できます。クラウドプロバイダー固有のモデル ID も利用できます。分類器のリクエストはメインの /model 設定とは独立して課金されるため、実際に使われているモデルを把握しておくことが重要です。

フックの出力解析と障害動作の仕様が詳細化

フックの終了コードと JSON 出力に関する仕様が詳細に追加されました。フックが exit 0 で終了しても JSON が解析できない場合やスキーマ検証に失敗した場合は、アクションをブロックする種類のフックでなければノンブロッキングエラーとして扱われ、アクション自体は続行されます。

the action goes ahead unless the hook is one whose failure blocks the action .

（出典 [1]）

（訳：そのフックが障害時にアクションをブロックする種類でなければ、アクションは続行されます。）

stdout の解析ルールも明文化されており、非同期でないフックで JSON として扱われるのは前後に余分なテキストなしで 1 つの JSON オブジェクトを出力した場合に限られます。PreToolUse フックでタイムアウトが発生しても、ブロックを必須とするフックを除いてツール呼び出しは続行されます。フックは最大 12 本が並列実行され、それを超える分はいずれかが完了次第順次起動します。

フォークモードが v2.1.302 からデフォルト ON に

サブエージェントのフォーク機能が v2.1.302 からデフォルトで有効になりました。インタラクティブセッションでは v2.1.232 からすでに有効でしたが、claude -p などの非インタラクティブ実行でも同様になりました。

Fork mode is on by default from Claude Code v2.1.302, and in an interactive terminal session from v2.1.232.

（出典 [7]）

（訳：フォークモードは Claude Code v2.1.302 からデフォルトで ON になり、インタラクティブターミナルセッションでは v2.1.232 から ON です。）

フォークを無効化するには CLAUDE_CODE_FORK_SUBAGENT を 0 に設定するか、Agent SDK 側で Agent(fork) を disallowedTools に追加します。フォークが ON のあいだ、インタラクティブセッションではサブエージェントの完了を待機できません。待機が必要な場合はフォークモードを OFF にしたうえで Claude に明示的に待つよう指示する方法がドキュメントに記載されています。

マウントドライブへの `rm` の保護条件と無効化手順

/Volumes、/mnt、/media などのマウント済みドライブパスへの再帰的 rm に対するプロンプト（マウントドライブプロンプト）の詳細な発動条件と無効化手順が追加されました。

Even with an allow rule for rm , Claude Code handles the command as a critical-path removal

（出典 [5]）

（訳：rm の許可ルールがあっても、Claude Code はそのコマンドをクリティカルパスの削除として扱います。）

CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT=1 を環境変数に設定することでプロンプトを無効化できますが、settings.json の env ブロックに書いても有効にならないため、claude 起動前のシェルで変数を設定する必要があります。対象パスの一覧（/Volumes/<drive>、/mnt/<name>、/run/media/<user>/<drive> など）もドキュメントに追加されています。

スケジュールタスク（旧 routines）の包括的なドキュメント化

旧称 routines だったクラウドスケジュールタスクの包括的なドキュメントが追加されました。スケジュールタスクはスケジュール・API トリガー・GitHub イベントの 3 種類のトリガーを組み合わせて設定でき、Pro/Max/Team/Enterprise プランで利用可能です。

A cloud scheduled task, formerly a routine, is a saved Claude Code configuration: a prompt, one or more repositories, and a set of connectors , packaged once and run automatically.

（出典 [13]）

（訳：クラウドスケジュールタスク（旧称 routine）は、プロンプト・1 つ以上のリポジトリ・コネクタのセットを 1 度設定して自動実行する Claude Code の設定です。）

スケジュールタスクは Anthropic 管理のクラウドインフラ上で実行されます。タスクはユーザーの claude.ai アカウントに帰属し、タスクが行うコミットや PR はユーザーの GitHub アカウント名義になります。また、旧名 routines がウェブアドレス・CLI・API にそのまま残っていることも明記されています。

スキルのクラウドセッション対応の明確化

Cowork セッションおよびクラウドセッションはローカルの ~/.claude/skills/ を読まないという制約が明文化されました。

Cowork sessions and cloud sessions , including cloud scheduled tasks , don't read ~/.claude/skills/ on your machine.

（出典 [11]）

（訳：Cowork セッションおよびクラウドセッション（クラウドスケジュールタスクを含む）は、お使いのマシンの ~/.claude/skills/ を読み込みません。）

クラウド環境でスキルを使うには、claude.ai アカウントに対してスキルを有効化（アップロード）する必要があります。ローカルにしか存在しないスキルをクラウドスケジュールタスクから呼び出すと「スキルが見つかりません」エラーが返されます。また、このスキルはサブエージェントへのプリロードおよびセッションスコープのスケジュールタスクからの起動もできない点に注意が必要です。

その他の更新

OpenTelemetry のツール決定イベントに classifier_verdict 属性と permission_mode 属性が追加された（v2.1.301 以降）。Auto モードのブロック理由や各ツール呼び出し検査時のパーミッションモードを記録できるようになった。
Agent SDK のフォークサブエージェントについて、Agent(fork) の deny ルールで個別に無効化できることが明記された。
デスクトップアプリのワークツリーセッションでは、プロジェクト設定（フック・スキル・エージェント定義など）はメインチェックアウトのルートから読み込まれる。
セッションスコープのスケジュールタスクは毎秒チェックされ、7 日で失効する。CLAUDE_CODE_DISABLE_CRON=1 で無効化可能。
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1 を設定すると、claude -p のストリーム JSON 出力にサブエージェントのテキストと思考ブロックが含まれるようになる。
CLAUDE_CODE_AUTO_COMPACT_WINDOW で自動コンパクションウィンドウを 100000〜1000000 トークンの範囲で設定可能に（200k 等のサフィックス値は v2.1.304 以降）。

まとめ

2026-10-20 の更新で最も実運用への影響が大きいのは、v2.1.302 による claude -p と Agent SDK のデフォルトモード変更です。パーミッションモードを明示していない既存の CI スクリプトや Agent SDK アプリケーションでツール呼び出しが拒否されるケースが生じる可能性があります。Auto モードの分類器モデルが環境変数で制御可能になり、フォークモードのデフォルト ON、フック出力仕様の詳細化も加わり、Claude Code の自律実行周りの挙動が全体的に整理された日と言えます。スケジュールタスクの包括的なドキュメント追加は、クラウド上での自動化を本格運用しようとする開発者に参照価値のある内容です。

出典

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

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up