autoMode

settings.json型object記述場所ユーザー設定または管理者設定

オートモードの分類子プロンプトをカスタマイズします。

含まれる設定

5件
  • allowstring[]オートモードの分類器における許可セクションのルールを設定します。
  • classifyAllShellboolean任意のコード実行パターンだけでなく、すべてのBash/PowerShellコマンドを自動モードの分類器(classifier)経由で実行します。
  • environmentstring[]オートモードの分類器における環境コンテキストセクションのルールを設定します。
  • hard_denystring[]オートモードの分類器におけるハード拒否ルールのリストを設定します。
  • soft_denystring[]オートモードの分類器におけるソフト拒否セクションのルールを設定します。

記述例

{
  "autoMode": {
    "soft_deny": ["$defaults", "Never run terraform apply"]
  }
}

使い方・用途

  • permissions.defaultMode が「auto」の場合に適用される許可/拒否ルールを調整する
  • autoMode.allow、soft_deny、environment 内に "$defaults" を含めることで、組み込みのデフォルトルールを維持したまま独自のルールを追加できる
  • autoMode.classifyAllShell を true に設定すると、オートモード中のすべての Bash/PowerShell コマンドが分類器を通過するようになる（v2.1.193 以降）
英語原文

Customization for the auto mode classifier prompt. Typically configured in managed settings to tune the allow/deny rules used when permissions.defaultMode is "auto". By default, allow, soft_deny, and environment REPLACE the corresponding built-in classifier section entirely. Include the literal string "$defaults" as an array entry (added in v2.1.118) to splice the built-in defaults in at that position alongside your custom rules. See https://code.claude.com/docs/en/permissions

関連ドキュメント

関連する変更履歴

v2.1.319(1件)

パーミッションルールや autoMode 設定が非常に大きい場合に、オートモードが理由を示さずにアクションを拒否する問題を修正した。現在は理由を説明し、autoMode の deny ルールが設定されていない場合にはターミナルで確認を求める
英語原文を表示
Fixed auto mode refusing actions without saying why when permission rules or autoMode settings are very large: it now explains and, unless autoMode deny rules are set, asks you in the terminal

関連ドキュメント

v2.1.316(2件)

'$defaults' を含まない管理された autoMode.allow リストが、ホストアプリの --settings、/permissions で追加した最初のルール、または /auto-mode-setup によって組み込みの例外を復元してしまう問題を修正した
英語原文を表示
Fixed a managed autoMode.allow list without "$defaults" getting the built-in exceptions back from a host app's --settings, a first rule added in /permissions, or /auto-mode-setup

関連ドキュメント

自動モードの挙動を変更した。'$defaults' を含まない autoMode.allow リストが、スケジュールタスクのプロンプトに関する組み込みルールを削除しなくなった
英語原文を表示
Changed auto mode so that an autoMode.allow list without "$defaults" no longer removes the built-in rule on scheduled-task prompts

変更後

autoMode.allow リストに '$defaults' を書き忘れても、スケジュールタスクのプロンプトに対する組み込みルールが消えなくなったため、許可設定を追加した際に意図せず組み込みの動作が失われることがなくなった。

関連ドキュメント

v2.1.282(1件)

ネストされた 1 つの値が不正な場合に、マネージドの permissions、autoMode、worktree、attribution 設定全体が無視される問題を修正した。ブロックの残りの部分は引き続き適用されるようになった
英語原文を表示
Fixed managed permissions, autoMode, worktree and attribution settings being ignored entirely when one nested value was invalid; the rest of the block now still applies

関連ドキュメント

v2.1.207(1件)

オートモードにおいて、リポジトリ内の.claude/settings.local.jsonからautoMode設定を読み込まないようになりました。今後は~/.claude/settings.jsonを使用してください。
英語原文を表示
Changed auto mode to no longer read autoMode from .claude/settings.local.json (repo-resident); use ~/.claude/settings.json instead

変更後

リポジトリごとにオートモードの設定を書き直す必要がなくなり、自分の信頼設定を一箇所で一元管理できるようになります。

関連ドキュメント

v2.1.193(1件)

すべてのBash/PowerShellコマンドをAutoモードの分類器経由で実行する autoMode.classifyAllShell 設定を追加
英語原文を表示
Added autoMode.classifyAllShell setting to route all Bash/PowerShell commands through the auto-mode classifier instead of only arbitrary-code-execution patterns

変更後

安全性を維持しつつ、信頼できる環境での定型的なシェル操作に対する手動承認の頻度をさらに減らすことができます。

関連ドキュメント

v2.1.136(1件)

オートモード(auto mode)の判定ルールに、例外を認めず無条件に実行を拒否する hard_deny 設定を追加しました。
英語原文を表示
Added settings.autoMode.hard_deny for auto mode classifier rules that block unconditionally regardless of user intent or allow exceptions

変更後

デプロイや権限変更などの重要な操作を確実にガードし、AIによる意図しない高リスクな操作を未然に防ぐことができます。

関連ドキュメント

v2.1.118(1件)

Auto mode(オートモード)：autoMode.allow、autoMode.soft_deny、autoMode.environment 内に "$defaults" を含めることで、組み込みのルールリストを置き換えるのではなく、カスタムルールを追加できるようになりました。
英語原文を表示
Auto mode: include "$defaults" in autoMode.allow, autoMode.soft_deny, or autoMode.environment to add custom rules alongside the built-in list instead of replacing it

変更後

デフォルトの強力な安全策を損なうことなく、最小限の設定で独自の環境に合わせた最適化が行えるため、オートモードの導入がより安全かつスムーズになります。

関連ドキュメント