Agent Autoloop 怎么用?让 Claude Code / Codex 在后台自己接活,拿不准才发卡片问你(安装、rules.json、实测)

Agent Autoloop 把 Claude Code、Codex 等命令行 Agent 变成后台循环:事件或定时派活,Agent 干完一轮就退出,只有拿不准才发卡片;你答完再续上原会话。本文按官方 README 与 SECURITY 说明安装与配置,并在本机实测 agent-autoloop try → answer → status 审批闭环,附 rules.json 早报示例、接本站 API Key 的写法,以及无人值守安全红线。

7 分钟阅读
Agent Autoloop 怎么用?让 Claude Code / Codex 在后台自己接活,拿不准才发卡片问你(安装、rules.json、实测)

先说结论:

  • Agent Autoloop(MIT)把「人守终端」改成「事件 / 定时派活 → Agent 干完一轮退出 → 拿不准才发卡片 → 你回答后继续」。官方 README 写明:macOS / Linux;Windows 官方版待定(进度见 issue #17,README 称目前可用 WSL2)。
  • 安装一行:curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh,装完先 agent-autoloop try。
  • 我们 2026 年 11 月 6 日在 Linux 上实测:Node 升到 24.22.2,装上 agent-autoloop v1.5.0,用 Codex(本站 Key,模型 gpt-6.1-sol)跑通审批闭环——提问约 9 秒出卡片,回答「绿色」后同一会话约 10 秒收束为「试跑通过」。无图形界面时桌面通知发不出(notify-send 不存在),用 status / answer 仍可完成。
  • 规则写在 ~/.agent-autoloop/rules.json:一条 cron 早报、一条 GitHub issues 规则即可起步;改完几秒内生效,用 agent-autoloop check 校验。
  • 无人值守等于把本机权限交给循环:卡片链接勿外传、Webhook 要鉴权;据项目 SECURITY,提示注入未根治,默认权限是 edit,有副作用的事先 ask。

创建 API Key,给 Claude Code / Codex 接上再跑后台循环 →

它解决什么问题

多数人用 Claude Code 或 Codex 时,是守着终端:输入 Prompt、盯着跑、随时回答追问。关掉窗口或走开,活就停了。

Agent Autoloop 的中心是一个确定性 kernel(官方称约 1650 行、运行时零依赖),四周用插件接事件源、Agent、通知通道和交付流水线。一条活的路径大致是:

  1. 事件进来:早上 9 点的 cron、新的 GitHub Issue、或一条告警,变成标准事件。
  2. 按规则派发:rules.json 决定交给哪个 Agent、在哪个目录干;同一主题排队中的新事件会合并进一轮。
  3. 干完一轮就退出:结论写在最终消息里,进程退出——等待你决策时不占 Agent 进程。
  4. 拿不准才发卡片:删数据、重启服务、对外发消息等敏感动作,通过飞书 / 钉钉 / 企微 / Slack / Discord 或桌面通知问你。
  5. 你点一下继续:回答会续上原来的会话把活做完。

官方 README 还写明:Claude Code、Codex、ACP(配合官方 Codex ACP 适配器)已实测过多轮问答与跨进程会话续接;飞书做过真实投递与按钮回调。Webhook 四套模板、GitLab Webhook 等则以本地 mock / 文档载荷核对为主,文中凡属此类会标「据官方 README」。

前置条件

项要求
系统macOS 或 Linux。Windows 官方版待定,进度见 issue #17;据 INSTALL,WSL2 可按 Linux 安装,需注意 systemd / linger / 桌面通知到不了 Windows 桌面等差异
运行时Node.js 24+、Git、curl
Agent至少装好并可用的 Claude Code 或 Codex(也可用 command 插件接其他 CLI)
本站 Key(可选)要用 aicodewith 的模型额度时,先注册并创建 API Key

我们这台机器原先是 Node 22,用 n 24 升到 24.22.2 后再装;agent-autoloop doctor 会检查 Node 大版本。

第 0 步:创建 API Key(接 Claude Code / Codex)

  1. 在 aicodewith.ai 注册并登录,点左侧「密钥管理」。
  2. 「创建密钥」,起一个好认的名字,比如「autoloop-box」。
  3. 确认后立刻复制完整 Key 存好;窗口关掉就看不到完整 Key。说明见创建 API Key 文档。

创建 API Key →

Codex 写全局 ~/.codex/config.toml(按本站 Codex 教程写在 Provider 段,不要用环境变量名去引用 Key):

toml
model = "gpt-6.1-sol"
model_provider = "aicodewith"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "你的 API Key"

Claude Code 写 ~/.claude/settings.json:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key"
  }
}

还没装 Codex 的先看《Codex 安装教程》,Key 与 Provider 细节见《Codex API Key 配置》和《Codex config.toml 配置指南》。后台子 Agent 相关可对照《Claude Code 后台子 Agent 状态行》;若你在找 Conductor 停服后的并行方案,见《Conductor 停服替代:git worktree》。

