Claude Codeのオートモードがデフォルトに!設定と注意点
Claude Code v2.1.283より、ターミナルやVS Codeでのオートモードが標準となりました。VPSなどのリモート環境で実行する際の権限設定や、手動モードとの切り替え方法、HIPAA構成時の挙動など、開発者が知っておくべき仕様変更を詳しく解説します。
2026 年 8 月 14 日に自動モードで変わったこと
Claude Code の自動モードでは、通常の権限確認なしでツール呼び出しを実行し、別の分類モデルで操作を確認します。保護されたパス以外の読み取りと作業ディレクトリへの変更は、分類モデルによる確認を受けません。2026 年 8 月 14 日以降、Pro、Max、Team プランでは、新しいセッションが自動モードで開始されるようになりました。2026 年 10 月 27 日時点のドキュメントでは、さらに、Claude Code v2.1.283 以降で、すべてのプランとプロバイダーの対話型ターミナルおよび VS Code セッションにおいて、自動モードが組み込みの開始モードになったと説明されています。モードはいつでも切り替えられます。すでに自分で設定したデフォルトが上書きされることはありません。
現在のドキュメントでは、この変更を次のように説明しています。
Claude Code v2.1.283 以降では、自動モードが対話型ターミナルおよび VS Code セッションの組み込みの開始権限モードです。それ以前のバージョンでは、Pro、Max、Ultra、Team プランでのみ、組み込みの開始権限モードです。
同じページにある 2 つのルールは、バージョン番号より重要です。自分の ~/.claude/settings.json に設定した defaultMode は、変更後も維持されます。Claude Code は自動モードに切り替えるかどうかを 1 回確認することがありますが、拒否すれば設定は維持されます。組織が managed settings で配布したデフォルトも維持されます。告知記事では、当初、Enterprise プランと Claude API では自動モードをオプトインのままにすると説明されていました。2026 年 10 月 22 日の更新では、Enterprise 管理者に対し、自動モードが組織のデフォルトになる前にメールで通知すると説明されています。v2.1.283 以降のドキュメントでは、ターミナルおよび VS Code セッションについてこの例外を設けていません。ただし、v2.1.285 以降では、HIPAA configuration が適用された組織は Manual モードで開始されます。
VPS(virtual private server)で Claude Code を実行している場合、この変更はノート PC で実行する場合より重要です。権限確認は、キーボードの前にいる人の対応が必要なチェックポイントです。リモートマシンではその場にいないことが多いため、セッションの開始モードが数時間そのまま使われます。非対話型の claude -p 実行には別のルールがあります。v2.1.302 以降では、モードを設定していない場合、サードパーティプロバイダーを使用する場合やテレメトリを無効にしている場合も含め、default で開始されます。2026 年 10 月 31 日時点の現行リリースは v2.1.316 で、permission-modes ページにこの動作が記載されています。v2.1.302 より前では、この 2 つのケースで auto から開始されることがありました。古いリリースの可能性がある場合は、マシン上で claude --version を実行してください。
Claude Code の権限モード(監視が多い順)
モードは6つあります。各行の先頭にある名前は、設定に記述する値、または --permission-mode に渡す値です。6つすべてがモデルではなく Claude Code 自体によって適用されます。ツール呼び出しで許可される操作を判断するのは、モデルを取り巻くハーネスの役割だからです。
default: ファイルの編集、シェルコマンドの実行、ネットワークへのアクセスを伴うほとんどの操作の前に、Claude が確認を求めます。作業ディレクトリ内の読み取りは、確認なしで実行されます。CLI (command line interface) ではこのモードに Manual というラベルが表示され、manualを別名として受け付けます。plan: Claude はファイルを読み取り、調査のためにコマンドを実行しますが、ソースは編集しません。計画を承認するまで編集はブロックされます。ただし、バイパス権限を利用できる対話型ターミナルセッションでは例外です。この場合、計画用コマンドには分類器も確認プロンプトも適用されません。acceptEdits: ファイル編集は確認なしで実行されます。ファイルシステムコマンドのmkdir、touch、rm、rmdir、mv、cp、sedも同様です。対象となるのは、作業ディレクトリ内またはadditionalDirectories内のパスだけです。保護されたパスへの書き込みと、重要パスとして認識された削除には引き続き確認が必要です。また、touchが自動承認されるのは、通常のファイルパスだけの場合です。それ以外のシェルコマンドには、通常の権限ルールが適用されます。auto: 通常の権限確認プロンプトが、分類器によるチェックに置き換わります。明示的なaskルールでは、引き続き確認が必要です。dontAsk: 通常なら確認を求める操作を、Claude Code が自動的に拒否します。インストールした mod が承認できる呼び出し、作業ディレクトリ内のファイル読み取り、allowルール、組み込みの読み取り専用 Bash コマンド、事前承認済みのドキュメント取得、PreToolUsehook が承認する呼び出しを除き、操作は実行されません。セッションが入力を待つことはありません。bypassPermissions:.gitや.claudeなどの保護されたパスへの書き込みを含め、確認プロンプトと安全性チェックがスキップされます。
セッション中に Shift+Tab を押すと、default、acceptEdits、plan の順に切り替わります。auto の状態では、最初に押すと default に戻ります。ステータスバーには、到達したモードが ⏵⏵ auto mode on や灰色の ⏸ manual mode on などとして表示されます。それ以外のモードは、デフォルトではこの切り替え対象に含まれません。アカウントが要件を満たすと、auto も対象になります。セッションの開始時に --permission-mode bypassPermissions、--dangerously-skip-permissions、--allow-dangerously-skip-permissions のいずれかを指定した場合、または user、--settings、managed settings で defaultMode: "bypassPermissions" を指定した場合に限り、bypassPermissions も対象になります。dontAsk は切り替え対象に表示されないため、claude --permission-mode dontAsk で設定してください。
Auto mode には新しいモデルも必要です。Auto mode 自体が表示されない場合は、通常これが原因です。2026年10月27日時点のドキュメントでは、Anthropic API で Claude Opus 4.6 以降、Sonnet 4.6 以降、Haiku 5.5、または Fable model が必要とされています。Amazon Bedrock、Google Cloud、Microsoft Foundry では対象モデルが少なく、Sonnet 4.5 などの古いモデルは、どの provider でもサポートされないと記載されています。Claude Code が Auto mode を利用できないと報告した場合は、まずこれらの要件と disableAutoMode 設定を確認してください。Anthropic がサーバー側で Auto mode を無効にすることもあります。その応答を受けたセッションでは、終了するまで Auto mode が無効のままです。古いセッション内で待つのではなく、後で新しいセッションを開始してください。
bypassPermissions を含むすべてのモードで、2つの制御が有効です。deny ルールと明示的な ask ルールです。別のツールが利用可能な間は、どちらも EndConversation には適用されません。セッションの開始モードに関係なく、これらが使用できる制御手段です。
自動モードの分類器がブロックする操作
分類器は、保留中の操作を読み取り、それが指定した内容に適合するかを判定する第2のモデルです。ドキュメントでは、その役割を次の1文で説明しています。
独立した分類器モデルが実行前に操作を確認し、要求を超えて権限を拡大する操作、認識されていないインフラストラクチャを対象とする操作、または Claude が読み取った悪意のあるコンテンツに誘導されたように見える操作をブロックします。
サーバー運用で特に遭遇しやすい次のカテゴリは、デフォルトでブロックされます。
curl | bashなど、コードをダウンロードして実行する操作- 本番環境へのデプロイとマイグレーション
- Force push
- 共有インフラストラクチャの変更
- ローカルサービスをパブリックインターネットから到達可能にするトンネルまたはリバースシェルの開設
- 有効な認証情報またはトークンをトランスクリプトやファイルに出力する操作
次の操作は、デフォルトで許可されます。
- 作業ディレクトリ内のローカルファイル操作
- lock ファイルまたはマニフェストで宣言された依存関係のインストール
- 読み取り専用の HTTP リクエスト
- 作業中のリポジトリのブランチへの push。default ブランチも含まれます。ただし、名前によってデプロイまたは公開の対象であることが示される non-default ブランチは除きます。push の内容には、分類器の他のルールも引き続き適用されます。
上記のような要約だけを基準に運用しないでください。claude auto-mode defaults を実行して完全なルール一覧を JSON で出力し、インストールされているバージョンに付属する一覧を確認してください。/auto-mode-setup は別のコマンドです。このコマンドはプロジェクトと直近のセッションから autoMode.environment の項目案を作成し、案を承認すると ~/.claude/settings.json に書き込みます。バージョン要件があるのはこのコマンドであり、claude auto-mode defaults ではありません。Pro、Max、Ultra、Team プランでは /auto-mode-setup に v2.1.228 以降が必要です。native Windows では v2.1.233 以降が必要です。Enterprise プランまたは Claude Console API key を使用する場合は、v2.1.283 以降が必要です。v2.1.304 より前では、テレメトリを無効にしたサーバーやサードパーティプロバイダー上のサーバーなど、feature flags を取得しないセッションでは /auto-mode-setup がありません。この条件に該当する場合は、先に更新してください。
この機能を頼る前に、重要な制限が2つあります。1つ目は、Claude Code 自身が送信する分類器リクエストでは、分類器が参照できるのはメッセージ、ファイル読み取りや検索などの読み取り専用参照を除くツール呼び出し、CLAUDE.md の内容です。ツールの結果は除外されます。そのため、Claude が読み取ったファイルや Web ページ内のテキストから、分類器に直接指示することはできません。2つ目は、分類器が1回のセッションで操作を連続3回、または合計20回ブロックすると、自動モードが一時停止し、Claude Code が確認プロンプトに戻ることです。プロンプトで操作を承認すると、自動モードが再開します。これらのしきい値は設定できません。-p flag を指定し、--permission-prompt-tool を指定しない non-interactive 実行では、確認に応答する人がいません。ドキュメントには、Claude Code は実行を停止しないと明記されています。ブロックされた操作は実行されず、Claude は作業を続けます。
この2つ目の動作は、リモートサーバーでは2通りの問題になります。実行したままの interactive セッションが制限に達すると、プロンプトで停止し、端末を見ていない人の応答を待ち続けます。-p の実行は待機しないため、ブロックされた手順を未実行のままジョブが終了することがあります。同じサーバー上の別の Claude Code セッションは、その人の代わりにはなりません。あるセッションから別のセッションへ送信したテキストは同意として扱われず、保留中の権限プロンプトにも応答できないためです。したがって、一方のセッションが停止している場合も、人による応答が必要です。エージェントが実行する内容を絞ることも対策の一部です。必要最小限の変更を行うようエージェントを誘導する skill を使うと、分類器が停止する大規模な操作へセッションが逸脱するのを防げます。skill が1つのタスクを誘導するのに対し、output style は system prompt 自体を編集します。そのため、小さく限定的な変更を求める style は、呼び出した1つのジョブだけでなく、セッションのすべてのターンに適用されます。
設定内の settings.json におけるモードの配置場所
ここまでの内容は、設定ファイル内の 1 つのオブジェクトです。
{
"permissions": {
"defaultMode": "auto",
"allow": [
"Bash(npm run test *)",
"Bash(git status)"
],
"ask": [
"Bash(git push *)",
"Bash(docker compose up *)"
],
"deny": [
"Read(./.env)",
"Read(./secrets/**)",
"Bash(curl *)"
]
}
}ルールは deny、次に ask、最後に allow の順で評価されます。その順序で最初に一致したルールが結果を決めます。後から指定した狭い範囲のルールが、先に指定した広い範囲のルールより優先されることはありません。Bash(aws *) に対する deny ルールは、同じコマンドを明示的に許可していても aws s3 ls をブロックします。allow ルールで deny ルールの例外を作ることはできません。Read と Edit の deny または ask ルールでは、gitignore の否定構文も使用できます。同じ設定ファイルの deny リストで、Read(*.env) の後に Read(!sample.env) を指定すると、sample.env という名前のファイルが直前のルールから除外されます。この例外が適用されるのは、同じ設定元にある、それより前の相対パスルールだけです。別の設定元による deny を上書きしたり、ディレクトリ全体がブロックされている場合に、その中のファイルを再び許可したりすることはできません。
ask は、auto モードで特に有効なルールの種類です。auto モードでは通常の確認プロンプトが省略されますが、ask ルールを指定すると、実行時に人の確認が必要な特定のコマンドだけ確認を戻せます。デプロイコマンドはここに指定します。コードをサーバーの外部へ出す前に確認したい場合は、Bash(git push *) もここに指定します。認証情報ファイルを deny に保持することも重要です。これは、そもそも認証情報をエージェントから到達できない場所に置く方法と組み合わせて使用します。
設定ファイルは、優先度の低いものから次の順序です。
~/.claude/settings.json: ユーザー設定です。すべてのプロジェクトに適用されます。.claude/settings.json: プロジェクト設定です。リポジトリにコミットします。.claude/settings.local.json: 1 つのリポジトリに対する自分専用の設定です。Claude Code が作成する場合は git-ignored になります。手動で作成する場合は.gitignoreに追加します。- 管理設定: 管理者が配置する設定です。Linux では、このファイルは
/etc/claude-code/managed-settings.jsonです。コマンドラインフラグを含め、管理された権限ルールを上書きするものはありません。
ここには、文書化された原因による注意点があります。defaultMode: "auto" は .claude/settings.json または .claude/settings.local.json から指定しても有効になりません。これにより、リポジトリに設定ファイルを含めても、そのリポジトリ自身が auto モードを許可することはできません。bypassPermissions も、この 2 つのファイルでは無視されます。そこで auto を設定すると、Claude Code は組み込みのデフォルトに戻ります。~/.claude/settings.json にある defaultMode は無視され、エラーも表示されません。この組み込みのデフォルトが Manual であるバージョンまたはプランでは、セッションは default モードで静かに開始します。この行を ~/.claude/settings.json に移動してください。/permissions を実行すると、現在有効なすべてのルールと、そのルールの取得元ファイルを一覧表示できます。
モードを無効にする2つの設定
管理者は2つのキルスイッチを使用できます。どちらもブール値ではなく、文字列 "disable" を指定します。
{
"permissions": {
"disableAutoMode": "disable",
"disableBypassPermissionsMode": "disable"
}
}ドキュメントでは、どちらの設定も任意の設定ファイルで文字列 "disable" を受け付けると説明されています。これらは、上書きできない管理対象の設定で特に有用です。
disableAutoMode は Shift+Tab サイクルから auto を削除します。--permission-mode auto で開始したセッションは、代わりに Manual モードで開始します。disableBypassPermissionsMode はバイパスモードに対して同じ役割を果たし、任意のスコープで機能します。そのため、自分の ~/.claude/settings.json に設定して、稼働中のサーバーで午前2時に使いたくないモードへ切り替えられないようにできます。他のユーザーも使うサーバーでは、代わりに両方を /etc/claude-code/managed-settings.json に設定してください。ユーザー設定ファイルはユーザーに属しますが、管理対象の設定ファイルはユーザーに属さないためです。
VPSで自動モードに分離境界が必要な理由
分類器は一度に1つのアクションのみをレビューします。承認されたアクションがその後何を行うかまでは制御しません。ドキュメントでは以下のように明確に線引きされています。
分類器はアクションごとの制御であり、分離境界ではありません。そのため、無人実行時には分離境界が多層防御として機能しますが、--dangerously-skip-permissionsのように必須というわけではありません。
したがって、リモートサーバーでの組み合わせは「自動モード」と「失っても問題ない環境」であり、bypassPermissionsと「希望的観測」の組み合わせではありません。バイパスモードは、コンテナ、仮想マシン、インターネットアクセスを遮断した開発コンテナなど、Claude Codeがホストシステムに損害を与えられない分離環境でのみ使用するようドキュメント化されています。データベースやリバースプロキシを稼働させているVPSは、これらに該当しません。
サーバー運用において重要な要素は3つあります。Claude Codeは必ずrootではなく一般ユーザーとして実行してください。そのユーザーには作業用ディレクトリのみを割り当て、読み取られては困るファイルにはアクセスさせないようにします。修復するよりも再構築する方針をとってください。これがジョブ終了後に破棄する使い捨てVMを推奨する理由です。ユーザー作成からファイアウォール設定に至るまでの詳細な強化策は、VPSでClaude Codeを実行するための完全な安全対策で解説しているため、ここでは繰り返しません。
Claude Codeはrootでの実行を自ら制限しています。LinuxおよびmacOSでは、sudo環境下やrootユーザーでバイパスモードを開始しようとすると拒否されます。
--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasonsこのチェックは認識されたサンドボックス内ではスキップされます。そのため、自律的なコンテナ作業における推奨回答は、Claude Codeを非rootユーザーとして実行する開発コンテナとなります。スマートフォンやノートPCからSSH経由でエージェントを操作する場合も、tmuxで維持される長時間実行のClaude Codeセッションに対して同じ論理が適用されます。セッション実行中、プロンプトを監視している人間は誰もいないからです。ログイン自体が成功しなければ何も開始されません。もしサーバーからPermission denied (publickey)で拒否された場合は、詳細なSSH出力から5つの障害のうちどれが発生しているかを確認してください。
Ubuntu VPS で Bash sandbox を設定する
組み込みの sandbox は、Claude が実行する sandbox 対象の Bash コマンドによるファイルシステムとネットワークへのアクセスを制限します。オペレーティングシステムは、子プロセスにもこの制限を適用します。除外されたコマンドと、承認済みの sandbox 外での再試行は、sandbox の外部で実行されます。Linux では、2 つのパッケージが必要です。
sudo apt-get install bubblewrap socatClaude Code を起動し、/sandbox を実行します。Mode、Overrides、Config のタブを含むパネルが開きます。必要なパッケージが不足している場合は、Dependencies タブだけが表示され、インストール対象が一覧表示されます。依存関係の確認は起動時に実行されるため、パッケージをインストールした後に Claude Code を再起動してください。再起動しないと、パネルにはパッケージが未インストールと表示されます。
Ubuntu 24.04 以降では、デフォルトの AppArmor ポリシーにより、bubblewrap が必要とする user namespace を作成できません。そのため、sandbox の起動に失敗します。自分の環境に該当するか確認します。
sysctl kernel.apparmor_restrict_unprivileged_userns0、または key が存在しないというエラーが表示された場合は、対応不要です。1 が表示された場合は、bwrap 用のプロファイルが必要です。
sudo tee /etc/apparmor.d/bwrap > /dev/null <<'EOF'
abi <abi/4.0>,
include <tunables/global>
profile bwrap /usr/bin/bwrap flags=(unconfined) {
userns,
include if exists <local/bwrap>
}
EOF
sudo systemctl reload apparmorこのプロファイルが適用される対象は bwrap 自体です。sandbox 内で実行するコマンドには適用されません。続いて、settings で境界を狭めます。
{
"sandbox": {
"enabled": true,
"filesystem": {
"denyRead": ["~/"],
"allowRead": ["."]
},
"network": {
"allowedDomains": ["github.com", "*.npmjs.org"]
}
}
}このブロックはプロジェクトの .claude/settings.json に記述します。プロジェクト設定からのみ、. がプロジェクトルートとして解決されるためです。同じ行を ~/.claude/settings.json に記述すると、. は代わりに ~/.claude として解決されます。その場合、denyRead のルールによってプロジェクトファイルは引き続きブロックされ、すべてのコマンドが編集対象のコードを読み取れなくなります。
この設定で保護されない対象も把握しておいてください。sandbox が制限するのは Bash とその子プロセスです。組み込みのファイルツールは Claude Code プロセス内で実行されます。一方、MCP (model context protocol) サーバーと hooks は、制限なしでホスト上を実行する別プロセスです。これらすべてを 1 つの境界内に置くには、Claude Code プロセス全体をコンテナ、仮想マシン、または @anthropic-ai/sandbox-runtime パッケージ内で実行します。ただし、執筆時点では beta の研究プレビューです。
各セットアップにはどのモードが適していますか?
個人のラップトップ上の単一リポジトリ
auto を使用し、実行させたいアクションに対して ask ルールを設定してください。操作者がキーボードの前にいるため、分類器のフォールバックが機能し、被害範囲も管理下の1台の端末に限定されます。8月14日のデフォルト設定は、このケースを想定して作成されました。
共有VPS
ユーザーごとに auto を使用し、各ユーザーの ~/.claude/settings.json に設定してください。その際、Claude Code を実行するアカウントは root 権限を持たず、他のユーザーの作業内容を読み取れない状態である必要があります。共有パスを保護する拒否ルールと共に、disableBypassPermissionsMode を /etc/claude-code/managed-settings.json 内の "disable" としてデプロイしてください。共有サーバーは bypassPermissions が不適切なケースの典型です。このモードが前提とする分離境界が存在せず、他のテナントがその境界内に同居しているためです。
CIおよび非対話型セッション
ジョブが必要とするコマンドを明示的に指定した allow リストと共に、dontAsk を使用してください。プロンプトを確認する人間がいない環境では、自動拒否が正しい失敗モードとなります。Auto モードも非対話的に実行されますが、-p の実行中に分類器によるブロックが繰り返されても処理は停止しません。ブロックされたアクションはスキップされ、Claude は作業を継続するため、一部のステップが未完了のままジョブが終了する可能性があります。bypassPermissions はイメージから再構築可能なコンテナや仮想マシン内でのみ使用し、重要な処理を実行しているホスト上では使用しないでください。
FAQ
自動モードが Claude Code のデフォルトになるのはいつですか?
Pro、Max、Team プランの新しいセッションでは、2026 年 8 月 14 日にデフォルトになりました。2026 年 10 月 27 日時点のドキュメントでは、Claude Code v2.1.283 以降、自動モードがすべてのプランとプロバイダーで、対話型ターミナルおよび VS Code セッションの組み込み開始モードになっています。ただし、HIPAA 構成が適用された組織では例外です。この場合、v2.1.285 以降は Manual モードで開始します。非対話型の claude -p 実行は、モードを指定しない限り default で開始します。v2.1.302 より前は、サードパーティプロバイダー上での実行やテレメトリを無効にした実行が auto で開始される場合がありました。v2.1.302 以降は、それらも default で開始します。自分で設定したデフォルトは、1 回限りの切り替え確認を承認しない限り維持されます。組織が管理するデフォルトも変更されません。ステータスバーに自動モードでは ⏵⏵ auto mode on と表示されるため、セッションが実際にどのモードで動作しているかを確認できます。
VPS では自動モードと bypassPermissions のどちらを使うべきですか?
隔離境界と組み合わせた自動モードを使用します。分類器はアクションの実行前に確認します。保護対象パスの外部に対する読み取りと作業ディレクトリの編集は、確認を省略します。ただし、ドキュメントには、自動モードはアクション単位の制御であり、隔離境界ではないと明記されています。そのため、無人実行ではコンテナ、仮想マシン、または必要に応じて再構築できるサーバーを使用します。bypassPermissions は確認を完全に省略するため、隔離環境でのみ使用するよう記載されています。Claude Code は Linux で root としてこのモードを開始することを拒否し、--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons と表示します。
サーバー上の誰も自動モードやバイパスモードを使えないようにするにはどうすればよいですか?
/etc/claude-code/managed-settings.json で permissions.disableAutoMode と permissions.disableBypassPermissionsMode を文字列 "disable" に設定します。管理対象設定は他のすべてのスコープより優先されるため、ユーザー設定ファイルでもコマンドラインフラグでも上書きできません。disableAutoMode により auto が Shift+Tab の選択肢から削除され、--permission-mode auto で開始したセッションは Manual モードで開始します。disableBypassPermissionsMode はどのスコープからでも使用できるため、単一のユーザーが自身の ~/.claude/settings.json に設定することもできます。
defaultMode: "auto" 設定が無視されるのはなぜですか?
設定したファイルが間違っているためです。defaultMode: "auto" は .claude/settings.json または .claude/settings.local.json から設定しても有効になりません。これは、リポジトリに設定ファイルを含めるだけで、そのリポジトリ自身が自動モードを許可できないようにするためです。Claude Code は代わりに組み込みのデフォルトへフォールバックします。その際、ユーザー設定にある defaultMode は無視され、エラーは表示されません。組み込みのデフォルトが Manual の場合、セッションは default モードで開始します。設定を ~/.claude/settings.json に移動し、/permissions を実行して、各有効なルールの出所となるファイルを確認します。自動モードを引き続き使用できない場合は、モデル要件を確認してください。Sonnet 4.5 などの古いモデルは、どのプロバイダーでもサポートされていません。