在 tmux 中 7x24 小时运行 Claude 智能体

https://t.co/hgH0awBoRY https://t.co/YIROMvZ9sp

Jedward23/Tmux-Orchestrator

来源: https://github.com/Jedward23/Tmux-Orchestrator

编排器英雄

在你睡觉时让 AI 智能体全天候运行 - Tmux 编排器使 Claude 智能体能够自主工作、安排自身的检查点，并在多个项目之间进行协调，无需人工干预。

🤖 关键能力与自主功能

• 自我触发 - 智能体自行安排检查点并自主继续工作
• 协同合作 - 项目经理向跨越多个代码库的工程师分配任务
• 持久运行 - 即使你合上笔记本电脑，工作也会继续进行
• 可扩展性 - 同时运行多个团队处理不同的项目

🏗️ 架构

Tmux 编排器使用三层层级结构来克服上下文窗口的限制：

┌─────────────┐ │ 编排器 │ ← 你在此处交互 └──────┬──────┘ │ 监控与协调 ▼ ┌─────────────┐ ┌─────────────┐ │ 项目 │ │ 项目 │ │ 经理 1 │ │ 经理 2 │ ← 分配任务，执行规范 └──────┬──────┘ └──────┬──────┘ │ │ ▼ ▼ ┌─────────────┐ ┌─────────────┐ │ 工程师 1 │ │ 工程师 2 │ ← 编写代码，修复错误 └─────────────┘ └─────────────┘

为什么要分离智能体？

• 上下文窗口有限 - 每个智能体专注于其角色
• 专业专长 - 项目经理进行管理，工程师编写代码
• 并行工作 - 多个工程师可以同时工作
• 更好的记忆 - 较小的上下文意味着更好的回忆能力

📸 实际操作示例

项目经理协调

启动项目经理 编排器创建并简报新的项目经理智能体

状态报告与监控

状态报告 多个并行工作的智能体提供的实时状态更新

Tmux 通信

读取 TMUX 窗口并发送消息 智能体如何在 tmux 窗口和会话之间进行通信

项目完成

项目已完成 成功完成项目，所有任务均已验证并提交

🎯 快速入门

选项 1：基本设置（单项目）

``bash

1. 创建项目规范

cat > project_spec.md << ‘EOF’ 项目：我的 Web 应用 目标：添加用户认证系统 约束：

• 使用现有的数据库架构
• 遵循当前的代码模式
• 每 30 分钟提交一次
• 为新功能编写测试

交付物：

1. 登录/注销端点
2. 用户会话管理
3. 受保护的路由中间件 EOF

2. 启动 tmux 会话

tmux new-session -s my-project

3. 在窗口 0 中启动项目经理

claude

4. 给 PM 规范，让它创建工程师

“你是一个项目经理。阅读 project_spec.md 并在窗口 1 中创建一个工程师 来实现它。每 30 分钟安排一次检查。”

5. 安排编排器检查

./schedule_with_note.sh 30 “检查 PM 在认证系统方面的进度” ``

选项 2：完整编排器设置

``bash

启动编排器

tmux new-session -s orchestrator claude

给它你的项目

“你是编排器。为以下项目设置项目经理：

1. 前端（React 应用）- 添加仪表板图表
2. 后端（FastAPI）- 优化数据库查询 安排自己每小时检查一次。” ``

✨ 关键功能

🔄 自我调度智能体

智能体可以使用以下命令自行安排检查点： bash ./schedule_with_note.sh 30 “继续仪表板实现”

👥 多智能体协调

• 项目经理与工程师通信
• 编排器监控所有项目经理
• 跨项目知识共享

💾 自动 Git 备份

• 每 30 分钟的工作进行一次提交
• 标记稳定版本
• 为实验创建功能分支

📊 实时监控

• 查看每个智能体正在做什么
• 在需要时介入
• 审查所有项目的进度

📋 最佳实践

编写有效的规范

``markdown 项目：电商结账 目标：实现多步骤结账流程

约束：

• 使用现有的购物车状态管理
• 遵循当前的设计系统
• 最多 3 个 API 端点
• 每完成一步后提交

交付物：

1. 带验证的配送地址表单
2. 支付方式选择（Stripe 集成）
3. 订单审查和确认页面
4. 成功/失败处理

成功标准：

• 所有表单正确验证
• 支付处理无错误
• 订单数据持久化到数据库
• 完成时发送邮件 ``

Git 安全规则

1. 开始任何任务之前 bash git checkout -b feature/[任务名称] git status # 确保干净状态

2. 每 30 分钟 bash git add -A git commit -m “进度：[完成了什么]”

3. 任务完成时 bash git tag stable-[功能]-[日期] git checkout main git merge feature/[任务名称]

🚨 常见陷阱与解决方案

🛠️ 工作原理

Tmux 的魔力

Tmux（终端复用器）是关键推动力，因为：

• 即使断开连接，它也能保持终端会话
• 允许在一个会话中有多个窗口/窗格
• Claude 在终端中运行，因此它可以控制其他 Claude 实例
• 可以以编程方式向任何窗口发送命令

💬 简化的智能体通信

我们现在对所有智能体通信使用 send-claude-message.sh 脚本：

``bash

向任何 Claude 智能体发送消息

./send-claude-message.sh session:window “你的消息在这里”

示例：

./send-claude-message.sh frontend:0 “登录表单的进度如何？” ./send-claude-message.sh backend:1 “API 端点 /api/users 返回 404” ./send-claude-message.sh project-manager:0 “请与 QA 团队协调” ``

该脚本自动处理所有定时复杂性，使智能体通信可靠且一致。

安排检查点

``bash

使用具体、可操作的注释进行调度

./schedule_with_note.sh 30 “审查认证实现，分配下一个任务” ./schedule_with_note.sh 60 “检查测试覆盖率，如果通过则合并” ./schedule_with_note.sh 120 “全面系统检查，如有必要轮换任务” ``

重要：编排器需要知道它正在运行的 tmux 窗口，以正确安排自己的检查点。如果调度不起作用，请使用以下命令验证编排器是否知道其当前窗口： bash echo “当前窗口: $(tmux display-message -p "#{session_name}:#{window_index}")"

🎓 高级用法

多项目编排

``bash

启动编排器

tmux new-session -s orchestrator

为每个项目创建项目经理

tmux new-window -n frontend-pm tmux new-window -n backend-pm
tmux new-window -n mobile-pm

每个 PM 管理自己的工程师

编排器在 PM 之间进行协调

``

跨项目智能

编排器可以在项目之间共享见解：

• “前端正在使用 /api/v2/users，相应更新后端”
• “认证在项目 A 中工作正常，在项目 B 中使用相同的模式”
• “在共享库中发现性能问题，在所有项目中修复”

📚 核心文件

• send-claude-message.sh - 简化的智能体通信脚本
• schedule_with_note.sh - 自我调度功能
• tmux_utils.py - Tmux 交互工具
• CLAUDE.md - 智能体行为指令
• LEARNINGS.md - 积累的知识库

🤝 贡献与优化

编排器通过社区发现和优化学到。在贡献时：

1. 在 CLAUDE.md 中记录新的 tmux 命令和模式
2. 分享新颖的用例和智能体协调策略
3. 提交 Claude 同步的优化
4. 根据最新发现保持命令参考最新
5. 在多个会话和场景中测试改进

关键改进领域：

• 智能体通信模式
• 跨项目协调
• 新颖的自动化工作流程

📄 许可证

MIT 许可证 - 自由但明智地使用。记住：伟大的自动化带来伟大的责任。

“我们今天建造的工具明天将编程自己” - Alan Kay, 1971