安装

bash
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh

安装器会把程序放到 ~/.agent-autoloop/app,配置与记录在 ~/.agent-autoloop,并尽量在 ~/.local/bin 放上 agent-autoloop 命令。无图形会话、CI 或临时 HOME 时,按 INSTALL 加 --no-service,再手动 agent-autoloop up。

我们实测(2026-11-06,Asia/Shanghai):

text
装好了。
  Agent:Codex
  通道:桌面通知
  规则:~/.agent-autoloop/rules.json
agent-autoloop v1.5.0(提交 f211ca2de3b1)

然后:

bash
agent-autoloop --version
agent-autoloop doctor
agent-autoloop up          # --no-service 安装时需要
agent-autoloop try

最小闭环:try → answer → status

try 会向本机发出试跑事件,按默认规则交给已接好的 Agent。非交互终端里,它打印问题与 answer 命令后退出——这是在等你,不是失败。

我们用 Codex 跑通的时间线(北京时间):

步骤时刻结果
agent-autoloop try15:25:01 → 15:25:10约 9 秒结束本轮,弹出卡片「试跑:选一个颜色」(蓝色 / 绿色)
agent-autoloop answer 1 215:25:27选绿色;中台立刻开第 3 轮,同一 Codex 会话续接
续跑结束15:25:27 → 15:25:37约 10 秒,结论「你选了绿色,试跑通过」
桌面通知同时本机无 notify-send,日志为 spawn notify-send ENOENT;用 CLI 仍可答完

终端里看到的关键输出类似:

text
事件发出去了,Agent 开始干活……

Agent 结束了这一轮,问了你一个问题。它现在不占进程、不花 Token。

【等你决定】#1 试跑:选一个颜色
这是一次试跑,选哪个都行。
  1. 蓝色
  2. 绿色
回答:agent-autoloop answer 1 <序号>
答完运行 agent-autoloop status,能看到它接着把活干完。

答完后:

bash
agent-autoloop answer 1 2
agent-autoloop status
agent-autoloop why 3

why 3 里可以看到:触发类型 card.answered、同一 codex://threads/... 会话、结束语「你选了绿色,试跑通过」。

诚实记录:第一次 try 曾因 Codex 默认模型名在本站未上线而失败;把 ~/.codex/config.toml 的 model 改成控制台可用的 gpt-6.1-sol 后重跑才通过。Claude Code 侧我们另用同一 Key 做了独立冒烟(约 6 秒返回 OK);本次 try 闭环走的是 Codex 插件。

写 rules.json

打开 ~/.agent-autoloop/rules.json,在 rules 里声明「什么时候、交给谁、在哪干」。to 必须是 agents 里已有的名字。

定时早报示例(据官方 README):

json
{
  "name": "Morning brief",
  "when": { "cron": "0 9 * * *" },
  "to": "codex",
  "cwd": "~/notes",
  "prompt": "Summarize yesterday's notes and commits into today's brief."
}

我们把等价规则临时写进本机后运行:

bash
agent-autoloop check
agent-autoloop rules explain

check 输出「规则没问题」;rules explain 显示时区 Asia/Shanghai,并列出「Morning brief:定时 每天 09:00(下次 11/07 09:00)→ codex」。保存后几秒内生效;文件坏了或读不到时,据 README,中台会继续跑上一份有效规则并给你发卡片。

GitHub Issue 示例(需先按手册在 sources 里接好 github):

json
{
  "name": "Handle issues",
  "when": { "source": "github", "types": ["issues.opened"] },
  "to": "codex",
  "cwd": "~/code/app",
  "skill": "handle-issue",
  "parallel": 3
}

官方还提供早报、Issue、告警、反馈、网站巡检、飞书周报、PR 交付等场景模板;启用时把对应 Skill 放进 Agent 的 skills 目录,再合并示例规则。

接 Claude Code、Codex 与其他 CLI

rules.json 的 agents 里,use 可以是内置的 claude、codex、acp、dsh,或 command 一行命令({prompt} 作为单个参数,不经 shell 拼接)。据官方 README:Claude Code / Codex / ACP 已跑过多轮与会话续接;Cursor CLI、pi、OpenClaw、Hermes、CodeBuddy 等 command 示例来自各工具文档,作者标明尚未逐一手测。

和「人守多个终端 / worktree」不同,Autoloop 侧重事件驱动的后台循环;若你要的是一任务一目录并行,仍可看Conductor 替代教程。Claude Code / Codex / Cursor 并列可选,按你本机已登录的客户端来接即可。

安全红线(无人值守必读)

