Claude Media
Claude Codeの自動承認オフ — auto modeからmanual modeに戻す手順

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. 1

    Shift+Tabを1回押す

    autoから押すと、最初の1回でdefault(Manual)になります。そこからさらに押すとacceptEdits→plan→defaultの順に巡回します。

  2. 2

    ステータスバーで確認する

    ⏸ manual mode onと灰色で出ていれば切り替え完了です。⏵⏵ auto mode onのままなら、押した回数が足りていません。

  3. 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を選びます。

開始モードは、次の順で決まります。

  1. claudeCode.initialPermissionMode
  2. インジケーターで最後に選んだモード(Manual・Edit automatically・Auto)
  3. 管理設定か~/.claude/settings.jsonのpermissions.defaultMode
  4. 組み込みの既定値

インジケーターで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完全ガイドにあります。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. code.claude.com/docs/en/permission-modes
  2. code.claude.com/docs/en/settings
  3. code.claude.com/docs/en/settings-reference
  4. code.claude.com/docs/en/sessions
  5. code.claude.com/docs/en/sandboxing
この記事を共有:XはてブLinkedIn