Codex
Codex CLI / VS Code 插件 / Codex App 使用 OminiApi 时的常见问题
配置教程见 Codex 配置。
401 Unauthorized
报错类似：
exceeded retry limit, last status: 401 Unauthorized, request id: xxxxxx检查是否有残留的环境变量
系统环境变量里的 OPENAI_API_KEY / OPENAI_BASE_URL 会覆盖配置文件，先确认它们不存在：
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)"两项都输出 MISSING 就直接进入下一步。否则运行下面的命令清空，然后重新打开终端：
cmd /c "setx OPENAI_API_KEY \"\" & setx OPENAI_BASE_URL \"\""返回 400 No eligible upstream supports the requested interface or model
当前模型在你密钥的分组里不支持 Responses 接口。Claude 系列不能在 Codex 里用，请换成 GPT 系列（如 gpt-6.1-sol、gpt-5.5），或在 API 密钥 里调整分组。更多错误见 错误码。
Connection failed
报错类似：
Connection failed: error sending request for url (https://omini.ominiapi.top/v1/responses)这是本机网络问题，按顺序排查：
- 检查网络是否通畅，浏览器能否打开
https://omini.ominiapi.top； - 开了代理工具的话，先关掉或把
omini.ominiapi.top设为直连再试； - 在终端里运行
codex发一句话，判断是不是 VS Code 插件的问题，是的话重启 VS Code； - 先看 服务状态，确认不是平台故障。还不行就带上报错截图 提交工单。
在容器或沙盒里连不上网
Codex 在 CLI 沙盒或容器（如代理工具的 TUN 模式）里运行时拉不到安装包、连不上网，而终端和 Claude Code 都正常，通常是 MTU 设置不当。把代理客户端里的 MTU 改成 1500 再试。
明明选了一个模型，账单里为什么还有别的模型
正常现象，不是配置错了，也不是账号被盗。
Codex 会在后台做一些小事，比如给会话起标题（/resume 列表里显示的那一行）、压缩长对话（/compact）、生成代码审查报告（/review）、整理联网搜索结果。做这些事时它可能换一个更便宜的模型，不用你在 /model 或 config.toml 里指定的那个。这是 Codex 官方的行为，无法通过配置关闭。
金额通常很小。明显偏大的话，到 使用日志 按时间找到那几笔看清楚，必要时 提交工单。
Windows 下中文乱码
按 Win + R，输入 intl.cpl 回车。
切到「管理」选项卡，点击「更改系统区域设置」。
勾选「Beta 版：使用 Unicode UTF-8 提供全球语言支持」，确定后重启电脑。
如何配置全局提示词
在 Codex 配置目录（%USERPROFILE%\.codex 或 ~/.codex）新建 AGENTS.md，写入提示词，重启 Codex 或 VS Code 后生效。示例见 Codex 配置 · 全局提示词。
如何开启内置网络搜索
在 config.toml 里加上：
[features]
web_search_request = true重启 Codex 后试试让它搜索。如果开启后请求报错，删掉这两行即可恢复。
更高效地使用 Codex
很多人用一段时间后觉得模型「变笨了」，大多数时候是用法问题：
- 拆分任务：不要提「帮我写一个管理系统后台」这样笼统的任务。Codex 的特点是严谨、指哪打哪，任务拆得越细效果越好；
- 保持掌控：提交任务前，你应该能预估这次会改哪些文件、产生哪些变动。不要让 AI 脱离你的掌控，否则项目会越改越乱；
- 避免压缩：大多数任务用 60% 左右的上下文就能解决。超过 60% 还没解决、甚至需要压缩，说明任务拆得还不够细。
常用命令
| 命令 | 说明 |
|---|---|
/model | 选择当前使用的模型 |
/approvals | 设置本会话的审批规则 |
/review | 审查当前工作区的变更 |
/resume | 从历史会话里选一个继续 |
/new | 在当前 CLI 里开启新对话 |
/init | 在当前目录生成 AGENTS.md 模板 |
/compact | 总结对话以释放上下文 |
/undo | 撤销上一次操作 |
/diff | 查看当前 git diff（含未跟踪文件） |
/mention | 把指定文件或目录加入对话 |
/status | 查看会话配置和 Token 使用情况 |
/mcp | 列出可用的 MCP 工具 |
/exit | 退出 Codex CLI |