𝐗𝐀𝐈 𝐂𝐨𝐧𝐭𝐫𝐨𝐥

XAI Router -> Codex-Cloud：Claude Code 极简兼容指南

Posted March 4, 2026 by XAI 技术团队 ‐ 3 min read

如果你想要一条稳定、简单、可控的链路，把 Claude Code 直接接到 gpt-5.3-codex，推荐下面这个架构：

Claude Code -> XAI Router -> Codex-Cloud -> OpenAI Responses (gpt-5.3-codex)

这个架构的核心目标只有三个字：少改动。

架构一图流

Claude Code
  └─ ANTHROPIC_BASE_URL=https://api.xairouter.com
     └─ /v1/messages
        └─ Codex-Cloud (Claude API -> Response API)
           └─ model: gpt-5.3-codex

你可以把 Codex-Cloud 理解成一个专注转换层：

  1. 输入端是 Claude API 请求。
  2. 中间做轻量字段兼容与参数映射。
  3. 输出端走 Response API，不做多余业务逻辑。

兼容体验（用户视角）

它提供的是“Claude Code 原样使用”的接入体验：

  1. 继续使用 Claude Code 的调用习惯与 Anthropic 风格配置。
  2. POST /v1/messages 请求链路可直接跑通，支持流式与工具调用。
  3. 模型统一到 gpt-5.3-codex，不需要额外改业务代码。
  4. effort: "max" 会映射到 xhigh，用于最高思考档位。

企业场景：Claude API 异常时平滑 Fallback

这个架构在企业里还有一个关键价值：把故障切换留在网关层，而不是业务代码里。

当上游出现波动时，你可以保持应用侧继续发 Claude API 形态请求，由 XAI Router 在后端执行切换策略（例如从主链路切到 Codex-Cloud 备用链路），做到：

  1. 应用代码不改，接口协议不改。
  2. 用户侧请求入口不变（仍是同一个 ANTHROPIC_BASE_URL）。
  3. 切换时间更短，回切也更简单。

一句话理解：前台稳定、后台可切换。

本地最小配置（可直接复用）

下面是一套可直接复用的本地配置模板。

1) Shell 环境变量

export ANTHROPIC_BASE_URL="https://api.xairouter.com"
export ANTHROPIC_AUTH_TOKEN="sk-***"
export ANTHROPIC_DEFAULT_OPUS_MODEL="gpt-5.3-codex"
export ANTHROPIC_DEFAULT_SONNET_MODEL="gpt-5.3-codex"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="gpt-5.3-codex"

2) ~/.claude/settings.json

{
  "model": "gpt-5.3-codex",
  "skipDangerousModePermissionPrompt": true,
  "effort": "max",
  "permissionMode": "bypassPermissions"
}

这套配置的效果是：

  1. 默认模型就是 gpt-5.3-codex。
  2. 思考强度走最高档（映射到 xhigh）。
  3. 本地权限策略更直接，减少交互阻断。

30 秒自检

1) 直接跑 Claude Code

claude "用 Rust 写一个最小 HTTP server，并解释每个模块职责"

如果你能稳定拿到回复并正常触发工具调用，就说明整条链路已跑通。

常见问题

Q1: Claude Code 走转换后还能用最高思考档吗？

可以。把 ~/.claude/settings.json 里的 "effort" 设为 "max"，即可映射到 xhigh。

一句话总结：XAI Router + Codex-Cloud 把 Claude 生态请求形态平滑接到 Codex 模型上，既能快速接入，也能在异常时做企业级平滑 Fallback。