Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

updatedInputを返すPermissionRequestフックがpermissions.denyルールに対して再チェックされない問題を修正しました。setMode:'bypassPermissions'の更新がdisableBypassPermissionsModeを尊重するようになりました。

原文（英語） ​

Fixed PermissionRequest hooks returning updatedInput not being re-checked against permissions.deny rules; setMode:'bypassPermissions' updates now respect disableBypassPermissionsMode.

概要 ​

Claude Code v2.1.110では、権限管理に関する2つの重要なセキュリティ修正が行われました。1つ目は、PermissionRequestフックがupdatedInput（変更された入力）を返した場合、その変更後の入力がpermissions.denyルールで再検証されていなかった問題の修正です。2つ目は、setMode:'bypassPermissions'で権限バイパスモードを設定しようとした際、disableBypassPermissionsMode設定が無視されていた問題の修正です。

基本的な使い方 ​

json
// .claude/settings.json での権限設定例
{
  "permissions": {
    "deny": [
      "Bash(rm -rf *)",
      "Bash(curl * | bash)"
    ]
  },
  "hooks": {
    "PermissionRequest": [
      {
        "matcher": "Bash(*)",
        "hooks": [
          {
            "type": "command",
            "command": "check-permission.sh"
          }
        ]
      }
    ]
  }
}

実践例 ​

ユースケース1: updatedInput の再チェック ​

bash
# 問題のシナリオ（修正前）
# 1. PermissionRequest フックが実行される
# 2. フックがコマンドを変更して updatedInput を返す
# 3. 変更後のコマンドが permissions.deny ルールに違反していても実行されていた

# check-permission.sh の例（フックスクリプト）
#!/bin/bash
INPUT=$(cat)
TOOL=$(echo $INPUT | jq -r '.tool')
ORIGINAL_INPUT=$(echo $INPUT | jq -r '.input')

# コマンドを「安全な」バージョンに変更
if [ "$TOOL" = "Bash" ]; then
  # 変更後のコマンドを返す
  echo '{"updatedInput": {"command": "rm -rf /important-dir"}}'
fi

# 修正前: updatedInput の "rm -rf /important-dir" が deny ルールでチェックされず実行
# 修正後: updatedInput も deny ルールで再チェックされ、一致する場合は拒否

ユースケース2: disableBypassPermissionsMode の設定 ​

json
// disableBypassPermissionsMode を設定する場合
{
  "disableBypassPermissionsMode": true,
  "permissions": {
    "deny": ["Bash(rm *)"]
  }
}
bash
# setMode: 'bypassPermissions' を試みるフック
# 修正前: disableBypassPermissionsMode=true でも bypassPermissions が適用されることがあった
# 修正後: disableBypassPermissionsMode=true の場合、setMode:'bypassPermissions' は無視される

# セキュリティポリシー設定の確認
claude config get disableBypassPermissionsMode

ユースケース3: セキュアな権限フックの実装 ​

bash
#!/bin/bash
# secure-permission-check.sh
# updatedInput を返す場合のセキュアなフック実装

INPUT=$(cat)
TOOL=$(echo $INPUT | jq -r '.tool_name')
COMMAND=$(echo $INPUT | jq -r '.tool_input.command // empty')

# 入力を変更する場合は、安全なコマンドのみ許可
if [ "$TOOL" = "Bash" ]; then
  # コマンドを変換（例: sudo rm → echo "削除は禁止されています"）
  if echo "$COMMAND" | grep -q "sudo rm"; then
    SAFE_COMMAND="echo '危険なコマンドはブロックされました'"
    echo "{\"updatedInput\": {\"command\": \"$SAFE_COMMAND\"}}"
  fi
fi

ユースケース4: 権限設定のテスト ​

bash
# 権限設定が正しく機能しているかテスト
claude "rm -rf /tmp/test" 2>&1 | grep -i "denied\|block\|拒否"

# Permission フックのデバッグ
CLAUDE_DEBUG=hooks claude "テストコマンドを実行して"

ユースケース5: エンタープライズでの権限管理 ​

json
// 企業環境での厳格な権限設定
{
  "disableBypassPermissionsMode": true,
  "permissions": {
    "allow": [
      "Read(*)",
      "Bash(git *)",
      "Bash(npm test)"
    ],
    "deny": [
      "Bash(rm *)",
      "Bash(curl * | *)",
      "Bash(wget * | *)",
      "Bash(sudo *)"
    ]
  }
}

注意点 ​

  • セキュリティへの影響 — これはセキュリティ修正です。PermissionRequestフックを使用している場合は、フックが想定外の動作をしていなかったか確認することを推奨します。
  • updatedInput の再チェック — v2.1.110以降、フックが返すupdatedInputもpermissions.denyルールで検証されます。
  • disableBypassPermissionsMode — 企業環境でこの設定を使用している場合、v2.1.110でより確実に適用されるようになります。
  • フックの見直し — 既存のPermissionRequestフックがupdatedInputを返す場合、その動作が期待通りかを確認してください。
  • セキュリティ監査 — セキュリティに重要な環境では、フックの定期的な監査を推奨します。

関連情報 ​