Claude Codeの自動承認オフ — auto modeからmanual modeに戻す手順
Claude Codeの自動承認(auto mode)をオフにして、manual modeに戻す手順です。今のセッションだけ戻す方法、次回以降も手動で始める設定、auto modeを選択肢から消す設定を、効く範囲で分けて扱います。
Claude Codeの自動承認(auto mode)をオフにしてmanual modeに戻す方法は2通りです。Shift+Tabで今のセッションだけ手動へ切り替えるか、settings.jsonのpermissions.defaultModeを"default"にして次回以降も手動で始めます。auto modeそのものを選べなくしたいなら、disableAutoModeという別の設定があります。3つは効く範囲が違うので、どこまで止めたいかで選びます。
なぜ、いつの間にかauto modeで始まるのか
v2.1.283以降のClaude Codeは、ターミナルでもVS Code拡張でも、設定が無ければauto modeで新規セッションを始めます。それより前のバージョンでは、Pro・Max・Teamプランで機能フラグを取得できたセッションだけがauto modeで始まり、それ以外はManualでした。背景と対象条件はauto mode既定化で確認したい設定にあります。
版番号には食い違いがあります。permission-modesページは「v2.1.283以降」と書いていますが、changelogでは全プラン・全プロバイダーへの拡大がv2.1.284(9月28日)の項目に載っています。v2.1.283の項目は、サードパーティプロバイダーとテレメトリーオフの対話セッションの変更です。
始まり方は、実行の仕方によっても変わります。
| 実行の仕方 | 何も設定しないときの開始モード |
|---|---|
| ターミナル・VS Code拡張(v2.1.283以降) | 何も設定しないときの開始モードauto |
claude -p・Agent SDK(通常の環境) | 何も設定しないときの開始モードdefault(Manual) |
claude -p・Python版Agent SDK(サードパーティプロバイダーかテレメトリーオフ、v2.1.285以降) | 何も設定しないときの開始モードauto |
どこかの設定ファイルにdisableAutoModeがある | 何も設定しないときの開始モードdefault(Manual) |
claude -pとPython版Agent SDKのauto開始は、v2.1.285(9月29日)のchangelogにある変更です。permission-modesページの記述はまだ更新されておらず、changelogが先行しています。--permission-modeを付ければ、この開始モードより優先されます。
auto modeを選べない状況(非対応のモデル、Anthropic側の一時的な無効化など)でも、セッションはエラーなくManualで始まります。インストールやアップグレード後の最初のセッションだけは、機能フラグが届く前に開始モードが決まるため、表と違うモードで始まることがあります。
「自動承認」と呼ばれる挙動には、ほかにacceptEdits(ファイル編集などを自動承認)とbypassPermissions(確認をすべて飛ばす)があります。bypassPermissionsは--dangerously-skip-permissionsなどで明示的に有効化しない限りShift+Tabの巡回に出てこないので、意図せずオンになっている心配はありません。この記事の対象は、すべての操作を確認するManual(default)へ戻す手順です。
実機で見るManualモードの指定方法
v2.1.285でclaude --helpを実行すると、--permission-modeの行は次のように出ます。
--permission-mode <mode> Permission mode to use for the session
(choices: "acceptEdits", "auto",
"bypassPermissions", "manual",
"dontAsk", "plan")選択肢に並ぶのはmanualで、設定値のdefaultは載っていません。それでもclaude --permission-mode default --versionは通り、--permission-mode bogusのような存在しない値だけが次のエラーで弾かれます。
error: option '--permission-mode <mode>' argument 'bogus' is invalid.
Allowed choices are acceptEdits, auto, bypassPermissions, manual, dontAsk, plan.つまりフラグにはdefaultとmanualのどちらを書いても同じ意味で通ります。ヘルプ表示に合わせてmanualと書くほうが、あとで読んだ人に意図が伝わります。manualの別名はv2.1.200以降で使えるため、それ以前のバージョンではdefaultと書きます。
今のセッションだけ手動に戻す
一番手早いのはShift+Tabでモードを切り替える方法です。
auto modeから手動へ戻す
- 1
Shift+Tabを1回押す
autoから押すと、最初の1回でdefault(Manual)になります。そこからさらに押すとacceptEdits→plan→defaultの順に巡回します。 - 2
ステータスバーで確認する
⏸ manual mode onと灰色で出ていれば切り替え完了です。⏵⏵ auto mode onのままなら、押した回数が足りていません。 - 3
起動時から手動にしたいときはフラグで指定する
claude --permission-mode manualで、そのセッションだけManualで始まります。次にclaudeを実行すれば、また既定のモードに戻ります。
手動のまま作業していて、Bashコマンドの許可プロンプトに「Yes, and switch to auto mode」という選択肢が出ることがあります。これを選ぶとコマンドを承認したうえでセッションがauto modeへ切り替わります(v2.1.247以降、auto modeが使える状況のManualとacceptEditsで表示)。誤って選ぶと手動に戻した意味がなくなるので、選択肢を読んでから押します。askルールやフックで強制されたプロンプトには、この選択肢は付きません。
次回以降も手動で始める
permissions.defaultModeに"default"(v2.1.200以降は"manual"も可)を書くと、その設定が届く範囲のセッションがManualで始まります。書く場所で範囲が変わります。
defaultModeを書く場所と効く範囲
~/.claude/settings.json
この端末で始めるターミナルのセッションすべてに効きます。
プロジェクトの.claude/settings.json
そのプロジェクトのターミナルセッションに効き、チームで共有できます。
管理設定(managed settings)
組織のターミナルセッションの開始モードになります。
個人の端末で常に手動から始めたいなら、~/.claude/settings.jsonに次のように書きます。
{
"permissions": {
"defaultMode": "default"
}
}"default"は、プロジェクトの.claude/settings.jsonや.claude/settings.local.jsonに書いても反映されます。逆にこの2つのファイルで無効になる値が2つあります。"auto"と"bypassPermissions"です。"bypassPermissions"を書くとセッションはManualで始まり、"auto"を書くとその値は捨てられ、~/.claude/settings.jsonに書いたdefaultModeまで飛ばして組み込みの既定値(v2.1.283以降ならauto)が使われます。auto modeを既定にしたいのに手動で始まる場合の原因もここにあり、書き先を~/.claude/settings.jsonに移せば解消します。
~/.claude/settings.jsonにauto以外のdefaultModeをすでに書き、ほかの設定ファイルにはdefaultModeがないとします。Pro・Max・Teamでは、この場合に起動時に一度だけauto modeへ変更するか尋ねられます。v2.1.285以降は、サードパーティプロバイダーとテレメトリーオフの環境でも尋ねられます。断れば設定はそのまま残り、以降のセッションで再び聞かれることはありません。
auto modeを選べなくする
defaultModeでは、auto modeへの切り替えそのものは塞げません。塞ぐのがdisableAutoModeです。管理設定で配ったときの挙動や、読めない値の扱いはClaude CodeのdisableAutoMode設定で扱っています。
defaultModeとdisableAutoModeの違い
defaultModeをdefaultにする
新規セッションがManualで始まるだけです。利用者はShift+Tabでも--permission-mode autoでもauto modeへ切り替えられます。
disableAutoModeを設定する
autoがShift+Tabの巡回から消えます。--permission-mode autoや設定ファイルのauto、組み込みの既定値でautoが選ばれても、セッションはManualで始まります。
書き方は次のとおりです。
{
"permissions": {
"disableAutoMode": "disable"
}
}公式の設定リファレンスでは、この設定の書き先は「どのファイルでもよい」と定められています。管理者向けの設定に見えますが、自分の~/.claude/settings.jsonに書けば、個人の端末でauto modeを消せます。管理設定に書いた場合は、利用者が上書きできない点が違います。管理設定側から届いた場合は、すでにauto modeで動いているセッションもauto mode disabled by settingsと表示されて、そのモードを抜けます(v2.1.251以降。それより前は、動いているセッションはそのまま続きました)。
VS Code拡張で同じ操作をするには
VS Code拡張は、プロジェクトの.claude/settings.jsonを開始モードの決定に使いません。会話ごとにモードインジケーターをクリックしてManualを選ぶのが即時の切り替えです。
常に手動から始めたい場合は、VS Codeのユーザー設定でclaudeCode.initialPermissionModeにdefaultかmanualを指定します。この設定はautoを受け付けません。Autoで始めたいときは、設定を空にしたままインジケーターから一度Autoを選びます。
開始モードは、次の順で決まります。
claudeCode.initialPermissionMode- インジケーターで最後に選んだモード(Manual・Edit automatically・Auto)
- 管理設定か
~/.claude/settings.jsonのpermissions.defaultMode - 組み込みの既定値
インジケーターでAutoを一度選んだ人が手動から始めたいときは、1の設定値を書けば、その選択より優先されます。~/.claude/settings.jsonのdefaultModeは拡張にも効きますが、インジケーターの選択には負けます。
手動に戻しても効き続ける設定
Manualモードにしても、個別の許可ルールは無効になりません。permissions.allowに登録済みのコマンドは、原則としてモードに関わらず確認なしで通ります。例外は、重要なパスを対象にするrm・rmdirと、bypassPermissionsでallowルールが働かない点です。毎回確認したい場合は、allowに何を書いているかも見直します。
permissions.denyは全モードで効くので、手動に戻したから禁止ルールが緩むことはありません。askルールで指名した操作は、bypassPermissionsを含むどのモードでも確認が出ます。
確認を減らしつつ手動は維持したい場合
auto modeは避けたいが、毎回のプロンプトも減らしたいときは、ManualのままBashサンドボックスのauto-allowを組み合わせます。分類器を経由せず、隔離環境の中でだけコマンドが自動実行される仕組みです。
/sandbox/sandboxのModeタブでauto-allowを選ぶと、macOS・Linux・WSL2の組み込みサンドボックス内でBashコマンドが確認なしで走ります。denyルールは働き続け、Bash(git push *)のようにコマンドの内容を名指ししたaskルールは、サンドボックス内でも確認が出ます。rmやrmdirが重要なパスを対象にする場合も、通常の許可フローに回ります。
サンドボックスに収まらないコマンド(許可されていないホストへのネットワークアクセスなど)は、通常どおりManualのプロンプトが出ます。設定ファイルから有効にするならsandbox.enabledをtrueにします。Plan mode中だけの審査方法はuseAutoModeDuringPlanで個別に制御できます。
設定したのに手動にならないとき
defaultModeを書いたのに変わらない: 複数の設定ファイルで値がぶつかったときの優先順は、強い順に管理設定、起動時のフラグ、プロジェクトのローカル設定(.claude/settings.local.json)です。その次がプロジェクト設定、最後がユーザー設定です。どの設定ファイルを読んだかは、セッション内で/statusを実行し、Setting sourcesの行で確認します- 最初のセッションだけ違うモードだった: 表と違っても、上で触れた初回の例外です。次のセッションからは表のとおりになります
- VS Code拡張だけ効かない: インジケーターで最後に選んだAutoが、
~/.claude/settings.jsonのdefaultModeより優先されている可能性があります。前節の1を書けば解消します - resumeしたらauto modeだった: 端末で
claude --continueやclaude --resume <セッションID>から再開すると、中断した時点のモードが復元されます。手動で再開したいなら、次のコマンドのようにモードを明示します。名前での再開は、名前が1件のセッションに一致するときだけ同じ扱いです。セッション選択画面や/resumeから開いた場合は保存されたモードを復元せず、選択画面では新規セッションと同じ決まり方、/resumeでは今のモードのまま続きます
claude --resume auth-refactor --permission-mode manualよくある質問
acceptEditsもオフになりますか
defaultModeを"default"にすれば、開始モードがManualになるため、acceptEditsから始まることはなくなります。ただしShift+Tabの巡回にはacceptEditsが残るので、セッション中に切り替えることはできます。
手動に戻すと、ファイル編集のたびに確認が必要になりますか
はい。Manualで確認なしに進むのは読み取り専用の操作だけです。ファイルの作成・編集やほとんどのシェルコマンドは、1件ずつ確認が出ます。特定の操作だけ確認を省きたいときは、permissions.allowに個別のルールを登録します。
まとめ
個人の端末でauto modeを二度と使わないなら、defaultModeよりdisableAutoModeのほうが1か所の設定で済みます。
手動に戻したのに特定のコマンドだけ確認なしで通るときは、モードよりもpermissions.allowを疑うのが近道です。auto modeの分類器が何を止めているかはauto mode分類器は何を止めているかで扱っています。allow/ask/denyを含む設定ファイル全体の構造はClaude Code settings.json完全ガイドにあります。Claude Code全体の入口はClaude Code完全ガイドにあります。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。