Codex

Codex 自己会在背地里做几件小事，比如：

• 给你的会话起个名字（就是 /resume 历史列表里显示的那一行标题）。
• 把很长的聊天记录压缩一下（/compact）。
• 生成代码审查报告（/review）。
• 帮你整理联网搜索的结果。

做这些小事的时候，Codex 会自己换一个更便宜的模型去处理，不会用你在 /model 或 config.toml 里指定的那个模型。所以账单里多出一些别的模型，是它自己在干活，不是你选错了。

到底要不要担心

• 这笔钱如果很小（一般几分钱到几毛钱），不用管，正常。
• 如果这笔钱很大（比如好几块钱以上），那就不正常了，请联系 VORTEX 支持。

想亲眼确认一下：打开 VORTEX API 控制台，登录账号后找到“使用日志”或“消费日志”，按时间定位那一笔记录，查看实际使用的模型和费用。

这类辅助调用无法通过 config.toml 里的配置项关闭，是 Codex 自带的行为。

很多人可能会在使用过一段时间 Codex 后认为模型不如以前好用，也就是出现所谓的“降智”现象。而就目前的使用体验来看，Codex 中提供的模型经过多次升级，其实都没有出现“降智”，关键在于你如何合理地使用模型。

1. 任务划分：任何时候，都不要提交一个非常笼统的任务，例如“请帮我写一个管理系统后台”。Codex 模型的特点是严谨有序、指哪打哪，这意味着你需要先对任务进行拆分。
2. 掌控之内：开始任务之前，评估任务是否拆分得足够细致、是否符合模块化开发准则。提交任务之前，应能预估本次改动会修改哪些文件、产生哪些变动。不要让 AI 脱离你的认知与掌控，否则项目可能越改越乱，直到从原点重新开始。

一些碎碎念：AI 时代让很多事情变得简单，但是基础知识决定着使用 AI 的上限。目前阶段的 AI 只算作一个十分优秀的 Copilot 角色，同样的 AI 在不同的人手里也会有不一样的发挥。

• 避免压缩：多数场景下，任务最多使用 Codex 大概 60% 的上下文就能解决。如果任务超过 60% 的上下文仍未解决，甚至还需要压缩，说明执行前的拆分还不够细致。优秀的 Codex Vibe Coding 使用者几乎不用进行内容压缩。

1. 确保 Codex CLI 与 VS Code Codex 插件正常运行，即已经能顺利在 VS Code 的 Codex 插件上与模型对话。
2. 按 Win + R，输入下面的路径并回车，打开用户目录下的 .codex 文件夹。

%userprofile%\.codex

找到目录中的 config.toml 文件并编辑。配置文件可以按下面的 VORTEX API 示例填写：

model_provider = "vortex"
model = "你的模型 ID"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

[model_providers.vortex]
name = "vortex"
base_url = "https://api.vortexai.best/v1"
wire_api = "responses"
requires_openai_auth = true

打开同一目录下的 AGENTS.md 文件（如果没有请手动创建），写入你的全局工作指南并保存。

# Codex 全局工作指南

## 回答风格
- 回答必须使用中文
- 对总结、Plan、Task 以及长内容，优先使用结构清晰的表格；普通内容正常输出

重启 VS Code，打开 Codex 插件即可开始使用。

1. 按 Win + R 打开运行窗口，输入以下命令后回车。

intl.cpl

1. 点击上侧选项卡“管理”，再点击“更改系统区域设置”。
2. 勾选“使用 Unicode UTF-8 提供全球语言支持”，点击确定，并重启电脑后再次使用 Codex。

1. Windows：按 Win + R 打开运行窗口，输入下面的路径并回车；macOS：打开 ~/.vscode/extensions。

%userprofile%\.vscode\extensions

1. 找到以 openai.chatgpt 开头的文件夹；如果存在多个目录，进入版本号最新的目录。
2. 依次进入 webview\assets 文件夹，找到插件的模型列表脚本。
3. 升级 VS Code Codex 插件到最新版本；若版本暂未包含目标模型，请使用可信来源提供的兼容替换脚本，并将文件放入该 assets 目录。
4. 重启 VS Code，确认模型列表已更新。

1. 先查看“配置 Codex”一章中的配置文件位置。
2. 教程中提到的 AGENTS.md 文件就是 Codex 的全局提示词文件；如果没有请手动创建。
3. 写入提示词并保存，重启 Codex 或 VS Code 后即可生效。

1. 先查看“配置 Codex”一章中的配置文件位置。
2. 打开 config.toml 文件，在里面加入以下内容。

[features]
web_search_request = true

运行 Codex，发起一次需要联网的信息查询进行验证。

当 Codex 在 CLI 沙盒或容器（如 tun 模式）中运行时遇到网络连接问题（如无法拉取安装包），且其他工具正常，这通常是由于 MTU 设置不当引起的。

解决方案：将 MTU 值改为 1500，此设置通常可在 Clash 客户端中进行更改。Linux 上找不到 Clash MTU 设置时，可参考 https://linux.do/t/topic/1220328。

报错信息类似为：

Connection failed: error sending request for url (https://api.vortexai.best/v1/responses)

出现这种情况通常是本机网络问题，按以下步骤排查。

1. 检查本机网络是否通畅，能否访问其他页面。
2. 检查电脑是否使用了网络代理工具；如果存在，请暂时关闭后重试。
3. 使用终端运行 codex 命令，尝试在 CLI 中发送对话，判断是否是 VS Code Codex 插件问题；如是，请重启 VS Code。
4. 如果还不行，带上报错截图、客户端版本和发生时间，在群内咨询客服或群友。

报错信息类似为：

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

在 Windows 或 macOS 终端运行以下命令，判断是否存在环境变量。

echo "================= OPENAI ENV CHECK ================="
if [ -n "$OPENAI_API_KEY" ]; then echo "OPENAI_API_KEY  = OK"; else echo "OPENAI_API_KEY  = MISSING"; fi
if [ -n "$OPENAI_BASE_URL" ]; then echo "OPENAI_BASE_URL = OK"; else echo "OPENAI_BASE_URL = MISSING"; fi
echo "========================================================="

如果 OPENAI_API_KEY 与 OPENAI_BASE_URL 均为 MISSING，进入下一步；如果输出不同，请清理旧变量后再继续。

unset OPENAI_API_KEY OPENAI_BASE_URL

1. 查看“配置 Codex”一章。
2. 检查 ~/.codex/auth.json 中的 API 密钥配置是否正确。
3. 检查 ~/.codex/config.toml 中的请求地址是否正确。

报错信息类似为：

unexpected status 403 Forbidden: {"error":{"message":"Usage not included in your plan","type":"usage_not_included"}}

出现这种情况可能是当前账号、API 密钥分组或目标模型没有可用额度。

1. 使用 Ctrl+C 打断当前对话；在 VS Code 中请点击停止按钮。
2. 重新发起对话，观察是否再次出现此问题。
3. 如果重试 3 次以上仍无效，带上报错截图和时间范围联系 VORTEX 支持。