Appearance
Codex 相关问题
Codex CLI 接入 AnyDoAPI 时的高频问题、排错与高效用法。
本页目录
| 章节 | 你可能在找 |
|---|---|
| 高效使用 | 任务拆分、避免「降智」 |
| 配置指南 | Windows 优化、乱码、AGENTS.md、VS Code 显示 gpt-5.6 |
| 常用命令 | 会话内命令速查 |
| 高频报错 | Connection failed、401、403 |
高效使用 Codex
很多人用一段时间后觉得模型「降智」。多数情况下并不是模型变弱,而是用法问题。
| 原则 | 怎么做 |
|---|---|
| 任务划分 | 不要提交过于笼统的任务(例如「帮我写一个管理系统后台」),先拆到模块级 |
| 掌控之内 | 提交前先预估会改哪些文件、产生哪些变动 |
| 避免压缩 | 多数任务用约 60% 上下文就能解决;经常 /compact 说明拆分还不够细 |
配置指南
Windows 下更丝滑地使用 Codex
可同时缓解读写异常、乱码、Token 偏高、项目无记忆等问题。
- 确认 Codex CLI 与 VS Code Codex 插件已能对话
Win + R打开%userprofile%\.codex- 编辑
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。
- 新建或编辑
AGENTS.md:
markdown
# Codex 全局工作指南
## 回答风格
- 回答必须使用中文
- 对总结、Plan、Task 以及长内容输出,优先逻辑整理后用表格美观输出;普通内容正常输出- 重启 VS Code / 终端后再试
Codex 在 Windows 下乱码?
Win + R,输入intl.cpl回车- 打开「管理」→「更改系统区域设置」
- 勾选「Beta 版:使用 Unicode UTF-8 提供全球语言支持」
- 确定并重启电脑后再使用 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 扩展会读取动态配置 107580212 的 available_models 白名单。远程配置若未包含 GPT-5.6,即便模型接口已返回这些模型,前端选择器也会把它们过滤掉。
修改位置
扩展目录通常为:
| 系统 | 路径 |
|---|---|
| Windows | %USERPROFILE%\.vscode\extensions\openai.chatgpt-<版本>\webview\assets\ |
| macOS / Linux | ~/.vscode/extensions/openai.chatgpt-<版本>/webview/assets/ |
只改 model-queries-*.js,不要改同样包含 107580212 的 app-main-*.js。
不同版本文件名哈希可能不同:先在 model-queries-*.js 中搜索 107580212 定位。修改前请备份原文件。
改什么
- 把空默认白名单改为本地必含列表:
js
// 原:M=[]
M=["gpt-5.6-sol","gpt-5.6-terra","gpt-5.6-luna"]- 把白名单选择改为「远程 ∪ 本地必含」:
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 会自动去重。
生效验证
- 保存后,命令面板执行
Developer: Reload Window - 重新打开模型选择器,应能看到:
gpt-5.6-solgpt-5.6-terragpt-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)排查顺序:
- 检查本机网络是否通畅
- 若开了代理,先关闭代理重试;或改用加速地址
https://api-edge.anydoapi.com/v1 - 先在终端跑
codex测试:CLI 正常而插件异常时,重启 VS Code - 仍不行时,带上报错截图联系客服或群友
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然后核对:
~/.codex/auth.json中的OPENAI_API_KEY是否正确~/.codex/config.toml中base_url是否为https://anydoapi.com/v1或加速地址,且model_provider与[model_providers.xxx]同名- 令牌分组是否为 Codex 专用分组
403 Forbidden / usage_not_included
报错类似:
text
unexpected status 403 Forbidden: {"error":{"message":"Usage not included in your plan", ...}}通常是当前号池账号异常:
- 用
Ctrl + C(或 VS Code 停止按钮)打断当前对话 - 重新发起请求
- 连续重试 3 次仍失败,带截图联系客服或群友
config.toml 改了不生效?
- 确认
model_provider = "anydoapi"与[model_providers.anydoapi]名称一致 - Codex 不会热重载,需退出进程并重新打开终端
- VS Code 插件需重启编辑器
沙盒 / 容器里无法联网?
若只有 Codex 在沙盒或容器(如 tun 模式)中拉包失败,而终端、Claude Code 正常,可尝试将代理客户端 MTU 调整为 1500 后重试。