Codex 相关问题
一点点技巧,如何更高效地使用 Codex
很多人可能会在使用过一段时间 Codex 后认为模型不如以前好用,也就是出现所谓的“降智”现象。而就目前我的使用体验来看,Codex 中提供的模型经过很多次升级,其实都没有出现“降智”,关键是在于你如何合理地去使用模型。
- 任务划分:任何时候,都不要去提交一个非常笼统的任务,例如
请帮我写一个管理系统后台等,这样使用必然降智!Codex 模型的特点是严谨有序,指哪打哪,这就意味着你需要对你的任务进行拆分。 - 掌控之内:在你开始一个任务之前,你需要对这个任务进行评估,思考这个任务是否已经拆分的足够细致,是否符合“模块化”开发的准则。在任务提交之前,你应该有能力预估 Codex 这次改动会修改哪些文件,产生哪些变动。一定不要让 AI 脱离你的认知与掌控之内,不然最终结局就是项目越改越乱,直到从原点重新开始。
一些碎碎念
有一说一,AI 时代让很多东西都变得十分简单,但是基础知识决定着你使用 AI 的上限,目前阶段的 AI 只算作是一个十分优秀的 Copilot 角色。这也导致同样的 AI 在不同的人手里会有不一样的发挥~
- 避免压缩:在多数场景下,你的任务其实最多使用 Codex 大概 60% 的上下文就能解决。如果你的任务超过了 60% 的上下文仍未解决,甚至还需要压缩,那么你这次任务执行之前的拆分工作算是失败了,你需要更加精细地拆分你的任务。一个优秀的 Codex Vibe Coding 选手几乎不用进行内容压缩!
在 Windows 系统下,丝滑使用 Codex!
重要
此方法同时解决读写文件、乱码、Token 耗费高、项目无记忆等多个痛点。
- 确保你的
Codex CLI与VS Code Codex插件正常运行,即你已经能顺利在 VS Code 的 Codex 插件上与模型进行对话。 - 键盘按下
Win + R键,输入以下内容后回车,打开你的用户目录:
%userprofile%\.codex- 找到目录中的
config.toml文件,打开并编辑,你的配置文件应该如下:
toml
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://tokenflow.run"
wire_api = "responses"
requires_openai_auth = true
[features]
goals = true- 打开目录下
AGENTS.md文件(如果没有请手动创建),在里面写入以下内容后保存:
markdown
# Codex全局工作指南
## 回答风格:
- 回答必须使用中文
- 对总结、Plan、Task、以及长内容的输出,优先进行逻辑整理后使用美观的 Table 格式整齐输出;普通内容正常输出- 运行你的 VS Code,打开 Codex 插件用起来,看看有什么不一样吧~
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 |
Codex 在 Windows 系统下乱码问题
- 按下快捷键
Win + R,打开左下角运行窗口,输入以下命令后回车:
intl.cpl

- 点击上侧选项卡“管理”,再点击红色箭头所示的“更改系统区域设置”按钮。

- 勾选红色箭头所指选项,点击确定。然后在刚才的窗口也点击确定,之后重启一下你的电脑再使用 Codex,即可避免乱码。
VS Code Codex 插件中设置最新模型
- 按下快捷键
Win + R,打开左下角运行窗口,输入以下命令后回车:
%userprofile%\.vscode\extensions通用步骤

- 找到以
openai.chatgpt开头的文件夹,后面的数字是版本号,如果存在多个这种开头的目录,选择版本号最新的目录进入。

- 依次进入
webview\assets文件夹,你会看到一大堆 js 文件。

- 下载替换脚本后解压,将这个 js 文件复制到刚才有一大堆 js 文件的目录(脚本会自动读取最新版本号与文件名,直接点击即可下载)。

- 重启你的 VS Code,你就能看见现在能选择最新模型啦!
Codex 如何配置全局提示词
- 请你查看 配置 CLI 工具 中的前两步。
- 教程中提到的
AGENTS.md文件就是 Codex 的全局提示词文件,如果没有这个文件,你同样需要手动创建这个文件,然后写入提示词。 - 写入提示词保存,重启你的 Codex 或者 VS Code,提示词即生效。
Codex 开启内置网络搜索
- 请你查看 配置 CLI 工具 中的前两步。
- 打开教程中提到的
config.toml文件,在里面加入以下内容:
toml
[features]
web_search_request = true
- 运行 Codex,进行尝试。
Codex 在容器或 CLI 沙盒中的网络连接问题
当 Codex 在 CLI 沙盒或容器(如 tun 模式)中运行时遇到网络连接问题(如无法拉取安装包),且其他工具(如终端、Claude Code)正常,这通常是由于 MTU 设置不当引起的。
解决方案:
- 将 MTU 值改为
1500,此设置通常可在您的 Clash 客户端中进行更改。 - 对于在 Linux 上找不到 Clash MTU 设置的用户,可以参考此链接:https://linux.do/t/topic/1220328
Connection failed 问题
报错信息类似为:
Connection failed: error sending request for url (https://xxxxxx/v1/responses)出现这种情况是你本机网络出现了问题,按以下步骤排查:
- 检查本机网络是否通畅,能否访问其他页面。
- 检查你的电脑是否使用了网络代理(梯子)工具,如果存在请你关闭。
- 使用终端,运行
codex命令,尝试在 CLI 中发送对话信息,判断是否是 VS Code Codex 插件问题,如是,请你重启 VS Code 进行尝试。 - 如果还不行,带上你的报错截图,在群内咨询客服或群友。
Codex 401 报错问题
报错信息类似为:
exceeded retry limit, last status: 401 Unauthorized, request id: xxxxxx- 在 Windows 或 macOS 的终端运行以下命令,判断是否存在环境变量。
bash
cmd /c "echo ================= OPENAI ENV CHECK ================= & ^ if defined OPENAI_API_KEY (echo OPENAI_API_KEY = OK) else (echo OPENAI_API_KEY = MISSING) & ^ if defined OPENAI_BASE_URL (echo OPENAI_BASE_URL = OK) else (echo OPENAI_BASE_URL = MISSING) & ^ echo ========================================================="如果输出以下内容,则直接进入第 2 步:
OPENAI_API_KEY = MISSING
OPENAI_BASE_URL = MISSING如果输出内容不同,请在终端运行以下命令后进入第二步:
bash
cmd /c "setx OPENAI_API_KEY \"\" & setx OPENAI_BASE_URL \"\""- 查看 配置 CLI 工具 一章。
重要
你需要:
- 检查
~/.codex/auth.json中的 ApiKey 配置是否正确。 - 检查
~/.codex/config.toml中的请求地址是否正确。
Codex 403 报错问题
报错信息类似为:
unexpected status 403 Forbidden: {"error":{"message":"Usage not included in your plan","type":"usage_not_included","param":null,"code":null,"plan_type":"basic"}}出现这种情况是号池中的这个账号出现问题,你需要:
- 使用
Ctrl + C来打断你的对话,如在 VS Code 中,请点击停止按钮。 - 重新发起对话进行尝试,观察是否再次出现此问题。
- 如果重试 3 次以上无效,带上你的报错截图,在群内咨询客服或群友。
