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.257(2件)

Fixed
Permissions
エージェントビューから ← で開いたセッションは、常に元のセッションの許可モードで開始される問題を修正しました。
英語原文を表示
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

変更前

エージェントビューから ← で開いたセッションは、ターゲットディレクトリの defaultMode やエージェントの permissionMode を無視して、常に元のセッションの許可モードで開始されていました。

変更後

エージェントビューから ← で開いたセッションは、ターゲットディレクトリの defaultMode やエージェントの permissionMode を尊重して、適切な許可モードで開始されるようになりました。

ユーザーへの恩恵

意図した許可モードでセッションを開始できるようになり、権限設定の意図通りに動作します。

関連ドキュメント

Changed
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

関連ドキュメント

v2.1.200(1件)

Changed
Permissions
「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

変更前

パーミッションモードのデフォルト設定が「default」という名称でした。

変更後

「Manual」が標準となり、従来の指定も引き続き受け入れられます。

ユーザーへの恩恵

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

関連ドキュメント

v2.1.143(1件)

Changed
PermissionsSettings
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)

変更前

エージェントビューからタスクを開始すると、ユーザー設定を無視して常に「auto」モードで開始されるなどの不整合がありました。

変更後

プロジェクトやユーザー設定で定義したデフォルトの権限モードが、バックグラウンド起動時にも正しく適用されます。

ユーザーへの恩恵

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

関連ドキュメント

v2.1.91(1件)

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

変更前

設定ファイルで新しい「auto」モードをデフォルトに指定しようとしても、スキーマ定義の不備によりエディタ上でエラーとして警告されたり、正しく認識されなかったりする場合がありました。

変更後

JSONスキーマが最新のパーミッション設定を正しく反映するように修正され、VS Codeなどのエディタで正確な入力補完と検証が行えるようになりました。

ユーザーへの恩恵

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

関連ドキュメント

v2.1.80(1件)

Fixed
PermissionsSettings
前回のセッションのキャッシュがある場合に、起動時に一部の管理設定(有効なプラグイン、パーミッション等)が適用されないバグを修正
英語原文を表示
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

変更前

組織で管理されている設定(Managed Settings)を使用していても、過去のセッション情報がキャッシュされていると、起動直後に最新の制限や環境変数が反映されない場合がありました。

変更後

キャッシュの有無に関わらず、起動時に管理ポリシーが確実に最優先で読み込まれるよう修正されました。

ユーザーへの恩恵

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

関連ドキュメント

v2.1.70(1件)

Fixed
PermissionsSettings
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

変更前

Web 上のリモート環境は本来自動で編集を承認する仕組みですが、ローカル用の設定ファイルにある不適切なモードが適用されてしまい、予期せぬ挙動を招く可能性がありました。

変更後

リモート環境の制約に合わせ、許可されていないパーミッションモードは安全に無視されるようになりました。

ユーザーへの恩恵

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

関連ドキュメント