Claude Code の開始モードは auto が既定、権限モード 6 種類と defaultMode の設定

Claude Code の permissions.defaultMode は、「allow にも deny にも一致しなかった操作をどう扱うか」を決める設定です。指定できる値は 6 つあります。

結論として、個人開発なら acceptEdits、初めて触るコードベースや設計作業なら plan、CI で許可リストを厳密にするなら dontAsk、隔離環境だけ bypassPermissions が目安です。

6 つの値の比較

値	確認なしで実行されるもの	向いている場面
default	読み取りのみ	すべての操作を自分で確認したいとき、慎重な作業
acceptEdits	読み取り、ファイル編集、mkdir・touch・mv・cp などの一般的なファイル操作	自分でレビューしながらコードを回すとき
plan	読み取りと、auto モードが使える場合は分類器が承認したコマンド	変更前にコードベースを調べるとき
auto	すべて(バックグラウンドの安全チェック付き)	長い作業、確認疲れの軽減
dontAsk	読み取りと事前承認済みのツール。確認が必要なものは拒否される	権限を絞った CI やスクリプト
bypassPermissions	すべて	隔離されたコンテナや VM のみ

すべての操作を確認するモードは、CLI や各拡張、デスクトップアプリで Manual と表示されます。設定値は default で、CLI は manual も別名として受け付けます(v2.1.200 以降)。

モードが決めるのは土台だけです。deny に一致する操作は bypassPermissions を含むすべてのモードでブロックされ、allow ルールは bypassPermissions では効果がありません。defaultMode が効くのは、どのルールにも一致しなかった操作です。

セッションの開始モードが決まる順序

Claude Code v2.1.283 以降、ターミナルと VS Code 拡張のセッションは、プランを問わず組み込みの開始モードが auto になりました。それより前のバージョンでは、auto が組み込みの既定値になるのは Pro・Max・Team プランだけです。

ターミナルで新しいセッションを始めるとき、モードは次のうち最初に該当したもので決まります。

1. --permission-mode フラグ、または --dangerously-skip-permissions
2. 設定ファイルの permissions.defaultMode
3. 組み込みの既定値

設定の書き方

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

ユーザー全体の既定にするなら ~/.claude/settings.json、プロジェクトごとなら .claude/settings.json、自分だけなら .claude/settings.local.json に書きます。

用途別の選び方

個人開発:acceptEdits

ファイル編集を毎回確認する手間がなくなり、コマンド実行(テスト、インストール、Git)は確認できます。編集内容は後から git diff でまとめて見る運用にすると効率的です。

初めてのコードベース・設計作業:plan

変更を伴わないので、安心して調査と計画を任せられます。計画に納得してから acceptEdits に切り替えて実装に進みます(Plan Mode の使い方)。

チーム共有の設定:default か acceptEdits

プロジェクトの settings.json に書く場合は、慎重な側に倒しておきます。速く進めたい人は自分の settings.local.json で acceptEdits に上書きできます。

CI・使い捨てコンテナ:dontAsk か bypassPermissions

確認する人がいない環境では、確認待ちで止まらないようにします。許可リストを厳密に決めて動かすなら dontAsk が向いています(確認が必要な操作は拒否されます)。すべてを通す bypassPermissions は、Claude Code が壊せないよう隔離された環境だけで使ってください。詳しい条件は bypassPermissions を安全に使える条件 にまとめています。

一時的に切り替える方法

方法	範囲
Shift+Tab	現在のセッション内。利用できるモードを順に切り替える
claude --permission-mode plan	そのセッションの初期モード
claude -p ... --permission-mode acceptEdits	非対話モードの 1 回の実行

いずれも設定ファイルは書き換えません。「普段は acceptEdits、今日は調査だけ」のような使い分けは、設定を変えずに Shift+Tab や起動オプションで行います。

関連する設定

defaultMode だけでは「どのコマンドを自動にするか」は決められません。allow / ask / deny と組み合わせた全体の設計は、親記事の settings.json で permissions を設計する を参照してください。

まとめ

• モードは 6 種類。default(Manual)・acceptEdits・plan・auto・dontAsk・bypassPermissions
• deny はすべてのモードで効き、allow は bypassPermissions では効果がない
• v2.1.283 以降、ターミナルと VS Code の開始モードはプランを問わず auto。フラグ → defaultMode → 組み込みの既定値の順で決まる
• auto と bypassPermissions は .claude/settings.json と .claude/settings.local.json では効かない
• Shift+Tab と --permission-mode は一時的な切り替えで、設定ファイルは変わらない

{
  "autoMode": {
    "allow": [
      "$defaults",
      "未 push のコミットに対する git commit --amend --reset-author は許可する: 著者情報の修正のみで、公開済み履歴は書き換えない"
    ]
  }
}