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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册后进控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_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 写错了；超时则是网络问题。
接着启动 Codex：
codex进入交互界面后输入一句写一个 Python 快速排序，能正常返回代码就说明整条链路通了。如果 Codex 启动时报config.toml parse error，多半是 TOML 格式问题，检查引号和缩进。实测下来，最容易错的是env_key写成了实际 Key 值而不是变量名，记住这里填的是变量名TAOTOKEN_API_KEY。
想单独测模型对话能力，可以打开模型对话 https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_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 启动报 401：Key 无效或环境变量没生效。echo $env:TAOTOKEN_API_KEY确认，没值就重启终端或重新登录系统。
Codex 报 model not found：config.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 Code，TaoToken 的同一个 Key 两边都能用，不用来回切。接入文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 里有各工具的配置示例，遇到新工具接入直接对照改 base_url 就行。API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 可以随时吊销旧 Key 重建，怀疑泄露时第一时间换。
最后提醒一句：Windows 上装 Codex，微软商店和 winget 是「能用就用」，msix 手动装才是保底。把 config.toml 骨架和验证命令存下来，下次换机器五分钟就能恢复环境。
