Codex /goal 介绍和用法

本文档用于说明 Codex 中 /goal 的作用、适合场景、使用方式和注意事项。

/goal 是什么

/goal 是 Codex 的目标管理能力，用来给当前会话设定一个明确目标，让 Codex 在后续执行中围绕这个目标持续推进。

普通对话通常是一问一答；/goal 更适合长任务，例如：

• 修复一个复杂 bug。
• 重构一个模块。
• 完成一个多步骤开发任务。
• 持续追踪一个任务是否真正完成。
• 在长上下文里避免偏离最初目标。

简单理解：

/goal = 给当前 Codex 会话设定一个明确任务目标

安装和启用

/goal 不是一个单独安装的插件，而是 Codex 新版本内置的目标管理功能。

要使用 /goal，需要满足两个条件：

1. 本机已经安装 Codex CLI 或 Codex App。
2. Codex 配置里已经开启 goals 功能。

第一步：安装或更新 Codex

如果本机还没有安装 Codex CLI，可以先安装 Codex。

常见安装方式：

npm install -g @openai/codex

如果已经安装过，可以更新到较新的版本：

npm update -g @openai/codex

安装完成后，检查命令是否可用：

codex --version

或者查看帮助：

codex --help

如果使用的是 Codex App，通常也会自带 Codex CLI 能力。可以在终端里执行：

codex app

用于启动或安装 Codex 桌面 App。

第二步：打开 Codex 配置文件

macOS / Linux：

~/.codex/config.toml

Windows：

%USERPROFILE%\.codex\config.toml

例如当前这台电脑的 Windows 用户名是 hh，所以路径是：

C:\Users\hh\.codex\config.toml

这里的 hh 只是当前电脑的用户名。其他电脑要换成自己的用户名，例如：

C:\Users\zhangsan\.codex\config.toml

也可以直接在 Windows 地址栏输入：

%USERPROFILE%\.codex

系统会自动打开当前用户自己的 .codex 配置目录。

第三步：开启 goals 功能

在 config.toml 里找到或新增 [features] 区块。

确保里面有：

[features]
goals = true

如果 [features] 已经存在，就只需要补这一行：

goals = true

不要重复写多个 [features] 区块。推荐写法如下：

[features]
goals = true
collaboration_modes = true
fast_mode = true
shell_tool = true
unified_exec = true

其中 goals = true 就是启用 /goal 的关键配置。

第四步：重启 Codex

修改 config.toml 后，需要重启 Codex CLI 或 Codex App。

如果是命令行版：

codex

如果是桌面版，关闭 Codex App 后重新打开。

第五步：验证是否可用

进入 Codex 会话后，输入：

/goal 帮我测试当前 goal 功能是否可用

如果 Codex 能识别并创建目标，就说明 /goal 已经启用成功。

也可以问：

当前 goal 是什么？

如果能看到当前目标信息，说明功能正常。

常见安装问题

如果输入 /goal 没反应，优先检查：

• Codex 版本太旧，需要更新。
• config.toml 没有写 goals = true。
• goals = true 没有写在 [features] 区块下面。
• 修改配置后没有重启 Codex。
• 当前使用的 Codex App 读取的不是你刚修改的配置目录。
• Windows 路径里的用户名写错，例如把别人的 C:\Users\hh 照抄到了自己电脑。

适合什么时候用

建议在下面这些场景使用 /goal：

1. 任务比较长，不是一两句话能完成。
2. 任务有明确完成标准。
3. 任务需要 Codex 持续读代码、改文件、跑测试、修复问题。
4. 你希望 Codex 不要中途偏离方向。
5. 你希望 Codex 能在较长时间内围绕同一个目标工作。

例如：

/goal 帮我把这个 Vue 项目的登录页接入真实接口，完成后跑构建确认没有报错

/goal 修复订单列表分页异常的问题，要求定位原因、修改代码、补充测试并验证

/goal 检查当前项目的 ApexAPI Codex 配置文档，补齐 Windows 和 macOS 的使用说明

不适合什么时候用

下面这些场景一般不需要 /goal：

• 只是问一个概念。
• 只是让 Codex 解释一段代码。
• 只是改一行配置。
• 只是让 Codex 翻译一句话。
• 任务没有明确结束条件。

例如下面这种就不太适合：

/goal 你好

/goal 介绍一下 JavaScript

这类问题直接问 Codex 即可。

基本用法

在 Codex 对话框中输入：

/goal 你的目标描述

例如：

/goal 帮我完成 ApexAPI 配置 Codex App 注入文档，要求包含 config.toml、auth.json、路径说明和常见错误排查

