Codex 相关
1. Codex 中常用命令
| 命令 | 说明 |
|---|---|
/model | 选择当前使用的模型 |
/approvals | 设置本会话的审批规则 |
/review | 让 Codex 审查当前工作区变更 |
/resume | 从历史会话列表中继续之前的会话 |
/new | 在当前 CLI 会话中开启新对话 |
/init | 在当前目录生成 AGENTS.md 模板 |
/compact | 总结对话内容以释放上下文 |
/undo | 撤销 Codex 的上一次操作 |
/diff | 查看当前 git diff(含未跟踪文件) |
/mention | 将指定文件或目录加入对话上下文 |
/status | 查看会话配置和 token 使用情况 |
/mcp | 列出当前可用的 MCP 工具 |
/exit | 退出 Codex CLI |
2. 如何更高效地使用 Codex
Codex 是一个指令遵循能力极强的模型,它的核心特点是”你说得越清楚,它做得越好”。与其让模型去猜你的意思,不如花时间把需求描述得足够具体。
🎯
核心原则:精准指令 + 控制上下文
Codex 不是一个”聊天伙伴”,而是一个严格执行指令的工具。你给出的指令越是模糊,它返回的结果就越是偏离预期。
打磨你的提示词
- 要具体,不要笼统: 不要只说”帮我写一个后台管理系统”,而是要说清楚每一个细节:使用什么框架、需要哪些字段、接口规范是什么。把任务拆到你能预判产出的粒度
- 提供上下文信息: 告诉 Codex 当前项目的技术栈、文件结构、编码规范。信息越充分,输出质量越高
- 明确期望的输出格式: 如果你希望返回特定格式的代码、表格、或分步骤的方案,直接在提示词中说明
控制上下文长度
Codex 虽然支持上下文压缩(/compact),但压缩后不可避免会丢失部分信息,可能出现”降智”现象。最佳实践是:
- 任务尽量一次完成: 确保在上下文用量不超过 60% 的情况下完成当前任务
- 及时开新会话: 完成一个模块后,用
/new开启新对话,而不是在同一个超长会话里继续 - 善用 AGENTS.md: 将项目的全局规范和常用信息写入
AGENTS.md,这样每次新会话都能自动加载,不占用对话上下文
3. Codex 在 Windows 系统下乱码问题
打开区域设置
按下快捷键 Win + R,输入以下命令后回车
intl.cpl更改系统区域设置
点击上侧选项卡「管理」,再点击「更改系统区域设置」按钮
勾选 UTF-8 选项
勾选使用Unicode UTF-8提供全球语言支持,点击确定。然后在刚才的窗口也点击确定,之后重启电脑再使用 Codex,即可避免乱码
4. Codex 如何配置全局提示词
- 请你查看 Codex CLI 配置 中的前两步
- 教程中提到的
AGENTS.md文件就是 Codex 的全局提示词文件,如果没有这个文件,你需要手动创建 - 写入提示词保存,重启你的 Codex 或者 VSCode,提示词即生效
5. Codex 开启内置网络搜索
- 请你查看 Codex CLI 配置 中的前两步
- 打开教程中提到的
config.toml文件,在里面加入以下内容
web_search = "live"6. Codex 在容器或 CLI 沙盒中的网络连接问题
当 Codex 在 CLI 沙盒或容器(如 tun 模式)中运行时遇到网络连接问题(如无法拉取安装包),且其他工具正常,这通常是由于 MTU 设置不当引起的。
解决方案:
- 将 MTU 值改为 1500,此设置通常可在您的 Clash 客户端中进行更改
- 对于在 Linux 上找不到 Clash MTU 设置的用户,可以参考此链接:https://linux.do/t/topic/1220328
7. Connection failed 问题
报错信息类似为:
Connection failed: error sending request for url (https://www.tabcode.com/v1/responses)出现这种情况是你本机网络出现了问题,按以下步骤排查:
- 检查本机网络是否通畅,能否访问其他页面
- 检查你的电脑是否使用了
网络代理(梯子)工具,如果存在请你关闭 - 使用终端运行
codex命令,尝试在 CLI 中发送对话,判断是否是 VSCode Codex 插件问题 - 如果还不行,带上你的报错截图,在群内咨询客服或群友
8. 401 报错问题
报错信息类似为:
exceeded retry limit, last status: 401 Unauthorized, request id: xxxxxxLast updated on