Skip to content

Codex 相关问题

Codex CLI 接入 AnyDoAPI 时的高频问题、排错与高效用法。

配置前先看

基础配置:Codex 配置 · CC Switch 快速上手

令牌分组:codex-team / codex-plus / codex-sale(详见 令牌分组介绍

本页目录

章节你可能在找
高效使用任务拆分、避免「降智」
配置指南Windows 优化、乱码、AGENTS.md、VS Code 显示 gpt-5.6
常用命令会话内命令速查
高频报错Connection failed、401、403

高效使用 Codex

很多人用一段时间后觉得模型「降智」。多数情况下并不是模型变弱,而是用法问题。

原则怎么做
任务划分不要提交过于笼统的任务(例如「帮我写一个管理系统后台」),先拆到模块级
掌控之内提交前先预估会改哪些文件、产生哪些变动
避免压缩多数任务用约 60% 上下文就能解决;经常 /compact 说明拆分还不够细

配置指南

Windows 下更丝滑地使用 Codex

可同时缓解读写异常、乱码、Token 偏高、项目无记忆等问题。

  1. 确认 Codex CLI 与 VS Code Codex 插件已能对话
  2. Win + R 打开 %userprofile%\.codex
  3. 编辑 config.toml
toml
model_provider = "anydoapi"
model = "gpt-5.5"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

[model_providers.anydoapi]
name = "anydoapi"
base_url = "https://anydoapi.com/v1"
wire_api = "responses"
requires_openai_auth = true

无科学上网时,可将 base_url 改为 https://api-edge.anydoapi.com/v1

  1. 新建或编辑 AGENTS.md
markdown
# Codex 全局工作指南

## 回答风格
- 回答必须使用中文
- 对总结、Plan、Task 以及长内容输出,优先逻辑整理后用表格美观输出;普通内容正常输出
  1. 重启 VS Code / 终端后再试
Codex 在 Windows 下乱码?
  1. Win + R,输入 intl.cpl 回车
  2. 打开「管理」→「更改系统区域设置」
  3. 勾选「Beta 版:使用 Unicode UTF-8 提供全球语言支持」
  4. 确定并重启电脑后再使用 Codex
如何配置全局提示词?

~/.codex/AGENTS.md(Windows:%userprofile%\.codex\AGENTS.md)就是全局提示词文件。没有就手动创建,写入后重启 Codex 或 VS Code 生效。

如何开启内置网络搜索?

config.toml 中加入:

toml
[features]
web_search_request = true

保存后重新运行 codex

VS Code Codex 插件里如何设置模型?

优先在 CLI / config.toml 中把 model 设为 模型广场 当前可用的名称,并重启 VS Code。若插件模型列表偏旧,先确认插件已更新到最新版,再核对令牌分组是否支持该模型。

若列表里看不到 gpt-5.6 系列,见下一题。

VS Code 不显示 gpt-5.6 系列模型?

原因

Codex VS Code 扩展会读取动态配置 107580212available_models 白名单。远程配置若未包含 GPT-5.6,即便模型接口已返回这些模型,前端选择器也会把它们过滤掉。

修改位置

扩展目录通常为:

系统路径
Windows%USERPROFILE%\.vscode\extensions\openai.chatgpt-<版本>\webview\assets\
macOS / Linux~/.vscode/extensions/openai.chatgpt-<版本>/webview/assets/

只改 model-queries-*.js不要改同样包含 107580212app-main-*.js

不同版本文件名哈希可能不同:先在 model-queries-*.js 中搜索 107580212 定位。修改前请备份原文件。

改什么

  1. 把空默认白名单改为本地必含列表:
js
// 原:M=[]
M=["gpt-5.6-sol","gpt-5.6-terra","gpt-5.6-luna"]
  1. 把白名单选择改为「远程 ∪ 本地必含」:
js
// 原:availableModels:new Set(t.success?t.data:M)
availableModels:new Set(t.success?[...t.data,...M]:M)

改完效果

情况行为
远程配置读取成功保留远程 available_models,并额外并入三个 GPT-5.6
远程配置读取失败直接使用本地三个 GPT-5.6 作为默认白名单

Set 会自动去重。

生效验证

  1. 保存后,命令面板执行 Developer: Reload Window
  2. 重新打开模型选择器,应能看到:
    • gpt-5.6-sol
    • gpt-5.6-terra
    • gpt-5.6-luna

若仍看不到:确认改的是当前启用的 openai.chatgpt 版本,且账号实际可从服务端取得这些模型。

注意

  • 这是本地客户端覆盖,不会改服务器动态配置或账号权限
  • 扩展更新后,修改可能被覆盖,需重新检查
  • 新版本若压缩变量名 / 结构变了,不要硬替换;重新定位 107580212 对应的 available_models 解析逻辑后再改

常用命令

命令说明
/model选择当前使用的模型
/approvals设置本会话的审批规则
/review审查当前工作区变更
/resume从历史会话列表继续
/new开启新对话
/init在当前目录生成 AGENTS.md 模板
/compact总结对话以释放上下文(尽量少用)
/undo撤销上一次操作
/diff查看当前 git diff(含未跟踪文件)
/mention将指定文件或目录加入上下文
/status查看会话配置和 token 使用情况
/mcp列出当前可用的 MCP 工具
/exit退出 Codex CLI

高频报错

Connection failed

报错类似:

text
Connection failed: error sending request for url (https://anydoapi.com/v1/responses)

排查顺序:

  1. 检查本机网络是否通畅
  2. 若开了代理,先关闭代理重试;或改用加速地址 https://api-edge.anydoapi.com/v1
  3. 先在终端跑 codex 测试:CLI 正常而插件异常时,重启 VS Code
  4. 仍不行时,带上报错截图联系客服或群友
401 Unauthorized

报错类似:

text
exceeded retry limit, last status: 401 Unauthorized

先检查本机是否残留冲突的环境变量:

bat
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 ========================================================="
bash
echo "================= OPENAI ENV CHECK ================="
if [ -z "$OPENAI_API_KEY" ]; then echo "OPENAI_API_KEY  = MISSING"; else echo "OPENAI_API_KEY  = OK"; fi
if [ -z "$OPENAI_BASE_URL" ]; then echo "OPENAI_BASE_URL = MISSING"; else echo "OPENAI_BASE_URL = OK"; fi
echo "========================================================"

若环境变量存在且与 auth.json / config.toml 冲突,先清空再测:

bat
cmd /c "setx OPENAI_API_KEY \"\" & setx OPENAI_BASE_URL \"\""
bash
unset OPENAI_API_KEY OPENAI_BASE_URL

然后核对:

  1. ~/.codex/auth.json 中的 OPENAI_API_KEY 是否正确
  2. ~/.codex/config.tomlbase_url 是否为 https://anydoapi.com/v1 或加速地址,且 model_provider[model_providers.xxx] 同名
  3. 令牌分组是否为 Codex 专用分组
403 Forbidden / usage_not_included

报错类似:

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

通常是当前号池账号异常:

  1. Ctrl + C(或 VS Code 停止按钮)打断当前对话
  2. 重新发起请求
  3. 连续重试 3 次仍失败,带截图联系客服或群友
config.toml 改了不生效?
  1. 确认 model_provider = "anydoapi"[model_providers.anydoapi] 名称一致
  2. Codex 不会热重载,需退出进程并重新打开终端
  3. VS Code 插件需重启编辑器
沙盒 / 容器里无法联网?

若只有 Codex 在沙盒或容器(如 tun 模式)中拉包失败,而终端、Claude Code 正常,可尝试将代理客户端 MTU 调整为 1500 后重试。


相关链接