最近有台 Win10 机器上装 Codex安装入口要经过 Microsoft Store商店窗口一直转圈点「获取」没反应。TaoToken 只负责通道侧绕开商店装完 Codex 之后模型请求要指向一个能用的 Base URLKey 和接口地址从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 拿。先把预期讲清楚免得走弯路。这篇分两段第一段解决「Win10 上 Microsoft Store 打不开、Codex 装不上」走 store.rg-adguard.net 下离线包手动装第二段解决「装完之后 Codex 找谁要模型」把 config.toml 里的 base_url 指到 https://taotoken.net/apiKey 从官网控制台创建。两段彼此独立第一段失败不影响第二段准备反过来也一样。遇到卡点先判断自己卡在哪一段不要一上来就怀疑通道配错了。1. Win10 点 Codex 安装入口卡在 Microsoft Store 的那几分钟1.1 症状长什么样商店转圈Codex 装不上典型表现是这样的从 Codex 的安装引导点进去系统会把你拽到 Microsoft Store 的应用详情页页面能打开但「获取」按钮点了没反应或者进度条卡在几十 KB 不动有时候连详情页都打不开直接提示稍后重试或者一串错误码。这时候 Codex 那边是干净的没有半装状态也没有残留进程问题全部集中在商店这个环节。还有一类表现更迷惑商店本身能浏览别的应用唯独 Codex 这个包下载到一半失败。这种情况多数和商店的缓存、登录态、系统时间、后台更新任务有关跟 Codex 无关。判断方法很简单——在商店里随便找个体积相近的应用试着装一下如果也失败那就是商店整体的问题不用再在 Codex 身上找原因。所以第一步不是重装 Codex而是承认这条路暂时走不通。商店的问题可能涉及系统组件、账户状态、更新服务逐个排查的时间成本远高于直接下离线包。要做的是把「安装」和「下载来源」这两件事解耦包从别处拿装完之后再单独处理模型通道。1.2 为什么换网络、清商店缓存不一定有用遇到商店打不开常见建议是改 DNS、重置商店缓存、跑疑难解答、注销再登录账户。这些手段有时候确实能救回来但它们的共同点是「赌一个原因」赌缓存脏了、赌登录态过期、赌某个后台服务没起来。Win10 的商店依赖一串组件任何一个环节出问题都长成同一副样子你没法从错误提示里直接看出是哪一层。更现实的是时间成本。你在一个装不上 Codex 的机器上折腾商店可能半小时后商店好了也可能两小时后依旧转圈而 Codex 还没开始装。离线包方案的价值就在这里它把变量减少到一个——你能不能从网页上把包下下来。这个条件在大多数能正常上网的机器上都成立失败率远低于修商店。注意一点离线包只解决「装」不解决「商店本身坏了」。如果这台机器以后还要靠商店装别的应用商店的问题迟早要单独修但如果目标只是让 Codex 跑起来装完就可以先往下走。1.3 分两步走装包绕开商店通道做统一接入到这里结论已经清楚了装包这一半走离线包通道那一半走统一接入。两件事的边界要划清楚否则很容易把两类报错混在一起——比如包装好了但请求 401你会以为是安装不完整或者通道配好了但 Codex 根本起不来你会以为是 Key 有问题。分开验证每次只动一个变量。通道侧要准备的东西只有两样一把 API Key一个 Base URL。Key 在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册账号之后创建Base URL 固定填 https://taotoken.net/api末尾不要加 /v1。这两样在装包阶段完全用不到但建议在下载离线包的同时顺手把 Key 建好后面配 config.toml 时就不用再切回来。2. 用 store.rg-adguard.net 拿 Codex 离线安装包2.1 左侧下拉选 ProductId文本框填 9PLM9XGG6VKS浏览器打开 store.rg-adguard.net。界面很朴素左边一个下拉框右边一个输入框再加一个勾选框和按钮。左边下拉框默认可能是 URL(link)把它切成 ProductId然后在右边文本框里填 Codex 对应的产品 ID9PLM9XGG6VKS。填完点勾选、点按钮页面下方会列出一串可下载的文件条目。这一步唯一的坑是下拉框没切。如果留在 URL(link) 模式却填了一串 ID页面会提示解析失败或者返回空列表看着像 ID 错了其实是模式不对。另一个小坑是 ID 里的空格和大小写直接复制上面的字符串别手打。列表出来之后不要急着点第一个。里面既有主程序包也有一些依赖包和不同架构的包名字里通常带 x64、arm、neutral 之类的标记还有 .appx、.msix、.msixbundle、.blockmap 等不同后缀。真正要下的是主程序包通常体积最大那个。2.2 X64 取下面那个包ARM 取上面那个包选择规则就一句话X64 机器取下面那个包ARM 机器取上面那个包。绝大多数 Win10 笔记本和台式机是 X64所以默认按「下面那个」来。如果你不确定架构在「设置 → 系统 → 关于」里看「系统类型」写着「基于 x64 的处理器」就是 X64写着 ARM 就是 ARM。为什么会分成上下两个同一份应用会针对不同架构打不同的包列表的排列位置是固定的上面对应 ARM、下面对应 X64。按这个规则取基本不会错。取错了的表现是安装阶段直接报「包不适用于此设备」或者架构不匹配不会装成一个坏掉的半成品所以即使取错也容易回退重新下另一个包就行。下载时尽量一次性把主包下完。网络中途断了可能导致文件不完整后面安装会报校验失败或者「无效的应用包」。如果下的后缀是 .msixbundle那是一个合集包里面已经包含多个架构按系统自动挑这种情况下不需要纠结上下。2.3 下载下来的包怎么在 Win10 上离线安装拿到包之后装 .appx / .msix / .msixbundle 有几种方式。最省事的是双击系统会拉起应用安装程序点「安装」即可。如果双击没反应或者提示「此应用包需要更新的 Windows 版本」可以换 PowerShell 走命令行安装。命令按包名来把路径换成你自己下载的位置即可。Add-AppxPackage -Path D:\download\你的包文件名.msixbundle如果这条命令报依赖缺失比如提示缺少某个 framework 包说明列表里还有几个依赖包没下。回到 store.rg-adguard.net 的结果页把标记为依赖项的包一起下下来先装依赖再装主包。依赖包通常体积小很多名字里会带 VCLibs、NET 之类字样按报错里提到的名字对一下。还有一种情况是包下载完整、依赖也齐但安装时报「证书不受信任」。这通常是系统时间不对或者包被改动过。先把系统时间校准再重新下载一次别用会改写文件内容的下载工具。装完之后在开始菜单里搜 Codex能搜到并打开第一段才算结束。2.4 先确认 Codex 本体能起来再谈通道这里刻意分成两个验证点。第一个验证点是 Codex 本体能不能启动、能不能打印版本号或者进入交互界面。这一步和模型通道没有关系即使 Key 还没配、base_url 还是空的程序本身也应该能起来只是在发请求的时候才会失败。第二个验证点才是模型请求能不能通。把两件事分开的好处是出错时你能立刻定位如果程序都起不来那是安装问题往上看第 2 节的依赖和架构如果程序能起来但一发请求就报错那才轮到通道配置。很多人把这两个混在一起排查最后既怀疑包有问题又怀疑 Key 有问题效率很低。打开终端直接跑 codex 看能不能进界面。能进就往下走报「命令不存在」说明安装路径没进 PATH重启一次终端通常就好还不行就检查包是不是装到了当前用户目录下。3. 装完 Codex 之后才发现的第二个问题Key 从哪来3.1 打开官网注册并创建 API Key原文到这里就结束了装完就没了但 Codex 真正要用起来必须回答一个问题它的模型请求发给谁。默认配置指向官方地址而你手上没有可用的凭据就会一直卡在鉴权失败。这一步改成在 TaoToken 上准备打开 TaoToken 注册账号进控制台创建 API Key。创建 Key 的过程不复杂但有两个习惯建议从第一天就养成。第一Key 建好之后当场复制走很多控制台只完整显示一次关掉页面就只剩掩码第二按用途分开建 Key比如给本地 Codex 一把、给别的工具另一把后面哪把要轮换直接吊销一把不影响其它工具。拿到的那串字符就是后面 config.toml 里要用的凭据统一写成占位符 YOUR_API_KEY。不要把真实 Key 贴到聊天记录、截图或者公开的配置文件里尤其是准备把配置发到群里问人的时候先把它替换掉。3.2 Base URL 记成 https://taotoken.net/api末尾别加 /v1Base URL 这一项最容易出事单独说一遍。填进工具的值是 https://taotoken.net/api末尾不带 /v1也不带任何查询参数。很多人习惯性在 base_url 后面补一个 /v1结果请求路径变成 /api/v1/xxx多出一段服务端直接 404 或者提示路径不存在。还有一个容易混的点官网落地页和接口地址不是同一个东西。注册、创建 Key、看模型列表、看用量走的是带参数的落地页 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end填进配置文件、环境变量、命令行参数里的接口地址一律是 https://taotoken.net/api。把落地页那一长串带查询参数的地址复制进 config.toml必然会报错因为那不是一个 API 端点。记不住就按这个对照表来用途填什么注册 / 建 Key / 看用量 / 看模型https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endCodex 的 base_urlhttps://taotoken.net/apiAPI Key 占位符YOUR_API_KEY3.3 模型 ID 去模型广场看当时的列表模型 ID 不要凭记忆写也不要从别处抄一个带日期后缀的名字。同一个模型在不同时间可能有不同的 ID 形式写错的表现是服务端返回「模型不存在」或者「无权访问该模型」和 Key 错误的报错长得很像容易误判。正确做法是打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 在模型广场看当前可用的列表把要用的那个 ID 原样复制出来。复制的时候注意别把界面上的显示名当成 ID。显示名给人看可能带空格和中文ID 是给接口用的通常是紧凑的英文字符串。两者在列表里通常并排展示认准标着「模型 ID」的那一列。如果还没想好选哪个先挑一个列表里明确标着可用于代码场景的跑通链路之后再换。验证阶段的目标是「通」不是「最优」换模型只是改 config.toml 里的一行成本很低。4. 把 Codex 的 config.toml 指到 TaoToken 兼容通道4.1 Windows 上 config.toml 的实际位置Codex 的配置文件放在用户目录下的 .codex 文件夹里文件名是 config.toml。Windows 上的用户目录通常是 C:\Users\你的用户名所以完整路径大致是 C:\Users\你的用户名.codex\config.toml。那个点开头的文件夹在资源管理器里默认可能被隐藏直接在地址栏输入路径最快。如果这个文件不存在自己新建一个就行注意扩展名是 .toml不是 .toml.txt。Windows 默认隐藏已知扩展名用记事本保存时容易变成 config.toml.txt结果配置根本不生效你还以为配置写错了。保存后在地址栏看一眼完整文件名确认没有多余后缀。改之前先备份一份把原文件复制成 config.toml.bak。这不是形式主义后面如果出现「改完反而起不来」的情况把备份盖回去就能回到一个已知可用的状态比逐行回滚快得多。4.2 model_provider 与 base_url 的最小配置配置文件的核心就三块用哪个模型、走哪个 provider、这个 provider 的地址和凭据从哪来。下面是一份最小可用的写法把占位符换成你自己的值即可。# C:\Users\你的用户名\.codex\config.toml model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat几个字段逐个说明。model 填你在模型广场复制出来的 IDmodel_provider 是一个自定义名字上面这段叫 taotoken下面的 [model_providers.taotoken] 必须和它同名两处不一致会报「找不到 provider」。base_url 就是反复强调的 https://taotoken.net/api末尾不要 /v1。env_key 指定从哪个环境变量读 Key而不是把 Key 明文写在文件里。wire_api 这一项跟 Codex 的版本有关如果你的版本不认这个字段删掉它再看认的话按上面的写。改完保存别在编辑器里开着不保存就去跑命令这种低级失误在现场排查里占比不低。4.3 Key 走环境变量别写死在文件里把 Key 放进环境变量的好处很直接配置文件可以随便备份、发给别人看、放进版本库都不会泄露凭据。Windows 上设置用户级环境变量用 setx命令如下把 YOUR_API_KEY 换成你从官网创建的那串字符。setx TAOTOKEN_API_KEY YOUR_API_KEYsetx 只对之后新开的进程生效当前已经开着的终端读不到。所以设完必须关掉终端重开或者干脆新开一个窗口。判断有没有生效在新窗口里执行 echo %TAOTOKEN_API_KEY%cmd或 $env:TAOTOKEN_API_KEYPowerShell能看到值就对了输出为空说明变量没设上或者你还在旧窗口里。注意这里的环境变量名是 TAOTOKEN_API_KEY和 config.toml 里 env_key 的值必须完全一致大小写也要对得上。顺手提醒一句不要看到别的工具用 ANTHROPIC_* 就照搬到 Codex 上两套配置体系不一样混着填只会让你多花时间排查一个不存在的问题。4.4 改完重启终端让配置重新加载配置文件和环境变量都动了之后重启终端是最省事的做法。Codex 一般在启动时读一次配置运行中途改文件不一定会热加载所以「改完不重启」经常表现为「明明改对了还是老样子」。养成改完就重开的习惯能省掉大量自我怀疑。重开之后先跑一个不带任何参数的 codex看它有没有在启动阶段报配置解析错误。TOML 语法很严格少一个引号、多一个逗号、把中文字符混进字符串里都会让整个文件解析失败。这类报错通常会把行号带出来照着行号看一眼就知道问题在哪。如果启动正常说明配置结构没问题接下来才是发一条请求验证链路。到这一步安装和配置两段工作都已经完成剩下的只是验证和排错。5. 一条最简请求同时验证商店绕行和通道配置5.1 验证用的最小 prompt验证不需要复杂场景越简单越好因为你要看的是链路通不通不是模型聪不聪明。随便给它一段本地文本让它解释比如一段你自己写的报错描述或者一句「用一句话说明什么是环境变量」。这种 prompt 不依赖任何文件、不需要工具调用纯文本进出最容易定位问题。如果你更习惯命令行也可以直接在终端里跑一次性的提示具体参数按你本地 Codex 版本的帮助信息来。核心是只发一次请求看它有没有返回内容。返回了内容就同时证明了两件事离线包装的 Codex 本体是好的通道的 Key、Base URL、模型 ID 三样也都对。这一步不要开工具执行、不要挂文件读写先把最干净的路径跑通。链路通了之后再叠加别的能力出问题时才能知道是新加的东西引入的。5.2 看返回内容里的模型名和结束原因请求返回之后别只看「有没有字」。顺手确认两点一是返回内容里体现的模型信息是不是你配置的那个二是这次请求有没有正常结束而不是中途被截断或者走到某个异常分支。前者能发现「配置写的是 A、实际用的是 B」这种隐蔽问题后者能发现 Key 权限不足导致的半截返回。如果返回内容是空的但进程没报错先看是不是被某个输出过滤或者编码问题吞掉了。换一个纯英文的简单 prompt 再试一次能把编码因素排除掉。还不行就看日志Codex 一般会把请求的目标地址和状态码写进日志对照一下地址是不是 https://taotoken.net/api。到这里验证的思路就是「一条最小请求 三项确认」确认返回非空、确认模型 ID 对得上、确认没有异常中断。三项都过第一段和第二段就算同时验收完成。5.3 回控制台对一下这次调用有没有记上链路通了之后还有一个值得养成的动作回到控制台看这次调用有没有被记录。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 进控制台看用量或调用记录正常情况下能找到刚才那条请求。能看到记录说明请求确实经过了你以为的那条通道而不是被别处的配置截胡了。如果验证成功但控制台没有任何记录说明请求可能发到了另一个地址或者你本地有多个配置文件在互相覆盖。这时候回去检查是不是存在多份 config.toml、是不是还有旧的环境变量指向别处。排查这类「明明通了但没记账」的问题比排查硬报错要省事得多因为方向很明确。对完这一次调用再决定要不要把 Key 换成长期用的那把。验证阶段用的 Key 可以单独建一把跑通之后吊销掉换成规划好的那把避免测试凭据流到日常使用里。6. 报错对照401、路径多了 /v1、模型 ID 对不上6.1 401 先查 Key 和环境变量401 基本可以断定是凭据问题不用去怀疑安装包。按顺序查三件事Key 本身有没有复制完整前后有没有多出空格或换行环境变量名和 config.toml 里 env_key 写的是不是同一个当前终端是不是在设置环境变量之前就开着的旧窗口。这三条能覆盖绝大多数 401。还有一种少见情况Key 建好之后被吊销了或者建 Key 的时候没给它对应的模型权限。控制台里能直接看到 Key 的状态和权限范围对着看一眼比猜快。如果你在同一台机器上有多把 Key确认一下当前生效的是哪一把别拿着已经废弃的那把反复试。排 401 的时候不要一上来就改 base_url。鉴权失败和地址错误的报错形态不一样把变量一次动一个才能知道哪一个才是真正的病根。6.2 多了一层 /v1 的表现如果你在 base_url 后面补了 /v1请求会打到 /api/v1/... 上表现通常是 404、路径不存在的提示或者网关返回一段看不懂的错误。这个错误的特征是「Key 明明是对的、模型名也是对的就是路由不到」。回头把 base_url 改回 https://taotoken.net/api一个字符都别多。排查时可以直接把配置里的地址抄出来和标准值逐字符比对https 有没有写成 httptaotoken.net 后面有没有多斜杠末尾有没有 /v1有没有把落地页那串查询参数带进来。这几项是地址类错误的高发区逐字符比一遍比读十遍报错有用。改完同样要重启终端。很多人改完文件立刻重跑看到的还是旧报错然后又怀疑改动无效实际上只是进程没重新读配置。6.3 模型 ID 不存在模型 ID 报错和 Key 报错的表象接近都会提示权限或不存在但原因不同。处理办法很直接打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 看模型广场当时的列表把你实际要用的那个 ID 原样复制进 config.toml注意不要带界面上的显示名或者多余空格。列表是动态的别用几个月前的记忆去填。如果你的配置里写的是某个带后缀的名字而列表里现在是另一种写法那就以列表为准。配置里的一切「别名」都会在服务端被当成精确匹配写错一个字符就是不存在。换完 ID 之后同样重启终端再试。如果新 ID 也报不存在检查一下是不是有两份配置在同时生效其中一份还写着旧 ID。6.4 离线包本身的坑架构下错、依赖缺失回到安装那一段。离线包最常见的两个问题是架构下错和依赖缺失。架构下错的表现是安装阶段直接拒绝报「包不适用于此设备」依赖缺失的表现是命令行安装时报缺少某个 framework或者双击之后进度条走一半失败。架构按前面那条规则来X64 取下面那个包ARM 取上面那个包不确定就看系统信息里的系统类型。依赖缺失就回结果页把带 VCLibs、NET 字样的依赖包一起下先装依赖再装主包顺序反了有时候也会失败。还有一个容易忽略的点下载不完整。看着文件下完了实际大小和页面标的不一致安装时报「无效的应用包」。重新下一次别用会改写响应的下载工具。装完之后在开始菜单能搜到、能打开才算第一段真正结束。7. 装好之后Key 和套餐怎么安排更省事7.1 先用模型对话试一把如果你只想先确认链路不想动本地配置最快的办法是打开 TaoToken 模型对话 用同一把 Key 在里面发一条消息。这一步和本地 Codex 用的是同一个通道页面里能通说明 Key 和模型 ID 都没问题剩下的只是本地配置文件的事。页面里试还有个好处模型 ID 可以直接从下拉里选不用手抄也就不会出现「抄错一个字符」这种问题。选好之后把页面上显示的 ID 记下来回头填进 config.toml能省掉一轮排错。试的时候别用太长的输入一条短消息足够。目标是验证鉴权不是压测。7.2 长期写代码看 Coding Plan如果你打算把 Codex 当日常写代码的助手短消息试通之后可以看一下 Coding Plan 的选项按自己的使用强度挑。具体额度和价格以页面当时显示为准不要照搬别人几个月前的说法这类信息变动比较频繁。选之前先想清楚使用模式是偶尔问几句还是每天大量生成和改写代码。前者按量更划算后者看套餐更省心。这一步没有标准答案和你的项目规模、每天写多少代码直接相关。如果这台 Win10 机器只是临时用一下方案可以先不着急定把链路跑通、记录一下实际消耗之后再回来选。7.3 Key 管理与文档入口最后把几个入口理一遍方便下次直接找。Key 在 控制台 API Keys 创建和管理建议按用途分把注册和模型列表在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 。如果你后面还要在别的命令行工具里接同一套通道环境变量和地址的写法可以参照 Claude Code 接入文档 里的对应章节注意那是另一套变量名别和 Codex 的 config.toml 混用。这一整套走下来真正花时间的其实是第一段——把商店绕过去。通道侧反而是最省事的部分一把 Key、一个固定地址 https://taotoken.net/api、一个从列表里复制出来的模型 ID。下次再遇到商店打不开的机器先下离线包再建 Key最后改 config.toml顺序别乱排查会轻松很多。