承認ダイアログに「Yes」を押し続けて、気づけば作業より承認のほうが多い。 Claude Codeを長く回していると、誰でも一度はこの状態に陥ります。
auto modeは、その承認を別のAI(分類器)に肩代わりさせる権限モードです。 手元のClaude Code v2.1.310と公式ドキュメントを突き合わせて、仕組み・切り替え方・止められる操作をまとめました。 実務でもプライベートでも毎日Claude Codeを使っている私の設定ファイルと照らし合わせた注意点も入れています。
この記事でわかること
- auto modeの正体と、ほかの5つの権限モードとの違い
- Shift+Tab・起動オプション・設定ファイルでの切り替え方
- 既定でブロックされる操作と、手動承認に戻る条件
- auto modeに入ると効かなくなる許可ルール
- 「unavailable」と出たときやブロックされたときの対処
PARTS LIST /目次
Claude Codeのauto modeとは?分類器が承認を肩代わりするモード
auto modeとは、Claude Codeの操作を実行前に別の分類器モデルが審査し、危険なものだけを止める権限モードです。 読み取りや作業ディレクトリ内の編集はそのまま通り、それ以外のコマンドは分類器が「頼まれた範囲を超えていないか」を判定します。
公式ドキュメントは、分類器が止める対象を3つ挙げています。 頼まれた範囲を超える操作、見知らぬインフラに向かう操作、Claudeが読んだ悪意あるコンテンツに誘導されたように見える操作です。 人間が毎回見ていた部分を、ルールを持った見張り役に任せる発想ですね。
ただし公式も「プロンプトは減るが安全を保証するものではない」と明記しています。 承認の回数を減らすための仕組みと捉えるのが正確です。
6つの権限モードの違いを比較表で整理
Claude Codeの権限モードは6種類あります。 auto modeの立ち位置は、ほかのモードと並べると一番わかりやすくなります。
Claude Codeの権限モード
設定ファイル上の default は画面では「manual mode」と表示され、CLIでは manual という別名でも指定できます。
名前が2つあるので、検索するときは両方で探すと見つかりやすくなります。
bypassPermissionsとの違いは「見張り役」の有無
auto modeとbypassPermissionsは、どちらも確認なしで進む点では同じです。 違いは、実行前に分類器が審査するかどうかにあります。
auto mode
分類器が実行前に審査し、force pushや本番デプロイなどを止める。普段の開発マシンで使う前提。
bypassPermissions
審査なしですべて実行する。公式はネットにつながらないコンテナやVMでだけ使うよう求めている。
bypassPermissionsは、起動時に警告ダイアログへの同意が要ります。 LinuxとmacOSでは、rootやsudoで動かすと拒否されます(認識済みのサンドボックス内を除く)。 自分のMacで普段使いするなら、選択肢はauto modeのほうです。
auto modeへの切り替え方3通り
auto modeには、セッション中に切り替える方法と、起動時や設定で最初から入る方法があります。 v2.1.283以降は、対話型のターミナルとVS Codeのセッションでauto modeが最初から選ばれる既定値になりました。 つまり最近インストールした人は、何もしなくてもauto modeで動いている可能性があります。
画面下のステータス表示に ⏵⏵ auto mode on と出ていれば、いまauto modeです。
まずは表示を見て、自分がどのモードにいるかを確かめるところから始めます。
Shift+Tabでセッション中に切り替える
一番手軽なのはShift+Tabです。 押すたびにモードが一周し、auto modeから押すと最初はdefault(manual)に戻ります。
順番は default → acceptEdits → plan です。 そのあとにbypassPermissions(有効な場合)、最後にauto mode(使える場合)が続きます。 dontAskは循環に出てこないので、使いたいときは起動オプションか設定で指定します。 Planモードのつもりで押しすぎると、そのままauto modeまで進んでしまう順番です。
default(manual)やacceptEditsの最中にBashの承認ダイアログが出たときは、「Yes, and switch to auto mode」を選ぶ手もあります。 そのコマンドを承認しながら、auto modeへ切り替わります。 Planモードの使い方は別記事にまとめています。
--permission-mode autoで起動時に指定する
起動時から入りたいときは --permission-mode を付けます。
-p の非対話実行でも同じ指定が使えます。
claude --permission-mode auto
claude -p "テストを実行して失敗を直して" --permission-mode auto
v2.1.302以降、-p やAgent SDKでモードを指定しないとManualで始まり、承認が要る操作は許可ルールなどが無い限り拒否されます。
スクリプトから無人で回すなら、モードを明示しておくのが安全です。
CLIオプション全体は下の記事で整理しています。
defaultModeで既定のモードを固定する
毎回同じモードで始めたいなら、設定ファイルの permissions.defaultMode に書きます。
{
"permissions": {
"defaultMode": "auto"
}
}
"auto" と "bypassPermissions" は、プロジェクトの設定ファイルに書いても反映されません。対象はリポジトリ内の .claude/settings.json と .claude/settings.local.json です。リポジトリを開いただけで勝手に権限が広がるのを防ぐためです。固定したいときはユーザー設定の ~/.claude/settings.json に書きます。
なおVS Code拡張の claudeCode.initialPermissionMode は auto を受け付けません。
VS Codeではモード表示をクリックして「Auto」を選びます。
auto modeで止められる操作・通る操作
auto modeの判定は、上から順に当てはまったところで決まります。 最初に自分で書いた許可・確認・拒否のルール、次に読み取りと作業ディレクトリ内の編集の自動許可、残りが分類器の審査です。
判定の流れを図にすると、次のようになります。
flowchart TD
A["Claudeが操作を実行しようとする"] --> B{"deny / ask / allow ルールに一致?"}
B -->|"deny"| X["実行しない"]
B -->|"ask"| P["人間に確認"]
B -->|"allow"| OK["実行"]
B -->|"一致なし"| C{"読み取り・作業ディレクトリ内の編集?"}
C -->|"はい"| OK
C -->|"いいえ"| D{"分類器の審査"}
D -->|"安全"| OK
D -->|"危険"| E["ブロックして理由をClaudeに返す"]
ブロックされたとき、Claudeはその理由を受け取って別のやり方を探します。 いきなり作業が止まるわけではない点が、手動承認との大きな違いです。
既定でブロックされる操作
既定のルールで止まる代表例は次のとおりです(公式ドキュメントの例から抜粋)。
curl | bashのようにダウンロードしたコードをそのまま実行する- 機密データを外部のエンドポイントへ送る
- 本番環境へのデプロイやマイグレーション
- force push、
git reset --hard、git clean -fd、git stash dropなど terraform destroyなどのインフラ削除- 人間が承認していないプルリクエストのマージや、CIチェックの無効化
git remote set-urlなどでpush先を変える(自分で新しいリモートを指定した場合を除く)
共通しているのは「取り返しがつかない」か「外に出ていく」操作です。 ローカルで完結して元に戻せる作業は、基本的に審査を通ります。
既定で許可される操作
逆に、既定で通る操作の例も公式に載っています。
- 作業ディレクトリ内のファイル操作
- ロックファイルやマニフェストに書かれた依存パッケージのインストール
.envを読み、対応するAPIへ認証情報を送る- 読み取りだけのHTTPリクエスト
- 作業中のリポジトリへのpush(
productionやgh-pagesのような公開用の名前のブランチを除く)
意外なのはpushです。 既定のブランチへのpushもプルリクエストの作成も通るので、「pushの前に自分で見たい」人は後述のaskルールを足しておく必要があります。
3回連続・合計20回で手動承認に戻る
分類器が3回連続、またはセッション内で合計20回ブロックすると、auto modeは一時停止して手動の承認に戻ります。 確認された操作を承認すると、auto modeが再開します。
この回数は設定で変えられません。
合計の回数はセッション中ずっと数えられ、上限に達して手動に戻ったときだけリセットされます。
-p の実行で上限に達した場合、その操作は実行されず、Claudeは作業を続けます。
auto modeに入ると効かなくなる許可ルール
auto modeに切り替えた瞬間、自分で書いた許可ルールの一部が外されます。 任意のコードを実行できてしまう広いルールを残すと、分類器の審査を素通りできてしまうためです。
公式ドキュメントで対象になっているのは次のルールです。
Bash(*)やPowerShell(*)のような全許可Bash(python*)のようにワイルドカードを付けたインタプリタBash(timeout *)のように、ラッパーコマンドのあとがワイルドカードだけのルールBash(* --version)のように、ワイルドカードで始まるルール- パッケージマネージャーのrunコマンド
AgentとMonitorの許可ルール
Bash(npm test) のような狭いルールは、そのまま残ります。
外されたルールは、auto modeを抜けると元に戻ります。
狭いルールも分類器を通したいときは、autoMode.classifyAllShell を true にすると、auto mode中はBashとPowerShellの許可ルールがすべて止まります。
そのぶん、許可ルールだけで通っていたコマンドも分類器の判定を待つので、少し遅くなります。
Bash(*)の全許可は外される
私の ~/.claude/settings.json と照らし合わせると、許可ルール7本のうち先頭が Bash(*) で、defaultModeは書いていません。
v2.1.310ならauto modeで始まるので、この Bash(*) はauto mode中は外されている計算です。

