Skip to content

Ultraplan 云端规划

把规划任务从本地 CLI 交给云端 Claude Code on the web 在 plan mode 里起草,再选地方执行。

是什么

Ultraplan 把一个规划任务从本地 CLI 移交给运行在 plan mode 下的 Claude Code on the web 会话。Claude 在云端起草计划,你的终端则保持空闲可做其他事;计划完成后在浏览器打开,可对具体段落评论、要求修订,并选择在何处执行。

它适合需要比终端更丰富评审界面的场景:可针对单个段落留评论(而非整体回复)、远程起草让终端腾出手、并能灵活选择执行位置。需要 Claude Code on the web 账户和一个 GitHub 仓库;目前处于 research preview,要求 Claude Code v2.1.91 或更高版本。

怎么工作

  • 从本地 CLI 用三种方式启动:运行 /ultraplan 加 prompt;在普通 prompt 中任意位置包含关键词 ultraplan;或在本地计划完成、出现审批对话框时选择 No, refine with Ultraplan on Claude Code on the web 把草稿送往云端。
  • Command 与 keyword 两种路径会先弹出确认对话框;本地计划路径跳过该对话框(该选择本身即为确认)。
  • 若 Remote Control 处于激活状态,ultraplan 启动时它会断开,因为两者都占用 claude.ai/code 界面,同一时间只能连一个。
  • 云端会话启动后,CLI 的输入框显示状态指示器:◇ ultraplan(正在研究代码库并起草)、◇ ultraplan needs your input(有澄清问题,需打开会话链接回应)、◆ ultraplan ready(计划已就绪可在浏览器审阅)。
  • 状态变为 ◆ ultraplan ready 后打开会话链接,在 claude.ai 的专用审阅视图查看计划:可对任意段落加 inline comments、用 emoji reactions 表态、用 outline 侧边栏在各段间跳转。
  • 让 Claude 处理评论后,它会修订并给出更新草稿,可反复迭代任意多次,再决定在何处执行。
  • 计划满意后在浏览器中选择执行位置:在同一云端会话执行,或送回正在等待的终端。

怎么配置 / 用法

从本地 CLI 启动示例:

/ultraplan migrate the auth service from sessions to JWTs

运行 /tasks 并选中 ultraplan 条目可打开详情视图,含会话链接、agent 活动和 Stop ultraplan 操作(停止会归档云端会话并清除指示器,不向终端保存任何内容)。

浏览器中执行:选 Approve Claude's plan and start coding 在同一云端会话实现,完成后审阅 diff 并创建 pull request;选 Approve plan and teleport back to terminal 送回终端(仅当会话由 CLI 启动且终端仍在轮询时出现,web 会话随后归档)。

送回终端后弹出标题为 Ultraplan approved 的对话框,三个选项:Implement here(注入当前会话继续)、Start new session(清空当前会话、仅以计划为上下文重新开始,会在顶部打印 claude --resume 命令以便返回先前会话)、Cancel(把计划存为文件不执行,并打印文件路径)。

什么时候用

  • 想针对计划的单个段落而非整体回复来留下定向反馈时。
  • 想让计划在远程起草、腾出本地终端做其他工作时。
  • 完成本地计划后想在更丰富的评审界面上进一步迭代修订时。
  • 希望灵活选择计划在云端执行并开 PR,或送回终端本地执行时。

限制 / 坑

  • 处于 research preview,行为与能力可能随反馈变化。
  • 要求 Claude Code v2.1.91 或更高版本。
  • 需要 Claude Code on the web 账户和一个 GitHub 仓库。
  • 因运行在 Anthropic 云端基础设施上,使用 Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry 时不可用。
  • 与 Remote Control 不能同时连接,启动 ultraplan 会使 Remote Control 断开。

硬事实速查(12 条)

  • Ultraplan 将规划任务从本地 CLI 移交给运行在 plan mode 下的 Claude Code on the web 会话。
  • 处于 research preview,要求 Claude Code v2.1.91 或更高版本。
  • 云端会话运行在账户的默认 cloud environment;若尚无,ultraplan 首次启动时自动创建。
  • 三种启动方式:/ultraplan 加 prompt、普通 prompt 含关键词 ultraplan、本地计划审批对话框中选 No, refine with Ultraplan on Claude Code on the web。
  • 三种状态指示器:◇ ultraplan、◇ ultraplan needs your input、◆ ultraplan ready。
  • 运行 /tasks 选中 ultraplan 条目可见会话链接、agent 活动及 Stop ultraplan 操作;停止会归档云端会话且不向终端保存内容。
  • 审阅视图支持 inline comments、emoji reactions 和 outline 侧边栏,可反复迭代修订。
  • 执行选项一:Approve Claude's plan and start coding,在同一云端会话实现,完成后审阅 diff 并从 web 创建 pull request。
  • 执行选项二:Approve plan and teleport back to terminal,送回终端本地执行,web 会话随后归档。
  • 送回终端后 Ultraplan approved 对话框含三选项:Implement here、Start new session、Cancel。
  • Start new session 会在顶部打印 claude --resume 命令以便返回先前会话;Cancel 把计划存为文件并打印文件路径。
  • 与 Remote Control 互斥:两者都占用 claude.ai/code 界面,同时只能连接一个。

官方出处:https://code.claude.com/docs/en/ultraplan