常见问题

返回 401 / authentication_error（认证失败）

检查 API Key 是否来自本站控制台、是否复制完整、前后是否带了多余空格。客户端只要求填 Key 时，不要手动加 Bearer 前缀；用 curl 测试时二选一即可：Authorization: Bearer 或 x-api-key。

提示 API key is not assigned to any group（未分配分组）

这个 Key 没有绑定分组，或者所在分组已被删除。重新创建 Key 并选择正确的分组，或联系管理员为你分配分组。

提示无可用账号 / no available accounts（503）

当前分组的上游账号池暂时没有可调度的账号（可能都在限流或维护中）。稍后重试；持续出现请联系管理员检查账号池状态。

模型报 404 / 不可用

先用 GET https://xmlumen.org/v1/models 确认当前 Key 的可用模型列表；再检查模型名拼写、Key 分组的平台是否与模型系列匹配（不同平台的模型名不能混用）。

提示余额或额度不足

检查账户余额、订阅状态、Key 的总额度与过期时间。充值或让管理员调整额度后再重试。

Claude Code 连不上或仍然走官方地址

确认 ANTHROPIC_BASE_URL 填的是站点根地址（不带 /v1），且 ANTHROPIC_AUTH_TOKEN 已设置。用环境变量配置时需要在新开的终端里重新启动 Claude Code，改完 settings.json 也建议重启一次，启动后用 /status 验证。

Codex 多轮对话报错或上下文丢失

确认 config.toml 中 wire_api = "responses" 且 base_url 以 /v1 结尾。如果你在自己的 Nginx 后面再套了一层反代，需要在 Nginx 的 http 块加上 underscores_in_headers on;，否则带下划线的会话头会被丢弃，导致多账号会话粘滞失效。

Codex 报 model_not_found（配置里还是 gpt-5.5）

ChatGPT 订阅类上游已不再提供 gpt-5.5，旧配置里的 model = "gpt-5.5" 可能直接返回 model_not_found。把 ~/.codex/config.toml 中的 model 改成分组开放的新模型（如 gpt-6.1-sol），或按客户端配置重新生成配置。

请求很慢或流式输出中断

先用简单的 curl 请求排除网络问题，再检查本地代理 / VPN 设置。如果经由 CDN，请确认没有对流式响应做缓冲。仍有问题时，把出现问题的时间点和模型反馈给管理员，便于在后台日志中定位。

Codex app 看不到网关开放的新模型

现象： 模型选择器里看不到分组已开放的新模型（如 gpt-6.1-sol / gpt-6-luna），或启动后自动降级到旧模型。

先检查配置： 确认 ~/.codex/config.toml 已按客户端配置加上远程模型目录（model_catalog_url 与 [features] 中的 api_key_model_discovery = true），且 Codex 版本不低于 0.156.0。保存后完全退出并重启 Codex，新建 task 再查看模型列表。

仍不显示时（桌面 app）： ChatGPT 桌面应用前端（webview/assets/model-list-filter-*.js）会对模型列表做二次过滤，API Key 账号受远程白名单限制，新模型进入白名单前会被隐藏。config.toml 只影响默认请求模型，无法解除前端过滤。可以将下方提示词完整粘贴给 Codex，让它自动执行修复流程（创建本地兼容副本，不修改 Store 原版应用）。

点击展开修复提示词

你好，请帮我修复 Codex app 无法显示网关新模型的问题。

背景：
- 自定义 API Key 网关已能返回新模型（如 gpt-6.1-sol / gpt-6-luna）
- ~/.codex/config.toml 已设置 model = "gpt-6.1-sol"
- 但 Codex 或 ChatGPT 桌面应用的模型选择器仍看不到这些模型

根因：
桌面应用前端在 webview/assets/model-list-filter-*.js 中有如下过滤逻辑：
  u = s && e !== `amazonBedrock`
当 authMethod 为 apikey（全小写）时，仍会应用远程白名单过滤，导致这些新模型被隐藏。

修复目标：
将过滤条件改为：
  u = s && e !== `amazonBedrock` && e !== `apikey`
使 API Key 模式跳过远程白名单，直接展示 app-server 实际返回且 hidden=false 的模型。

请按以下步骤操作：

1. 查询已安装的 OpenAI.Codex 包信息：
   Get-AppxPackage OpenAI.Codex | Select-Object Name, Version, InstallLocation

2. 设置路径变量（$pkg、$sourceAsar、$workDir、$patchedAsar、$backupDir、$localApp）

3. 备份原始 app.asar，核对 SHA-256 一致

4. 用 `npx --no-install asar extract` 解包到临时目录

5. 用 ripgrep 找到 model-list-filter-*.js：
   rg -l -S "useHiddenModels|amazonBedrock" $workDir --glob "*.js"

6. 将文件中的
     u=s&&e!==`amazonBedrock`
   替换为
     u=s&&e!==`amazonBedrock`&&e!==`apikey`
   （变量名以实际压缩结果为准，语义：useHiddenModels && authMethod !== amazonBedrock && authMethod !== apikey）

7. 用 `node --check` 验证语法

8. 用 `npx --no-install asar pack` 重新封装为 patched.asar

9. 复制官方 app 目录到 %LOCALAPPDATA%\OpenAI\ChatGPT-Gateway\<version>
   robocopy $sourceApp $localApp /E /COPY:DAT /R:1 /W:1

10. 替换本地副本的 resources\app.asar，核对 SHA-256 一致

11. 创建开始菜单快捷方式 "ChatGPT (Gateway)"

12. 静态验证：
    rg -n -S "amazonBedrock.*apikey" <解包目录>\webview\assets\model-list-filter-*.js

完成后告诉我每步的执行结果和最终 SHA-256 哈希对比。
注意：不要修改 WindowsApps 目录下的原始 Store 应用文件。

验证： 修复完成后，从开始菜单启动 ChatGPT (Gateway)，在模型选择器中确认出现网关开放的新模型。

注意： Store 更新后需基于新版本重新执行修复流程；不同版本的 model-list-filter-*.js 文件名（哈希后缀）和压缩后的变量名都会变化，应按代码语义定位而非固定文件名。如果新版本里已经找不到这段过滤逻辑，说明官方已做调整，无需再修复。

常见问题 ​

常见问题