承認が減っているのは許可ルールのおかげとは限らない。auto mode中は、分類器が通しているぶんも混ざっています。
逆に、Manualやaccept editsへ切り替えた瞬間に Bash(*) が復活します。
モードによって同じ設定ファイルの意味が変わるので、広い許可ルールは消しておくほうが挙動を読みやすくなります。
denyとaskのルールは今までどおり効く
一方で、拒否(deny)と確認(ask)のルールはauto modeでも分類器より先に効きます。 denyはbypassPermissionsでも止まる、一番強い壁です。
Claude CodeにMacの容量調査を頼み、空きを6.6GBから29GBまで戻したときの話です。キャッシュの削除はClaude Codeが進めてくれましたが、rm -rfは権限で拒否され、最後は私がターミナルで実行しました。設定ファイルを見ると、deny側に rm -rf 系のルールが9本並んでいます。消す操作だけは人間が打つ、という線引きは、モードが変わっても残しておきたいところです。
pushの前に確認を挟みたいなら、askに書きます。
{
"permissions": {
"ask": [
"Bash(git push *)",
"Bash(gh pr create *)"
]
}
}
ただし git -C <dir> push のように書き方を変えたコマンドはこのルールに当たりません。
確実に止めたい場合は、コマンド全体を調べるPreToolUseフックを併用します。
autoModeブロックで分類器に環境を教える
分類器は既定で、作業ディレクトリと、そのリポジトリに設定されたリモートだけを「内側」として扱います。
会社のGitHub組織へのpushやチームのクラウドバケットへの書き込みが止まるのは、分類器が組織のリポジトリやバケットを外部だと判断するからです。
信頼できる場所を教えるのが、設定ファイルの autoMode ブロックです。
ブロックには4つの欄があり、どれも正規表現ではなく、新人エンジニアに説明するような文章で書きます。
autoModeブロックの4つの欄
environmentに信頼する場所を書く
ほとんどの場合、設定が必要なのはenvironmentだけです。
"$defaults" を配列に入れておくと、既定の内容を残したまま自分の行を足せます。
{
"autoMode": {
"environment": [
"$defaults",
"Source control: github.com/your-org and all repos under it",
"Trusted internal domains: api.example.com"
]
}
}
"$defaults" を入れずにsoft_denyやhard_denyを書くと、その欄の既定ルールがまるごと置き換わります。force pushや curl | bash の既定の歯止めまで消えるので、自分で全部書き直すつもりがない限り必ず入れておきます。
自分で書くのが面倒なら、/auto-mode-setup を実行すると、プロジェクトの設定や最近のセッションのコマンドから下書きを作ってくれます。
受け入れると ~/.claude/settings.json に書き込まれます。
保存したあとは、auto modeで無視される Bash(*) のような許可ルールを消すかも聞いてくれます。
claude auto-modeコマンドで設定を確かめる
設定が効いているかは、ターミナルの claude auto-mode サブコマンドで確かめられます。
v2.1.310で --help を表示すると、次の5つが並んでいました。
設定を書いたら、まず config で自分の行が入っているかを見るのが早道です。
セッション内なら /permissions の「Auto mode」タブでも確認・編集できます。
プロジェクトの設定ファイルには書けない
分類器が autoMode を読むのは、ユーザー設定(~/.claude/settings.json)・管理者の管理設定・--settings フラグの3か所だけです。
リポジトリ内の .claude/settings.json と .claude/settings.local.json に書いても読まれません。
理由は、リポジトリに混ぜ込まれた設定で許可ルールを勝手に増やされるのを防ぐためです。 一方でCLAUDE.mdは分類器も読むので、「force pushしない」のようなプロジェクトの決まりはCLAUDE.mdに書けば両方に効きます。
auto modeが使えない・ブロックされたときの対処
auto modeまわりのつまずきは、「そもそも選べない」と「途中で止められた」の2つに分かれます。
前者は条件の確認、後者は /permissions の画面で解決できることがほとんどです。
順に見ていきます。
「unavailable」と出るときの確認ポイント
auto modeが使えないと表示されたら、次の条件を上から確認します。
- プラン:すべてのプランで利用可。TeamとEnterpriseは管理者が無効にできる
- モデル:Anthropic APIならOpus 4.6以降・Sonnet 4.6以降・Haiku 5.5などが必要。Amazon BedrockやMicrosoft Foundryなどでは、Sonnet 5以降・Opus 4.7以降・Haiku 5.5などが条件。Sonnet 4.5・Opus 4.5・Haiku 4.5はどこでも非対応
- 設定:どこかの設定ファイルで
permissions.disableAutoModeが"disable"になっていないか - セッション:サーバー側で一度オフになったセッションは、終わるまでオフのまま
最後の項目は見落としがちです。
条件を直しても同じセッションでは戻らないので、新しいセッションを立ち上げてから試します。
auto modeを選んでいても使えない状態だと、セッションはManualで始まります。
古い記事にある claude --enable-auto-mode は初期のプレビュー時の手順で、いまはShift+Tabか --permission-mode auto で入ります。
ブロックされた操作を/permissionsで再実行する
ブロックされると bash blocked by auto mode のような通知が出ます。
角かっこ内の [Data Exfiltration] などは、当てはまったルールの名前です。
step
1/permissionsを開いて「Recently blocked」タブを選ぶ
ブロックされた操作が一覧で並びます。
step
2行を選んでコマンドの中身を確かめる
行の説明文ではなく、下に表示される実際のコマンドを見て判断します。
step
3rキーで承認し、Escで閉じる
Claudeがその操作をやり直します。 承認しても許可ルールは増えないので、毎回通したい操作はallowかenvironmentに足します。
一度きりの操作なら、次のメッセージで「このブランチをforce pushして」のように具体的に頼む手もあります。 公式は「リポジトリを片付けて」のような曖昧な依頼ではforce pushの許可にならないと説明しています。
よくある質問
Q1. Claude Codeのauto modeは無料プランでも使える?
すべてのプランで利用できます。 ただし対応モデル(Anthropic APIならSonnet 4.6以降など)が条件で、TeamとEnterpriseでは管理者が無効にしている場合があります。 BedrockやFoundryなど、Anthropic API以外では対応モデルの条件が少し厳しくなります。
Q2. auto modeとbypassPermissionsはどっちを使えばいい?
普段の開発マシンならauto modeです。 bypassPermissionsは審査なしですべて実行するため、公式はネットにつながらないコンテナやVMでの利用に限るよう求めています。
Q3. auto modeをオフにして手動承認に戻すには?
Shift+Tabを押すと、auto modeからはまずdefault(manual)に戻ります。
毎回手動で始めたいなら、~/.claude/settings.json の permissions.defaultMode に "default" を書きます。
Q4. auto modeはVS Codeでも使える?
使えます。
モード表示をクリックして「Auto」を選びます。
claudeCode.initialPermissionMode の設定値には auto を指定できない点に注意してください。
Q5. auto modeのブロック回数の上限は変えられる?
変えられません。 3回連続か合計20回ブロックされると手動承認に戻る仕様は固定です。 同じ操作が何度も止まるなら、environmentに信頼する場所を足すほうが根本的な対処になります。
Q6. 分類器にはどのモデルが使われている?
既定はClaude Sonnet 5です(セッションがSonnet 4.6で動いているときはSonnet 4.6)。
v2.1.302以降は、環境変数 CLAUDE_CODE_AUTO_MODE_MODEL でモデルIDを指定して変えられます。
ただし変わるのはClaude Code側から送る審査だけで、/status の「Auto mode server」がEnabledのときのサーバー側の審査には効きません。
auto modeは「承認を減らす」ための見張り役
auto modeは、承認ダイアログを押す回数を減らす代わりに、分類器という見張り役を置く権限モードです。 v2.1.283以降は対話型セッションの既定値なので、知らないうちに使っている人も多いはずです。
【要点まとめ】
- 切り替えはShift+Tab・
--permission-mode auto・ユーザー設定のdefaultMode - force push・本番デプロイ・外部への送信などは既定で止まる
- 3回連続か合計20回ブロックで手動承認に戻る
Bash(*)などの広い許可ルールはauto mode中は外される- 信頼する場所は
~/.claude/settings.jsonのautoMode.environmentに書く
見落としやすいのは、モードが変われば同じ設定ファイルの意味も変わる点です。
便利さに乗っかる前に、一度だけ自分の設定を claude auto-mode config で眺めておくと、止められたときに慌てずに済みます。
ほかの設定まわりは、おすすめ設定の記事にまとめています。
あわせて ~/.claude/settings.json の allow に Bash(*) が残っていないかも確かめておきます。
続きを追う:X(@Tom_Java_Tech) / RSS
途中経過は、また書きます。

