Skip to Content

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 不是一个”聊天伙伴”,而是一个严格执行指令的工具。你给出的指令越是模糊,它返回的结果就越是偏离预期。

打磨你的提示词

  1. 要具体,不要笼统: 不要只说”帮我写一个后台管理系统”,而是要说清楚每一个细节:使用什么框架、需要哪些字段、接口规范是什么。把任务拆到你能预判产出的粒度
  2. 提供上下文信息: 告诉 Codex 当前项目的技术栈、文件结构、编码规范。信息越充分,输出质量越高
  3. 明确期望的输出格式: 如果你希望返回特定格式的代码、表格、或分步骤的方案,直接在提示词中说明

控制上下文长度

Codex 虽然支持上下文压缩(/compact),但压缩后不可避免会丢失部分信息,可能出现”降智”现象。最佳实践是:

  1. 任务尽量一次完成: 确保在上下文用量不超过 60% 的情况下完成当前任务
  2. 及时开新会话: 完成一个模块后,用 /new 开启新对话,而不是在同一个超长会话里继续
  3. 善用 AGENTS.md: 将项目的全局规范和常用信息写入 AGENTS.md,这样每次新会话都能自动加载,不占用对话上下文

3. Codex 在 Windows 系统下乱码问题

打开区域设置

按下快捷键 Win + R,输入以下命令后回车

intl.cpl

更改系统区域设置

点击上侧选项卡「管理」,再点击「更改系统区域设置」按钮

勾选 UTF-8 选项

勾选使用Unicode UTF-8提供全球语言支持,点击确定。然后在刚才的窗口也点击确定,之后重启电脑再使用 Codex,即可避免乱码


4. Codex 如何配置全局提示词

  1. 请你查看 Codex CLI 配置 中的前两步
  2. 教程中提到的 AGENTS.md 文件就是 Codex 的全局提示词文件,如果没有这个文件,你需要手动创建
  3. 写入提示词保存,重启你的 Codex 或者 VSCode,提示词即生效

5. Codex 开启内置网络搜索

  1. 请你查看 Codex CLI 配置 中的前两步
  2. 打开教程中提到的 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)

出现这种情况是你本机网络出现了问题,按以下步骤排查:

  1. 检查本机网络是否通畅,能否访问其他页面
  2. 检查你的电脑是否使用了网络代理(梯子)工具,如果存在请你关闭
  3. 使用终端运行 codex 命令,尝试在 CLI 中发送对话,判断是否是 VSCode Codex 插件问题
  4. 如果还不行,带上你的报错截图,在群内咨询客服或群友

8. 401 报错问题

报错信息类似为:

exceeded retry limit, last status: 401 Unauthorized, request id: xxxxxx

你需要:

  1. 检查 ~/.codex/auth.json 中的 ApiKey 配置是否正确
  2. 检查 ~/.codex/config.toml 中的 请求地址 是否正确

查看 Codex CLI 配置 一章

Last updated on