1. Windows 上装 Codex 到底卡在哪OpenAI Codex 在 Windows 上的安装链路说直白点就是「微软商店 winget 手动 msix」三条路但每条路都可能给你甩脸色。我见过太多人卡在第一步打开微软商店搜 Codex要么搜不到要么点安装转圈半天报 0x80073CF9换 winget 敲winget install Codex直接提示「找不到与输入条件匹配的程序包」再换手动下载 msix浏览器又弹「无法安全下载」。这三连击下来很多人就放弃了。这篇就是冲着这些报错来的。我会把 Codex 在 Windows 上的完整安装流程拆成可复制的步骤包括微软商店打不开时的替代下载方式、winget 源配置、msix 手动安装命令以及装完之后怎么用 TaoToken 的统一 Key 把 Codex 接上模型服务。适合谁看如果你是在 Windows 上想用 Codex 做代码补全、命令行辅助又不想被商店和包管理器反复折磨那这篇就是给你写的。先说清楚 Codex 是什么它是 OpenAI 推出的编码助手有 CLI 形态也有 IDE 插件形态能读你的项目文件、执行命令、生成补丁。Windows 上官方主推微软商店分发但商店本身经常抽风所以备用方案必须掌握。下面按「先解决安装再解决接入」的顺序来。2. 装之前先把 TaoToken 的 Key 准备好Codex 装好只是空壳它需要连一个模型服务才能干活。TaoToken 在这里的角色是统一 Key 网关你不需要分别去配 OpenAI、Anthropic 各家 Key用同一个 Key 就能在 Codex、Claude Code、Cursor 这些工具之间切换。对 Windows 用户来说少配一套环境变量就少踩一个坑。具体操作打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后进控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在 API Keys 页面创建一个新 Key。建议命名带上用途比如codex-win方便后面排查是哪个 Key 出的问题。创建后立刻复制页面刷新就看不到了。拿到 Key 之后Codex 的配置走的是config.toml文件。Windows 上的路径通常是C:\Users\你的用户名\.codex\config.toml如果没有这个目录就手动建。这个文件是 Codex 读取模型端点、Key、默认模型的地方后面第 3 节会给完整骨架。注意Key 不要写进项目仓库里的任何文件只放在用户目录下的 config.toml 或系统环境变量里。团队协作时用环境变量引用别硬编码。如果你后面还要跑 Claude Code 或做长期编码任务可以顺带看下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它和 Codex 用的是同一套 Key不用重复申请。3. 微软商店 / winget / msix 三条安装路径3.1 微软商店直接安装首选但看运气正常路径是打开微软商店搜索 Codex点安装。如果商店能正常打开且搜得到这一步最省事。但实测下来国内网络环境下商店经常报 0x80073CF9 或 0x80D05001前者是部署失败后者是下载中断。遇到这两个错误别反复点重试直接跳到 3.3 的 msix 手动安装。3.2 winget 安装与源配置winget 是 Windows 包管理器命令是winget install --id OpenAI.Codex -e如果报「找不到与输入条件匹配的程序包」先更新源winget source update winget search Codex搜不到说明你的 winget 源里没有这个包或者源被限制。可以尝试指定源winget install --id OpenAI.Codex -e --source msstore--source msstore表示从微软商店源拉取。如果这一步也失败说明商店源本身不可用回到 3.3。3.3 msix 手动下载安装兜底方案成功率最高这是 excerpt 里提到的思路我把它补完整。打开 https://store.rg-adguard.net/ 右侧下拉选Retail搜索框粘贴 Codex 的商店链接https://www.microsoft.com/zh-cn/p/codex/9plm9xgg6vks点搜索后列表里找.msix或.msixbundle文件选对应你系统架构的版本大多数人是 x64。点击下载时浏览器可能提示「无法安全下载」右键该下载项选「保留」即可。下载完成后在文件所在目录右键「在终端中打开」执行Add-AppxPackage -Path .\你的文件名.msixbundle如果报依赖缺失比如提示需要Microsoft.VCLibs就在同一个 rg-adguard 页面搜Microsoft.VCLibs.140.00下载对应 msix 先装。安装成功后开始菜单搜索 Codex 就能看到图标。3.4 config.toml 骨架装完后创建C:\Users\你的用户名\.codex\config.toml内容如下# Codex 配置文件 model gpt-4o model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY [history] persistence save-all然后在系统环境变量里加TAOTOKEN_API_KEY值就是你第 2 节复制的 Key。设置完重启终端让环境变量生效。这里base_url用 https://taotoken.net/api 不带任何多余路径Codex 会自动拼接/v1/chat/completions这类端点。4. 验证请求确认 Codex 真的连上了配置写完别急着用先验证。打开 PowerShell确认环境变量读到了echo $env:TAOTOKEN_API_KEY能打印出 Key 就说明环境变量生效。然后跑一个最小请求用 curl 测端点连通性curl https://taotoken.net/api/v1/models -H Authorization: Bearer $env:TAOTOKEN_API_KEY返回 JSON 里能看到模型列表说明 Key 和端点都通。如果返回 401是 Key 错了返回 404是 base_url 写错了超时则是网络问题。接着启动 Codexcodex进入交互界面后输入一句写一个 Python 快速排序能正常返回代码就说明整条链路通了。如果 Codex 启动时报config.toml parse error多半是 TOML 格式问题检查引号和缩进。实测下来最容易错的是env_key写成了实际 Key 值而不是变量名记住这里填的是变量名TAOTOKEN_API_KEY。想单独测模型对话能力可以打开模型对话 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 用同一个 Key 发一条消息能回就说明 Key 本身没问题问题在 Codex 配置侧。5. 本篇常见报错排查0x80073CF9商店部署失败。原因通常是商店缓存损坏。先试wsreset清缓存不行就走 3.3 手动 msix。winget 找不到包先winget source update再winget search Codex。如果搜出来是空的说明你的源里没有直接走 msix。Add-AppxPackage 报依赖缺失缺 VCLibs 或 UI.Xaml。去 rg-adguard 搜对应依赖包先装依赖再装主包。顺序不能反。Codex 启动报 401Key 无效或环境变量没生效。echo $env:TAOTOKEN_API_KEY确认没值就重启终端或重新登录系统。Codex 报 model not foundconfig.toml 里的model字段写了一个 TaoToken 不支持的模型名。改成gpt-4o或去模型对话页面看可用列表。curl 超时检查是不是公司网络限制了出站。换手机热点试一下能通就是网络策略问题。config.toml 不生效确认文件路径是C:\Users\你的用户名\.codex\config.toml不是项目目录下的。Codex 只读用户目录这份。msix 安装后开始菜单搜不到等 10 秒再搜或者去C:\Program Files\WindowsApps确认包在不在。不在就是安装没成功重跑 Add-AppxPackage 看报错。6. 装完之后怎么长期用Codex 装好只是起点。日常用的时候建议把常用 prompt 存成模板比如「读当前目录所有 py 文件找出未处理的异常」。Codex 的 CLI 支持管道输入你可以cat error.log | codex 分析这个报错比手动贴日志快。Key 管理上如果你同时用 Codex 和 Claude CodeTaoToken 的同一个 Key 两边都能用不用来回切。接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里有各工具的配置示例遇到新工具接入直接对照改 base_url 就行。API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 可以随时吊销旧 Key 重建怀疑泄露时第一时间换。最后提醒一句Windows 上装 Codex微软商店和 winget 是「能用就用」msix 手动装才是保底。把 config.toml 骨架和验证命令存下来下次换机器五分钟就能恢复环境。