𝐘𝐀𝐈

XAI Router 启用 Codex App 插件

Posted May 9, 2026 by XAI 技术团队 ‐ 6 min read

不少用户在配置 Codex App 时，会遇到一个现象：模型请求已经可以通过 XAI Router 正常使用，但 Codex Apps / Plugins 页面仍然是灰色，无法打开插件目录。

这个问题的关键不是“模型 API 有没有代理成功”，而是 Codex 插件页面需要官方 ChatGPT/Codex 登录态。最简单、最稳定的方式是：

  1. 先用官方账号登录 Codex。
  2. 再把模型请求配置到 XAI Router。
  3. 不要把插件后台地址强行改到模型代理地址。

这样既能正常打开插件页面，也能让日常模型请求继续走 XAI Router 的 Codex 套餐。

先看结论

如果你只是普通用户，推荐使用下面这套方案：

Codex 插件页面：使用官方 Codex / ChatGPT 登录态
Codex 模型请求：使用 XAI Router API

也就是说，登录和模型 API 是两件事：

  • 官方登录态：用于解锁 Codex Apps、Plugins、远程插件目录等能力。
  • XAI Router API Key：用于实际模型调用、计费、路由和套餐额度。

不要把这两件事混在同一个 auth.json 里。

为什么插件页面会变灰

Codex 的插件页面不是单纯看你有没有模型 API Key。它会检查当前 Codex 是否有官方 ChatGPT/Codex backend 登录态。

如果你只配置了一个普通 API Key，例如：

sk-Xvs...

模型请求可以正常发出，但 Codex 客户端会认为你不是官方 ChatGPT/Codex backend 登录模式，于是 Apps / Plugins 页面可能会被禁用。

这也是很多用户困惑的地方：

明明 Codex 能回答、能改代码，为什么插件还是灰的？

原因是：模型请求可用，不等于插件后台可用。

正确链路应该是什么

推荐链路如下：

插件目录 / Apps 页面
Codex App -> 官方 ChatGPT backend

模型请求
Codex App -> XAI Router -> 上游 Codex 模型服务

这样做的好处是：

  1. 插件页面由官方登录态解锁，兼容性最好。
  2. 模型调用继续走 XAI Router，不影响套餐额度和路由能力。
  3. 不需要用户理解复杂的 backend-api 代理细节。
  4. 不需要为了插件页面额外修改本地代理服务。

第一步：先在 Codex App 登录官方账号

Codex App 的插件页面依赖 App 内的官方登录态。请在 Codex App 里退出当前登录方式，然后使用自己的官方 OpenAI / ChatGPT 账号重新登录。

完成后，Codex App 会在本地保存官方登录状态，用于打开 Apps / Plugins 页面。

注意：不要把 XAI Router Key 当成 Codex App 的登录凭证。也就是说，不要把 sk-Xvs... 写进 ~/.codex/auth.json，否则 Codex 可能会进入 API Key auth 模式。模型请求可以用，但插件页面仍然可能无法打开。

一句话记住：

Codex App 用官方账号登录，XAI Router Key 单独配置给模型 Provider。

第二步：配置 XAI Router 模型 Provider

打开或创建：

~/.codex/config.toml

推荐写法如下：

model_provider = "xai"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
model_reasoning_summary = "none"
model_context_window = 1050000
model_auto_compact_token_limit = 945000
approval_policy = "never"
sandbox_mode = "danger-full-access"
service_tier = "fast"
suppress_unstable_features_warning = true
cache_ttl = "30m"

[model_providers.xai]
name = "OpenAI"
base_url = "https://api.xairouter.com"
experimental_bearer_token = "sk-Xvs..."
wire_api = "responses"
requires_openai_auth = false
supports_websockets = true

[features]
goals = true
multi_agent = true
remote_connections = true
responses_websockets_v2 = true

把 sk-Xvs... 替换成你在 XAI Router 后台复制的 API Key。完成后重新启动 Codex App。

为什么推荐 experimental_bearer_token

对普通用户来说，experimental_bearer_token 的好处是配置最少：不用理解 shell、环境变量、.zshrc、.bashrc，也不用担心 Codex App 是否能读取终端环境变量。

你只需要记住一件事：

Codex App 官方登录态放在 auth.json
XAI Router Key 放在 config.toml 的 experimental_bearer_token

注意：experimental_bearer_token 会明文保存在 ~/.codex/config.toml。请不要把这个文件上传到公开仓库，也不要截图公开完整 Key。

常见问题

1. 我已经能用 Codex 写代码，为什么插件还是灰的？

因为模型请求可用，只说明模型 API 可用。插件页面还需要官方 ChatGPT/Codex 登录态。

如果你之前使用 API Key 方式登录过 Codex，Codex App 可能仍处于 API Key 认证模式。此时可以在 App 里主动退出，再用自己的官方 OpenAI / ChatGPT 账号登录。这样会让本地 ~/.codex/auth.json 重新保存官方登录态，用于开启插件页面。

如果官方账号提示默认模型额度不足，也不代表 XAI Router 不可用。只要本文的 Provider 配置生效，真正的模型请求仍然会走 XAI Router。

2. 插件请求会不会消耗 XAI Router 套餐？

插件目录浏览、安装这类后台请求主要依赖官方登录态。真正调用模型、让 Codex 执行任务时，模型请求会按你的 XAI Router Provider 配置走 XAI Router。

最后再总结一次

如果你的目标是“Codex 插件能打开，同时模型请求走 XAI Router”，请按这个顺序做：

  1. 登录自己的官方 OpenAI / ChatGPT 账号，保留官方登录态。
  2. 在 ~/.codex/config.toml 配置 XAI Router Provider，可以直接复制 XAI Router 后台提供的推荐配置。

如果你还没有 XAI Router Codex 套餐，可以访问 m.xairouter.com 注册账号并开通 Codex 套餐。开通后复制你的 API Key，按本文配置即可让 Codex 模型请求通过 XAI Router 使用。