1. Codex 清理 C 盘时 auth.json 路径与鉴权报错排查Windows 上跑 Codex 做 C 盘清理很多人卡住的地方其实不是清理脚本本身而是 Codex 的鉴权配置。你让 Codex 扫描磁盘、生成 PowerShell 清理计划它跑着跑着突然报鉴权失败或者清理完重启 Codex 发现登录态没了这类问题八成和auth.json有关。这篇就聚焦这个场景用 PowerShell 定位 Codex 的auth.json核对里面的 endpoint 和鉴权字段把它改到 TaoToken 的接入地址然后验证清理脚本能一次跑通、鉴权不再中断。先说清楚 Codex 是什么、能做什么、适合谁。Codex 是 OpenAI 推出的编码智能体可以在终端里读代码、改文件、执行命令也能帮你写磁盘清理这类运维脚本。它适合已经在用命令行开发、想让 AI 直接动手改工程的 Windows 用户。而auth.json是 Codex 保存鉴权信息的本地文件里面记录了 API endpoint、密钥、模型等关键字段。一旦这个文件里的 endpoint 指向不对或者密钥失效Codex 就会在调用模型时中断——表现出来就是清理脚本跑到一半卡住、报 401、或者提示本地代理失败。为什么清理 C 盘会和鉴权扯上关系因为 Codex 在执行清理任务时会频繁调用模型来生成和校验 PowerShell 脚本。它每生成一段删除或移动逻辑都要回一次模型确认安全性。如果鉴权链路不稳任务就会断在中间你拿到的清理计划可能只写了一半。更麻烦的是有些清理脚本会顺手清理AppData下的缓存目录如果没排除 Codex 自己的配置目录auth.json可能被当成缓存删掉登录态直接丢失。我实测下来最稳的做法是两步走第一步用 PowerShell 把 Codex 的配置路径和auth.json内容摸清楚确认 endpoint 和鉴权状态第二步把 endpoint 改到 TaoToken 的接入地址让鉴权走一个稳定的入口再跑清理脚本验证连通性。这样即使清理脚本动了缓存目录只要auth.json指向明确、密钥有效Codex 重启后依然能正常鉴权。这一节先把问题边界划清楚你要排查的是 Codex 在 Windows 下的auth.json路径、endpoint 字段、鉴权状态以及改到 TaoToken 后的连通性。下面会给出可复制的auth.json字段模板、PowerShell 检查命令、以及改完之后的验证请求步骤。目标很具体——一次跑通清理脚本确认鉴权不再中断。需要提醒的是清理 C 盘本身有风险Codex 生成的脚本一定要先看清理计划再执行。而鉴权配置的修改属于低风险操作改错了顶多是 Codex 连不上不会动到系统文件。所以建议先解决鉴权再让 Codex 去碰磁盘。顺序反了你会在清理中途反复被鉴权报错打断体验很差。2. TaoToken 前置准备拿到 Base URL、Key 和 Model ID在改auth.json之前你得先有 TaoToken 的三件套Base URL、API Key、Model ID。这三个字段缺一不可Codex 的鉴权就是靠它们拼出来的。很多人改配置失败不是路径写错而是三件套里少了一个或者 Base URL 多写了斜杠、少写了/v1。先说 Base URL。TaoToken 的 API 入口是https://taotoken.net/api注意这里不要加 UTM 参数鉴权配置里只写干净的 API 地址。Codex 在拼接请求时会在这个 Base URL 后面接上具体的路径所以你在auth.json里填的应该是根地址而不是某个具体接口。如果你填成了带查询参数的地址Codex 发请求时参数会错位直接报 404 或 401。再说 API Key。你需要登录 TaoToken 的控制台在 API Keys 页面创建一个新的密钥。创建的时候建议起个能认出来的名字比如codex-win-clean方便以后排查是哪个客户端在用。密钥只在创建时完整显示一次复制下来存好后面要写进auth.json。如果你已经有密钥但忘了内容直接新建一个别去猜旧的。最后是 Model ID。Codex 需要知道调用哪个模型这个 ID 要和 TaoToken 支持的模型列表对上。你可以在模型对话页面先试一下目标模型能不能正常回复确认可用之后再写进配置。Model ID 写错的表现是鉴权通过但请求报模型不存在和 401 是两码事排查时要区分开。三件套准备好之后建议先在 PowerShell 里做一次最小验证确认 Base URL 和 Key 能通再去改auth.json。这样能把「网络/密钥问题」和「配置文件问题」分开省得改完配置发现是密钥本身失效。# 最小连通性验证确认 Base URL 和 Key 可用 $baseUrl https://taotoken.net/api $apiKey 你的_API_Key $headers { Authorization Bearer $apiKey Content-Type application/json } # 列出可用模型确认鉴权通过 Invoke-RestMethod -Uri $baseUrl/v1/models -Headers $headers -Method Get | Select-Object -ExpandProperty data | Select-Object -First 10 id这段命令跑通、能列出模型 ID说明 Base URL 和 Key 没问题。如果这里就报 401先别改auth.json回去检查密钥是不是复制全了、有没有多余空格。如果报连接失败检查网络和 Base URL 拼写。只有这一步过了后面的配置才有意义。关于长期编码和 Agent 场景如果你打算让 Codex 持续跑清理、重构这类多轮任务可以了解一下 Coding Plan它更适合高频调用。但不管用哪种方式Base URL、Key、Model ID 这三件套的填写规则是一样的先把基础打通。3. 可复制配置auth.json 字段模板与 PowerShell 定位命令这一节是核心给你可以直接复制的auth.json字段模板以及用 PowerShell 定位配置文件的命令。Codex 在 Windows 下的配置目录通常在用户目录里具体路径会因版本和安装方式不同而有差异所以第一步是「找到它」而不是「猜它在哪」。先用 PowerShell 把可能的配置路径列出来。Codex 的配置一般放在$env:USERPROFILE\.codex或者$env:APPDATA下的相关目录。下面这段命令会扫描常见位置把存在的auth.json和config.toml都列出来并显示修改时间方便你判断哪个是当前在用的。# 定位 Codex 配置文件auth.json 与 config.toml $candidates ( $env:USERPROFILE\.codex, $env:USERPROFILE\.config\codex, $env:APPDATA\codex, $env:LOCALAPPDATA\codex ) foreach ($dir in $candidates) { if (Test-Path $dir) { Write-Host 目录存在: $dir -ForegroundColor Green Get-ChildItem -Path $dir -Recurse -Include auth.json,config.toml -ErrorAction SilentlyContinue | Select-Object FullName, Length, LastWriteTime | Format-Table -AutoSize } else { Write-Host -- 不存在: $dir -ForegroundColor DarkGray } }跑完这段你会看到实际存在的配置文件路径。记下auth.json的完整路径后面所有操作都基于它。如果多个位置都有优先看修改时间最新的那个那通常是 Codex 当前读取的。找到之后先备份再改。备份这一步别省改错了能一键还原。# 备份 auth.json改错可还原 $authPath $env:USERPROFILE\.codex\auth.json # 换成你上一步查到的真实路径 $backup $authPath.bak_$(Get-Date -Format yyyyMMdd_HHmmss) Copy-Item -Path $authPath -Destination $backup -Force Write-Host 已备份到: $backup -ForegroundColor Green接下来是auth.json的字段模板。Codex 的鉴权字段命名可能随版本变化但核心是 endpoint、key、model 这几项。下面给一个通用模板你把值替换成自己的三件套。注意 JSON 里不能有多余逗号字符串要用双引号。{ api_base: https://taotoken.net/api, api_key: 你的_API_Key, model: 你的_Model_ID, provider: openai-compatible, timeout: 60 }如果你用的是config.toml形式的配置字段对应关系如下可以按需改写。TOML 里字符串同样用双引号布尔值不加引号。# config.toml 片段把鉴权指向 TaoToken [model] provider openai-compatible base_url https://taotoken.net/api api_key 你的_API_Key model_id 你的_Model_ID timeout 60写回文件时建议用 PowerShell 的Set-Content并指定 UTF-8 编码避免中文或特殊字符乱码。下面这段把模板写入auth.json写入前会先校验 JSON 是否合法不合法就不覆盖防止把配置写坏。# 写入 auth.json 并校验 JSON 合法性 $authPath $env:USERPROFILE\.codex\auth.json $json { api_base: https://taotoken.net/api, api_key: 你的_API_Key, model: 你的_Model_ID, provider: openai-compatible, timeout: 60 } try { $null $json | ConvertFrom-Json # 先校验 Set-Content -Path $authPath -Value $json -Encoding UTF8 Write-Host auth.json 已更新: $authPath -ForegroundColor Green } catch { Write-Host JSON 格式错误未写入: $($_.Exception.Message) -ForegroundColor Red }这里有个关键点api_base一定要写https://taotoken.net/api不要带 UTM 参数也不要写成首页地址。Codex 会在这个根地址上拼接/v1/...之类的路径写错了请求就发不出去。另外provider填openai-compatible是因为 TaoToken 提供的是兼容接口Codex 按这个协议发请求即可。改完配置后如果你同时用 Claude Code 或 Cline 这类工具它们的配置逻辑类似都是 Base URL Key Model ID 三件套。Claude Code 的配置可以放在settings.json里Cline 的 MCP 配置则在扩展设置里填。不管哪个工具只要三件套一致鉴权行为就一致排查思路可以复用。4. 验证请求确认鉴权不再中断并跑通清理脚本配置改完必须验证。验证分两层第一层是 Codex 自身能不能正常鉴权第二层是清理脚本能不能一次跑通不中断。很多人只做了第一层结果清理跑到一半又断回头发现是脚本里动了 Codex 的配置目录。先做第一层用 PowerShell 直接读auth.json并模拟一次请求确认 endpoint 和 key 生效。下面这段会读取配置、拼出请求、调用模型列表接口成功返回就说明鉴权链路通了。# 读取 auth.json 并验证鉴权 $authPath $env:USERPROFILE\.codex\auth.json $cfg Get-Content $authPath -Raw | ConvertFrom-Json Write-Host Base URL: $($cfg.api_base) Write-Host Model : $($cfg.model) $headers { Authorization Bearer $($cfg.api_key) Content-Type application/json } try { $resp Invoke-RestMethod -Uri $($cfg.api_base)/v1/models -Headers $headers -Method Get Write-Host 鉴权成功可用模型数: $($resp.data.Count) -ForegroundColor Green } catch { Write-Host 鉴权失败: $($_.Exception.Message) -ForegroundColor Red }返回「鉴权成功」之后再做第二层让 Codex 跑一次清理任务观察是否中断。这里的关键是在给 Codex 的提示词里明确排除 Codex 自己的配置目录避免清理脚本误删auth.json。你可以在清理提示词里加一条约束比如「跳过$env:USERPROFILE\.codex目录不要处理其中的任何文件」。这样即使 Codex 扫描到缓存目录也会把配置目录列为高风险项保留。验证清理脚本时建议先让 Codex 只输出清理计划不执行。检查计划里有没有把.codex目录、AppData\Roaming下的软件配置列进去。确认安全后再让它生成 PowerShell 脚本。脚本里应该有 Try-Catch 和大小统计执行前先看一遍。# 清理脚本执行前的安全检查确认没有触碰 Codex 配置目录 $plan Get-Content .\cleanup_plan.txt -Raw if ($plan -match \.codex) { Write-Host 警告清理计划包含 .codex 目录请手动排除后再执行 -ForegroundColor Yellow } else { Write-Host 清理计划未包含 Codex 配置目录可继续 -ForegroundColor Green }跑通之后你会看到清理前后磁盘可用空间的变化以及实际移动/删除了哪些目录。如果中途鉴权没有再报错说明auth.json改到 TaoToken 生效了。这时候可以重启一次 Codex再读一次配置确认重启后鉴权依然正常——这一步能验证配置是持久化的不是内存里的临时状态。如果验证模型本身是否可用可以到模型对话页面手动发一条消息确认目标 Model ID 能正常回复。这能排除「鉴权通过但模型不可用」的情况和 401 区分开。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth排查这一节按真实报错来对照你遇到哪条就查哪条。这些报错在 Codex 清理 C 盘的场景里出现频率很高而且容易和清理脚本本身的问题混淆。401 Unauthorized。这是最常见的鉴权失败。原因通常是三种Key 复制不全、Base URL 写错、或者auth.json里字段名不对。先用第 4 节的验证命令读配置确认api_key和api_base的值和你预期一致。如果 Key 里有空格或换行ConvertFrom-Json读出来会带进去请求就失败。检查方法是把 Key 打印出来看长度和创建时对比。另外确认api_base是https://taotoken.net/api没有多余斜杠或参数。local proxy failed。这个报错说明 Codex 尝试走本地代理但没连上。常见于配置里残留了旧的代理设置或者环境变量里有HTTP_PROXY/HTTPS_PROXY指向了一个已经关掉的本地端口。用 PowerShell 检查环境变量把失效的代理清掉。# 检查并清理失效的代理环境变量 Get-ChildItem Env: | Where-Object { $_.Name -match PROXY } | Format-Table Name, Value -AutoSize # 如确认失效可在当前会话清除 Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinuereading choices 相关报错。这类报错通常出现在响应解析阶段提示读取choices字段失败。原因可能是 Base URL 指向了一个返回格式不兼容的接口或者 Model ID 写错导致返回了错误结构。确认api_base指向 TaoToken 的兼容接口model字段填的是模型列表里真实存在的 ID。可以先用第 4 节的模型列表命令确认 ID 拼写。OAuth 相关报错。如果你之前用 OAuth 方式登录过 Codex配置里可能残留了 OAuth 的 token 字段和api_key冲突。排查方法是打开auth.json看有没有access_token、refresh_token之类的字段。如果有且你打算用 API Key 方式就把这些字段删掉只保留api_key。OAuth 和 API Key 两种鉴权方式不要混用混用会导致鉴权状态不确定。配置改了但没生效。Codex 可能缓存了旧配置或者你改的不是它实际读取的那个文件。用第 3 节的定位命令重新确认路径看修改时间是不是你刚改的。如果多个位置都有auth.json把不用的那个改名或删掉避免干扰。改完配置后重启 Codex让它重新加载。清理脚本误删配置。这是最坑的一种表现是清理跑完 Codex 登录态没了。根因是清理脚本把.codex目录当缓存删了。预防方法是在清理提示词里明确排除该目录并在执行前用第 4 节的安全检查命令扫一遍计划。如果已经删了用备份还原auth.json重新验证鉴权。对照这些报错排查时记住一个原则先确认三件套Base URL、Key、Model ID正确再看配置文件路径对不对最后看有没有代理或 OAuth 残留。顺序别乱乱了你会在多个可能原因之间反复横跳。6. 接入文档与 API Keys 入口配置改完、验证通过之后如果你还想把这套鉴权方式用到其他工具上或者想确认字段的最新写法可以去看接入文档里面有 Base URL、鉴权头、请求格式的完整说明。文档里的字段命名和本篇模板一致照着填就行。如果你还没创建 API Key或者想给不同的清理任务分配不同的 Key 方便追踪用量去 API Keys 页面新建。建议一个任务一个 Key出问题时能快速定位是哪个客户端在报错。创建后记得立刻复制保存页面刷新后就不再完整显示。验证模型是否可用除了命令行也可以直接在模型对话页面发消息测试。这比改配置更快适合在改auth.json之前先确认目标模型能正常回复。确认可用后再写进配置能少走弯路。如果你打算让 Codex 长期跑清理、重构这类多轮任务高频调用下可以看看 Coding Plan它更适合持续性的编码和 Agent 场景。但不管用哪种方式Base URL、Key、Model ID 这三件套的填写规则不变先把基础鉴权打通再考虑用量和成本。最后提醒一句清理 C 盘的脚本一定要先看计划再执行鉴权配置的修改属于低风险但磁盘操作不是。把鉴权先稳住再让 Codex 去碰磁盘整个流程会顺很多。