Claude CodeAnthropic の機能

FEATURE

Auto mode (オートモード)

Auto mode (オートモード) は、Claude Code が定型的な権限確認 (permission prompt) を挟まずに作業を実行できるモードです。

提供中公式発表と照合済み
初出未調査
ページ更新
提供状態提供中
公式の記載で確認できた環境ターミナル、IDE 拡張、クラウド基盤経由
提供を確認できたプランMax
目次 CONTENTS
  1. できること
  2. 機能解説
  3. 使い方
  4. 利用シーン
  5. ChatGPT・OpenAI の対応する機能
  6. これまでの変更
  7. 関連する機能
  8. 出典
CAN DO

できること

POINT 01

権限確認なしで実行

定型的な権限確認で止まらずに、Claude が作業を実行できます。各操作は実行前に別の分類器モデルが審査します。

POINT 02

会話で境界を指定

「don't push」のように会話で伝えた境界は、既定ルールが許可する操作でも分類器がブロックします。ブロックされた操作を許可すると伝えると、分類器はそれを承認として扱い、ブロックを解除する場合があります。

POINT 03

分類器ルールの調整

/permissions の Auto mode タブで分類器ルールを表示・編集できます。autoMode.allow などに "$defaults" を含めると組み込みリストを残したままカスタムルールを追加でき、settings.autoMode.hard_deny で無条件にブロックするルールも設定できます。

GUIDE

機能解説

概要

実行前の操作は別の分類器モデルが審査し、依頼の範囲を超える操作、認識していないインフラを対象とする操作、Claude が読んだ悪意あるコンテンツに誘導されたとみられる操作をブロックします。権限確認を減らす仕組みであり、安全性を保証するものではありません。

auto mode では、確認のための質問で止まらずに作業を続けるよう Claude が促されます。ただし、プロンプトやスキルが質問を明示的に前提にしている場合は質問します。

分類器の判断の前提は次のとおりです。

  • セッション開始時の作業ディレクトリと、そこに設定されたリモートを信頼します。
  • curl | bash のようなコードのダウンロードと実行は、既定でブロックします。
  • auto mode に入ると、任意のコード実行を許す広い allow ルールを外し、auto mode を抜けると元に戻します。
  • Claude Code 自身の分類器リクエストからはツールの結果を除くため、ファイルや Web ページの悪意あるコンテンツが分類器を直接操作することはできません。
  • サブエージェントの起動前に委任するタスクの説明を評価し、危険に見えるタスクは起動の時点でブロックします。

既定のルール一覧は claude auto-mode defaults で JSON として出力できます。

ブロックされたときの動き

操作がブロックされると、Claude Code は通知を表示し、その操作を /permissions の Recently blocked (最近ブロックされたもの) タブに一覧します。ここで操作を承認すると、Claude は再試行できます。

分類器が 3 回連続、または合計 20 回ブロックすると auto mode は一時停止し、Claude Code は権限確認の表示に戻ります。分類器が操作を評価できない場合、エラーには再試行・/compact・--debug での実行といったヒントが含まれます。

分類器の拒否後に発火する PermissionDenied フックもあり、{retry: true} を返すと、モデルに再試行できることを伝えられます。

分類器の実行場所とモデル

auto mode では、Claude Code が自前の分類器リクエストを送る代わりに、セッションのモデルリクエストの一部としてサーバーに操作の審査を求める場合があります。サーバーが審査する場合はその判定で決まり、判定が返らない操作は審査なしで実行せずに拒否します。

  • Claude API と Enterprise のユーザー、ゲートウェイでは、分類器のオーバーヘッドを課金しないサーバー側分類器が既定です。テレメトリ無効時の Anthropic API 直接接続でも、サーバー側分類器が既定です。
  • Bedrock・Vertex・Foundry では当面ローカル分類器が既定で、CLAUDE_CODE_AUTO_MODE_SERVER=1 でプラットフォームのサーバー側分類器を使えます。
  • サーバーに問い合わせず、常に Claude Code 自身の分類器リクエストを使うには CLAUDE_CODE_AUTO_MODE_SERVER=0 を設定します。
  • /status の Auto mode server 行で、そのセッションの分類器がサーバーで動くかを確認できます。

分類器リクエストの既定のモデルは Claude Sonnet 5 です。CLAUDE_CODE_AUTO_MODE_MODEL に完全なモデル ID を設定するとクライアント側分類器のモデルを変えられますが、サーバー側 auto mode のモデルは変わりません。課金される分類器リクエストにフォールバックしたときは、VS Code と JetBrains のパネルに Continue/Stop の確認が表示されます。

管理者・導入時に確認したい点

  • claude -p や Agent SDK の実行を auto mode で始めるには、claude -p に --permission-mode auto を渡すか、TypeScript では permissionMode: "auto"、Python では permission_mode="auto" を指定します。
  • 権限モード未設定の対話型ターミナルと VS Code のセッションは、すべてのプランとプロバイダーで auto mode で始まります。permissions.defaultMode を設定すると、そちらが優先されます。
  • defaultMode の auto は .claude/settings.json や .claude/settings.local.json からは効かないため、~/.claude/settings.json に移します。autoMode の設定も、リポジトリ内の .claude/settings.local.json からは読まれません。
  • 管理設定で disableAutoMode を "disable" にすると、Shift+Tab の切り替えから auto が外れ、--permission-mode auto で始めたセッションも Manual で始まります。
  • 定型的な操作がブロックされる場合、管理者は autoMode.environment で信頼するリポジトリ、バケット、サービスを追加できます。/auto-mode-setup は、プロジェクトと最近のセッションを読んで環境を auto mode に学習させるガイド付きセットアップです。
  • auto mode のまま push やプルリクエストのコマンドの前に人の確認を挟むには、permissions.ask ルールを追加します。
  • blockReadsOutsideWorkingDirectories がオフの間は、作業ディレクトリ外のパスに Read・Grep・Glob ツールを初めて使うときに、読み取りを許可するか確認します。
  • autoMode.classifyAllShell を使うと、任意のコード実行のパターンだけでなく、すべての Bash/PowerShell コマンドを分類器に通せます。
  • 設定を既定に戻すには claude auto-mode reset を使います (確認を省くには --yes を付けます)。
