codex cli 在 windows 上需手动配置 config.toml 实现模型选择、禁用缓存等定制功能;全局配置位于 %userprofile%.codex,项目级配置优先级更高且须置于项目根目录的 .codex 文件夹内。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想让 Codex CLI 在 Windows 10/11 上按你习惯的方式运行——比如默认用更强的模型、禁用本地响应缓存、限定只读指定目录,这些都不能靠界面点选,全得靠改 config.toml 文件实现。
确认并进入全局配置目录
按下 Win + R,输入 %USERPROFILE%\.codex,回车。如果弹出“找不到路径”提示,说明该文件夹还不存在,需要手动创建。
在资源管理器地址栏直接粘贴路径后回车,若目录为空白或根本打不开,就右键空白处→新建→文件夹,命名为 【.codex】(注意开头的英文点号,不能漏,也不能写成中文句号)。
这一步必须做对,否则后续所有配置文件都放错位置,Codex 根本不会读取。
写入基础 config.toml 文件
在刚建好的 【.codex】 文件夹内,新建一个文本文档,重命名为 config.toml(确保扩展名是 .toml,不是 .txt)。
用记事本或 VS Code 打开它,直接复制粘贴以下内容(全部覆盖原有内容,哪怕文件刚新建是空的):
model_provider = "token173"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.token173]
name = "token173"
base_url = "https://api.token173.com/v1"
wire_api = "chat/completions"
为不同项目单独定制配置
当你同时维护多个项目,且每个项目需要不同的模型或调用规则时,绝不能动全局 config.toml——否则所有项目一起变。
方法一:项目级配置优先级更高
在项目根目录(比如 D:\Projects\backend-api)下,新建文件夹 【.codex】,再在里面新建 config.toml。内容格式和全局一致,但只影响当前项目。
方法二:快速验证是否加载成功
打开 PowerShell,cd 进入该项目根目录 → 运行 codex --debug → 查看输出里 "Loaded config from" 后面的路径。如果是项目路径,说明配置已生效;如果显示用户目录,说明你没在正确目录下执行命令。
第一步:确保终端当前路径就是项目根目录,不是子文件夹也不是桌面。
第二步:修改完项目级 config.toml 后,必须关闭当前终端,新开一个再执行 codex 命令——旧终端会缓存旧配置。
第三步:项目配置中 model_provider 字段值必须和 [model_providers.xxx] 小节名称完全一致,大小写、下划线都不能错,否则启动报错。









