settings.json

permissions.defaultMode

型string記述場所どの設定ファイルでも可

デフォルトの権限モード。

取りうる値

acceptEditsClaude Code はファイル編集や `mkdir`・`mv` などの一般的なファイルシステムコマンドも確認なしで実行する
bypassPermissionsClaude Code は確認なしですべてを実行する
defaultClaude Code は読み取りのみ確認なしで実行する
delegate
dontAskClaude Code は事前承認されたツールのみ実行し、確認が必要な呼び出しはすべて自動拒否する
planClaude Code は読み取りと計画のみ行い、プランの承認まで編集をブロックする
autoClaude Code はバックグラウンドの安全チェック付きですべてを実行する
manual"default" の別名(v2.1.200 以降)

記述例

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

使い方・用途

  • セッション開始時のデフォルト権限モードを設定する
  • 選択肢: default(読み取りのみ確認なし)/ acceptEdits(ファイル編集も自動承認)/ plan(計画承認まで編集ブロック)/ auto(バックグラウンド安全チェック付きで自動承認)/ dontAsk(事前承認外は自動拒否)/ bypassPermissions(すべて確認なし・隔離環境専用)/ manual(default の別名)/ delegate(実験的。エージェントチームリーダー用)
  • UI 上は「default」モードが v2.1.200 から「Manual」と表記される
  • VS Code 拡張で bypassPermissions を既定にするには拡張設定の「Allow dangerously skip permissions」トグルが必要で、無効な場合は Manual で起動する
  • 自動モードを既定にするにはユーザーまたは管理設定で "permissions": {"defaultMode": "auto"} を設定
  • セッションは CLI フラグ(--permission-mode など)がこの設定より優先される
英語原文(公式ドキュメントより)

Default permission mode. "default": prompts on first use. UNDOCUMENTED. "manual": accepted alias for "default" (the CLI/VS Code/JetBrains UI now labels this mode "Manual" as of v2.1.200; permission-modes.md has not yet been updated to mention it). "acceptEdits": auto-accepts file edits. "plan": read-only, no modifications. UNDOCUMENTED. "delegate": coordination-only for agent team leads (agent teams are experimental; enable via CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS). "dontAsk": auto-denies unless pre-approved via permissions. "bypassPermissions": skips all prompts (use only in isolated environments). "auto": auto-approves tool calls with background safety checks that verify actions align with your request. See https://code.claude.com/docs/en/permissions

関連ドキュメント

関連する変更履歴

v2.1.284(1件)

Changed
対話ターミナルおよび VS Code セッションを、権限モードが設定されていない場合にはすべてのプランとプロバイダーで auto モードで開始するように変更した。ただし permissions.defaultMode の設定はこれを上書きする。
英語原文を表示
Changed interactive terminal and VS Code sessions to start in auto mode when no permission mode is configured, on every plan and provider; permissions.defaultMode still overrides it

変更後

権限モードを設定していない場合でも、対話ターミナルや VS Code のセッションが自動で auto モードで開始されるようになり、多くの操作で承認プロンプトが表示されずに済む。

関連ドキュメント

v2.1.283(1件)

Changed
サードパーティプロバイダー利用時やテレメトリ無効時のインタラクティブセッションについて、権限モードが設定されていない場合に auto モードで開始するように変更;permissions.defaultMode は引き続きこれを上書きする
英語原文を表示
Changed interactive sessions on third-party providers or with telemetry off to start in auto mode when no permission mode is configured; permissions.defaultMode still overrides it

変更後

サードパーティプロバイダー利用時やテレメトリ無効時など、権限モードを設定していない対話セッションでも自動的にオートモードで開始されるようになり、以前より少ない確認プロンプトで作業を進められる。

関連ドキュメント

v2.1.257(2件)

Fixed
← で開いたエージェントビューから起動したセッションが、常に元のセッションの権限モードで開始され、対象ディレクトリの defaultMode とエージェントの permissionMode が上書きされる問題を修正した
英語原文を表示
Fixed sessions dispatched from an agent view opened with ← always starting in the original session's permission mode, overriding the target directory's defaultMode and the agent's permissionMode

関連ドキュメント

Changed
.claude/settings.json または .claude/settings.local.json にある defaultMode: 'bypassPermissions' が、'auto' と同様に無視されるようになった。ユーザー設定または管理設定で設定するか、--permission-mode を渡す必要がある
英語原文を表示
Changed defaultMode: "bypassPermissions" in .claude/settings.json or .claude/settings.local.json to be ignored, like "auto"; set it in user or managed settings, or pass --permission-mode

変更後

プロジェクト内の .claude/settings.json や .claude/settings.local.json に書かれた bypassPermissions の設定が無視されるようになったため、リポジトリをクローンしただけの利用者が知らずに危険な権限バイパスモードで起動してしまうことを防げる。bypassPermissions を使いたい場合は、利用者自身の設定ファイルや管理設定で指定するか、--permission-mode フラグで明示的に渡せばよい。

関連ドキュメント

v2.1.200(1件)

Changed
「default」パーミッションモードが「Manual」へ名称変更されました。CLI、VS Code、JetBrains全体で適用され、新しい指定方法もサポートされます。
英語原文を表示
Changed the "default" permission mode to "Manual" across the CLI, --help, VS Code, and JetBrains; --permission-mode manual and "defaultMode": "manual" are accepted alongside default

変更後

権限管理の動作が名称からより直感的に理解できるようになり、運用の混乱を防げます。

関連ドキュメント

v2.1.143(1件)

Changed
claude agents から起動したセッションが、settings.json の permissions.defaultMode を優先的に参照するように修正しました
英語原文を表示
Background sessions launched from claude agents now honor permissions.defaultMode from settings.json (was previously overridden to auto mode)

変更後

自分の好みの承認ワークフロー(planモードなど)を、バックグラウンド作業でも一貫して利用できます。

関連ドキュメント

v2.1.91(1件)

Fixed
settings.json における permissions.defaultMode: "auto" の JSON スキーマバリデーションを修正しました。
英語原文を表示
Fixed JSON schema validation for permissions.defaultMode: "auto" in settings.json

変更後

設定のミスを未然に防ぎ、チームプランなどで提供される高度な自動化モードをスムーズに導入・運用できるようになります。

関連ドキュメント

v2.1.80(1件)

Fixed
前回のセッションのキャッシュがある場合に、起動時に一部の管理設定(有効なプラグイン、パーミッション等)が適用されないバグを修正
英語原文を表示
Fixed managed settings (enabledPlugins, permissions.defaultMode, policy-set env vars) not being applied at startup when remote-settings.json was cached from a prior session

変更後

企業のセキュリティポリシーや共有設定が常に正しく適用されるため、コンプライアンスを維持したまま安心して作業を開始できます。

関連ドキュメント

v2.1.70(1件)

Fixed
Claude Code Remote 環境において、permissions.defaultMode に acceptEdits または plan 以外が設定されている場合に、それらが無視されるよう修正しました。
英語原文を表示
Fixed permissions.defaultMode settings values other than acceptEdits or plan being applied in Claude Code Remote environments — they are now ignored

変更後

ローカルとリモートで設定を共有している場合でも、各環境に最適なセキュリティ設定が自動で適用されます。

関連ドキュメント