在 Claude Code 中定时运行 ConsoleX 任务
在 Claude 桌面应用中使用 /consolex:schedule，可以让这台电脑按指定时间执行已添加的 ConsoleX 任务。工作由 Claude Code 完成；ConsoleX 记录交付，开启自动验收后再按任务保存的标准检查。
本页适用于两种用法的本地定时运行。用法 A 需要本机保留主要技能；用法 B 还可以选择在 ConsoleX 中定时运行。下面先比较执行位置，再介绍桌面端操作。
先选择在哪里定时运行
| 在 ConsoleX 中定时 | 在 Claude Code 桌面端定时 | |
|---|---|---|
| 谁负责发起运行 | ConsoleX | 指定电脑上的 Claude 桌面应用 |
| 工作在哪里执行 | ConsoleX | 那台电脑的 Claude Code 环境与工作文件夹 |
| 做法保存在 ConsoleX 中的任务 | 支持 | 通过插件支持 |
| 做法保存在本地技能中的任务 | 在编码代理中执行，不能在 ConsoleX 设定时 | 本机有主要技能即可支持 |
| 去哪里改时间或停止 | ConsoleX 的任务设置 | 那台电脑的 Claude 桌面应用 |
本页介绍的是桌面端本地定时任务。Anthropic 另有云端定时和 CLI 的 /loop；/consolex:schedule 使用桌面应用的定时工具。本地运行需要应用保持打开、电脑处于唤醒状态，也可能延迟启动或在休眠后补跑。当前应用行为请参考 Claude Code 官方定时文档。
开始前准备
-
在执行任务的电脑上安装并连接 ConsoleX 插件，使用 Claude 桌面应用中的 Claude Code 会话，并确认能使用定时任务工具。
-
在准备工作的文件夹里打开会话。插件会按发起会话的文件夹准备定时安排。
-
如果任务需要 ConsoleX 的工具或文件，到 设置 → 编码代理，为这台电脑开启 工具和文件，并确认需要的连接已经可用。
-
把任务添加到这台电脑：
/consolex:add 每周研究简报 -
先调用对应的
/cx-…技能运行一次，确认能够读取材料、调用工具、交付并接受验收，再设定时。
创建定时安排
在这个桌面会话中运行：
/consolex:schedule 每周研究简报 -- 每个工作日 08:30
可以用已添加任务的名称、任务链接或 /cx-… 名称来指明任务。多个任务匹配时，请选准目标；没有写时间时，Claude 会询问什么时候执行。
插件先检查任务是否已经在其他地方定时运行，再把应使用的任务提示交给 Claude，由桌面定时工具创建或更新。完成后，请核对时间、这台电脑的本地时区、工作文件夹和权限模式。这里的时区与 ConsoleX 账号设置的时区分别计算。
创建后，在桌面应用的 Scheduled（定时任务） 页面确认安排，并试一次 Run now（立即运行）。权限和执行过程在桌面端对应会话中查看；已经提交的交付和验收则在 ConsoleX 任务的 运行历史 中查看。
工作要求放在任务里
定时安排负责指明任务、时间和工作文件夹。做法、交付目标、发布或发送要求、审批规则，以及验收失败后怎么办，都跟任务一起维护：
- 做法保存在 ConsoleX 中：修改 ConsoleX 里的任务说明。
- 做法保存在本地技能中：修改原技能；交付目标和运行规则仍在 ConsoleX 中维护。
- 验收与自动修改：在任务的验收设置里修改。
让插件生成定时提示，不要把业务说明再复制成另一份提示。例如，“发布之前必须等我确认”属于任务规则；定时安排只需说明运行哪个任务、什么时候运行。
无人值守运行与验收
定时运行时，没有人在会话里回答问题。需要你决定或核实的事项会写出来，留给你查看；这不意味着智能体可以执行任务已保存规则之外的操作。
自动修改默认关闭。开启后，必需的输出检查未通过时，可以在你选定的轮数内修改并再次验收；缺少证据或待核验项不会自动触发改稿。详见验收之后。
桌面应用的工具权限仍然有效：定时安排创建成功，运行也可能卡在权限提示。依赖无人值守执行之前，请先试跑并确认所需工具的权限配置合适。
修改、暂停或停止
- 改时间：在桌面应用里再次用
/consolex:schedule指向同一个任务，给出新时间。插件会优先更新已有安排；如果有多个，会让你指明是哪一个。只有你要求增加执行时间时，才另加一份。 - 暂停或恢复：使用 Claude 桌面应用中的定时控制；也可以让那里的 Claude 暂停。
- 彻底停止：在桌面应用中删除该定时安排。
/consolex:remove是移除本地任务技能的另一个操作，不能替代停掉定时。 - 换电脑或工作文件夹：先停掉旧安排，再在目标电脑或文件夹中打开会话，重新设置。
直接在桌面应用里修改后，可能要等下一次 Claude Code 发消息、打开会话或定时运行时，ConsoleX 才收到同步。因此，ConsoleX 的显示可能比桌面端稍晚更新。
避免同一任务重复运行
一个任务应从一个地方定时运行。插件能够确认任务已在 ConsoleX 或另一台电脑启用定时时，会拒绝再新建或启用；ConsoleX 也会在存在有效本地定时安排时，阻止再开启自己的定时。
在 ConsoleX 任务设置中，可以看到类似 由……上的 Claude 定时运行 的提示。想换执行位置时，先到当前执行方关闭定时，再创建新安排。
这项检查依赖上报状态。ConsoleX 无法连接时，插件会提示无法检查，请自行确认已有安排；旧版本或手动创建的定时也可能重叠。发现运行两遍时，请到创建它们的地方关闭其中一份。
如果旧电脑确实已经不再执行任务，可以在 ConsoleX 中点 这台电脑已不再运行，解除记录。这个操作只清除 ConsoleX 里的关联，不会远程停掉另一台电脑上的安排；那台电脑还在用时，仍要停掉实际定时任务。
常见问题
| 遇到的情况 | 检查什么 |
|---|---|
| 没有定时任务工具 | 使用支持定时的桌面会话。普通终端会话不会通过这个集成直接创建持久的桌面定时安排。 |
| 没有按时运行 | 查看电脑、桌面应用、定时状态和桌面运行历史。保存了安排，不代表已经完成一次运行。 |
| 运行一直在等待 | 打开对应 Claude 会话，查看权限提示、缺少的材料或工具。 |
| ConsoleX 没有新交付 | 检查桌面运行是否启动并完成到交付，以及 /consolex:status 是否显示有效连接。 |
| ConsoleX 仍显示旧时间 | 在 Claude Code 中打开新会话或发送一条消息，让插件同步，再刷新任务页。 |
| 找不到主要技能 | 先在那台电脑上恢复或安装任务所需的主要技能，再重新执行。 |