Claude Codeのauto mode既定化で確認したい設定
auto modeが組み込みの既定パーミッションモードになりました。v2.1.283以降は全プラン対象で、それ以前はPro・Max・Teamのみです。初回の例外と確認したい設定をまとめます。
ターミナルまたはVS Code拡張の新規セッションは、auto modeで始まるようになりました。設定ファイルを何も書いていなくても、組み込みの既定値そのものがauto modeに変わっています。当初はPro・Max・Teamプランが対象で、macOS・Linux・WSLはClaude Code v2.1.228以降、Windowsはv2.1.233以降(2026年8月14日リリース)でした。v2.1.283以降は全プラン・全プロバイダーが対象です。古いバージョンでは何も変わりません。同じv2.1.233では、Opus 4.8以降のモデルでTodo/Taskツールが既定オフになる変更も入っており、この時期のバージョンアップでは既定値の変化が重なっている点に注意が必要です。
auto mode既定化とは何か
auto mode既定化とは、Claude Codeがセッション開始時に選ぶ権限モードの組み込みの既定値が、これまでのManual(default)からauto modeに切り替わったことを指します。ユーザーが--permission-mode autoを指定しなくても、条件を満たせば最初からauto modeで立ち上がります。設定は何も要りません。auto modeそのものを消したい場合はdisableAutoMode設定を使います。
v2.1.283以降は、ターミナルまたはVS Code拡張の対話セッションなら、プランや接続経路を問わず対象です。Bedrock・Vertex AI・Foundry・Claude appsゲートウェイやEnterpriseプランも含みます。v2.1.283より前は対象がPro・Max・Teamプランに限られ、Bedrock経由などのほかの環境はManualモードから始まっていました。auto modeそのものの設計はClaude Code auto modeの中身で扱った二層防御の分類器が土台になっており、既定化はその分類器を「使うかどうかを選ぶ機能」から「最初から動いている前提」へ格上げする変更です。
どの条件で何が既定になるか
組み込みの既定値は、実行環境と条件によって次のように分かれます。上から順に該当する行が適用され、最初に一致した行で確定します。
| 実行環境・条件 | 組み込みの既定モード |
|---|---|
設定ファイルでdisableAutoModeが"disable" | 組み込みの既定モードManual(default) |
| インストール直後・更新直後の初回セッション | 組み込みの既定モード表と異なるモードで始まることがある(次回から表のとおり) |
claude -p(非対話実行)またはAgent SDK経由 | 組み込みの既定モードフィーチャーフラグを取得できるセッションではManual(default)。取得しないセッション(サードパーティープロバイダーやテレメトリーオフ)では、v2.1.285以降がauto、それ以前がManual |
| 組織にHIPAA構成が適用され、そのセッションが対象 | 組み込みの既定モードv2.1.285以降はManual(default)。auto modeには切り替えられる |
| v2.1.283以降で、ターミナルまたはVS Code拡張(全プラン・全プロバイダー) | 組み込みの既定モードauto |
| v2.1.283より前で、Bedrock・Vertex AI・Foundry・Claude Platform on AWS・Claude appsゲートウェイ、Enterpriseプラン、Claude Console APIキー | 組み込みの既定モードManual(default) |
| v2.1.283より前で、Pro・Max・TeamプランのターミナルまたはVS Code拡張 | 組み込みの既定モードauto |
permissions.defaultModeをユーザー設定ファイルに書いていれば、auto以外の値はその設定が優先されます。プロジェクト側の.claude/settings.jsonや.claude/settings.local.jsonに"auto"を書いても効かず、この場合は組み込みの既定値にフォールバックする点に注意が必要です。
既に手動固定していた設定はどうなるか
~/.claude/settings.jsonでdefaultModeをauto以外の値に固定していて、ほかの設定ファイルがdefaultModeを指定していない場合、セッションはそのまま指定したモードで始まり続けます。ただしPro・Max・Teamプランでは、ターミナルまたはVS Code拡張が「auto modeに切り替えますか」と一度だけ尋ねてきます。断れば設定はそのまま残り、次回から再度聞かれることもありません。
VS Code拡張の判定順はCLIと少し違い、次の節で4段に分けて示します。拡張はプロジェクトの.claude/settings.jsonを、開始モードの決定に読みません。設定の階層と優先順位の全体像はClaude Code settings.json完全ガイドにまとめています。
defaultModeとinitialPermissionModeで既定を決める
permissions.defaultModeとclaudeCode.initialPermissionModeは、設定する場所も使える値も違います。
| 設定 | 書く場所 | autoを指定できるか |
|---|---|---|
permissions.defaultMode | 書く場所~/.claude/settings.jsonまたは管理設定 | autoを指定できるかできる |
permissions.defaultMode | 書く場所プロジェクトの.claude/settings.json・.claude/settings.local.json | autoを指定できるかできない(ターミナルではautoとbypassPermissions以外の値が効く。VS Code拡張はどの値も読まない) |
claudeCode.initialPermissionMode | 書く場所VS Codeのユーザー設定 | autoを指定できるかできない(default・manual・acceptEdits・plan・bypassPermissionsのみ) |
VS Code拡張は新しい会話を、次の順で最初に該当したモードで始めます。
claudeCode.initialPermissionMode- モード表示から前回選んだManual・Edit automatically・Auto
- 管理設定か
~/.claude/settings.jsonのpermissions.defaultMode - 組み込みの既定(プラン・プロバイダー・組織設定で決まる)
拡張でautoから始めたいなら、claudeCode.initialPermissionModeは空のままにして、モード表示から一度Autoを選びます。v2.1.283より前は、3番目のdefaultModeを読むのがPro・Max・Teamプランでフィーチャーフラグを取得できたセッションに限られていました。
今すぐ確認したい設定
既定化の影響を受けるかどうかは、次の4点で切り分けられます。
claude --version
claude update- バージョン: macOS・Linux・WSLはv2.1.228以降、Windowsはv2.1.233以降で既定化の対象になります。v2.1.283以降は全プラン対象です。古いバージョンでは組み込みの既定値は引き続きManualです
- プランと接続経路: v2.1.283より前なら、Pro・Max・Teamでターミナルまたは拡張から使っているかを確認します。v2.1.283以降はBedrock・Vertex・Foundry経由も対象です。v2.1.283より前でこれらの経路を使う場合の手順はCLAUDE_CODE_ENABLE_AUTO_MODEの解説にまとめています
~/.claude/settings.jsonのdefaultMode: すでに値を書いているなら、その値が優先されます。書いていなければ既定化の影響を直接受けます- 組織の
disableAutoMode: Team・Enterpriseで管理者が無効化していないか、/permissionsで確認します
セッションが実際にどのモードで動いているかは、ステータスバーの表示(⏵⏵ auto mode onか⏸ manual mode on)で見分けられます。既定を明示的に手動へ戻す手順はClaude Codeの自動承認オフで扱っています。
既定化後も分類器の判定は変わらない
既定になるのは「どのモードで始まるか」だけで、auto mode自体の中身は変わっていません。ツール呼び出しはこれまでどおり分類器が評価し、危険と判定したものだけが手元に戻ってきます。分類器がどのルールをどう評価するかはautoMode設定で調整でき、hard_deny・soft_deny・allowの優先順位や、Bash・PowerShellコマンド全体を分類器に通すclassifyAllShellといった項目の詳細はauto mode分類器は何を止めているかで扱っています。
プランモード中の扱いも既定でオンです。useAutoModeDuringPlanが有効なら、計画中のシェルコマンドは毎回のプロンプトの代わりに分類器の判定を経由します。既定化によってこの設定が変わるわけではありませんが、auto modeで始まるセッションが増えた分、計画中に分類器を経由する場面も増えます。
auto modeが既定になったのは分類器の実績が理由と見てよいか
Anthropicは既定化の判断理由を個別には説明していません。ただし時系列で見ると、既定化はauto mode単体のリリースから半年近く経ってからの変更です。この間にhard_deny・soft_deny・allowの3層ルールとclassifyAllShellが追加され、分類器が止める範囲は当初よりも広がっています。承認プロンプトの93%が形骸化していたという当初の課題認識に対し、機械判定の網が育った段階で「既定を変える」判断に進んだ、という順序としては筋が通っています。
一方で、既定化は分類器の性能そのものが変わったことを意味しません。auto modeが利用可能になった時点の設計と、v2.1.234時点の分類器は評価対象こそ広がっていますが、判定の仕組み自体は同じ二層防御です。既定が変わったからといって、個々のセッションでの見え方が急に変わるわけではありません。
設定の優先順位で迷ったとき
defaultModeを複数の場所で設定していると、どれが効いているか分かりにくくなります。優先順位は「起動時のフラグ」「設定ファイル(管理設定 > プロジェクト設定 > ユーザー設定)」「組み込みの既定値」の順です。プロジェクト設定が効くのはターミナルだけで、autoとbypassPermissionsの値は無効です。組織の管理設定でTeam・Enterprise向けにdefaultModeを配布している場合、ユーザー個人の~/.claude/settings.jsonより管理設定が優先されます。既定化の影響を受けるのは、どの階層にもdefaultModeが書かれていない場合に限られる、と覚えておくと切り分けが早くなります。
よくある質問
自分ですでにauto modeを選んでいた場合、何か変わりますか
変わりません。組み込みの既定値は「何も指定していないときにどうなるか」を決めるだけなので、すでに--permission-mode autoやdefaultMode: "auto"でauto modeを使っていた環境には影響しません。
Bedrock・Vertex・Foundry経由でも既定でautoになりますか
v2.1.283以降はなります。この3経路とClaude appsゲートウェイでもauto modeが使え、対話セッションの組み込みの既定になります。使えるのはClaude Sonnet 5以降・Opus 4.7以降・Fableモデルで、ほかのモデルではManualで始まります。v2.1.283より前は対象外だったため、autoにするにはpermissions.defaultModeを明示的に"auto"へ設定します。
Enterpriseプランは対象になりますか
v2.1.283以降は対象です。それより前のバージョンでは、EnterpriseプランとClaude Console APIキーの環境は組み込みの既定値がManualでした。組織として既定を固定したい場合は、管理設定側でdefaultModeを明示的に指定します。
更新した直後のセッションでいきなりautoになりますか
なるとは限りません。フィーチャーフラグが届く前に開始モードが決まるため、更新後の最初のセッションは表と違うモードで始まることがあります。2回目以降は表のとおりです。
VS Code拡張でも同じ判定になりますか
条件を満たす限り同じ組み込みの既定値が使われますが、判定経路はCLIと異なります。拡張はclaudeCode.initialPermissionModeと前回選んだモードを先に見ます。initialPermissionModeにはautoを指定できません。
組織として全員に既定でauto modeを使わせられますか
できます。管理設定(managed settings)でpermissions.defaultModeを"auto"に設定すると、Team・Enterpriseのターミナルセッションはその値で始まります。個々のユーザーは引き続き手動でauto modeから切り替えられるため、既定を揃えたい場合の設定先はここになります。アプリ側の新規セッションの扱いはClaudeアプリのauto mode既定化で整理しています。
まとめ
auto mode既定化は、ターミナルおよびVS Code拡張の対話セッションで、組み込みの既定パーミッションモードをManualからautoへ切り替えた変更です。当初はPro・Max・Teamプランが対象で、macOS・Linux・WSLはv2.1.228以降、Windowsはv2.1.233以降(2026年8月14日)でした。v2.1.283以降は全プラン・全プロバイダーに広がっています。v2.1.283より前のBedrock・Vertex・Foundry経由やEnterpriseプランはManualのままで、更新直後の初回セッションは表と違うモードで始まることがあります。すでにdefaultModeを設定している環境には影響しないため、確認すべきはバージョンと~/.claude/settings.json、そして組織のdisableAutoModeの3点になります。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。