Windows 本地部署 Codex++ 超详细图文教程：config.toml 配 TaoToken 接入最新 GPT 模型

1. Windows 上跑 Codex 到底卡在哪Codex 是给 Codex 客户端加一层本地管理壳的工具装完之后你能在 ChatGPT 桌面端里直接让它操作本机文件、开浏览器、跑命令。听起来很爽但 Windows 上真正跑通的人不多卡点基本集中在三处一是官方通道在国内网络下请求不通模型列表拉不下来二是 Codex 的供应商配置默认走 OpenAI 官方地址不改就一直是 401 或超时三是config.toml这个核心配置文件藏得深字段写错一个字母客户端启动后直接白屏或者插件不加载。这篇就按我实际部署的顺序走一遍先拿到可用的 API 通道和 Key再装 Codex然后把config.toml完整配好最后用一条「在桌面建文件夹」的指令验证 GPT 模型是不是真的通了。适合已经装过 Codex 客户端、想在 Windows 本地把电脑操控能力跑起来的人。全程命令和配置都能直接复制路径按你自己的用户名替换即可。需要先说明一点Codex 本身不提供模型它只是个配置管理和插件加载工具模型调用走的是你在config.toml里填的base_url。所以整条链路能不能通取决于这个地址是否稳定、Key 是否有效、wire_api协议是否匹配。下面每一步我都会标出验证点出问题能快速定位到是哪一环。2. 前置准备TaoToken 通道与 API Key模型通道这块我用的是 TaoToken它把 GPT 系列模型的调用统一到一个 API 入口省得自己折腾网络层。你需要在官网注册后进控制台创建 Key。具体操作打开 https://taotoken.net/api 对应的控制台入口左侧找到 API Keys 页面点创建名称随便填比如codex-win额度限制和 IP 限制第一次调试建议先关掉避免请求被拦。创建完把sk-开头的 Key 复制出来只显示一次丢了就得重建。这里有个细节Codex 走的是 Responses API 协议不是老的 Chat Completions。所以你在 TaoToken 这边不用额外选协议Key 是通用的协议由客户端config.toml里的wire_api responses决定。模型名要填 TaoToken 支持的 GPT 系列标识比如gpt-5.6-sol这类具体以你控制台模型列表里显示的为准别照抄网上的旧名字。注意Key 不要写进会提交到 Git 的文件里。config.toml如果放在项目目录下记得加.gitignore。生产环境建议用环境变量注入后面第 3 节会给做法。充值按需来调试阶段充最小额度就够跑通再补。余额到账是实时的创建完 Key 可以直接进下一步。3. 安装 Codex 与目录结构Codex 的安装包从它的发布页下载Windows 下是 exe 安装包双击一路下一步桌面会生成快捷方式。装完后先别急着开确认两个目录存在C:\Users\你的用户名\.codex—— 这是 Codex 的主目录config.toml就放这里C:\Users\你的用户名\AppData\Local\OpenAI\Codex—— 运行时和插件缓存如果你之前装过微软商店版的 ChatGPT 客户端.codex目录一般已经生成了。没有的话手动建一个权限给当前用户完全控制。打开 Codex 主界面左侧切到「供应商配置」点添加供应商。这里先填一版基础参数做连通性测试字段填写值名称taotokenBase URLhttps://taotoken.net/apiKey你创建的 sk- 开头密钥接入模式纯 API协议Responses API默认模型gpt-5.6-sol保存后点顶部「重启 Codex」。这一步只是让工具知道有这么个供应商真正生效还要靠config.toml因为插件、沙箱、MCP 这些都得在配置文件里声明。环境变量这块如果你不想把 Key 明文写进 toml可以在系统环境变量里加一个TAOTOKEN_API_KEY然后在配置里引用。不过 Codex 当前版本对env引用的支持有限稳妥起见第一次先用明文跑通确认链路没问题再改成环境变量方案。4. 核心config.toml 完整配置骨架这是全文最关键的一步。打开 Codex 的供应商配置编辑当前供应商把预览框里的内容全部删掉替换成下面这份。路径里的Administrator换成你自己的 Windows 用户名其他字段照抄。model gpt-5.6-sol model_provider custom model_catalog_json model-catalogs/relay-mrvm8mop.json sandbox_mode danger-full-access notify [ C:\\Users\\Administrator\\AppData\\Local\\OpenAI\\Codex\\runtimes\\cua_node\\03b1cdac8af3a530\\bin\\node_modules\\oai\\sky\\bin\\windows\\codex-computer-use.exe, turn-ended ] [model_providers.custom] name custom wire_api responses requires_openai_auth true base_url https://taotoken.net/api/ [features] goals true js_repl false [mcp_servers.node_repl] args [] command C:\Users\Administrator\AppData\Local\OpenAI\Codex\runtimes\cua_node\03b1cdac8af3a530\bin\node_repl.exe startup_timeout_sec 120 [mcp_servers.node_repl.env] NODE_REPL_NATIVE_PIPE_CONNECT_TIMEOUT_MS 1000 NODE_REPL_NODE_MODULE_DIRS C:\Users\Administrator\AppData\Local\OpenAI\Codex\runtimes\cua_node\03b1cdac8af3a530\bin\node_modules NODE_REPL_NODE_PATH C:\Users\Administrator\AppData\Local\OpenAI\Codex\runtimes\cua_node\03b1cdac8af3a530\bin\node.exe NODE_REPL_TRUSTED_CODE_PATHS C:\Users\Administrator\.codex CODEX_HOME C:\Users\Administrator\.codex BROWSER_USE_AVAILABLE_BACKENDS chrome,iab SKY_CUA_NATIVE_PIPE 1 CODEX_CLI_PATH C:\Users\Administrator\AppData\Local\OpenAI\Codex\bin\e2d6a5ee2cac801c\codex.exe [plugins] [plugins.computer-useopenai-bundled] enabled true [plugins.chromeopenai-bundled] enabled true [plugins.browseropenai-bundled] enabled true [plugins.visualizeopenai-bundled] enabled true [marketplaces.openai-bundled] last_updated 2026-07-23T05:05:23Z source_type local source \\?\C:\Users\Administrator\.codex\.tmp\bundled-marketplaces\openai-bundled [shell_environment_policy.set] BROWSER_USE_AVAILABLE_BACKENDS chrome,iab NODE_REPL_TRUSTED_CODE_PATHS C:\Users\Administrator\.codex [windows] sandbox elevated [desktop] show-context-window-usage true followUpQueueMode queue conversationDetailMode STEPS_COMMANDS几个字段单独解释一下改错就白干wire_api responses必须和 TaoToken 的 Responses 协议对齐写成chat会报 404。base_url结尾带斜杠不带的话部分版本会拼出双斜杠导致 400。sandbox_mode danger-full-access是让 Codex 能读写任意磁盘路径调试阶段用跑通后你可以收紧成workspace-write。requires_openai_auth true表示走 OpenAI 兼容鉴权头TaoToken 这边是认的。[plugins]段里computer-use和browser是核心前者管键鼠和窗口操作后者管内置浏览器。少一个桌面建文件夹这类指令就会失败。[mcp_servers.node_repl]是给插件提供 Node 运行时的路径必须指向你机器上真实存在的node_repl.exe版本号那串哈希每个人不一样去AppData\Local\OpenAI\Codex\runtimes下找对应目录。保存后重启 Codex再重启 ChatGPT 客户端。配置文件改动不会热加载必须重启进程。5. 验证请求一条指令确认 GPT 通了配置生效后打开 ChatGPT 客户端在对话框输入在桌面建一个文件夹命名为 ABC预期结果是桌面自动出现ABC文件夹。这说明三件事都成了模型请求经 TaoToken 正常返回、computer-use插件加载成功、沙箱权限放行。如果你想更精确地验证模型层可以在 Codex 的日志面板看请求记录正常会有一条 POST 到https://taotoken.net/api/responses的记录返回 200body 里带model字段和 token 用量。看到这个就说明 GPT 模型调用链路完全通了。再补一个纯文本验证排除插件干扰在对话里问「你现在用的是哪个模型」返回里应该出现你配置的gpt-5.6-sol。如果这里返回的是别的名字说明model字段没生效回去检查config.toml第一行有没有被覆盖。6. 常见报错排查启动后白屏或插件不加载九成是config.toml语法错误。TOML 对引号敏感Windows 路径必须用单引号或双反斜杠。用在线 TOML 校验器过一遍或者把配置分段注释掉二分定位。401 UnauthorizedKey 无效或没带上。检查requires_openai_auth是否为 trueKey 有没有多余空格。TaoToken 控制台里确认 Key 状态是启用。404 或 model not foundwire_api协议填错或者模型名不在 TaoToken 支持列表里。改成responses模型名以控制台列表为准。请求超时base_url写错或网络层不通。确认地址是https://taotoken.net/api/结尾斜杠别丢。可以在 PowerShell 里curl https://taotoken.net/api看是否有响应。桌面建文件夹没反应computer-use插件没启用或sandbox_mode权限不够。检查[plugins]段和[windows] sandbox elevated。另外 ChatGPT 客户端里的权限设置要改成完全访问默认权限会拦掉文件操作。node_repl 启动失败command路径里的哈希目录不存在。去AppData\Local\OpenAI\Codex\runtimes\cua_node下看你实际的目录名替换掉配置里的03b1cdac8af3a530。排查顺序建议从模型层往插件层走先确认纯文本对话能返回再测文件操作最后测浏览器。这样每步的失败原因不会混在一起。7. 跑通之后怎么继续用链路通了之后日常使用就简单了Codex 保持后台运行ChatGPT 客户端正常开模型请求自动走 TaoToken。如果你要长期跑编码任务或者接 Agent 工作流建议把额度套餐换成 Coding Plan比按次调用划算具体在 https://taotoken.net/api 的控制台里能看到选项。配置这块跑通后建议做两件事一是把config.toml备份一份Codex 升级有时会重置供应商配置二是把sandbox_mode从danger-full-access收紧到workspace-write只放开你实际要操作的目录降低误操作风险。Key 如果之前是明文写的换成环境变量注入具体做法是在系统环境变量里加TAOTOKEN_API_KEY然后配置里引用Codex 新版本对env字段的支持在逐步完善可以先在测试供应商上验证再切主配置。模型名这块别写死TaoToken 控制台的模型列表会更新隔段时间去看一眼有没有新版本改config.toml第一行就行其他不用动。