跳到主要内容

在 Claude Code 中运行与验收任务

连接 Claude Code 后，可以在当前会话里开始一个已保存的 ConsoleX 任务，也可以把它添加成技能，方便反复使用。请在存放工作文件的文件夹里操作。

真实的 Claude Code 会话：用 /consolex:start 运行任务，ConsoleX 验收每次交付，要修改时 Claude 会先问你。第 1 次没过规则检查，第 2、3 次没过 AI 检查，第 4 次通过；每次尝试都记在运行记录里。示例任务和笔记；只有背景音乐，没有配音。

先确认任务类型​

本页适用于两种用法中已经保存的任务：A 使用本机的主要技能，B 载入 ConsoleX 保存的做法与支持的能力。两者都可以用下面的命令执行；A 需要本机有原来的主要技能。如果尚未把 Claude Code 做法存成任务，先看保存步骤。

在 Claude Code 中使用 ConsoleX 的技能与工具​

对于做法保存在 ConsoleX 中的任务，插件会载入保存的任务说明，并带上任务配置的能力：

  • 技能：可以导出的技能会安装或刷新到本机。部分技能无法导出，例如共享智能体的私有技能。遇到你自己已有的同名本地技能，会保留原文件，不强行覆盖；不可用或跳过的能力会有提示。
  • 工具与文件：先到 设置 → 编码代理，为这台电脑开启 工具和文件。插件让 Claude Code 调用任务支持的 ConsoleX 工具，实际调用由 ConsoleX 使用你已配置的连接执行，并记录用量，凭据留在 ConsoleX。尚未补齐密钥或连接的工具，以及共享智能体的工具，不能通过这个入口使用。
  • 执行模型：使用 Claude Code 自己的模型配置，不会切换成任务在 ConsoleX 运行时选用的模型。

普通 Claude Code 会话中，本地工具和技能仍然可用。插件会要求智能体在需要的步骤使用已配置的 ConsoleX 工具，遇到访问问题先说明，再决定是否改用本地能力。如果希望把任务技能和 ConsoleX 工具与日常会话分开准备，可以使用独立会话；Claude Code 仍会提供工作所需的基础文件工具和技能读取工具。

在当前会话里开始任务​

  1. 列出任务，也可以在命令后加任务名称中的关键词筛选：

    /consolex:tasks

  2. 用名称启动一个任务，或粘贴它的 ConsoleX 完整任务链接：

    /consolex:start 每周研究简报

  3. 本次运行有额外要求时，写在 -- 后面：

    /consolex:start 每周研究简报 -- 使用当前文件夹里的笔记写本周简报。

/consolex:start 会载入任务并在当前会话里开始工作，不会安装可复用的任务技能。如果多个任务匹配，请补充名称或使用完整任务链接。-- 后的要求只用于这次运行；要影响以后的运行，请在 ConsoleX 中修改任务。

添加任务，方便反复使用​

运行：

/consolex:add 每周研究简报

插件会安装任务技能，并告诉你实际的 /cx-… 名称。在 Claude Code 里调用这个名称，就能执行任务，也可以附上本次材料或要求。任务的 在 Claude Code 里做… 对话框中也有可复制的添加命令。

添加或刷新任务不会运行它。要移除本地任务技能，使用 /consolex:remove 加任务名或技能名。ConsoleX 中的任务及其历史仍会保留；定时任务需要单独管理。

使用独立会话​

如果希望在准备好任务技能、文件和 ConsoleX 工具的新会话里执行，先运行：

/consolex:run 每周研究简报

核对返回的终端命令，再到终端里运行。获取命令本身不会开始工作；想在当前会话直接做任务，请用 /consolex:start。

如果任务的做法保存在本地技能中，这台电脑上需要有该技能。找不到主要技能时，任务会停止，插件会告诉你缺少哪一个。

验收之后​

开启自动验收后，插件会把每次交付提交到 ConsoleX，并显示结论和运行链接。在 ConsoleX 的 运行历史 中，可以把结果、验收报告与其他尝试一起查看。详见查看运行结果与验收报告。

  • 通过：在现有证据范围内符合检查要求。仍有需要你确认的事项时，请继续核对。
  • 未通过：查看具体遗漏了哪些要求。默认情况下，智能体会报告问题，等你决定后再继续。
  • 待核验，或验收未能完成：按情况补充依据、人工复核或重新验收。缺少证据不能直接说明交付内容有错。

自动修改默认关闭。在任务的验收设置中开启后，必需的输出检查未通过时，可以触发修改和再次验收，最多按你选定的 0–10 轮执行。每次修改和 AI 验收正常计费；待核验项和外部操作不会自动变成改稿要求。

在当前任务会话中，/consolex:check 会检查最近一次交付，/consolex:check off 会关闭这个会话的验收。

验收能看到什么​

插件发送交付内容和能够收集到的任务工具记录。识别出的凭据会脱敏，但不保证能识别每一个敏感值。工具记录有数量与长度限制，可能缺少更早、会话外或暂不支持的操作；验收通过不能证明电脑上所有操作都被检查过。

如果只想发送交付内容，不发送工具记录，请在启动 Claude Code 的环境里设置 CONSOLEX_TOOL_EVIDENCE=off。需要这些记录的检查项可能因此变为待核验。

交付文件时，请让 Claude Code 指明实际可读取的成果文件。回复里出现一个路径，不代表文件内容已经接受验收。验收也不会撤销已经发生的发布或发送；需要审批的操作，请写进任务的运行规则。

定时运行​

在 Claude 桌面应用中，先添加任务，再使用 /consolex:schedule 加任务名和期望时间。此操作需要桌面应用的定时任务工具，单独使用终端 CLI 不提供这些工具。

工作内容、发布要求和验收失败后怎么做，都跟任务一起维护。任务已在其他地方定时运行时，请先停掉原安排，再创建新的。创建步骤、命令示例、权限、修改和排错，见在 Claude Code 中定时运行 ConsoleX 任务。

相关内容​