设置后，Codex 会把这句话作为当前会话的核心目标。

写好 /goal 的关键

一个好的 /goal 应该包含四个要素：

1. 要做什么。
2. 做到什么程度。
3. 涉及哪些文件、功能或项目。
4. 如何判断完成。

推荐格式：

/goal 帮我完成【具体任务】，要求【具体范围】，最后通过【验证方式】确认完成

示例：

/goal 帮我修复用户登录后跳转错误的问题，要求定位根因、修改相关代码，并通过现有登录流程测试验证

/goal 帮我把项目里的 OpenAI 配置切换到 ApexAPI，要求修改配置文件、检查 key 读取方式，并写一份使用说明文档

/goal 帮我优化后台订单列表页面，要求保留现有设计风格，修复移动端错位，并跑一次构建确认

可以带 token 预算

如果当前 Codex 版本支持目标预算，可以在创建目标时指定 token 预算。

示例：

/goal 用 50000 token 以内完成当前项目登录模块的接口接入和构建验证

token 预算的作用是给 Codex 一个工作上限，方便控制长任务成本。

注意：

• 只有你明确写了预算，Codex 才会设置预算。
• 不写预算时，Codex 只记录目标，不额外限制 token。
• 预算不是任务质量标准，只是资源上限。

查看当前目标

如果想确认当前会话是否已经设置目标，可以询问：

当前 goal 是什么？

或者：

查看当前目标

Codex 会返回当前目标、状态、已用资源和剩余预算等信息，具体显示内容取决于当前 Codex 版本。

完成目标

当 Codex 判断目标已经完成时，会把目标标记为完成。

你也可以明确告诉 Codex：

这个 goal 已经完成了

或者：

把当前目标标记为完成

标记完成后，这个目标不再作为当前会话的进行中目标。

不能做什么

当前 /goal 主要用于“创建目标、查看目标、完成目标”。

一般不要把它理解成完整的项目管理系统。它通常不负责：

• 同时管理多个并行目标。
• 自动暂停目标。
• 自动恢复历史目标。
• 修改已经创建好的目标内容。
• 把普通聊天自动转换成目标。

如果要换目标，建议先完成当前目标，再创建新的目标。

推荐写法

文档类任务

/goal 帮我写一份 ApexAPI 配置 Codex App 注入文档，要求包含 Windows/macOS 路径、config.toml、auth.json、截图引用和常见问题

代码修复类任务

/goal 帮我修复支付回调验签失败的问题，要求定位原因、修改代码、补充必要测试，并说明验证结果

前端页面类任务

/goal 帮我完成后台用户管理页，要求包含搜索、分页、启用禁用、编辑弹窗，并保持现有项目 UI 风格

配置排查类任务

/goal 帮我排查 Codex 使用 ApexAPI 时 key 对不上的问题，要求检查 config.toml、auth.json、provider 名称和 base_url 是否一致

不推荐写法

目标太宽：

/goal 帮我优化项目

问题是范围不清楚，Codex 不知道优化什么，也不知道怎么判断完成。

目标太虚：

/goal 让系统更好

问题是没有明确文件、功能和验收标准。

目标太多：

/goal 修 bug、写文档、做页面、重构后端、优化数据库、部署上线

问题是任务跨度太大，建议拆成多个独立目标。

最佳实践

使用 /goal 时建议遵循下面规则：

1. 一个 /goal 只写一个核心目标。
2. 尽量写清楚验收标准。
3. 能指定项目路径就指定项目路径。
4. 能指定文件就指定文件。
5. 需要验证时写清楚验证方式，例如构建、测试、截图或运行检查。
6. 目标完成后及时标记完成，再开始下一个目标。

完整示例

下面是一条比较完整的 /goal：

/goal 帮我把当前 Codex 配置文档整理完整，要求说明 ApexAPI 的 config.toml 和 auth.json 配置方式，明确 Windows 用户名路径不能照抄 hh，并补充 key 对不上和 503 报错的区别。完成后生成 Markdown 文件。

这条目标比较好，因为它明确说明了：

• 要做的是配置文档。
• 涉及 ApexAPI、config.toml 和 auth.json。
• 要强调 Windows 用户名路径问题。
• 要补充常见报错。
• 最终产物是 Markdown 文件。

总结

/goal 的核心价值是让 Codex 在长任务中保持目标一致。

短问题可以直接问；长任务、代码修改、文档编写、配置排查、功能开发，建议先用 /goal 明确目标，再让 Codex 持续执行。

推荐模板：

/goal 帮我完成【任务】，要求【范围和约束】，最后通过【验证方式】确认完成