settings.json

defaultMode

デフォルトのパーミッションモードを設定します（default, acceptEdits, plan, auto, dontAsk, bypassPermissions）。

使い方・用途

  • プロジェクトの性質に合わせて起動時のセキュリティレベルを調整できます。例えば、調査中心なら 'plan'、ガシガシ修正させたいなら 'acceptEdits' を選びます。
  • 'auto' モードを選択することで、安全な操作を Claude が背景で判断し、確認プロンプトの頻度を最小限に抑えたスムーズな対話を実現できます。
英語原文(公式ドキュメントより)

Default permission mode. "default": prompts on first use. "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.91 (1件)

Fixed
Settings Permissions
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
Settings Permissions
前回のセッションのキャッシュがある場合に、起動時に一部の管理設定（有効なプラグイン、パーミッション等）が適用されないバグを修正
英語原文を表示
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
Settings Permissions
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 上のリモート環境は本来自動で編集を承認する仕組みですが、ローカル用の設定ファイルにある不適切なモードが適用されてしまい、予期せぬ挙動を招く可能性がありました。

変更後

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

ユーザーへの恩恵

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

関連ドキュメント