Claude AI 钩子开发指南 - 自定义事件处理与自动化工作流

hooks by parcadei/continuous-claude-v3

209 周安装量

3,600 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/parcadei/continuous-claude-v3 --skill hooks

AI/机器学习开发自动化

🇨🇳中文介绍

钩子开发规则

在 .claude/hooks/ 目录下处理文件时：

模式

Shell 包装器 (.sh) → 通过 npx tsx 调用 TypeScript (.ts)

Shell 包装器模板

#!/bin/bash
set -e
cd "$CLAUDE_PROJECT_DIR/.claude/hooks"
cat | npx tsx <handler>.ts

TypeScript 处理器模式

interface HookInput {
  // 事件特定字段
}

async function main() {
  const input: HookInput = JSON.parse(await readStdin());

  // 处理输入

  const output = {
    result: 'continue',  // 或 'block'
    message: '可选的系统提醒信息'
  };

  console.log(JSON.stringify(output));
}

钩子事件

PreToolUse - 工具执行前（可阻止执行）
PostToolUse - 工具执行后
UserPromptSubmit - 处理用户提示前
PreCompact - 上下文压缩前
SessionStart - 会话开始/恢复/压缩时

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

🇺🇸English

Hook Development Rules

When working with files in .claude/hooks/:

Pattern

Shell wrapper (.sh) → TypeScript (.ts) via npx tsx

Shell Wrapper Template

#!/bin/bash
set -e
cd "$CLAUDE_PROJECT_DIR/.claude/hooks"
cat | npx tsx <handler>.ts

TypeScript Handler Pattern

interface HookInput {
  // Event-specific fields
}

async function main() {
  const input: HookInput = JSON.parse(await readStdin());

  // Process input

  const output = {
    result: 'continue',  // or 'block'
    message: 'Optional system reminder'
  };

  console.log(JSON.stringify(output));
}

Hook Events

PreToolUse - Before tool execution (can block)
PostToolUse - After tool execution
UserPromptSubmit - Before processing user prompt
PreCompact - Before context compaction
SessionStart - On session start/resume/compact
Stop - When agent finishes

Testing

Test hooks manually:

echo '{"type": "resume"}' | .claude/hooks/session-start-continuity.sh

Registration

Add hooks to .claude/settings.json:

{
  "hooks": {
    "EventName": [{
      "matcher": ["pattern"],  // Optional
      "hooks": [{
        "type": "command",
        "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/hook.sh"
      }]
    }]
  }
}

Weekly Installs

209

Repository

parcadei/contin…laude-v3

GitHub Stars

3.6K

First Seen

Jan 22, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode200

codex200

gemini-cli197

cursor197

github-copilot195

amp189