文档中心
Codex 强制启用 gpt-5.3-codex(模型列表不显示时)
当 Codex 模型列表里看不到 gpt-5.3-codex 或模型无法加载时,本文提供修改 .codex/config.toml 与命令行强制启用的完整步骤、风险说明和适用场景。
最近有用户遇到:gpt-5.3-codex 在 Codex 模型列表里不显示或无法加载。
这篇教程给你两个可落地方案:
- 直接改配置文件,强制默认模型为
gpt-5.3-codex - 启动时用参数显式指定模型(可选危险全权限模式)
方法一:修改 config.toml 强制切换模型(推荐)
在根目录找到:
.codex/config.toml
把:
model = "gpt-5.2-codex"
改成:
model = "gpt-5.3-codex"
保存后重新运行 codex,默认就会使用 gpt-5.3-codex。
修改前可以先备份并确认文件内容:
cp ~/.codex/config.toml ~/.codex/config.toml.bak
grep -n '^model' ~/.codex/config.toml
不同安装方式的配置目录可能由当前版本决定。如果找不到文件,先执行 codex --help,再在用户目录搜索 config.toml,不要直接新建多个同名文件造成配置来源混乱。
方法二:命令行临时强制指定模型
codex -m gpt-5.3-codex
这个方式不会改配置文件,适合临时测试。
验证结果时重点观察三点:Codex 是否能正常启动、模型是否接受第一条请求、连续发送第二条请求时是否仍返回同样的权限或模型错误。若命令直接提示模型不存在,通常是账号、版本或 API 服务端没有开放该模型,继续修改本地配置也不会解决。
全权限模式命令(高风险)
codex -m gpt-5.3-codex --dangerously-bypass-approvals-and-sandbox
命令含义:
codex:启动 Codex CLI-m gpt-5.3-codex:指定本次会话模型--dangerously-bypass-approvals-and-sandbox:跳过审批与沙箱限制
该标志会让 Codex 以当前用户权限直接读写文件、执行命令,不再弹出审批提示。
使用危险标志前必须确认
仅在以下条件都满足时使用:
- 当前是可控环境(本地开发机/隔离容器)
- 项目已经有版本管理(如 Git)
- 你明确知道这次任务会修改哪些目录和文件
不建议在生产环境、线上服务器、敏感主机默认开启此参数。
常见报错怎么判断?
- model not found / unknown model:模型名未被当前账号或服务端开放,先查看可用模型和版本说明。
- 401 / 403:认证或权限问题,检查当前登录身份、API Key 和
OPENAI_BASE_URL,不要把密钥贴到日志或文章中。 - 配置文件解析失败:检查 TOML 引号、缩进和重复键;可以先恢复
.bak文件,再逐项修改。 - 启动后仍使用旧模型:关闭已有会话并重新启动,确认项目级配置没有覆盖全局配置。
建议的安全操作顺序
- 先用方法一或
codex -m gpt-5.3-codex验证模型可用 - 再决定是否需要危险标志
- 执行前先
git status,执行后立刻复查改动
一句话总结
当模型列表加载不到 gpt-5.3-codex 时,最稳妥做法是先修改 .codex/config.toml 强制切换;
--dangerously-bypass-approvals-and-sandbox 只用于你能完全承担风险的自动化场景。
常见问题
为什么改了 config.toml 仍然看不到 gpt-5.3-codex?
先确认当前 Codex 版本、账号权限和服务商实际提供的模型列表,再用 codex -m gpt-5.3-codex 做一次单次测试。模型名称本身不能绕过服务端权限或版本限制。
如何撤销强制模型设置?
删除或注释 config.toml 中的 model 行即可恢复默认选择;修改前建议先复制一份配置文件,便于出现启动错误时快速回滚。