摘要在 Codex Desktop 中使用 PackyCode 或 PackyAPI 时常见报错包括401 Unauthorized、Invalid API key、Model is not available、stream disconnected before completion等。很多问题并不是 Key 真的过期而是Key、Base URL、模型名称和 Codex 配置没有对应到同一套服务。本文以 PackyCode / PackyAPI 为例整理一套可复用的排查流程。1. 问题现象在 Codex Desktop 中配置 PackyCode 或 PackyAPI 后可能会遇到下面几类报错。1.1 Invalid API keyunexpected status 401 Unauthorized: Invalid API key provided, url: https://codex-api.packycode.com/v1/responses或者unexpected status 401 Unauthorized: 无效的令牌, url: https://www.packyapi.com/v1/responses这类错误的核心不是只看Invalid API key而是要先看后面的url。如果请求地址是https://codex-api.packycode.com/v1/responses说明当前请求发到了 PackyCode Codex 包月接口。如果请求地址是https://www.packyapi.com/v1/responses说明当前请求发到了 PackyAPI 接口。同样是 Packy 相关服务但不同接口对应的 Key 可能不是同一套。Key 如果发错接口就会被认为无效。1.2 模型不可用Model gpt-4o is not available. Available models: gpt-5.2, gpt-5.3-codex, gpt-5.4, gpt-5.4-mini, gpt-5.5这种报错和 Key 无效不是一回事。它说明接口已经连通Key 大概率也通过了认证但配置里的模型名不可用。例如配置里写了model gpt-4o但平台实际可用模型只有gpt-5.2 gpt-5.3-codex gpt-5.4 gpt-5.4-mini gpt-5.5那就应该改成model gpt-5.5或者更偏 Codex 场景的model gpt-5.3-codex1.3 流式连接中断stream disconnected before completion: error sending request for url (https://api.packycode.com/v1/responses)这类错误一般不是典型的 Key 错误而是流式响应中途断开。常见原因包括Base URL 写错 第三方接口不稳定 网络或代理断流 接口对 Responses API 支持不完整 模型响应时间过长如果偶发可以先重试。如果频繁出现应优先检查 Base URL 是否写成了平台要求的地址。2. PackyCode 和 PackyAPI 的地址不要混用接入时最容易混淆的是两个地址。PackyCode Codex 包月接口https://codex-api.packycode.com/v1PackyAPI 接口https://www.packyapi.com/v1这两个地址看起来都和 Packy 有关但不一定使用同一套 Key。如果手里的 Key 属于 PackyAPI却配置成base_url https://codex-api.packycode.com/v1就可能出现401 Unauthorized: Invalid API key provided反过来如果 Key 属于 PackyCode Codex 包月接口却配置成 PackyAPI 地址也可能认证失败。所以排查时不要先怀疑模型也不要先反复换 Key先确认当前 Key 对应哪个 Base URL3. 检查 Codex 当前配置Windows 下Codex 配置文件通常在C:\Users\用户名\.codex\config.toml可以用 PowerShell 查看关键配置Get-Content $HOME\.codex\config.toml | Select-String -Pattern model_provider|^model\s*|base_url|wire_api|requires_openai_auth正常会看到类似内容base_url http://127.0.0.1:15721/v1 model_provider packycode model gpt-5.5 [model_providers.packycode] base_url https://www.packyapi.com/v1 wire_api responses requires_openai_auth true这里有两个base_url不要搞混。第一个base_url http://127.0.0.1:15721/v1是 Codex Desktop 的本地代理地址通常不用动。第二个[model_providers.packycode] base_url https://www.packyapi.com/v1才是真正请求 PackyAPI 的远程地址。4. PackyAPI 可用配置示例如果 Key 属于 PackyAPI可以使用下面这种配置base_url http://127.0.0.1:15721/v1 service_tier priority model_provider packycode model gpt-5.5 model_reasoning_effort high [model_providers.packycode] name packycode base_url https://www.packyapi.com/v1 wire_api responses requires_openai_auth true其中model gpt-5.5可以根据平台返回的可用模型列表调整。如果平台提示可用模型包括gpt-5.2 gpt-5.3-codex gpt-5.4 gpt-5.4-mini gpt-5.5常用选择可以是model gpt-5.5或者model gpt-5.3-codex5. PackyCode Codex 包月配置示例如果 Key 明确属于 PackyCode Codex 包月接口可以使用base_url http://127.0.0.1:15721/v1 service_tier priority model_provider packycode model gpt-5.5 model_reasoning_effort high [model_providers.packycode] name packycode base_url https://codex-api.packycode.com/v1 wire_api responses requires_openai_auth true如果这个配置返回401 Unauthorized: Invalid API key provided url: https://codex-api.packycode.com/v1/responses但改成base_url https://www.packyapi.com/v1后可以正常使用说明当前 Key 更可能是 PackyAPI Key而不是 PackyCode Codex 包月 Key。6. 检查 auth.json第三方 Key 通常写在C:\Users\用户名\.codex\auth.json格式类似{ OPENAI_API_KEY: sk-******************************** }虽然字段名叫OPENAI_API_KEY但在第三方兼容接口场景下这里可以放 PackyCode 或 PackyAPI 提供的 Key。不要把完整 Key 发到聊天、截图、文章或代码仓库里。可以用下面的命令检查格式不输出完整 Key$j Get-Content $HOME\.codex\auth.json -Raw | ConvertFrom-Json $k $j.OPENAI_API_KEY [PSCustomObject]{ HasKey if ($k) { 是 } else { 否 } Length if ($k) { $k.Length } else { 0 } StartsWithSk if ($k -like sk-*) { 是 } else { 否 } ContainsSpace if ($k -match \s) { 是 } else { 否 } ContainsChinesePunctuation if ($k -match [\u3000-\u303F\uFF00-\uFFEF]) { 是 } else { 否 } }正常结果应类似HasKey : 是 StartsWithSk : 是 ContainsSpace : 否 ContainsChinesePunctuation : 否如果出现空格、中文标点、长度明显异常就要重新复制 Key。7. 改完配置后必须重启 Codex修改config.toml后不要直接在旧会话里继续点重试。建议执行Get-Process | Where-Object { $_.ProcessName -match Codex } | Stop-Process -Force -ErrorAction SilentlyContinue然后重新打开 Codex并新建会话测试。原因很简单旧进程可能还在使用启动时读取的配置 旧会话可能还保存着旧模型或旧 provider例如已经把配置改成model gpt-5.5但旧会话仍然报Model gpt-4o is not available这种情况通常不是配置没改而是旧会话或旧进程没刷新。8. 常见报错与处理方法报错判断处理https://codex-api.packycode.com/v1/responses 401Key 不被 PackyCode 包月接口认可确认 Key 是否属于 PackyCode 包月不确定时试 PackyAPI 地址https://www.packyapi.com/v1/responses 401PackyAPI 不认可 Key检查 Key 是否有效、是否复制完整、是否有权限Model gpt-4o is not availableKey 通过了但模型不可用改成返回列表中的模型stream disconnected before completion流式响应断开重试检查 Base URL、网络和平台稳定性改了模型还报旧模型旧进程或旧会话没刷新杀掉 Codex 进程新建会话请求发到api.openai.com走了 OpenAI 官方接口第三方 Key 不能用于该地址需要改第三方 Base URL9. 推荐排查顺序以后再遇到类似问题可以按下面顺序处理。第一步看报错 URL先确认请求到底发到了哪里https://codex-api.packycode.com/v1/responses https://www.packyapi.com/v1/responses https://api.openai.com/v1/responses第二步确认 Key 类型问清楚 Key 到底属于PackyCode Codex 包月 PackyAPI OpenAI 官方 API 其他第三方平台第三步检查 config.tomlGet-Content $HOME\.codex\config.toml | Select-String -Pattern model_provider|^model\s*|base_url|wire_api|requires_openai_auth第四步检查 auth.json确认 Key 存在、没有空格、没有中文标点、没有复制错。第五步确认模型名称如果平台返回可用模型列表就使用列表里的模型不要凭经验写gpt-4o或其他名称。第六步重启 Codex新建会话修改配置后必须重启 Codex最好新建会话验证。10. 建议保存多套配置如果经常在 ChatGPT 账号、PackyAPI、PackyCode 包月之间切换建议保存多份配置文件。例如config.toml.chatgpt config.toml.packyapi config.toml.packycode保存当前 PackyAPI 配置Copy-Item $HOME\.codex\config.toml $HOME\.codex\config.toml.packyapi以后切换回 PackyAPICopy-Item $HOME\.codex\config.toml.packyapi $HOME\.codex\config.toml -Force切换后重启 CodexGet-Process | Where-Object { $_.ProcessName -match Codex } | Stop-Process -Force -ErrorAction SilentlyContinue总结Codex Desktop 接入 PackyCode 或 PackyAPI 时401 报错不一定代表 Key 过期。更常见的问题是Key、Base URL、model_provider、model 没有对齐排查时记住一条原则PackyAPI Key 就配 PackyAPI Base URL PackyCode 包月 Key 就配 PackyCode 包月 Base URL 模型名必须使用平台实际支持的名称 改完配置必须重启 Codex 并新建会话。如果codex-api.packycode.com返回 401而www.packyapi.com/v1可以正常使用基本可以判断当前 Key 属于 PackyAPI而不是 PackyCode Codex 包月接口。