Claude Code Auto Modeとは｜設定方法・安全性と権限の違い
Claude Codeの確認プロンプトを減らしたいものの、--dangerously-skip-permissionsは怖い——そんな開発者向けに、Auto Modeの役割を整理します。使えるプランとモデル、Shift+Tabでの切り替え、永続設定、安全な境界の作り方まで、現行の公式仕様に沿って確認します。
Claude Code Auto Modeは、別の分類器が各操作を事前評価し、危険・不可逆・信頼境界外の操作を止めながら確認回数を減らす権限モード。Manualや権限バイパスとの違いを理解し、ask・denyルールを重ねれば、長時間タスクを安全寄りに自動実行できる。
目次 (9)
Claude Code Auto Modeとは
Auto Modeは、Claude Codeがファイル編集、シェルコマンド、ネットワークアクセスなどを行う前に、別の分類器が操作内容を評価する権限モードです。安全と判断された日常的な操作は確認なしで進み、依頼範囲を超える操作、不可逆・破壊的な操作、信頼されていない宛先へのアクセスはブロックされます。
Manualより確認を減らし、権限バイパスより保護を残す中間的な選択肢です。Anthropicの権限モード公式ドキュメントは、長時間タスクや「プロンプト疲れ」の軽減に向く一方、安全性を保証せず、機密操作の人間レビューを置き換えないと説明しています。
Auto Modeの仕組み
ツールが呼び出されると、通常の権限ルール、その後に分類器の順で判定されます。permissions.denyは分類器より前に拒否し、permissions.askはAuto Mode中でも確認を表示します。それ以外を分類器が評価します。
主な評価点は、依頼範囲からの逸脱、未知のインフラ、読み込んだ悪意ある内容からの誘導です。デフォルトの信頼範囲は作業ディレクトリと開始時のリポジトリリモートで、社内APIやクラウドバケットは明示しないと外部扱いになる場合があります。
同じ操作が3回連続、または1セッションで合計20回ブロックされると、一時的に確認プロンプトへ戻り、承認後に再開します。
利用できるプラン・モデル・環境
2026年7月時点ではすべてのプランが対象ですが、TeamとEnterpriseは組織の所有者による有効化が必要です。
モデル条件は接続先で異なります。Anthropic APIではOpus 4.6以降またはSonnet 4.6以降が対象です。Bedrock、Google Cloud、Microsoft Foundryなどは対応モデルが別に定められ、古いSonnet 4.5、Opus 4.5、Haiku、Claude 3系は対象外です。
一時期必要だったCLAUDE_CODE_ENABLE_AUTO_MODE=1はv2.1.207で不要になりました。対応モデルは変わり得るため、導入時は公式ページを再確認してください。
Auto Modeを有効化する手順
claude --versionでClaude Codeのバージョンを確認し、古ければ公式の方法で更新します。- 対応モデルを選び、Team・Enterpriseでは所有者による有効化も確認します。
- Claude Codeを起動し、
Shift+Tabで権限モードを切り替えてautoを選びます。autoが表示されない場合は、プラン、モデル、組織設定を見直します。 - 起動時からAuto Modeにする場合は、
claude --permission-mode autoを実行します。 - 常にAuto Modeから始める場合だけ、ユーザー設定の
~/.claude/settings.jsonに次を追加します。
{
"permissions": {
"defaultMode": "auto"
}
}
リポジトリ内の.claude/settings.jsonや.claude/settings.local.jsonに書いたautoは、リポジトリ自身による権限付与を防ぐため無視されます。永続設定はユーザー設定または組織の管理設定に置きます。
Manual・Plan・権限バイパスとの違い
| モード | 確認なしで進む範囲 | 向く場面 |
|---|---|---|
Manual（設定値はdefault） |
読み取り中心 | 初見のリポジトリ、認証・課金・本番関連 |
acceptEdits |
読み取り、編集、一般的なファイル操作 | 差分を後からまとめてレビューする作業 |
plan |
読み取りと計画 | 実装前の調査、設計、大規模変更の整理 |
auto |
分類器の安全チェックを通過した操作 | 長時間のテスト、修正、反復作業 |
dontAsk |
事前許可済みの操作だけ | 制限されたCIやスクリプト |
bypassPermissions |
ほぼすべて | 隔離されたコンテナやVMのみ |
Plan Modeは編集前の調査、Auto Modeは安全チェック付きの実行に使います。変更範囲が曖昧なら、先にClaude Code Plan Modeの使い方で計画し、合意後に切り替えます。権限バイパスにはAuto Mode相当の保護がないため、日常のローカル環境には不向きです。
デフォルトで止まる操作と限界
Auto Modeでは、ルートやホームを対象にした削除、force push、未知の宛先へのデータ送信、安全チェックを迂回する操作などが止まります。一方、通常のpushや依頼に沿ったPull Request作成は通る場合があるため、公開前に人が見る運用には追加ルールが必要です。
分類器には誤検知と見逃しがあり得ます。秘密情報、本番データ、課金を伴う操作は無監視にせず、Auto Mode設定リファレンスに沿って信頼先と通常の権限ルールを設定します。
検索上位のQiitaの解説とZennの解説も仕組みの理解に役立ちますが、対象プランや有効化フラグは更新されているため、利用条件は公式を優先してください。
ask・deny・信頼境界を設定する
permissions.askにBash(git push *)やBash(gh pr create *)を追加し、公開前の確認を残します。permissions.denyに絶対実行させない操作を追加します。denyは分類器や会話上の指示より先に評価されます。autoMode.environmentに、信頼するソース管理組織、社内ドメイン、クラウドバケットを自然言語で記述します。claude auto-mode configで実際に読み込まれた設定を確認します。- 小さなテスト用リポジトリで、許可した操作と止めたい操作の両方を試してから対象を広げます。
例として、ユーザー設定には次のように境界を記述できます。
{
"permissions": {
"defaultMode": "auto",
"ask": [
"Bash(git push *)",
"Bash(gh pr create *)"
]
},
"autoMode": {
"environment": [
"$defaults",
"Source control: github.example.com/example-org and all repositories under it",
"Trusted internal domains: *.internal.example.com"
]
}
}
environmentは正規表現ではなく自然言語です。最初はソース管理組織と検証用サービスだけに絞り、必要な宛先を記録しながら追加します。
Auto Modeが向く作業・向かない作業
向くのは、テスト失敗の修正、型エラーの反復解消、限定範囲のリファクタリング、ドキュメント整備など、ゴールと対象が明確な作業です。テストコマンドや期待出力も渡します。
本番デプロイ、データベース移行、秘密情報、課金を伴う変更、広範囲の削除には向きません。Manualで確認するか、Plan Modeで変更内容を固めてから進めます。
最初は「1リポジトリだけ」「外部送信なし」のように限定し、確認回数とブロック内容を見て対象を広げます。
Auto Modeが表示されない・止まり続けるとき
autoが表示されない場合は、次の順に確認します。
- Claude Codeを最新版へ更新します。
- 現在のモデルが接続先の対応モデルか確認します。
- Team・Enterpriseでは所有者がAuto Modeを有効にしているか確認します。
- 管理設定の
permissions.disableAutoModeが"disable"になっていないか確認します。 defaultModeを永続化する場合、設定先がリポジトリ内ではなく~/.claude/settings.jsonか確認します。
止まり続ける場合は、claude auto-mode configで信頼境界を確認します。社内リポジトリや検証用バケットが未知の宛先ならautoMode.environmentへ狭く追加し、広範な許可は避けます。
