1. Windows 上折腾 Codex 的真实痛点与场景拆解Codex 在 Windows 上的完整生命周期管理说白了就三件事装得上、连得通、卸得干净。听起来简单但我在 Windows 11 上反复装了三遍才把链路跑顺中间踩的坑足够写一篇排障手册。Codex 是 OpenAI 推出的 AI 编程助手能根据自然语言生成代码、解释报错、重构函数适合日常写业务逻辑、补单元测试、读陌生仓库的开发者。它有三种形态Microsoft Store 的桌面应用、npm 全局安装的 Codex CLI、以及 VSCode 里的集成扩展。三种形态的安装路径、配置文件和卸载残留位置完全不同混着装最容易出问题。真正让人头疼的不是安装本身而是配置环节。Codex CLI 默认走 OpenAI 官方通道但很多开发者的网络环境并不稳定于是需要把请求指向一个统一的 API 通道。这时候auth.json就成了关键文件——它决定了 Codex 去哪里拿模型、用什么 Key、走哪个 Base URL。我见过太多人卡在401 Unauthorized或者local proxy failed上翻遍文档也找不到auth.json到底该放哪、字段怎么写。这篇内容聚焦 Windows 环境下 Codex 的完整生命周期从安装方式选择到auth.json的逐字段配置再到用curl验证连通性最后是卸载时怎么把残留清干净。我会给出可直接复制的 JSON 配置片段和 PowerShell 命令每一步都说明预期结果。如果你正在 Windows 上第一次接触 Codex或者装完之后连不上模型这篇可以当作操作手册跟着做。核心检索词就三个Codex Windows 安装、auth.json 配置、Codex 卸载清理。2. TaoToken 统一 Key 接入的前置准备与通道说明在动手改配置之前先把「统一 Key」这件事讲清楚。Codex CLI 本身是一个客户端它需要一个兼容 OpenAI 接口协议的服务端来响应请求。TaoToken 提供的就是这样一个统一 API 通道你拿到一个 Key配好 Base URLCodex 就能通过它调用背后的模型不用在多个平台之间来回切换 Key 和地址。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 根地址是 https://taotoken.net/api注意这个地址后面不加任何查询参数。前置准备分三步。第一步注册并登录后进入控制台在 API Keys 页面创建一个新 Key。创建时建议给 Key 起一个能识别的名字比如codex-win-cli方便以后在多个工具之间区分。Key 只在创建时完整显示一次复制后先存到密码管理器里别直接贴在聊天窗口。第二步确认你要用的 Model ID。Codex CLI 的配置里需要显式指定模型名称常见的有gpt-4o、gpt-4o-mini、claude-3-5-sonnet这类具体以控制台模型列表为准。第三步确认 Windows 上的 Node.js 版本。Codex CLI 依赖 Node 18 以上推荐 20 LTS。用node --version检查如果低于 18先用winget install OpenJS.NodeJS.LTS升级。这里要强调一个容易混淆的点Base URL 和完整请求地址不是一回事。Codex CLI 的配置里填的是 Base URL也就是https://taotoken.net/api它会在后面自动拼接/v1/chat/completions这类路径。如果你手贱在 Base URL 后面加了/v1最终请求就会变成/api/v1/v1/chat/completions直接 404。我第一次配的时候就犯了这个错报错信息只显示Not Found排查了半小时才发现是路径重复。另外TaoToken 的 Key 和 OpenAI 官方 Key 格式不同不要拿sk-开头的官方 Key 往这里填。Key 的权限范围在控制台可以限制建议只勾选需要的模型权限降低泄露风险。准备好 Key、Model ID、Base URL 这三样东西就可以进入下一步的配置文件编写了。3. auth.json 与 config.toml 可复制配置片段Codex CLI 在 Windows 上的配置目录是C:\Users\你的用户名\.codex\。这个目录默认不存在需要手动创建。打开 PowerShell先建目录New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.codex然后在这个目录下创建两个文件auth.json和config.toml。auth.json负责存放 Key 和认证信息config.toml负责模型和通道配置。先写auth.json内容如下{ OPENAI_API_KEY: 你的TaoToken Key, OPENAI_BASE_URL: https://taotoken.net/api }注意字段名是OPENAI_API_KEY和OPENAI_BASE_URL这是 Codex CLI 识别的固定键名不要改成api_key或base_url否则读不到。Key 直接填你从控制台复制的那串字符不要加引号以外的任何符号。Base URL 就是https://taotoken.net/api结尾不要带斜杠。接着写config.toml这是 Codex CLI 的主配置文件model gpt-4o model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key OPENAI_API_KEY [profiles.default] model gpt-4o model_provider taotoken这段 TOML 里model_provider定义了一个名为taotoken的提供方base_url指向统一通道env_key告诉 Codex 从环境变量或auth.json里读取 Key。profiles.default是默认配置档启动时自动加载。如果你要用别的模型把model的值换成控制台里支持的 Model ID 即可。如果你用的是 VSCode 集成版配置位置不同。VSCode 的 Codex 扩展读取的是settings.json路径在C:\Users\用户名\AppData\Roaming\Code\User\settings.json。在里面加{ codex.apiKey: 你的TaoToken Key, codex.baseUrl: https://taotoken.net/api, codex.model: gpt-4o }三件套齐了Base URL、Key、Model ID。桌面应用版则在设置界面里手动填这三项没有文件配置。三种形态的配置互不影响但建议只保留一种避免 Key 多处存放。4. 验证 API 连通性与 Codex 启动实测配置写完后先别急着启动 Codex用curl单独验证通道是否通。Windows 10 1803 以上自带curl.exe直接在 PowerShell 里跑curl.exe -X POST https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer 你的TaoToken Key -H Content-Type: application/json -d {\model\:\gpt-4o\,\messages\:[{\role\:\user\,\content\:\ping\}],\max_tokens\:10}预期返回是一段 JSON包含choices数组和message.content字段。如果返回401说明 Key 不对或没带上返回404检查 Base URL 是否多写了/v1返回model not found说明 Model ID 写错了。这一步通了再启动 Codex CLI。启动命令很简单codex第一次启动会读取~/.codex/config.toml和auth.json。如果配置正确你会看到交互式界面直接输入问题即可。测试一句「用 Python 写一个快速排序」观察是否正常返回代码。如果卡住不动按CtrlC退出检查auth.json的字段名是否拼错。我实测下来最容易出问题的是auth.json的编码。用记事本保存时如果选了「UTF-8 带 BOM」Codex 解析会失败报invalid character之类的错。建议用 VSCode 或 Notepad 保存为「UTF-8 无 BOM」。另外PowerShell 里设置环境变量OPENAI_API_KEY会覆盖auth.json的值如果你之前setx过记得清掉否则会一直用旧 Key。验证通过后你可以把 Codex 接到日常编码流程里。比如在项目目录下运行codex让它读当前仓库的代码并回答问题。CLI 支持--model参数临时覆盖配置里的模型方便对比不同模型的效果。5. 常见报错排查401、local proxy failed 与 OAuth排障部分按报错信息对照这是最省时间的做法。401 Unauthorized九成是 Key 问题。先确认auth.json里的OPENAI_API_KEY字段名没写错再确认 Key 没有多余空格。用curl单独测一次如果curl也 401说明 Key 本身无效或已过期去控制台重新生成。如果curl通了但 Codex 报 401说明 Codex 没读到auth.json检查文件路径是否为C:\Users\用户名\.codex\auth.json注意.codex前面有个点。local proxy failed这个报错通常出现在你之前配过系统代理但代理已经关闭的情况下。Codex 会读取HTTP_PROXY/HTTPS_PROXY环境变量如果这两个变量指向一个不可用的地址就会报local proxy failed。解决方法是清掉这两个环境变量[System.Environment]::SetEnvironmentVariable(HTTP_PROXY, $null, [System.EnvironmentVariableTarget]::User) [System.Environment]::SetEnvironmentVariable(HTTPS_PROXY, $null, [System.EnvironmentVariableTarget]::User)然后重开 PowerShell 再试。注意不要用「代理」相关的工具去绕直接走 TaoToken 的统一通道即可。reading choices 报错完整信息通常是error reading choices: unexpected end of JSON input。这说明服务端返回了空响应或非 JSON 内容。先确认 Base URL 是https://taotoken.net/api没有多余路径。再用curl -v看原始响应如果返回的是 HTML 错误页说明请求打到了错误的地址。还有一种可能是 Model ID 不被支持换一个控制台里明确列出的模型再试。OAuth 相关报错Codex CLI 某些版本会尝试 OAuth 登录流程如果你看到OAuth token exchange failed或浏览器跳转后回调失败说明它没走auth.json的 Key 认证。检查config.toml里model_provider是否指向了taotoken以及env_key是否写对。如果仍然触发 OAuth可以在启动时加--no-oauth参数强制走 Key 认证。codex 命令找不到npm 全局安装后codex的可执行文件在%APPDATA%\npm目录下。如果 PowerShell 提示无法将 codex 识别为 cmdlet把这个目录加到 PATH[System.Environment]::SetEnvironmentVariable(Path, $env:Path ;$env:APPDATA\npm, [System.EnvironmentVariableTarget]::User)重开终端即可。如果还不行用npm config get prefix确认全局路径把那个路径下的bin或根目录加进 PATH。6. 卸载清理与长期使用建议卸载分三种形态处理别只删一个就以为干净了。桌面应用版设置 → 应用 → 已安装的应用 → 找到 Codex → 卸载。或者用 PowerShellGet-AppxPackage *codex* | Remove-AppxPackageCLI 版先卸载 npm 包再删配置目录。npm uninstall -g openai/codex Remove-Item -Recurse -Force $env:USERPROFILE\.codex Remove-Item -Recurse -Force $env:APPDATA\npm\node_modules\openai\codexVSCode 扩展版在扩展面板里卸载 Codex 相关扩展然后清理settings.json里的codex.*配置项。彻底清理还要检查环境变量。如果你之前setx过OPENAI_API_KEY用下面命令删掉[System.Environment]::SetEnvironmentVariable(OPENAI_API_KEY, $null, [System.EnvironmentVariableTarget]::User)再检查%APPDATA%\Codex和%LOCALAPPDATA%\Codex是否存在有就删。注册表一般不用动Codex 不写注册表项。长期使用建议Key 定期轮换控制台里可以设置过期时间config.toml里可以加[profiles]多套配置比如一个默认用gpt-4o一个用gpt-4o-mini做快速补全如果团队协作把config.toml模板放进仓库但auth.json永远不要提交。需要长期跑编码任务或 Agent 流程的可以了解 Coding Plan 的额度方案日常验证模型效果直接用模型对话页面测一句最快。接入文档里有完整的字段说明和示例遇到配置问题先翻文档再排查比盲目改文件高效得多。
Codex Windows 安装、配置与卸载全面指南：TaoToken 统一 Key 接入实践
1. Windows 上折腾 Codex 的真实痛点与场景拆解Codex 在 Windows 上的完整生命周期管理说白了就三件事装得上、连得通、卸得干净。听起来简单但我在 Windows 11 上反复装了三遍才把链路跑顺中间踩的坑足够写一篇排障手册。Codex 是 OpenAI 推出的 AI 编程助手能根据自然语言生成代码、解释报错、重构函数适合日常写业务逻辑、补单元测试、读陌生仓库的开发者。它有三种形态Microsoft Store 的桌面应用、npm 全局安装的 Codex CLI、以及 VSCode 里的集成扩展。三种形态的安装路径、配置文件和卸载残留位置完全不同混着装最容易出问题。真正让人头疼的不是安装本身而是配置环节。Codex CLI 默认走 OpenAI 官方通道但很多开发者的网络环境并不稳定于是需要把请求指向一个统一的 API 通道。这时候auth.json就成了关键文件——它决定了 Codex 去哪里拿模型、用什么 Key、走哪个 Base URL。我见过太多人卡在401 Unauthorized或者local proxy failed上翻遍文档也找不到auth.json到底该放哪、字段怎么写。这篇内容聚焦 Windows 环境下 Codex 的完整生命周期从安装方式选择到auth.json的逐字段配置再到用curl验证连通性最后是卸载时怎么把残留清干净。我会给出可直接复制的 JSON 配置片段和 PowerShell 命令每一步都说明预期结果。如果你正在 Windows 上第一次接触 Codex或者装完之后连不上模型这篇可以当作操作手册跟着做。核心检索词就三个Codex Windows 安装、auth.json 配置、Codex 卸载清理。2. TaoToken 统一 Key 接入的前置准备与通道说明在动手改配置之前先把「统一 Key」这件事讲清楚。Codex CLI 本身是一个客户端它需要一个兼容 OpenAI 接口协议的服务端来响应请求。TaoToken 提供的就是这样一个统一 API 通道你拿到一个 Key配好 Base URLCodex 就能通过它调用背后的模型不用在多个平台之间来回切换 Key 和地址。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 根地址是 https://taotoken.net/api注意这个地址后面不加任何查询参数。前置准备分三步。第一步注册并登录后进入控制台在 API Keys 页面创建一个新 Key。创建时建议给 Key 起一个能识别的名字比如codex-win-cli方便以后在多个工具之间区分。Key 只在创建时完整显示一次复制后先存到密码管理器里别直接贴在聊天窗口。第二步确认你要用的 Model ID。Codex CLI 的配置里需要显式指定模型名称常见的有gpt-4o、gpt-4o-mini、claude-3-5-sonnet这类具体以控制台模型列表为准。第三步确认 Windows 上的 Node.js 版本。Codex CLI 依赖 Node 18 以上推荐 20 LTS。用node --version检查如果低于 18先用winget install OpenJS.NodeJS.LTS升级。这里要强调一个容易混淆的点Base URL 和完整请求地址不是一回事。Codex CLI 的配置里填的是 Base URL也就是https://taotoken.net/api它会在后面自动拼接/v1/chat/completions这类路径。如果你手贱在 Base URL 后面加了/v1最终请求就会变成/api/v1/v1/chat/completions直接 404。我第一次配的时候就犯了这个错报错信息只显示Not Found排查了半小时才发现是路径重复。另外TaoToken 的 Key 和 OpenAI 官方 Key 格式不同不要拿sk-开头的官方 Key 往这里填。Key 的权限范围在控制台可以限制建议只勾选需要的模型权限降低泄露风险。准备好 Key、Model ID、Base URL 这三样东西就可以进入下一步的配置文件编写了。3. auth.json 与 config.toml 可复制配置片段Codex CLI 在 Windows 上的配置目录是C:\Users\你的用户名\.codex\。这个目录默认不存在需要手动创建。打开 PowerShell先建目录New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.codex然后在这个目录下创建两个文件auth.json和config.toml。auth.json负责存放 Key 和认证信息config.toml负责模型和通道配置。先写auth.json内容如下{ OPENAI_API_KEY: 你的TaoToken Key, OPENAI_BASE_URL: https://taotoken.net/api }注意字段名是OPENAI_API_KEY和OPENAI_BASE_URL这是 Codex CLI 识别的固定键名不要改成api_key或base_url否则读不到。Key 直接填你从控制台复制的那串字符不要加引号以外的任何符号。Base URL 就是https://taotoken.net/api结尾不要带斜杠。接着写config.toml这是 Codex CLI 的主配置文件model gpt-4o model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key OPENAI_API_KEY [profiles.default] model gpt-4o model_provider taotoken这段 TOML 里model_provider定义了一个名为taotoken的提供方base_url指向统一通道env_key告诉 Codex 从环境变量或auth.json里读取 Key。profiles.default是默认配置档启动时自动加载。如果你要用别的模型把model的值换成控制台里支持的 Model ID 即可。如果你用的是 VSCode 集成版配置位置不同。VSCode 的 Codex 扩展读取的是settings.json路径在C:\Users\用户名\AppData\Roaming\Code\User\settings.json。在里面加{ codex.apiKey: 你的TaoToken Key, codex.baseUrl: https://taotoken.net/api, codex.model: gpt-4o }三件套齐了Base URL、Key、Model ID。桌面应用版则在设置界面里手动填这三项没有文件配置。三种形态的配置互不影响但建议只保留一种避免 Key 多处存放。4. 验证 API 连通性与 Codex 启动实测配置写完后先别急着启动 Codex用curl单独验证通道是否通。Windows 10 1803 以上自带curl.exe直接在 PowerShell 里跑curl.exe -X POST https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer 你的TaoToken Key -H Content-Type: application/json -d {\model\:\gpt-4o\,\messages\:[{\role\:\user\,\content\:\ping\}],\max_tokens\:10}预期返回是一段 JSON包含choices数组和message.content字段。如果返回401说明 Key 不对或没带上返回404检查 Base URL 是否多写了/v1返回model not found说明 Model ID 写错了。这一步通了再启动 Codex CLI。启动命令很简单codex第一次启动会读取~/.codex/config.toml和auth.json。如果配置正确你会看到交互式界面直接输入问题即可。测试一句「用 Python 写一个快速排序」观察是否正常返回代码。如果卡住不动按CtrlC退出检查auth.json的字段名是否拼错。我实测下来最容易出问题的是auth.json的编码。用记事本保存时如果选了「UTF-8 带 BOM」Codex 解析会失败报invalid character之类的错。建议用 VSCode 或 Notepad 保存为「UTF-8 无 BOM」。另外PowerShell 里设置环境变量OPENAI_API_KEY会覆盖auth.json的值如果你之前setx过记得清掉否则会一直用旧 Key。验证通过后你可以把 Codex 接到日常编码流程里。比如在项目目录下运行codex让它读当前仓库的代码并回答问题。CLI 支持--model参数临时覆盖配置里的模型方便对比不同模型的效果。5. 常见报错排查401、local proxy failed 与 OAuth排障部分按报错信息对照这是最省时间的做法。401 Unauthorized九成是 Key 问题。先确认auth.json里的OPENAI_API_KEY字段名没写错再确认 Key 没有多余空格。用curl单独测一次如果curl也 401说明 Key 本身无效或已过期去控制台重新生成。如果curl通了但 Codex 报 401说明 Codex 没读到auth.json检查文件路径是否为C:\Users\用户名\.codex\auth.json注意.codex前面有个点。local proxy failed这个报错通常出现在你之前配过系统代理但代理已经关闭的情况下。Codex 会读取HTTP_PROXY/HTTPS_PROXY环境变量如果这两个变量指向一个不可用的地址就会报local proxy failed。解决方法是清掉这两个环境变量[System.Environment]::SetEnvironmentVariable(HTTP_PROXY, $null, [System.EnvironmentVariableTarget]::User) [System.Environment]::SetEnvironmentVariable(HTTPS_PROXY, $null, [System.EnvironmentVariableTarget]::User)然后重开 PowerShell 再试。注意不要用「代理」相关的工具去绕直接走 TaoToken 的统一通道即可。reading choices 报错完整信息通常是error reading choices: unexpected end of JSON input。这说明服务端返回了空响应或非 JSON 内容。先确认 Base URL 是https://taotoken.net/api没有多余路径。再用curl -v看原始响应如果返回的是 HTML 错误页说明请求打到了错误的地址。还有一种可能是 Model ID 不被支持换一个控制台里明确列出的模型再试。OAuth 相关报错Codex CLI 某些版本会尝试 OAuth 登录流程如果你看到OAuth token exchange failed或浏览器跳转后回调失败说明它没走auth.json的 Key 认证。检查config.toml里model_provider是否指向了taotoken以及env_key是否写对。如果仍然触发 OAuth可以在启动时加--no-oauth参数强制走 Key 认证。codex 命令找不到npm 全局安装后codex的可执行文件在%APPDATA%\npm目录下。如果 PowerShell 提示无法将 codex 识别为 cmdlet把这个目录加到 PATH[System.Environment]::SetEnvironmentVariable(Path, $env:Path ;$env:APPDATA\npm, [System.EnvironmentVariableTarget]::User)重开终端即可。如果还不行用npm config get prefix确认全局路径把那个路径下的bin或根目录加进 PATH。6. 卸载清理与长期使用建议卸载分三种形态处理别只删一个就以为干净了。桌面应用版设置 → 应用 → 已安装的应用 → 找到 Codex → 卸载。或者用 PowerShellGet-AppxPackage *codex* | Remove-AppxPackageCLI 版先卸载 npm 包再删配置目录。npm uninstall -g openai/codex Remove-Item -Recurse -Force $env:USERPROFILE\.codex Remove-Item -Recurse -Force $env:APPDATA\npm\node_modules\openai\codexVSCode 扩展版在扩展面板里卸载 Codex 相关扩展然后清理settings.json里的codex.*配置项。彻底清理还要检查环境变量。如果你之前setx过OPENAI_API_KEY用下面命令删掉[System.Environment]::SetEnvironmentVariable(OPENAI_API_KEY, $null, [System.EnvironmentVariableTarget]::User)再检查%APPDATA%\Codex和%LOCALAPPDATA%\Codex是否存在有就删。注册表一般不用动Codex 不写注册表项。长期使用建议Key 定期轮换控制台里可以设置过期时间config.toml里可以加[profiles]多套配置比如一个默认用gpt-4o一个用gpt-4o-mini做快速补全如果团队协作把config.toml模板放进仓库但auth.json永远不要提交。需要长期跑编码任务或 Agent 流程的可以了解 Coding Plan 的额度方案日常验证模型效果直接用模型对话页面测一句最快。接入文档里有完整的字段说明和示例遇到配置问题先翻文档再排查比盲目改文件高效得多。