codex apply
在本地应用一个在云端生成的 Diff。
codex apply <TASK_ID>(简写:codex a)会把某个 Codex 云端聊天最新生成的 diff 应用到当前本地工作目录中。该命令通过 ID 获取对应的云端任务,提取其 diff,并通过 git apply 应用;前提是已完成身份验证,并且对该聊天有访问权限。成功时,Codex 会报告已应用的文件;如果 git apply 失败(例如出现冲突),命令会以错误码结束,并列出已应用、被跳过和发生冲突的路径。在官方文档中,该命令被标记为“Stable”(稳定)。要找到对应的任务 ID,可以使用 codex cloud list,它会列出现有的云端聊天及其状态和 URL;而 codex cloud exec 则用于发起一个新的云端任务。因此,codex apply 只是最后一步:把已经在云端生成好的 diff 应用到本地,而不涉及启动或管理云端任务本身。
✅ 什么时候用?
把云端任务的结果应用到本地
codex apply <task-id> —— 把云端生成的 diff 应用到本地
在本地应用之前先查看云端结果,然后再应用
codex cloud list --json,先找到任务 ID,然后执行 codex apply <task-id>
⛔ 什么时候不该用?
根本没有云端 diff,只有本地未纳入版本控制的改动
codex apply 需要一个有效的云端任务 ID,并据此拉取对应的 diff;对于纯本地的工作,没有可供拉取的内容。
更好的选择: 直接用普通的 Codex 会话(codex)或 codex exec 在本地进行修改
想要启动一个新的云端任务
codex apply 只应用已经存在的 diff,本身不会启动新的云端任务。
更好的选择: 使用 codex cloud exec 来发起一个新的云端任务
来源
- Codex CLI 文档:Reference ↗ learn.chatgpt.com
更多命令 · Codex CLI