アクション リファレンス

アクション種別

allow

コマンドの実行を許可します。出力なし。

allow ls
allow find
  next: bulkExec

Hook 動作: exit 0、出力なし。

deny

コマンドをブロックします。メッセージが stderr 経由で Claude に伝わり、自律的な書き直しが可能になります。

deny rm  "trash コマンドを使ってください"
deny eval  "eval は静的解析不能です。コマンドを直接記述してください"

Hook 動作: exit 2、メッセージが stderr に出力。

設計原則: deny メッセージには「なぜブロックされたか」と「代わりに何をすべきか」を書く。これにより ccchain は単なるブロッカーではなく、AI への教育ツールになります。

warn

コマンドを許可しますが、Claude に警告を送信します。

warn curl  "WebFetch の使用を検討してください"

Hook 動作: exit 0、{"decision":"allow","message":"..."} が stdout に出力。

注意: Claude が警告に従うかはモデル依存です。ccchain は exit code と出力フォーマットを保証しますが、Claude の振る舞いは制御しません。

ask

Claude Code の組み込みパーミッションダイアログに委譲し、ユーザーに判断を求めます。

ask rm
  message: "ファイル削除を確認してください"

Hook 動作: exit 0、{"decision":"ask"} が stdout に出力。

hint

注意: ccchain hook post は現在パススルーです。hint アクションと PostToolUse のルール評価は将来のリリースで対応予定です。

PostToolUse アクション。コマンド実行後に次のアクションを Claude に提案します。

postToolUse
  allow WebFetch
    mode: hint
    message: "結果をファイルに保存してください"

Hook 動作: exit 0、メッセージが stdout に出力（PostToolUse のみ）。

評価順序

last-rule-wins

複数のルールがマッチした場合、最後のマッチルールが優先:

allow rm      # 最初のマッチ
deny rm       # 最後のマッチ — こちらが勝つ

制限レベル

パイプラインや複合コマンドの評価では、全セグメントの中で最も制限的な結果が返されます:

レベル	アクション
0	allow
1	hint
2	warn
3	ask
4	deny

フォールバック

どのルールにもマッチしないコマンドは fallback 設定に従います（デフォルト: ask）。

動的コマンド

変数展開やコマンド置換を含むコマンドは自動的に deny されます:

$cmd foo              # → deny（変数がコマンド名）
$(generate_cmd) foo   # → deny（コマンド置換がコマンド名）
eval "$dynamic"       # → deny（動的な eval 引数）

メッセージ: "dynamic command detected: static analysis not possible"