Codex /goal 从启用到跑通：无人值守开发实操指南

这篇文章介绍了如何使用Codex CLI的/goal命令来自动化执行复杂任务。主要内容包括：启用/goal功能：需修改配置文件并重启Codex 编写有效目标：采用五段式模板，包含范围、约束、完成条件和停止条件三种工作流程：直接使用、结合Plan模式或OpenSpec规格驱动进阶技巧：使用goal-prompt-builder自动生成目标，以及OpenSpec+goal组合工作流常见问题：避

chatblog

1171人浏览 · 2026-05-09 20:26:50

chatblog · 2026-05-09 20:26:50 发布

在这里插入图片描述

这篇教你做一件事：启用 Codex CLI 的 /goal 命令，写出能跑一整天不跑偏的目标，让代理自主完成复杂任务。

做完之后，你能给 Codex 一个目标然后去睡觉。第二天回来看进度报告。

原理拆解见上一篇。这篇只讲操作。

先看完整流程

在这里插入图片描述

前提条件

Codex CLI ≥ 0.128.0 — 跑 codex --version 确认
如果版本不够：npm update -g @openai/codex

可选：先准备一个稳定的模型入口

如果你已经有可用的 OpenAI 兼容接口，这段直接跳过。

如果你现在卡在「没有现成 provider、想先把 Codex 跑起来」这一步，可以先挂一个兼容网关。像 Neco Api 注册入口这种聚合型中转，适合先把环境搭起来再说；它自己的接入说明也放在公开文档页里。

它比较适合放在这篇文章里的原因只有一个：省事。你不用先自己折腾多家模型供应商和格式差异，先拿一个 OpenAI 兼容入口把 Codex 跑通，后面再慢慢替换成你自己的正式方案。

如果你准备用它，按这个最小流程就够了：

登录后台，新建一个 API Key，完整复制保存。
安装 Node.js LTS，然后重新打开终端。
跑 node -v 和 npm -v，确认基础环境正常。
打开 ~/.codex/config.toml，把 base_url 设为 https://api.sbbbbbbbbb.xyz/v1。
把后台复制的完整 Key 填进 experimental_bearer_token。
启动 codex，发一句「你好，只回复‘连接成功’四个字」做连通性测试。

几个最容易踩坑的点：

OpenAI 兼容客户端一般填带 /v1 的地址
Claude Code 填根地址 https://api.sbbbbbbbbb.xyz，不要带 /v1
图片接口走 /v1/images/generations
如果报 401，先怀疑 Key 复制不完整、前后有空格，或者中间被换行
如果提示余额不足或模型无权限，优先找服务方处理，不要在本地反复重装

阶段一：启用 /goal

/goal 默认关闭，需要手动开启。

第一步：编辑配置文件

nano ~/.codex/config.toml

加上：

[features]
goals = true

如果你还想用 /plan 配合 /goal，把协作模式也开：

[features]
goals = true
collaboration_modes = true

保存退出。

第二步：重启 Codex

关掉当前终端，重新打开 Codex。

验证： 输入 /，在补全列表里能看到 /goal 就是成功了。或者直接输入 /goal 回车，显示「暂无目标」就对了。

阶段二：写目标

这是最关键的一步。目标写得好不好，直接决定跑出来的质量。

第三步：用五段式模板写目标

/goal <一句话描述目标>

Scope: <作用范围，其他不要碰>

Constraints:
- <硬性约束 1>
- <硬性约束 2>

Done when:
1. <可验证的产物 1，引用具体文件或命令>
2. <可验证的产物 2>

Stop if:
- <停止条件 1>
- <停止条件 2>

Use a token budget of <N> tokens for this goal.

第四步：检查目标质量

发之前过一遍：

目标能被映射成清单吗？
有没有「全部」「所有」「彻底」「improve」这种虚词？有就换掉
Done when 每一条都能跑一个命令验证吗？
Stop if 是机械可识别的吗？
Token budget 设了吗？

一个具体例子：

/goal 把 src/data/words.json 里的词库扩展到 1000 个唯一词条。

Scope: 只改 src/data/words.json，其他文件不动。

Constraints:
- 词条 schema 保持不变
- 不允许重复（以 word 字段去重）
- 只用真实常见英语单词

