0
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?

2026-10-01 Claude Code 公式ドキュメント更新まとめ:auto モードのデフォルト化とセッション制御の整備

0
Posted at

この日の更新は、auto モードが対話セッションの既定起動モードになる変更の詳細な記述と、フック・スキル・MCP にわたる実行制御の仕様明文化の 2 点に集中している。

auto モードが既定の起動モードになった

permission-modes ドキュメントに、auto モードが有効になる条件の詳細が追加された。Claude Code v2.1.283 以降をターミナルまたは VS Code 拡張から起動すると、auto モードで始まる。-p フラグや Agent SDK 経由の非対話セッションでは、フィーチャーフラグを取得できる環境に限り v2.1.285 以降で同様に auto が既定になる。サードパーティプロバイダー経由やテレメトリ無効化環境ではこの条件を満たさず、default モードのままとなる。

初回セッションでの案内表示もドキュメント化された。ターミナルではセッション先頭に一度だけ表示され、VS Code 拡張では新規会話画面のカードとして非表示にするまで残る。

Agent SDK 側でも挙動が変わっている。

Before TypeScript Agent SDK v0.3.286, omitting permissionMode was the same as passing default .

(出典 [9])

(訳:TypeScript Agent SDK v0.3.286 より前は、permissionMode を省略することは default を渡すことと同等でした。)

現行では省略すると auto が選択される。auto モードでは、ベア Bash エントリのような広範な許可ルールが無視されるため、既存コードが default モードを前提としている場合は permissionMode: "default" を明示的に渡す必要がある。

CLI には --safe-mode フラグが追加された。このフラグで起動すると、CLAUDE.md・スキル・プラグイン・フック・MCP サーバー・カスタムエージェント・テーマ・キーバインドなど、ほぼすべてのカスタマイズが無効になった状態でセッションが始まる。設定起因の動作不良をトラブルシュートする用途として位置づけられている。

--desktop フラグも追加された。カレントディレクトリで Claude Desktop アプリを開き、ターミナル側のセッションを起動せずに終了する。macOS と x64 Windows の Claude サブスクリプション利用者が対象で、v2.1.285 以降が必要。

フックで参照できるセッション情報が増えた

hooks ドキュメントに、SessionStart フックが受け取るフィールドの仕様が追記された。agent_type は --agent オプション付きで起動したときのエージェント名、session_title は /rename コマンド・--name フラグ・フック出力・Agent SDK の renameSession() などで設定したカスタムタイトルの値だ。

UserPromptSubmit hooks also receive session_title when the session has a custom title

(出典 [1])

(訳:UserPromptSubmit フックも、セッションにカスタムタイトルがある場合は session_title を受け取ります。)

UserPromptSubmit でも同じフィールドが参照できる。自動生成されるセッションタイトルは session_title には現れないため、フックが既存のカスタムタイトルを上書きしないよう、このフィールドを事前確認することが推奨されている。source が "resume" または "fork" でトランスクリプトに Claude の応答が 1 件以上ある場合、SessionStart フックは追加フィールドも受け取る。

スキルが途中で止まる原因と対処が明文化された

skills および slash-commands ドキュメントに、スキルの動作が途中で止まるパターンとその対処がまとめられた。毎回必ず守らせたいルールはスキル本文ではなくフックに移す必要がある。スキルのフロントマターに hooks セクションを定義すると、そのフックはスキルが呼び出された瞬間からセッション終了まで有効になる。

コンテキスト圧縮(compaction)後はスキルの先頭部分しか保持されないため、重要な指示をファイルの上部に置くことが推奨されている。圧縮後に内容が失われた場合はスキルを再呼び出しすることで全文を復元できる。

deny ルールの適用範囲についても詳細が追記された。エイリアスに対する deny ルールを書くと、バンドルされた /code-review もブロックされる。v2.1.260 より前は、ネストされたスキルを修飾名で登録している場合に非修飾名の deny ルールではブロックできなかった動作変更も記録されている。

MCP の OAuth 認証は HTTPS エンドポイント限定に

MCP ドキュメントに、OAuth 認証の送信先制限が明記された。

Sends MCP OAuth credentials only to a token endpoint served over HTTPS or at localhost , 127.0.0.1 , or ::1 .

(出典 [3])

(訳:MCP の OAuth 認証情報は、HTTPS で提供されるトークンエンドポイント、または localhost・127.0.0.1・::1 にのみ送信されます。)

ローカルネットワーク上の別デバイスなど、localhost 以外のプレーン http:// エンドポイントへのサインインは失敗する。詳細は「Refusing to send credentials to non-https token endpoint」のドキュメントへ誘導されている。

その他の更新

  • BASH_DEFAULT_TIMEOUT_MS を 30 分超に設定した場合、バックグラウンドコマンドのデフォルト上限も同じ値になる(v2.1.285 以降)。
  • BASH_MAX_TIMEOUT_MS を 2 時間超に設定した場合、バックグラウンドコマンドの最大時間上限も同じ値になる(v2.1.285 以降)。
  • CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK を 1 に設定すると、Amazon Bedrock および Google Cloud の Agent Platform でセッション中にモデルアクセスが失われたとき、古いモデルへの自動切り替えを止めてリクエストをそのまま失敗させる(v2.1.285 以降)。
  • CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY を 1 に設定すると、起動時のモデルアクセスチェック結果のキャッシュを無効化できる(v2.1.285 以降)。
  • MCP のツールが組織ポリシーでブロックされている場合、/mcp tool list に「disabled by your organization」と表示され、デスクトップアプリおよび claude.ai チャットでも同じブロックが適用される。
  • Agent SDK フックから HTTP リクエストなどの非同期処理を行えることが明記された。

まとめ

この日の更新で最も影響範囲が広いのは、auto モードのデフォルト化だ。v2.1.283 以降のターミナルセッション、および v2.1.285 以降でフィーチャーフラグを取得できる非対話セッションが対象になる。Agent SDK を使って自動化を組んでいる開発者は、permissionMode の省略が auto を意味するようになった点を確認する必要がある。スキルのフック連携や deny ルールの仕様整備、MCP OAuth の送信先制限といった変更は、それぞれ既存設定の見直しを促す実運用上の指針となっている。

出典

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

[1] https://code.claude.com/docs/en/hooks
[2] https://code.claude.com/docs/en/slash-commands
[3] https://code.claude.com/docs/en/mcp
[4] https://code.claude.com/docs/en/skills
[5] https://code.claude.com/docs/en/env-vars
[6] https://code.claude.com/docs/en/headless
[7] https://code.claude.com/docs/en/permission-modes
[8] https://code.claude.com/docs/en/cli-reference
[9] https://code.claude.com/docs/en/agent-sdk/permissions
[10] https://code.claude.com/docs/en/agent-sdk/hooks

0
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
0
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?