1. Windows 上装完 Codex 却卡在登录，问题到底出在哪
Codex 是 OpenAI 推出的命令行编码代理工具，能在终端里读写文件、跑命令、改代码，适合习惯用命令行干活的开发者。在 Windows 上，很多人第一步就选了微软商店安装，装完打开却卡在登录界面——要么提示网络不可达，要么让你填 GPT API 密钥却不知道去哪拿。这篇就把从微软商店装 Codex 到接入 GPT API 密钥的完整排错流程捋一遍，重点讲环境变量怎么设、config.toml 骨架怎么写、报错怎么定位。
我自己在 Windows 11 上反复装过几次，踩的坑集中在三块：一是微软商店下载进度卡住或安装后命令找不到；二是登录环节默认走账号体系，没有海外手机号根本走不通；三是即便拿到 API 密钥，环境变量和配置文件没对齐，请求照样 401。下面按顺序拆开讲，每一步都给可复制的命令和配置，你照着做基本能一次跑通。
需要先说明的是，Codex 本身是客户端工具，它需要一个兼容 OpenAI 接口的 API 通道来发请求。我用的是 TaoToken 的统一 Key/API 通道，好处是密钥格式统一、接入文档清晰，不用在多个平台之间来回切换。下面所有配置都基于这个通道来写，你换成其他兼容通道时，把 base_url 和 key 替换掉即可。
2. 前置准备：TaoToken 通道与 API 密钥获取
在动 Codex 之前，先把 API 通道准备好。TaoToken 官网是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 端点固定为 https://taotoken.net/api ，注意这个地址后面不加任何查询参数。
注册登录后，进控制台创建 API 密钥。控制台入口在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，密钥管理页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。创建时给密钥起个能认出来的名字，比如 codex-win，复制出来先存到记事本，后面配置要用。
这里有个容易忽略的点：密钥只在创建时完整显示一次，关掉页面就看不到了。如果你没存，直接删掉重建一个，别在页面上反复找。另外密钥属于敏感信息，别提交到 Git 仓库，后面我们会用环境变量来引用它，而不是硬编码进配置文件。
接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面写了兼容 OpenAI 接口的调用方式，Codex 的配置就是按这个格式来的。如果你后面要验证模型是否通，可以用模型对话页 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=model&utm_campaign=rewrite 先发一条消息试试，确认密钥本身没问题，再回来配 Codex，这样能把「密钥错」和「配置错」两类问题分开。
3. 微软商店安装 Codex 与命令定位
微软商店搜 Codex 能搜到，但下载进度卡住是常事。如果进度条长时间不动，先检查系统时间和时区是否准确，时间偏差过大会导致商店的 TLS 握手失败。其次在「设置 → 应用 → 应用和功能」里确认没有残留的旧版本，有的话先卸载再重装。
装完之后，很多人遇到「命令找不到」。Codex 装好后不一定自动进 PATH，你需要手动定位它的可执行文件。打开 PowerShell，跑下面这条命令找安装位置：
Get-ChildItem -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps" -Filter "*codex*" -Recurse -ErrorAction SilentlyContinue如果 WindowsApps 下没有，去包安装目录找：
Get-AppxPackage *codex* | Select-Object Name, InstallLocation拿到 InstallLocation 后，把该目录加进用户级 PATH：
$codexPath = (Get-AppxPackage *codex*).InstallLocation [Environment]::SetEnvironmentVariable("Path", $env:Path + ";$codexPath", "User")改完 PATH 要重开一个 PowerShell 窗口才生效，旧窗口读的是旧环境变量。重开后输入codex --version，能打印版本号就说明命令通了。这一步不通，后面配置全是白搭，所以先确认命令可用再往下走。
4. 环境变量与 config.toml 骨架配置
Codex 读取配置有两个来源：环境变量和 config.toml。环境变量放密钥，config.toml 放模型和端点。先设环境变量，在 PowerShell 里执行（把 sk-xxx 换成你实际的密钥）：
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-xxx", "User") [Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://taotoken.net/api", "User")设完同样要重开终端。验证是否写入成功：
[Environment]::GetEnvironmentVariable("OPENAI_API_KEY", "User") [Environment]::GetEnvironmentVariable("OPENAI_BASE_URL", "User")能回显出你设的值就对了。注意 base_url 结尾不要带斜杠，带斜杠有些客户端会拼出双斜杠导致 404。
接下来是 config.toml。Codex 的配置文件默认在%USERPROFILE%\.codex\config.toml，没有这个目录就手动建：
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"然后写入下面这个骨架，这是实测能跑通的最小配置：
model = "gpt-4o-mini" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "OPENAI_API_KEY" wire_api = "chat"几个参数说明一下。model 填你要用的模型名，先用 gpt-4o-mini 这类轻量模型验证连通性，通了再换大的。model_provider 是个标识，和下面[model_providers.taotoken]的段名对应，名字随便起但要一致。env_key 指向你刚设的环境变量名，Codex 会去读这个变量拿密钥，这样配置文件里就不出现明文密钥。wire_api 用 chat 表示走 Chat Completions 格式，兼容性最好。
如果你更习惯用命令行参数临时指定，也可以不写 config.toml，直接：
codex --model gpt-4o-mini --api-base https://taotoken.net/api但长期用还是建议写进 config.toml，省得每次敲。
5. 验证请求与成功结果确认
配置写完，先做一次最小连通性验证。最直接的方式是用 curl 打一次接口，确认密钥和端点本身没问题：
curl.exe https://taotoken.net/api/chat/completions ` -H "Authorization: Bearer $env:OPENAI_API_KEY" ` -H "Content-Type: application/json" ` -d '{\"model\":\"gpt-4o-mini\",\"messages\":[{\"role\":\"user\",\"content\":\"ping\"}]}'注意 PowerShell 里 curl 是 Invoke-WebRequest 的别名，所以要用curl.exe显式调用真正的 curl。返回 JSON 里带 choices 字段和内容，就说明密钥和端点都通。如果返回 401，是密钥问题；返回 404，多半是 base_url 拼错；返回 429，是额度或频率限制。
接口通了之后，回到 Codex 里跑一次真实请求：
codex "用一句话解释什么是递归"正常的话终端会流式输出模型回复。第一次跑可能会提示你确认某些权限，按提示允许即可。如果 Codex 报「provider not found」，检查 config.toml 里 model_provider 的值和段名是否完全一致，大小写敏感。如果报「env_key not set」，说明环境变量没读到，重开终端再试。
实测下来，从设环境变量到 Codex 出第一句回复，顺利的话五分钟内能搞定。卡住的地方九成在环境变量没生效或 config.toml 段名对不上，把这两处对齐基本就通了。
6. 本篇常见报错定位与排查
把几个高频报错和对应处理列一下，方便你对号入座。
| 报错现象 | 可能原因 | 处理方式 |
|---|---|---|
| codex 不是内部或外部命令 | PATH 未包含安装目录 | 按第 3 节重新定位并加 PATH，重开终端 |
| 401 Unauthorized | 密钥错误或未读到 | 用GetEnvironmentVariable确认变量值，重设后重开终端 |
| 404 Not Found | base_url 拼写错误或带斜杠 | 确认是https://taotoken.net/api，结尾无斜杠 |
| provider not found | config.toml 段名与 model_provider 不一致 | 两处名字改成完全一致 |
| 连接超时 | 系统时间偏差或网络策略 | 校准系统时间，确认能访问 API 端点 |
| 429 Too Many Requests | 频率或额度限制 | 降低请求频率，检查账户额度 |
还有一个隐蔽的坑：Windows 的环境变量分「用户」和「系统」两级，你用SetEnvironmentVariable(..., "User")设的是用户级，如果之前系统级设过同名变量，系统级会覆盖用户级。排查时两级都查一下：
[Environment]::GetEnvironmentVariable("OPENAI_API_KEY", "User") [Environment]::GetEnvironmentVariable("OPENAI_API_KEY", "Machine")如果 Machine 级有旧值，用管理员权限的 PowerShell 清掉，或者直接覆盖成新值。
另外 config.toml 的编码要用 UTF-8 无 BOM，用记事本另存时注意选对编码，带 BOM 有时会让解析器读首行出错。用 VS Code 或 Notepad++ 保存更稳妥。
7. 后续接入与长期使用建议
连通性验证通过后，如果你只是偶尔用 Codex 跑几个小任务，当前配置就够了。但如果你打算把 Codex 当日常编码代理长期用，比如让它读整个项目、跑测试、改多文件，那按量计费的模式在频繁调用下成本会上去。这种情况可以看下 Coding Plan，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，适合长期编码和 Agent 场景，比单次调用更划算。
如果你用的是 Claude Code 这类 Anthropic 体系的工具，接入方式略有不同，参考 https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claudecode&utm_campaign=rewrite 里的说明，核心思路一样：base_url 指向统一通道，密钥走环境变量。
最后提醒一句，config.toml 里不要写明文密钥，用 env_key 引用环境变量，这样配置文件可以放心备份和同步。密钥轮换时只改环境变量，不用动配置文件。这套配置我在 Windows 11 上跑了几个月，没再出过鉴权问题，你按上面步骤走一遍，应该能一次绕过安装和鉴权阶段的典型坑点。
