auto-mode-setupが解決する課題

先に答えると、auto-mode-setupは自動操作を許可するスイッチではなく、auto modeを使う前に環境を確認する準備手順です。対象データと権限を分け、fixtureで結果を見てから本番に近い作業へ進めます。

Claude Code公式changelogの2.1.304（2026年10月19日）は、/auto-mode-setupを「プロジェクトと最近のセッションを読み、環境についてauto modeへ教えるguided setup」と説明しています。新しい担当者がリポジトリの構造や直近の作業を把握しないまま自動モードへ進む問題を、開始前の確認に寄せる機能です。

一方、既存のClaude Code Auto modeのserver classifier記事が、server側の判定やfallbackを扱うのに対し、本稿はsetupの準備と運用境界に限定します。setupは権限承認、秘密情報の許可、レビュー責任を代替しません。

setup・auto mode・通常運用の比較

段階目的人間が決めること
通常の確認作業対象と制約を把握読ませる範囲、成果物、担当者
/auto-mode-setupプロジェクトと最近のセッションを環境理解へ反映表示された内容の正確さ、不要情報、変更の有無
auto mode設定された判断境界で作業を進める許可操作、停止条件、レビューとrollback
通常のpermission mode操作ごとの確認と制御危険操作、例外、管理設定の優先順位

Claude Codeの権限設定で扱うallow・ask・denyの設計と、auto modeの選択を混ぜないことが重要です。setupが環境を理解しても、書込みや外部送信を許可する根拠にはなりません。

実行前に確認する7項目

  1. バージョン: claude --versionで2.1.304以降か、更新経路と接続先を記録します。
  2. 対象プロジェクト: worktree、branch、生成物、submoduleを確認し、本番原本で試さない選択肢を残します。
  3. 最近のセッション: 読み取られる可能性のある履歴に顧客情報、秘密情報、未公開計画がないか分類します。
  4. 設定の範囲: user・project・localの設定とmanaged settingsの優先順位を確認します。
  5. 許可操作: Read、Edit、Bash、MCPなどを目的別に分け、auto modeへ一括で渡さない範囲を決めます。
  6. 終了条件: テスト、diff、レビュー、手動承認のどこで止めるかを一文にします。
  7. 復旧: branch、commit、バックアップ、ログの保存先を決めてから開始します。

公式Settingsガイドは設定のscopeと優先順位を説明しています。設定を追加する前に、どのファイルが実効設定になっているかを/configや/statusなどで確認し、個人設定をチーム標準だと誤認しないでください。

安全に試す8手順

  1. 作業用branchまたは一時worktreeを作り、現在のcommitを記録する。
  2. fixtureのプロジェクトでsetupを先に実行し、表示された読み取り対象を確認する。
  3. プロジェクト構造、最近のセッション、ルールのどれが反映されたかをメモする。
  4. 不要な履歴、秘密情報、顧客データが対象になっていないか人間が再確認する。
  5. 自動化する作業を低リスクの読み取り・テストへ限定する。
  6. 初回は実装ではなく計画、diff、テスト結果を出力させる。
  7. 期待した境界と実際のtool呼び出し、拒否、確認を照合する。
  8. 合格なら対象業務を一つだけ広げ、失敗時は通常の確認運用へ戻す。

設定が正しく見えても、実際のtool呼び出しが予定外なら合格にしません。特に外部MCP、ブラウザ、Shell、ファイル書込みは、環境理解と副作用が別の問題です。setupを使った日付、version、対象branch、結果、承認者を記録すると、後で「いつ何を教えたのか」を再現できます。

企業での適用範囲を分ける

2.1.304のchangelogは、auto-mode-setupがBedrock、Vertex、Foundry、Claude apps gateway、telemetry-disabled sessionsでも利用可能になったと記載しています。これは利用経路の対応範囲であり、各契約のデータ保持、組織ポリシー、リージョン、proxy制約が同じになることを意味しません。接続先ごとに、入力がどこへ送られるか、誰が設定を管理するか、ログを何日保持するかを確認します。

既存のmanaged settings診断記事とも接続し、個人が追加した設定が管理設定を上書きできると決めつけないでください。setupは便利な入口ですが、組織の責任分界、データ持ち出し、変更承認を省略する理由にはなりません。

公開前readbackと判断の線引き

公開直前には、正式名称をauto-mode-setupと表記し、対象versionが2.1.304であること、利用経路の対応範囲と自社契約の条件を別々に確認します。最近のセッションを読む機能だからといって、過去の履歴が常に安全な入力になるわけではありません。原本の保存場所、読み取り日、確認者を台帳へ残し、不要な履歴を除外できない場合はsetupを使わず通常の確認へ戻します。

判断の合格条件は、便利に動いたことではなく、対象範囲を説明でき、想定外のtool呼び出しを検知でき、branchを戻せることです。setup後に許可範囲を広げるときも、一度に複数の業務や接続先を変えず、差分とテスト結果を確認してから次へ進めます。

導入チェックリスト

  • 2.1.304以降と接続先を記録した
  • プロジェクトと最近のセッションの機密性を確認した
  • user・project・local・managed settingsの優先順位を確認した
  • auto modeへ渡す操作と渡さない操作を分けた
  • fixtureまたは一時branchで初回試験をした
  • tool呼び出し、拒否、承認、diff、テストを記録した
  • 停止条件とrollback手順を決めた
  • 接続先別の保持・監査・契約条件を確認した

よくある質問

auto-mode-setupは自動で変更を加えますか？

公式changelogはプロジェクトと最近のセッションを読み、auto modeへ環境を教えるguided setupとして説明しています。実行前に表示内容と設定変更を確認し、権限の判断を別に行います。

auto modeを使えば確認なしで安全に動きますか？

いいえ。auto modeの実行可否と安全性を保証する機能ではありません。権限、データ分類、停止条件、レビューを別に設計します。

BedrockやVertexでも使えますか？

2.1.304の公式changelogはBedrock、Vertex、Foundry、Claude apps gateway、telemetry-disabled sessionsでも利用可能になったと記載しています。契約や組織設定は環境ごとに確認してください。

自社の導入手順を整理できますか？

無料診断で対象業務、許可する操作、確認者、停止条件、ログと引き継ぎを整理できます。無料診断（60秒）からご相談ください。

まとめ

auto-mode-setupは、自動運転の前にプロジェクトと最近のセッションを確認し、auto modeへ環境を教えるための入口です。安全性を自動で保証する機能ではないため、データ分類、権限、確認者、停止条件、復旧を先に固定し、低リスクのfixtureから段階的に広げます。Miraigentでは、Claude Codeの機能追加を企業の権限・データ・監査・引き継ぎまで含めて無料で診断します。無料診断（60秒）からご相談ください。