Ultraplan 适合想把规划放到云端、在浏览器细看后再决定执行位置的 Claude Code 用户:CLI 启动后,Claude Code on the web 会话在 plan mode 中起草方案,你可以逐段评论并反复修改。需要 Claude Code v2.1.91 或更高版本,且仅在 Anthropic 云端可用;用 /tasks 可查看状态,完成后可选在 Web 执行或送回终端。
Claude Code Ultraplan:CLI 发起云端规划、浏览器审阅与执行
Ultraplan 会把本地 CLI 里的规划任务交给运行在 Claude Code on the web 的 plan mode 会话来处理。Claude 在云端研究代码库并起草方案,你的终端继续可用;方案准备好后,可以在浏览器里对具体段落评论、要求修改,然后决定是在 Web 端执行,还是回到本地终端继续。
这类场景最有用:
- 针对性反馈:直接对方案中的某一段留言,不必整段重写
- 终端不中断:规划在远端进行,本地 CLI 仍能继续做别的事
- 执行方式可选:既可以在 Web 上实现并创建 pull request,也可以发回终端本地执行
Ultraplan 需要 Claude Code on the web 账号和 GitHub 仓库。由于它运行在 Anthropic 的云基础设施上,使用 Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry 时不可用。云端会话使用你账号的默认 cloud environment;如果你还没有 cloud environment,Ultraplan 会在首次启动时自动创建。
从 CLI 启动 Ultraplan
在本地 CLI 会话里,有三种启动方式:
- 命令:运行
/ultraplan,后面跟你的提示语 - 关键词:在普通提示语中任意位置包含
ultraplan - 从本地 plan 发起:Claude 完成本地 plan 后出现批准对话框时,选择 No, refine with Ultraplan on Claude Code on the web,把草稿发到云端继续迭代
例如,要规划一次服务迁移,可以这样写:
/ultraplan migrate the auth service from sessions to JWTs
命令方式和关键词方式都会先弹出确认对话框再启动。因为“从本地 plan 发起”本身已经是确认动作,所以不会再多弹一次。
如果 Remote Control 处于激活状态,Ultraplan 启动时会断开连接。两者都占用 claude.ai/code 接口,同一时间只能连接一个。
状态指示
云端会话启动后,CLI 的输入提示会显示状态指示器:
| 状态 | 含义 |
|---|---|
◇ ultraplan |
Claude 正在研究代码库并起草方案 |
◇ ultraplan needs your input |
Claude 有澄清问题,需要你打开会话链接回复 |
◆ ultraplan ready |
方案已准备好,可以在浏览器中审阅 |
运行 /tasks,再选中 ultraplan 条目,可以打开详情视图,里面有会话链接、agent 活动记录,以及 Stop ultraplan 操作。停止后会归档云端会话并清除状态指示器;不会保存到你的终端。
在浏览器中审阅和修改方案
当状态变成 ◆ ultraplan ready 时,打开会话链接即可在 claude.ai 查看方案。这个审阅界面包含:
- Inline comments:高亮任意片段,留下评论让 Claude 处理
- Emoji reactions:对某个段落做表情反应,不用写完整评论也能表示认可或担忧
- Outline sidebar:在各个章节之间快速跳转
当你要求 Claude 处理评论时,它会修改方案并给出更新后的草稿。你可以按需反复迭代,直到准备好执行。
选择在哪里执行
方案看起来合适后,可以在浏览器里选择由 Claude 在云端继续实现,或者把方案送回等待中的终端。
在 Web 端执行
在浏览器中选择 Approve Claude’s plan and start coding,Claude 会在同一个 Claude Code on the web 会话里直接实现方案。此时终端会显示确认信息,状态指示器清除,工作继续在云端进行。实现完成后,查看 diff,并从 Web 界面创建 pull request。
发回本地终端执行
在浏览器中选择 Approve plan and teleport back to terminal,即可把方案带回本地终端执行,并使用你本地环境中的完整权限。这个选项只会在会话从 CLI 启动、且终端仍在轮询时出现。Web 会话会被归档,不会继续并行工作。
此时你的终端会弹出标题为 Ultraplan approved 的对话框,里面有三个选项:
- Implement here:把方案注入当前对话,接着上次的位置继续
- Start new session:清空当前对话,只保留方案作为上下文重新开始
- Cancel:不执行,把方案保存到文件;Claude 会打印文件路径,方便你之后再打开
如果你选择新建会话,Claude 会在最上方打印一条 claude --resume 命令,方便你之后回到之前的对话。
相关资源
- Claude Code on the web:Ultraplan 运行所依赖的云端基础设施
- Plan mode:本地会话中的规划方式
- Find bugs with ultrareview:Ultraplan 的代码审查对应功能,用于在合并前发现问题
- Remote Control:使用 claude.ai/code 接口连接在你自己机器上运行的会话
常见问题
Ultraplan 和本地 plan mode 有什么区别?
本地 plan mode 在终端内完成规划,反馈也主要发生在终端里。Ultraplan 则把规划放到云端,在浏览器里提供逐段评论、Emoji 反应和大纲导航,适合需要更细审阅界面的场景。
使用 Bedrock、Vertex AI 或 Microsoft Foundry 时能用 Ultraplan 吗?
不能。Ultraplan 依赖 Anthropic 的云基础设施,因此在使用 Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry 时不可用。
关闭浏览器后,Ultraplan 会继续运行吗?
会。只要 CLI 里的状态指示器还在,云端会话就仍在运行。你可以之后重新打开会话链接继续审阅。