permissions.deny

settings.json型array記述場所どの設定ファイルでも可

拒否される操作に関するパーミッションルールのリストです。

記述例

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Bash(curl *)"
    ]
  }
}

使い方・用途

  • .env や機密情報が含まれるディレクトリへのアクセスを Claude に絶対に許可したくない場合に、最優先の制限として設定します。
  • セキュリティ上のリスクがある curl やネットワーク操作を禁止し、組織のポリシーに反するツールの実行を確実に阻止できます。
英語原文

List of permission rules for denied operations

関連ドキュメント

関連する変更履歴

v2.1.319(1件)

permissions.denyInsteadOfPrompting 設定を追加した: 権限プロンプトで待機することになる tool call は拒否され、ターンが続行される。ターミナルセッション、subagent、teammate に適用される
英語原文を表示
Added permissions.denyInsteadOfPrompting setting: a tool call that would wait on a permission prompt is denied and the turn continues, in terminal sessions, subagents and teammates

変更後

権限プロンプトへの回答待ちでターンが停止しなくなり、Claude が許可待ちで長時間止まることなく作業を続けられる。放置しがちなバックグラウンド実行やサブエージェント・チームメイトの処理でも、待ちが発生したものは自動的に拒否されるため、手動での対応なしにターンが完結する。

関連ドキュメント

v2.1.110(1件)

PermissionRequestフックによる入力更新後にpermissions.denyルールが再チェックされない問題、およびバイパス設定が制限を無視できる問題を修正
英語原文を表示
Fixed PermissionRequest hooks returning updatedInput not being re-checked against permissions.deny rules; setMode:'bypassPermissions' updates now respect disableBypassPermissionsMode

変更後

組織で設定したセキュリティポリシーをバイパスされるリスクが解消され、フック機能を安心して業務に組み込めます。

関連ドキュメント

v2.1.101(1件)

permissions.deny ルールが PreToolUse フックの permissionDecision: "ask" よりも優先されるよう修正
英語原文を表示
Fixed permissions.deny rules not overriding a PreToolUse hook's permissionDecision: "ask" — previously the hook could downgrade a deny into a prompt

変更後

セキュリティ設定の優先順位が明確になり、意図しないツールの実行をより確実に防止できます。

関連ドキュメント