据项目 SECURITY与 README「Usage and provider terms」:

  • 本机权限:循环跑在你的账号下;默认 access 是 edit,给 full 前想清楚 Agent 能碰到什么。有副作用的动作走 ask / askFirst。
  • 卡片链接:谁拿到谁就能回答该卡,创建起 7 天内有效;不要发到公开频道。链接回答是持有即授权。
  • 事件进不了调度:谁干、在哪个目录、什么 Skill、什么权限,只由 rules.json 决定;别人写的标题正文默认进资料文件,不直接拼进 Prompt——但这挡不住所有提示注入,Agent 仍可能读到外部文本。
  • Webhook / 通道:对外要 HTTPS 反代;Webhook 模板据文档没有外部幂等保证;接飞书等通道时按手册做鉴权,私人反馈不要接到共享群。
  • 凭据:中台不读取、不中转 Claude Code / Codex 的登录态;模型用量记在你自己的账号下。自动化负载请用 API Key,而不是个人订阅额度(据 Anthropic / OpenAI 对自动化场景的一般建议,见各厂文档)。
  • 测完清理:本机测完后删除含 Key 的 config.toml / settings.json 与相关日志,全盘搜索 Key 片段应为 0。

二手文章(如 explainx.ai、karmazinmedia 等)可作「据报道」了解氛围,具体命令与安全边界以仓库 README / SECURITY / INSTALL 为准。

常见问题

Windows 能不能装?

官方 README 写明 Windows 版待定,作者计划在 11 月 7–8 日回家后做兼容测试,进度见 issue #17。据 INSTALL,现在可用 WSL2 按 Linux 安装,并注意 systemd、linger、桌面通知与用量上报等差异。

必须装系统服务吗?

不是。有 systemd 时 service install 可登录常驻;CI / 无图形 / 临时 HOME 用 --no-service,再 agent-autoloop up。doctor 在无服务时会提示服务未跑,只要中台与 Agent 在线即可。

try 失败或模型报错怎么办?

先 agent-autoloop doctor,确认 Node ≥ 24、中台可连、Agent 在线。接本站时核对 model 是否在控制台模型列表里、experimental_bearer_token 是否完整。我们第一次失败就是模型名不在列表;改名后 try 才通过。

和自己开一堆终端有什么区别?

自己开终端是人在环上盯;Autoloop 是事件进来才拉起一轮,等你决策时进程退出。需要图形化多 worktree 并行时,Autoloop 不是唯一答案,可与 worktree 方案并用。

小结

  1. 升到 Node 24,安装 Agent Autoloop,接好 Claude Code 或 Codex。
  2. agent-autoloop up(如需)后跑 try,用 answer / status 走完一圈。
  3. 在 rules.json 写 cron 或 GitHub 规则,check + rules explain 确认。
  4. 按 SECURITY 管好权限、卡片链接与 Key;测完清掉本机 Key。

创建 API Key,开始你的第一条后台规则 →

相关文章

UI SDK 是什么、怎么用?Vercel + shadcn 给 Agent 的行为库,在 Claude Code / Codex / Cursor 里安装与实测(0.1.0-beta.1)

UI SDK 是什么、怎么用?Vercel + shadcn 给 Agent 的行为库,在 Claude Code / Codex / Cursor 里安装与实测(0.1.0-beta.1)

UI SDK 是 Vercel 在 2026 年 11 月 12 日发布的、给 Agent 用的行为(behaviors)库,版本 0.1.0-beta.1。行为写在与框架无关的 @ui-sdk/core 里,再由 React、Vue、Svelte、Solid 和 Web Components 适配器渲染。本文按官方文档整理它是什么、怎么安装、怎么给 Claude Code / Codex / Cursor 装 skill,并记录我们在测试机上的真实命令、耗时和输出。

AWS Emulator 是什么、怎么装?让 Claude Code / Codex 在本地测 AWS 应用(1.0.322 实测)

AWS Emulator 是什么、怎么装?让 Claude Code / Codex 在本地测 AWS 应用(1.0.322 实测)

AWS Emulator 是 AWS 官方 2026 年 11 月 12 日(北京时间)正式发布的本地 AWS 模拟器,没有额外服务费、源码开放,不需要 AWS 账号,覆盖 200 多个服务。本文在 Debian 13 上实测 1.0.322:安装命令、AWS CLI 指向本地 endpoint 建 S3 桶和 DynamoDB 表、常见报错,以及让 Claude Code、Codex、Cursor 对着模拟器写代码跑测试的接法。

T3 Code 是什么、怎么装?接入 Claude Code 和 Codex、配置第三方 API Key 与常见报错(0.1.9 实测)

T3 Code 是什么、怎么装?接入 Claude Code 和 Codex、配置第三方 API Key 与常见报错(0.1.9 实测)

T3 Code 是 pingdotgg 开源的编码 Agent 控制台,本身不带模型,调用你机器上已装好的 Claude Code、Codex、Cursor 等 CLI。本文在 Linux 上实测 T3 Code 0.1.9:讲清安装命令,Claude Code 和 Codex 先各自接上 AICodeWith API Key、再由 T3 Code 调用的配置方法,用 t3 thread 命令行跑通两端的过程,以及我们实际遇到的报错和解法。