Done when:
1. words.json 包含恰好 1000 个唯一词条
2. tools/validate.js 校验通过
3. 终端输出最终词条数和文件大小

Stop if:
- 需要修改 words.json 以外的文件
- 需要新增 npm 依赖
- schema 校验失败超过 3 次

Use a token budget of 80000 tokens.

阶段三：跑起来

第五步：回车，走人

粘贴完整目标，回车。Codex 开始自主推进。

你可以去做别的事。

第六步：随时查看进度

/goal

不带参数，显示当前状态：目标内容、耗时、token 用量。

第七步：控制生命周期

/goal pause    # 暂停
/goal resume   # 恢复
/goal clear    # 中止

跨会话恢复：

codex resume <session-id>

三种工作流

在这里插入图片描述

工作流 A：直接用。 70% 的任务用这个。边界清楚，自己能写五段式模板。

工作流 B：Plan + Goal。 任务复杂、需求模糊时，先用 /plan 讨论方案，Codex 会问你关键决策。讨论完退出 Plan 模式（Shift+Tab），再下 /goal。

工作流 C：OpenSpec + Goal。 规格驱动开发。先用 OpenSpec 生成 proposal、specs、design、tasks 四个文档，再把规格交给 /goal 执行。产物质量最稳。

进阶：用 goal-prompt-builder 自动生成目标

如果懒得每次手写五段式，装这个 Skill：

git clone https://github.com/win4r/goal-prompt-builder.git
ln -s "$(pwd)/goal-prompt-builder/goal-prompt-builder" ~/.claude/skills/goal-prompt-builder

重启后，跟 Codex 说「我想用 /goal 来做 XXX」，它会自动检测项目类型，问你几个问题，输出一段可以直接粘贴的五段式目标。

内部有审计友好度打分。低于 70 分直接拒绝渲染，要求你补充信息。

进阶：OpenSpec + /goal 完整流程

安装 OpenSpec：

npm install -g @fission-ai/openspec@latest
cd your-project
openspec init

生成规格：

/opsx:propose 为项目新增 Cohere Rerank 作为第五个 provider

Codex 会生成 openspec/changes/ 下的四个文档。然后：

/goal 严格实现 openspec/changes/add-cohere-rerank/ 中的变更。

First action: 先读 proposal.md / specs/ / design.md / tasks.md，
报告每个文件的字数和关键章节标题，等我确认后再开始。

Scope: design.md 里的 MUST NOT 列表严格遵守。

Done when:
1. tasks.md 每项打勾，引用文件路径
2. npx tsc --noEmit 退出码 0
3. npm test 退出码 0

Stop if:
- 需要修改 MUST NOT 列表中的文件
- 需要 npm install 新依赖

Use a token budget of 120000 tokens.

注意 First action 那行。强制 Codex 先读完规格再动手，防止它假装「知道了」实际没读全。

第一次做的建议

先拿一个小任务练手。比如「给这个文件补 20 个单元测试」
Token budget 先设小一点（5 万），看跑出来的节奏对不对
第一轮输出对不上目标，立刻 /goal pause，补上下文，再 /goal resume
长任务不要手动 /compact。让自动压缩落在轮次边界
如果你用的是聚合网关或中转站，第一轮先跑最小目标，确认模型可用、上下文不丢、长任务不会中途断流，再上整夜任务

容易踩的坑

Plan 模式下 /goal 不延续
UI 显示 Goal active，但实际不推进。必须先 Shift+Tab 退出 Plan 模式再下 /goal。

第一条消息就发 /goal
会导致 resume 列表里找不到这个会话。先随便发一句话，再用 /goal。

目标里用虚词
「优化所有」「彻底清理」「improve performance」。审计机制映射不了，跑出来的结果一定偏。换成具体数字和可验证状态。

不设 token 预算
跑飞了没有软停止。永远设 budget。

破坏性操作不加保护
/goal 会自己往下推进。如果目标涉及删文件、改数据库，Constraints 和 Stop if 里必须写明红线。

控制命令速查

操作	命令
创建目标	`/goal <objective>`
查看进度	`/goal`
暂停	`/goal pause`
恢复	`/goal resume`
清空	`/goal clear`
退出 Plan 模式	`Shift+Tab`
跨会话恢复	`codex resume <id>`