26.6 自动编程与Stop Hook

约 1359 字大约 5 分钟

自动编程概述

在2026年，Claude Code的自动编程功能已经成为构建自主、自我修复开发工作流的标准。通过Stop hook（停止钩子）等高级功能，开发者可以实现"Auto Code Forever"（永远自动编码）的工作模式，让Claude Code能够在无人干预的情况下持续运行数小时甚至数天，自主完成从代码生成到测试修复的全流程。

Stop Hook核心概念

1. 什么是Stop Hook

Stop Hook是Claude Code在每个工作周期结束时自动执行的操作，可以是shell命令或基于LLM的提示。与普通提示不同，Hook是由环境强制执行的保证动作，提供了确定性的控制机制。

Stop Hook的类型

命令类型Hook：执行shell命令，用于检查错误、运行测试或执行其他自动化任务
提示类型Hook：使用"type: prompt"配置，允许LLM评估工作是否真正完成或是否需要触发后续操作

2. Stop Hook的工作原理

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│ Claude完成任务  │────▶│ Stop Hook触发   │────▶│ 执行检查/评估   │
└─────────────────┘     └─────────────────┘     └─────────────────┘
                               ▲                      │
                               │                      ▼
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│ 继续执行任务    │◀────│ 反馈结果给Claude │◀────│ 生成反馈/指令   │
└─────────────────┘     └─────────────────┘     └─────────────────┘

实现"Auto Code Forever"的模式

1. 链式反应循环

配置Stop Hook运行脚本检查错误（ linting、测试等）。如果发现错误，脚本会以特定状态退出，迫使Claude重新评估并继续修复代码。

# 示例：使用Biome进行代码检查的Stop Hook脚本
#!/bin/bash

# 运行代码检查
npx biome check src

# 如果发现错误，以状态码1退出，提示Claude继续修复
if [ $? -ne 0 ]; then
    echo "发现代码错误，请Claude继续修复"
    exit 1
fi

echo "代码检查通过，任务完成"
exit 0

2. 自主Agent框架

用户在远程VPS服务器（如AWS EC2或Hetzner）上部署Claude Code，并使用--dangerously-skip-permissions标志绕过手动批准提示，使其能够24/7无人工干预运行。

# 示例：在远程服务器上启动Claude Code的命令
claude --dangerously-skip-permissions --project-path /home/user/my-project

3. Todo驱动开发

通过维护PROJECT.md或todo.md文件，使用Hook在当前任务结束后立即向Claude提供列表中的下一个任务。

# todo.md示例

## 待办任务
1. ✅ 实现用户认证功能
2. ⏳ 开发数据模型
3. ⏳ 集成API接口
4. ⏳ 编写测试用例

# 示例：读取下一个任务的Hook脚本
#!/bin/bash

# 查找下一个未完成的任务
next_task=$(grep -n "⏳" todo.md | head -1)

# 如果找到任务，以状态码1退出并提供下一个任务
if [ ! -z "$next_task" ]; then
    echo "当前任务完成，下一个任务：$next_task"
    exit 1
fi

echo "所有任务已完成"
exit 0

设置与命令

1. 配置Hook

在终端中输入/hooks打开交互式配置菜单，或直接编辑配置文件：

// claude/settings.json
{
  "hooks": {
    "Stop": {
      "type": "command",
      "command": "./scripts/check-code.sh",
      "match": ".*"
    },
    "PostToolUse": {
      "type": "command",
      "command": "./scripts/format-code.sh",
      "match": ".*\.(js|ts|tsx)$"
    }
  }
}

2. 自动继续命令

使用以下命令允许Agent在不请求权限的情况下执行shell命令和文件编辑：

claude --dangerously-skip-permissions

3. 中断操作

按Escape键停止当前工作周期
按Ctrl+C完全退出会话

流行的自动化工具

1. claude-mem

一个插件，用于在无限会话中保留项目上下文，防止AI在长时间运行的任务中"变笨"或失去目标跟踪。

2. CC AutoRenew

防止会话过期间隙的工具，确保Agent在计划的编码块期间保持活跃。

注意事项与最佳实践

1. 避免无限循环

谨慎使用调用claude的Hook
使用条件或最大迭代次数防止失控成本
示例：在脚本中添加计数器

#!/bin/bash

# 检查是否达到最大迭代次数
if [ -f .iteration_count ]; then
    count=$(cat .iteration_count)
    if [ $count -ge 10 ]; then
        echo "已达到最大迭代次数10，停止自动修复"
        exit 0
    fi
    count=$((count+1))
else
    count=1
fi

echo $count > .iteration_count

# 继续执行检查...

2. 错误处理

使用非零退出码向Claude发出问题信号
状态码2会阻止继续执行

3. 安全考虑

--dangerously-skip-permissions标志会绕过所有权限检查，请谨慎使用
在生产环境中建议保留手动批准机制
定期监控长时间运行的任务