Ultraplan 是 Claude Code 在 Week 15 推出的云端规划功能（研究预览），让你从本地 CLI 发起一个规划任务，Claude 在云端 Plan Mode 里草拟方案，你在浏览器里用内联评论精细化修改，最后选择在云端执行还是拉回本地。本文是 Ultraplan 的完整使用指南。
Ultraplan 解决什么问题？
传统 Plan Mode 的局限：
- 规划结果只在终端里显示，不方便对某一段落单独评论
- 规划时占用本地终端，无法做其他事
- 计划一旦批准，执行和规划共享同一个上下文
Ultraplan 的改进：
- 浏览器审阅界面：高亮任意段落，留内联评论，用 Emoji 标记关注/认可
- 云端异步规划：规划在 Anthropic 云端进行，本地终端解放出来做别的
- 灵活执行：在云端直接执行 → 创建 PR，或者把计划"传送"回本地 Terminal
前置条件
- Claude Code v2.1.91 或更高版本
- 有 claude.ai/code 账户（不支持 Amazon Bedrock / Google Vertex AI / Microsoft Foundry）
- 项目必须有 GitHub repository（执行时创建 PR 需要）
首次使用时会自动创建云端环境，不需要手动配置。
三种启动方式
方式一：/ultraplan 命令
/ultraplan migrate the auth service from sessions to JWTs方式二：在普通对话里说"ultraplan"
帮我 ultraplan 一下把所有 API 端点从 callback 改成 async/await 的迁移方案
方式三：从本地 Plan 升级到 Ultraplan
当 Claude 完成本地规划，显示审批对话框时，选择：
No, refine with Ultraplan on Claude Code on the web
本地的草稿会直接发送到云端继续迭代，不需要重新描述任务。
终端状态指示器
Ultraplan 运行时，终端输入框会显示：
| 状态 | 含义 |
|---|---|
◇ ultraplan | Claude 正在云端分析代码库，草拟计划 |
◇ ultraplan needs your input | Claude 有澄清问题，需要打开浏览器回答 |
◆ ultraplan ready | 计划已就绪，可以去浏览器审阅 |
运行 /tasks，选择 ultraplan 条目，可以看到会话链接、Agent 活动详情，以及 Stop ultraplan 按钮（停止后云端会话归档，状态指示清除）。
注意：Ultraplan 和 Remote Control 不能同时使用，两者都需要 claude.ai/code 界面。
在浏览器里审阅和修改计划
当状态变为 ◆ ultraplan ready，打开 claude.ai 里的会话链接。
审阅界面的功能：
内联评论
- 高亮任意段落，输入评论
- Claude 读取评论后修改对应部分，重新生成更新版本
- 可以多轮迭代，直到满意
Emoji 快速反馈
- 对某个 section 加 Emoji 表示赞同或担忧
- 不需要写完整评论，快速给出方向性反馈
目录导航
- 右侧 Outline sidebar 快速跳转到计划的不同章节
- 对长篇计划特别有用
示例流程：
规划任务：把 Express 应用迁移到 Hono 框架
Claude 草稿（5 个章节）：
1. 依赖分析 ✓
2. 路由迁移策略 [你评论：先迁移非核心路由，主路由最后处理]
3. 中间件适配 [你评论：Hono 的中间件顺序和 Express 不同，需要注意]
4. 测试策略 ✓
5. 部署计划 [你点了 👀 表示需要更多细节]
Claude 根据评论更新草稿 → 你再次审阅 → 满意后批准
执行：两种方案
方案一：在云端执行（点击 "Approve Claude's plan and start coding"）
- Claude 在同一个云端会话里实现计划
- 本地终端显示确认，状态指示清除
- 实现完成后，在浏览器里 Review Diff，直接创建 PR
- 适合：不需要本地环境、标准 PR 工作流
方案二：传送回本地 Terminal（点击 "Approve plan and teleport back to terminal"）
只在会话从本地 CLI 发起、且终端还在 polling 时出现。
本地 Terminal 显示 Ultraplan approved 对话框，三个选项：
| 选项 | 效果 |
|---|---|
| Implement here | 把计划注入当前对话，从中断处继续执行 |
| Start new session | 清除当前对话，以计划为唯一上下文开始新会话 |
| Cancel | 把计划保存到文件，不执行 |
选 Start new session 时，Claude 会在顶部打印一个 claude --resume 命令，可以随时回到之前的对话。
适合传送回本地的场景：
- 需要访问本地服务（数据库、localhost API）
- 需要运行本地测试套件
- 需要访问没有提交到 git 的本地配置文件
实战使用技巧
技巧 1：让 Ultraplan 先澄清再规划
触发 ultraplan 后，在浏览器里等待 needs your input 状态，提前回答 Claude 的澄清问题。这比等到计划出来后再大范围修改要高效。
技巧 2：评论要具体，不要只说"不对"
❌ 这里不对
✅ 这里的迁移顺序有问题，应该先迁移数据库层，再迁移 API 层，因为 API 层依赖数据库层的新接口
技巧 3：大型任务用 Ultraplan，小任务用本地 Plan
- 大型任务（需要多次迭代、多人参与讨论）：Ultraplan
- 简单任务（1-2 步修改，明确需求）：本地
/plan即可
技巧 4：在浏览器计划阶段加入约束
在评论里加入之前忘记说的约束：
补充：API 变更期间不能修改数据库 Schema，所有新接口必须向后兼容
技巧 5：保存好"传送回来"的计划文件
如果选了 Cancel，Claude 会把计划保存到文件并打印路径。这份文件可以：
- 后续直接拿来作为 Start new session 的 context
- 分享给团队成员审阅
- 作为 ADR（架构决策记录）存档
Ultraplan vs 本地 Plan Mode vs Ultrareview
| 功能 | 用途 | 阶段 |
|---|---|---|
本地 /plan | 快速本地只读规划 | 开发前 |
/ultraplan | 云端异步规划 + 浏览器精细审阅 | 开发前（大型任务） |
/ultrareview | 云端并行多 Agent 代码审查 | 提 PR 前 |
来源：Claude Code 官方文档 - Plan in the cloud with ultraplan | 整理：ClaudeEagle