
30 秒速读
用 Claude Code 干活时最烦的一幕:一个长任务一跑就是十几分钟,主会话被占着,既不能并行聊别的,又怕关掉窗口任务就没了。本篇讲 agent-jobs 的三种运行方式怎么选、安装的 3 个关键卡点,以及装完必改的 4 个设置,把长任务丢给后台,主会话保持可交互。
软件信息
| 项目 | 说明 |
|---|---|
| 软件名称 | Agent Jobs |
| 类型 | 开源后台任务编排工具(据项目说明) |
| 开发语言 | Go(单个二进制) |
| 运行平台 | Linux / macOS |
| 前置依赖 | Claude Code(claude -p 无头能力)、Git |
| 数据存储 | SQLite(每个 agent 一个文件) |
| 服务方式 | systemd user service / launchd / 手动 CLI |
| 集成 | MCP(agent-jobs mcp 暴露任务工具) |
| 版本 | 以官网为准 |
| 更新日期 | 以官网为准 |
版本选择:三种运行方式,结论先行
结论:Linux 用 systemd user service,macOS 用 launchd,常驻运行。手动 CLI 只适合临时试一次——守护进程才能实现“重启后任务继续跑”,这正是它区别于 tmux 挂后台的核心价值。
| 运行方式 | 适合谁 | 代价 |
|---|---|---|
| systemd user service(Linux 推荐) | 长期在 Linux 开发机上用的人 | 要写 service 文件,开机自启自己配 |
| launchd(macOS 推荐) | Mac 开发机用户 | plist 配置略繁琐 |
| 手动 CLI | 临时试用、验证功能 | 关掉终端,任务管理就没了 |
明确推荐:决定长期用就一步到位配常驻服务;只想看看效果,手动 CLI 跑一两个任务验证报告契约是否符合你的习惯。
安装步骤:只讲 3 个关键卡点
- 先确认 claude -p 可用。Agent Jobs 的本质是把任务交给受限的后台 claude -p 进程执行,Claude Code 没装、或无头模式跑不通,后面全免谈。这是第零步。
- 放好 Go 二进制并给执行权限。单个二进制加 SQLite 就是它的全部家当,放到 PATH 里,确认
agent-jobs --help有输出。部署组件集中是它的一大优点,别自己把它搞复杂。 - 配常驻服务并验证重启恢复。按项目说明配好 systemd user service(或 macOS 的 launchd),然后重启一次守护进程,确认排队中的任务不受影响——这个验证不做,等于没用到它的核心能力。
装完必改的 4 个设置
- 1. 回合数 / 预算 / 墙钟超时(三重护栏):给每个任务设上限。体感差别:不设的话一个失控任务能把 API 额度烧穿;设了就是“花多少钱、跑多久”心里有数,睡觉也踏实。
- 2. 通知方式:任务完成后主会话只收到一行结果通知,详细报告按需读取。体感差别:默认配置可能让你错过完成提醒,按自己的工作习惯配通知渠道。
- 3. SQLite 存储位置与保留策略:每个 agent 一个 SQLite 文件。体感差别:默认放哪、任务记录保留多久,提前定好,省得历史任务把磁盘塞满了才发现。
- 4. MCP 任务工具暴露(agent-jobs mcp):把任务能力以 MCP 方式提供出去。体感差别:开了之后 Claude Code 主会话里就能直接发任务,不用切终端,工作流才真正闭环。
注意事项
- 任务卡死了怎么办:守护进程负责排队、启动、监控和清理任务;先看任务状态,墙钟超时护栏会兜底,必要时手动清理对应的 Git worktree。
- 主会话重启后任务还在吗:在。据项目说明,任务进程独立于主会话和守护进程,重启后继续跑,结果按固定报告契约返回,主会话按需读取。
- 它会不会自动 push 代码或发消息:不会。任务只改独立 Git worktree,不推送、不发布、不对外发消息;变更要你检查报告和 diff 之后自己操作,安全边界很清晰。
常见问题
- 能多机分布式调度吗:不能。据项目说明它面向单机 / 单主机工作流,多租户、分布式调度不在覆盖范围,有这类需求别硬套。
- 并发任务怎么管:每个任务独立 worktree、独立 SQLite,天然隔离;但并发策略和故障恢复细节据项目说明有限,生产化之前先从源码确认再压并发。
报错与排错
- claude -p 跑不通:先确认 Claude Code 已安装且无头模式可用,这是第零步;这一步不通,后面的任务编排全免谈,细节以官网为准。
- agent-jobs –help 无输出:先检查二进制是否已放进 PATH 并给了执行权限,再确认当前终端会话是否加载了正确的 PATH,仍无输出可重新下载对应平台的二进制对照。
适合谁,不适合谁
一句话:适合重度 Claude Code 用户、想把长任务异步化且接受单机工作流的个人开发者;不适合需要团队协作、多机调度,或者根本不用 Claude Code 的人——它的全部设计都绑在 claude -p 上。
GitHub 国内访问较慢,如打不开可多刷新几次
推荐版本:按平台选常驻服务。Linux 用 systemd user service,macOS 用 launchd;手动 CLI 只适合临时试一次,守护进程才能实现重启后任务继续跑。
| 版本运行方式 | 推荐程度 | 说明 |
|---|---|---|
| systemd user service(Linux) | 推荐,稳定常驻 | 长期在 Linux 开发机上用 |
| launchd(macOS) | 推荐,稳定常驻 | Mac 开发机用户 |
| 手动 CLI | 仅临时试用 | 关掉终端,任务管理就没了 |

关注「软件教程管家」
回复软件名即取即下:网盘下载链接 + 提取码,一步直达,不用再跳转。
本站资源仅供个人学习交流,请勿用于商业用途。软件与资料版权归原作者所有;如有侵权,请通过公众号「软件教程管家」联系我们,我们将在 24 小时内下架处理。查看免责声明 ›







