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://vortexapi.xyz/v1"
wire_api = "responses"
requires_openai_auth = true

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

# Codex 全局工作指南

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

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

聊到一半就开始压缩上下文，前面交代过的细节还得再说一遍？如果你确实需要在一个任务里放入大量代码或资料，可以把上下文窗口设为 1M，也就是约 100 万 Token。前提是你选的模型和接入渠道本身支持这个长度，光改配置不能把模型的上限变大。

1. 打开用户目录下的 .codex/config.toml。Windows 可以按 Win + R，输入 %userprofile%\.codex；macOS 可以在访达中按 Shift + Command + G，输入 ~/.codex。
2. 在文件顶部加入下面两行，放在 [model_providers.vortex]、[features] 等方括号配置段之前。如果已经有同名配置，直接修改原来的值，不要重复添加。

model_context_window = 1000000
model_auto_compact_token_limit = 900000

第一行把上下文窗口设为 100 万 Token；第二行是自动压缩的触发阈值，这里用 90 万作为示例，给后续回复和工具结果留一些余量。它不是要求你每次都把上下文用满。

保存后，退出并重新打开 Codex；用 VS Code 插件的话就重启 VS Code，再开一个新会话。可以查看上下文用量提示，确认容量是否更新。如果仍显示原来的容量，先检查当前模型和渠道是否支持 1M，以及项目配置有没有覆盖这两项。

请帮我把 Codex 上下文窗口设为 1000000 Token，自动压缩阈值设为 900000，保留其他配置，并告诉我如何重启生效。

刚装好打开全是英文，先去设置里切一下语言。这里说的是下图所示的桌面客户端界面语言，按英文菜单名称找就行。

1. 打开 Settings（设置），在左侧选择 General（常规）。
2. 找到 Language（语言 / 应用 UI 语言），点开右侧下拉框，把 Auto-detect（自动检测）改成“简体中文”。找不到时，可以在下拉框的搜索栏里搜索 Chinese。
3. 如果是新安装的客户端，改完语言后需要先开启魔法（网络代理），再彻底退出并重新启动 Codex，让它能够联网下载语言包。只关窗口可能还在后台运行，要从应用菜单或托盘中选择退出。
4. 重启后保持网络通畅，等语言包下载完成，再检查设置页和菜单是否已经变成中文。如果还是英文，确认语言选项已保存，并检查代理是否对客户端生效，然后重新启动。

请帮我把 Codex 桌面客户端的界面语言改为简体中文；如果无法直接修改，请告诉我操作步骤，并提醒我开启魔法后重启下载语言包。

着急等结果时，可以试试 Fast 模式。它用于加快模型响应，实际快多少还得看模型和当时的服务情况。平时不赶时间的话，保持普通模式就好。

在支持 Fast 的 Codex CLI 会话中，输入下面的命令即可开启：

/fast on

输入 /fast status 可以查看当前状态；用完后输入 /fast off 关闭。如果提示不支持，先更新客户端，再确认当前模型和接入渠道是否支持 Fast。

如果希望默认开启，也可以编辑前面提到的 config.toml：把 service_tier 放在文件顶部、所有方括号配置段之前，再在 [features] 下设置 fast_mode。已有 [features] 段时，只在原段内补充或修改这一项，不要重复新建。

service_tier = "fast"

[features]
fast_mode = true

保存后重启 Codex 并新开会话。想取消默认开启，就删除 service_tier = "fast" 这一行，再重启。通过 VORTEX API 接入时，发起请求后可以去消费日志核对：Codex 的 fast 设置会映射为请求中的 priority，所以日志里看到 service_tier = priority 也是正常的，最终以日志中的计费结果为准。

请帮我配置 Codex 默认开启 Fast（service_tier = "fast"、[features] 下 fast_mode = true），保留其他配置，并告诉我如何重启生效。

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://vortexapi.xyz/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 支持。