HOW TO USE

使い方

ここでは、auto mode のセッションを起動し、分類器が使ったモデルを確認する手順を示します。

  1. claude --permission-mode auto --debug-file classifier-debug.log を実行し、デバッグファイル付きで auto mode のセッションを開始します。
  2. 分類器に審査させる操作として Claude に curl https://example.com を実行させ、ログで classifier_request_started を検索します。
公式ヘルプを開く ↗
USE CASES

利用シーン

CASE 01

定型的な権限確認を挟まずに、Claude にコーディング作業を続けさせたい場面に使えます。

CASE 02

claude -p や Agent SDK による非対話の実行を、分類器の審査付きで動かす場面に使えます。

CASE 03

組織として信頼するリポジトリやサービスを autoMode.environment に登録し、分類器の判断の前提をそろえる場面に向いています。

CASE 04

push やプルリクエストの作成の前だけ人の確認を挟みたい場面に、permissions.ask ルールと組み合わせて使えます。

COMPARISON

ChatGPT・OpenAI の対応する機能

比較の単位となる業務: コーディングエージェントの操作権限の自動判定・承認

Codex の Automatic approval reviews (自動承認レビュー (Guardian)) は、対象となる承認プロンプトを、リクエストの実行前に自動レビュー担当エージェントに回せます。Auto mode も、実行前の操作を別の分類器モデルが審査します。

結果の見せ方として、Codex アプリは設定されている場合にレビューの状態とリスクレベルを含む自動レビュー項目を表示し、承認・拒否・停止・タイムアウトのどれになったかを確認できます。Auto mode は、ブロックした操作の通知を表示し、/permissions の Recently blocked タブに一覧して、そこで承認できます。

フックとの連携では、Codex は権限フックで厳格な自動レビューのリクエストを解決できます。Auto mode には、分類器の拒否後に発火する PermissionDenied フックがあります。

TIMELINE

これまでの変更

  1. /auto-mode-setup が Bedrock・Vertex・Foundry、Claude apps gateway、テレメトリ無効のセッションでも使えるようになりました。

  2. CLAUDE_CODE_AUTO_MODE_MODEL が加わりました。

  3. 権限モード未設定の対話型ターミナルと VS Code のセッションが auto mode で始まるようになりました。

  4. テレメトリ無効時の Anthropic API 直接接続でもサーバー側分類器が既定になり、VS Code と JetBrains に Continue/Stop の確認が加わりました。

  5. サーバー側分類器の既定化と、/status の Auto mode server 行が加わりました。

  6. クラウドのメタデータ認証情報の取得、egress の回避、テナントをまたぐアクセスを、環境が想定済みとしない限り自動承認しない Containment Escape ルールが加わりました。

  7. /permissions に Auto mode タブが加わりました。

  8. Bedrock・Vertex AI・Foundry やテレメトリ無効時も、重大度スコア付き分類を含め Claude API と同じ既定を使うようになりました。

  9. Pro・Max・Team プランの初回利用通知から、コストがやや高くなるという古い注記が削除されました。

  10. SendMessage で他のエージェントセッションに送るメッセージを、送信前に分類器で評価するようになりました。

  11. 外部セッションの分類器が既定で Sonnet 5 を使うようになり、claude auto-mode reset が加わりました。

  12. Bedrock・Vertex AI・Foundry でオプトインなしに使えるようになり、disableAutoMode で無効化できます。.claude/settings.local.json から autoMode を読まなくなりました。

  13. autoMode.classifyAllShell が加わりました。

  14. サブエージェントの起動前の評価と、ローカル作業の破棄を求めていない場合の破壊的 git コマンド (git reset --hard など) のブロックが加わりました。

  15. オプトインの同意が不要になり、リポジトリ内容の一括転送などデータ持ち出しの検出が改善されました。VS Code ではモードピッカーへの表示に bypass-permissions 設定が不要になり、Bedrock・Vertex・Foundry で Opus 4.7 と Opus 4.8 向けに CLAUDE_CODE_ENABLE_AUTO_MODE=1 で使えるようになりました。

  16. 評価できない場合のエラーにヒントが付き、settings.autoMode.hard_deny が加わりました。

  17. "$defaults" によるカスタムルールの追加と、オプトイン確認の「Don't ask again」が加わりました。

  18. Opus 4.7 使用時に Max サブスクライバーが使えるようになり、--enable-auto-mode が不要になりました。

  19. auto mode と bypass-permissions mode で、サンドボックスのネットワークアクセス確認を自動承認するようになりました。

  20. 分類器の拒否後に発火する PermissionDenied フックが加わり、拒否されたコマンドの通知と /permissions からの再試行に対応しました。

SOURCES

出典

出典 23 件を表示