普通人 AI 实战手册

Appearance

10 · Codex Cloud 上手：把活交上云，但别什么都扔上去 ​

Codex Cloud 可以理解成：你把一个任务交给云端环境，让 Codex 在远程帮你处理项目。 它适合比较明确、可以等待结果的任务。

但小白刚开始不要把它当成万能按钮。 云端跑得再方便，也需要你把任务说清楚、把边界圈好、把结果验收。

Codex Cloud 任务边界

上云前先把任务写成工单 ​

Cloud 不是边聊边试的地方。 你要先把任务写清楚：

  1. 目标是什么。
  2. 范围在哪里。
  3. 不允许做什么。
  4. 完成后怎么验收。

写不清楚的任务，先不要丢上云。

先用这张“小工单” ​

把任务交给 Cloud 前，先填这份小工单：

text
任务名称：
【一句话写清楚要做什么】

目标：
【完成后应该看到什么结果】

范围：
【只允许改哪些页面、文件或模块】

限制：
1. 不要处理哪些内容
2. 不要新增哪些东西
3. 遇到什么情况要停下来

验收：
1. 应该运行什么检查
2. 我应该打开哪个页面看结果
3. 最后要说明改了哪些文件

填不满这张工单，就先回桌面 App 里边聊边想清楚。

第一步：先理解它和桌面 App 的区别 ​

桌面 App 更像你旁边的助手。 你看着它读文件、改文件、跑检查。

Codex Cloud 更像你把任务派出去。 它在云端执行，完成后把结果交回来。

所以它适合：

  1. 目标清楚的修复。
  2. 范围明确的小功能。
  3. 可以通过测试或构建验证的任务。
  4. 需要等一会儿、不必全程盯着的任务。

它不适合：

  1. 你自己还没想清楚的需求。
  2. 需要你频繁判断方向的设计稿。
  3. 涉及隐私、密钥、账号的操作。
  4. 一句话说不清的大改版。

第二步：云端任务必须写清楚结果 ​

在桌面 App 里，你可以边聊边改。 在 Cloud 里，任务描述要更完整。

一个新手可用的任务格式：

text
目标：
请修复首页按钮点击后没有反应的问题。

范围：
只处理首页相关代码，不要重构全站。

要求：
1. 先定位问题原因
2. 再做最小修改
3. 不要新增无关依赖
4. 修改后运行现有检查

交付：
请说明改了哪些文件、原因是什么、怎么验证。

你看，这不是一句“帮我修一下”。 它把目标、范围、要求、交付都写清楚了。

第三步：先给小任务，不要给大愿望 ​

新手最容易写这种任务：

text
帮我把这个网站优化一下。

这句话太空。 Codex Cloud 不知道你要优化内容、样式、速度、结构，还是代码质量。

改成这样会更好：

text
请优化首页移动端排版。
范围只限首页文件和必要样式文件。
目标是：
1. 手机宽度下文字不重叠
2. 按钮不超出屏幕
3. 图片保持完整比例
不要改文章内容。
完成后说明我应该打开哪个页面检查。

这就能执行。

第四步：不要把敏感信息交给任务 ​

云端任务里不要直接写：

  1. API Key。
  2. 数据库密码。
  3. 服务器登录密码。
  4. 微信、抖音、支付账号信息。
  5. 私人身份证、手机号、客户资料。

如果任务必须涉及配置，可以这样写：

text
项目需要读取环境变量 API_KEY。
请只检查读取逻辑，不要要求我把真实密钥写进代码。
如果需要示例，请使用 FAKE_API_KEY 作为占位。

真实密钥永远不要写进教程、仓库、对话和截图里。

第五步：收到结果后先看三件事 ​

Cloud 任务完成后，不要只看总结。 你要看：

  1. 改了哪些文件。
  2. 运行了哪些检查。
  3. 有没有说明验证方法。

可以继续问：

text
请用小白能看懂的话总结这次云端任务结果：
1. 你最终改了什么
2. 为什么这样改
3. 有没有改到任务范围之外
4. 我现在应该怎么验收

如果它改得太多，让它解释每一个文件。 解释不清，就不要急着合并或上线。

第六步：适合 Cloud 的 5 类任务 ​

修一个明确 bug

text
请修复登录页输入错误密码后没有错误提示的问题。
只改登录相关文件。

补一个小功能

text
请给文章页增加“复制链接”按钮。
只做按钮、点击复制和成功提示。

补测试或检查

text
请为现有价格计算函数补充测试。
不要改业务逻辑，除非测试发现明显错误。

整理文档

text
请更新 README 的启动步骤。
只根据当前项目脚本写，不要编造不存在的命令。

修构建失败

text
请定位构建失败原因并做最小修复。
修复后运行构建命令，并说明错误原因。

第七步：不适合 Cloud 的任务 ​

这些任务先不要交给 Cloud：

  1. “帮我想一个商业模式。”
  2. “帮我从零设计整个产品。”
  3. “连接我的真实服务器并部署。”
  4. “登录我的账号帮我操作。”
  5. “把所有代码都重写一遍。”

不是它完全不能做。 而是这些任务需要大量判断、确认和上下文，小白很难验收。

常见错误 ​

错误一：任务太大

把“优化网站”拆成“优化首页手机端按钮不换行”。

错误二：没有验收标准

没有验收标准，就不知道它是否完成。

错误三：把密钥放进任务

真实密钥只放在安全配置里，不放在对话和代码示例里。

错误四：云端结果不看 diff

Cloud 完成不等于可以直接上线。 结果仍然要检查。

检查清单 ​

派发 Cloud 任务前，确认：

  • 任务目标能用一句话说清。
  • 范围限制到具体页面、文件或功能。
  • 有明确验收标准。
  • 不包含真实密钥和隐私数据。
  • 完成后会看改动、看检查结果、看验证方法。

小结 ​

Codex Cloud 的价值不是“让你不用管”。 它的价值是把清楚的任务放到云端执行，让你回来验收结果。

小白阶段先记住一句话： 能验收的任务，才适合交给 Cloud。 下一篇讲 AGENTS.md：怎么给 Codex 写一份项目说明书，让它每次开工都更懂你的规矩。