Hook 脚本和 Claude Code 之间通过四个通道通信：
| 通道 | 方向 | 作用 |
|---|---|---|
| stdin | Claude Code → 脚本 | 传入 JSON 上下文数据（事件名、工具名、工具输入等） |
| stdout | 脚本 → Claude Code | 返回结构化 JSON，控制 Claude 的后续行为 |
| exit code | 脚本 → Claude Code | 基础决策信号：0 放行、2 阻断、其他为非阻断错误 |
| stderr | 脚本 → Claude Code | 调试信息通道。退出码 2 时，stderr 内容反馈给 Claude |
事件触发时，Claude Code 将一个 JSON 对象写入脚本的 stdin。所有事件共享以下公共字段：
| 字段 | 说明 |
|---|---|
session_id | 当前会话标识符 |
cwd | 触发时的工作目录 |
hook_event_name | 触发的事件名（如 PreToolUse） |
工具相关事件（PreToolUse / PostToolUse 等）额外包含 tool_name 和 tool_input。PostToolUse 还有 tool_output。
退出码 0 时，Claude Code 解析 stdout 中的 JSON。通用输出字段：
| 字段 | 默认值 | 作用 |
|---|---|---|
continue | true | 设为 false 时 Claude 立即停止处理 |
stopReason | 无 | continue 为 false 时显示给用户的原因 |
suppressOutput | false | 设为 true 时隐藏 stdout 内容 |
systemMessage | 无 | 显示给用户的警告消息 |