1. Codex 在 Windows 弹出“完成 Windows 设置”到底卡在哪你打开 Codex Windows 客户端界面突然弹出一句“完成 Windows 设置 ChatGPT 需要一次性权限才能在你的电脑上运行”点确认没反应点取消直接退出重装一遍还是老样子。这个提示看起来像 Windows 系统 UAC 弹窗但实际排查下来它更多是 Codex 自己在初始化本地运行环境时抛出的状态提示跟系统账户权限、UAC 等级关系不大。Codex 在 Windows 上启动时会做几件事读取用户目录下的.codex配置目录、解析config.toml、加载 MCP Server 列表、尝试建立本地沙箱运行环境。只要其中任何一步失败Codex 就可能把错误统一收敛成“完成 Windows 设置”这个界面让你误以为是权限问题。实际原因通常集中在三类config.toml里写了不支持的枚举值、MCP 配置缺少type字段、.codex目录整体状态损坏。这篇面向的是在 Windows 上用 Codex 做日常编码、刚配过 MCP 或改过配置文件的同学。我会按“先看日志 → 再查 config.toml → 再查 MCP → 最后重置 .codex”的顺序把每一步的命令、配置片段和验证动作都写清楚你照着做基本能定位到具体是哪一层出的问题。如果你同时用 TaoToken 这类兼容 Anthropic/OpenAI 协议的网关来跑 Codex配置项的写法也要对齐后面会给可复制的片段。先明确一点这个弹窗不是让你去改 Windows Defender、UAC 滑块或者系统账户类型。把系统权限翻一遍大概率白忙。真正要盯的是 Codex 自己的配置链路。2. 前置准备TaoToken 接入 Codex 的 Base URL 与 Key在排查之前先把 Codex 要用的模型接入信息准备好否则你改完配置也没法验证请求是否真的通。Codex 支持通过兼容 OpenAI 协议的自定义 Base URL 接入TaoToken 提供的就是这类接口。你需要三样东西Base URL、API Key、Model ID。Base URL 填https://taotoken.net/api注意这里不带任何查询参数。API Key 到控制台的 API Keys 页面创建路径是https://taotoken.net/console/api-keys。Model ID 按你实际要用的模型填比如claude-sonnet-4-5这类标识具体以文档页https://taotoken.net/doc列出的为准。如果你只是想在排查阶段快速确认模型能不能通可以先用模型对话页https://taotoken.net/models发一条测试消息确认 Key 有效、额度正常再回到 Codex 里配。这样能把“Key 本身有问题”和“Codex 配置有问题”两件事分开不然你会在两个层面来回怀疑。长期用 Codex 做编码或跑 Agent 的话可以考虑 Coding Plan入口在https://taotoken.net/coding-plan它更适合高频调用场景。但排查阶段先用按量 Key 就够了别一上来就上套餐先把链路跑通。准备好这三样之后记住一个原则Base URL、Key、Model ID 这三件套在 Codex 的config.toml和 MCP 配置里必须一致对应任何一处写错都会让初始化失败而失败的表现又恰好是那个“完成 Windows 设置”弹窗。3. 可复制配置config.toml 与 MCP 的完整写法Codex 的用户配置目录在 Windows 下是C:\Users\你的用户名\.codex主配置文件是config.toml。下面给一份可以直接改的片段重点是把model_verbosity写成合法值把 MCP 的type字段补全。# C:\Users\你的用户名\.codex\config.toml # 模型接入Base URL 不带 UTMKey 换成你自己的 model claude-sonnet-4-5 model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY # 关键verbosity 只能是 low / medium / high # 写成 max 会直接报 unknown variant model_verbosity medium # 沙箱相关Windows 下建议保持默认不要手动改成 elevated sandbox_mode workspace-write这里最容易踩的坑就是model_verbosity。很多人从别处抄配置抄到model_verbosity maxCodex 解析时直接抛Error loading config.toml: unknown variant max, expected one of low, medium, high in model_verbosity。这个报错一旦出现Codex 初始化就会中断界面就退化成那个“完成 Windows 设置”提示。所以第一件事就是把max改成low、medium或high。接下来是 MCP 配置。MCP Server 通常写在config.toml的[mcp_servers.xxx]段里或者单独的 MCP 配置文件。JetBrains IDE 一键生成的 MCP 配置经常缺type字段导致 Codex 无法识别 Server 类型。# MCP Server 配置示例注意 type 字段必须存在 [mcp_servers.jetbrains] command npx args [-y, jetbrains/mcp-server] type studio # 缺失这一行会导致初始化失败 url http://127.0.0.1:63342/api/mcptype的取值要跟你的 MCP Server 实际类型对齐JetBrains 系一般是studio其他 Server 按文档填。不要直接复制别人的整段 MCP 配置覆盖自己的因为 command、args、url 都跟具体 Server 绑定覆盖后反而引入新问题。如果你用的是 Codex 的 auth.json 方式管理凭据路径在C:\Users\你的用户名\.codex\auth.json里面存的是 Key 的引用不要跟config.toml里的env_key冲突。三件套对齐的原则在这里同样适用Base URL 在config.tomlKey 在环境变量或 auth.jsonModel ID 在model字段。4. 验证请求确认 Codex 能正常启动并跑通一次调用配置改完别急着点那个授权按钮先做两步验证。第一步在 PowerShell 里直接跑 Codex 的命令行模式看它能不能加载配置。打开终端执行codex --version codex config validate如果config validate报unknown variant或Error loading config.toml说明配置还有问题回到第 3 节对照检查。如果没有任何报错说明config.toml解析通过。第二步用 curl 直接打 TaoToken 的接口确认 Key 和 Base URL 是通的curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: ping}] }返回里如果有choices字段和正常内容说明接入层没问题。如果返回 401那是 Key 的问题去https://taotoken.net/console/api-keys重新生成一个。如果返回local proxy failed之类的错误检查 Base URL 是不是多写了路径或参数正确写法就是https://taotoken.net/api。两步都通过之后再启动 Codex 客户端。这时候如果还弹“完成 Windows 设置”点那个授权按钮正常情况下它会走完初始化流程并进入主界面。如果点了还是卡住说明问题在 MCP 或.codex目录进入下一节排查。验证成功的标志是Codex 主界面能正常打开发一条消息能收到模型回复MCP 面板里能看到你配置的 Server 处于 connected 状态。三者都满足才算真正解决。5. 常见报错排查401、local proxy failed、reading choices、OAuth排查时对照真实报错比盲改配置高效得多。下面几个是高频错误和对应处理。401 UnauthorizedKey 无效或没带上。检查config.toml里的env_key指向的环境变量是否真的设置了PowerShell 里用echo $env:TAOTOKEN_API_KEY确认。如果为空说明环境变量没生效重启终端或改用 auth.json 方式。local proxy failed通常是 Base URL 写错或者本地网络把请求拦了。确认 Base URL 是https://taotoken.net/api不要带/v1之外的额外路径。如果公司网络有拦截换网络环境再试。reading choices相关报错一般是响应体解析失败常见于 Model ID 写错返回的不是标准 chat completion 结构。核对model字段跟文档里列出的 ID 完全一致。OAuth报错Codex 某些版本会走 OAuth 流程拿凭据如果卡在 OAuth 回调检查默认浏览器是否能正常打开以及.codex目录下有没有残留的旧 token 文件。删掉.codex里的 token 缓存再重试。MCP 相关的隐性失败IDE 开着能连、关掉就连不上这是因为 MCP Server 依赖 IDE 进程。Codex 启动时如果连不上 MCP 地址又缺type字段就无法判断 Server 类型初始化直接失败。解决办法是补上type或者确保 IDE 在 Codex 启动前已经运行。如果以上都排查完还是不行就进入重置流程先备份C:\Users\你的用户名\.codex整个目录到.codex-backup然后删除原目录重启 Codex。它会重新生成默认配置你再把第 3 节的片段填回去。这一步能清掉大部分因为配置状态损坏导致的诡异问题。6. 排查完之后把 Codex 接入稳定跑起来走到这里你应该已经能定位到具体是哪一层出的问题。回顾一下排查链路先看 Codex 日志里的Error loading config.toml和unknown variant确认model_verbosity是不是写了max再查 MCP 配置有没有缺type最后才动.codex目录做重置。这个顺序比直接卸载重装有效得多因为重装不会清用户目录里的旧配置问题会原样复现。配置稳定之后日常用 Codex 做编码建议把 Base URL、Key、Model ID 这三件套固定下来写在一个地方避免多处不一致。TaoToken 的接入文档在https://taotoken.net/doc里面有各协议的完整参数说明配 Codex 或 Claude Code 时可以直接对照。需要新建或轮换 Key 就去https://taotoken.net/console/api-keys。如果你后面要接 Claude Code 这类工具配置逻辑跟 Codex 类似同样是 Base URL 加 Key 加 Model ID 三件套文档里有专门的接入章节可以跟。长期高频跑编码任务的话Coding Plan 会比按量更省心入口在https://taotoken.net/coding-plan。最后留一个实用习惯每次改完config.toml或 MCP 配置先跑一遍codex config validate再启动客户端。这一步能帮你把大部分初始化失败挡在弹窗之前省得又对着“完成 Windows 设置”发呆。