𝐗𝐀𝐈 𝐗𝐀𝐏𝐈

配置说明

面向 Codex CLI / Codex App / Claude Code / OpenCode / OpenClaw 的统一接入说明。

Codex CLI / App Claude Code OpenCode OpenClaw

统一前提：网关地址使用（OpenAI 使用）；并配置环境变量 XAI_API_KEY。

Codex CLI / Codex App

Codex 客户端支持两种 wire 协议：responses 与 chat。按模型能力选择其一即可。只要 ~/.codex/config.toml 与 XAI_API_KEY 配置完成，Codex App 可直接复用同一套网关配置。Windows 配置文件路径为 %USERPROFILE%\.codex\config.toml。

方案 A：wire_api = "responses"（推荐 Codex 模型）

# ~/.codex/config.toml
model_provider = "xai"
model = "gpt-5.3-codex"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
model_reasoning_summary = "detailed"
model_verbosity = "high"
approval_policy = "never"
sandbox_mode = "danger-full-access"

[model_providers.xai]
name = "xai"
base_url = ""
wire_api = "responses"
requires_openai_auth = false
env_key = "XAI_API_KEY"

# 启动
export XAI_API_KEY="sk-Xvs..."
codex --yolo

方案 B：wire_api = "chat"（适配 OpenAI Chat 形态模型）

# ~/.codex/config.toml
[model_providers.xai]
name = "xai"
base_url = ""
env_key = "XAI_API_KEY"
wire_api = "chat"
requires_openai_auth = false

[profiles.minimax]
model = "MiniMax-M2.5"
model_provider = "xai"

# 启动
export XAI_API_KEY="sk-Xvs..."
codex --profile minimax

Windows CMD（启动与校验）

:: 配置文件路径
:: %USERPROFILE%\.codex\config.toml

:: 设置密钥
set XAI_API_KEY=sk-Xvs...

:: 方案 A（responses）
codex

:: 方案 B（chat）
codex --profile minimax

Windows PowerShell（启动与校验）

# 配置文件路径
# $env:USERPROFILE\.codex\config.toml

$env:XAI_API_KEY="sk-Xvs..."

# 方案 A（responses）
codex

# 方案 B（chat）
codex --profile minimax

验证命令：codex（responses）或 codex --profile minimax（chat）

Claude Code（gpt-5.3-codex）

Claude Code 主要通过环境变量接入。以下示例将默认模型映射到 gpt-5.3-codex，网关地址使用。

环境变量配置（Linux / macOS）

export XAI_API_KEY="sk-Xvs..."
export ANTHROPIC_AUTH_TOKEN="$XAI_API_KEY"
export ANTHROPIC_BASE_URL=""
# 可选：自定义 Claude 默认模型映射（不配置也可正常使用）
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"

# 启动 Claude Code
claude

环境变量配置（Windows CMD）

set XAI_API_KEY=sk-Xvs...
set ANTHROPIC_AUTH_TOKEN=%XAI_API_KEY%
set ANTHROPIC_BASE_URL=
:: 可选：自定义 Claude 默认模型映射（不配置也可正常使用）
set ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.3-codex
set ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5.3-codex
set ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.3-codex

claude

环境变量配置（Windows PowerShell）

$env:XAI_API_KEY="sk-Xvs..."
$env:ANTHROPIC_AUTH_TOKEN=$env:XAI_API_KEY
$env:ANTHROPIC_BASE_URL=""
# 可选：自定义 Claude 默认模型映射（不配置也可正常使用）
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="gpt-5.3-codex"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="gpt-5.3-codex"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="gpt-5.3-codex"

claude

验证命令：claude

OpenCode（Responses: gpt-5.3-codex / Chat: MiniMax-M2.5）

OpenCode 建议使用全局配置文件 ~/.config/opencode/opencode.jsonc（Windows: %USERPROFILE%\.config\opencode\opencode.jsonc）。你的系统已做协议兼容，可按需在 Responses API 与 Chat API 两套配置间二选一。

使用顺序：先选 API 方案（A = Responses，B = Chat），再选对应系统（Linux / macOS 或 Windows）配置块。

方案 A（Responses API）配置文件（Linux / macOS）

# ~/.config/opencode/opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "model": "openai/gpt-5.3-codex",
  "small_model": "openai/gpt-5.3-codex",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "",
        "apiKey": "{env:XAI_API_KEY}"
      }
    }
  }
}

export XAI_API_KEY="sk-Xvs..."
opencode debug config

方案 A（Responses API）配置文件（Windows）

:: 文件路径：%USERPROFILE%\.config\opencode\opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "model": "openai/gpt-5.3-codex",
  "small_model": "openai/gpt-5.3-codex",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "",
        "apiKey": "{env:XAI_API_KEY}"
      }
    }
  }
}

:: CMD
set XAI_API_KEY=sk-Xvs...
opencode debug config

:: PowerShell
$env:XAI_API_KEY="sk-Xvs..."
opencode debug config

方案 B（Chat API）配置文件（Linux / macOS）

# ~/.config/opencode/opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "model": "xai-chat/MiniMax-M2.5",
  "small_model": "xai-chat/MiniMax-M2.5",
  "provider": {
    "xai-chat": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "",
        "apiKey": "{env:XAI_API_KEY}"
      },
      "models": {
        "MiniMax-M2.5": {}
      }
    }
  }
}

export XAI_API_KEY="sk-Xvs..."
opencode debug config

方案 B（Chat API）配置文件（Windows）

:: 文件路径：%USERPROFILE%\.config\opencode\opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "model": "xai-chat/MiniMax-M2.5",
  "small_model": "xai-chat/MiniMax-M2.5",
  "provider": {
    "xai-chat": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "",
        "apiKey": "{env:XAI_API_KEY}"
      },
      "models": {
        "MiniMax-M2.5": {}
      }
    }
  }
}

:: CMD
set XAI_API_KEY=sk-Xvs...
opencode debug config

:: PowerShell
$env:XAI_API_KEY="sk-Xvs..."
opencode debug config

请求示例 A：Responses API（gpt-5.3-codex）

curl /responses \
  -H "Authorization: Bearer ${XAI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"gpt-5.3-codex",
    "input":"用一句话解释微服务网关的作用"
  }'

请求示例 B：Chat API（MiniMax-M2.5）

curl /chat/completions \
  -H "Authorization: Bearer ${XAI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"MiniMax-M2.5",
    "messages":[{"role":"user","content":"用一句话解释微服务网关的作用"}]
  }'

验证命令：opencode debug config（确认配置）与 opencode run "你好"（验证调用）

OpenClaw

OpenClaw 可接入 OpenAI API、Claude API，并可扩展 OpenAI Responses API。XAI Router 默认支持 OpenAI API 与 Claude API 两种协议；如需 Responses，使用 api = "openai-responses"。配置文件路径：Linux / macOS 为 ~/.openclaw/openclaw.json，Windows 为 %USERPROFILE%\.openclaw\openclaw.json。

方式 1：OpenAI Chat API 兼容（api = "openai-completions"）

{
  "agents": {
    "defaults": {
      "model": { "primary": "xairouter/MiniMax-M2.5" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "xairouter": {
        "baseUrl": "",
        "apiKey": "${XAI_API_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "MiniMax-M2.5", "name": "MiniMax-M2.5" }]
      }
    }
  }
}

方式 2：Claude API 兼容（api = "anthropic-messages"）

{
  "agents": {
    "defaults": {
      "model": { "primary": "xairouter/MiniMax-M2.5" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "xairouter": {
        "baseUrl": "",
        "apiKey": "${XAI_API_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "MiniMax-M2.5", "name": "MiniMax-M2.5" }]
      }
    }
  }
}

方式 3：OpenAI Responses API 兼容（api = "openai-responses"）

{
  "agents": {
    "defaults": {
      "model": { "primary": "xairouter/gpt-5.3-codex" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "xairouter": {
        "baseUrl": "",
        "apiKey": "${XAI_API_KEY}",
        "api": "openai-responses",
        "models": [{ "id": "gpt-5.3-codex", "name": "gpt-5.3-codex" }]
      }
    }
  }
}

Windows CMD（环境变量与配置文件路径）

set XAI_API_KEY=sk-Xvs...
mkdir "%USERPROFILE%\.openclaw" 2>nul
notepad "%USERPROFILE%\.openclaw\openclaw.json"

openclaw models status

Windows PowerShell（环境变量与配置文件路径）

$env:XAI_API_KEY="sk-Xvs..."
New-Item -ItemType Directory -Path "$env:USERPROFILE\.openclaw" -Force | Out-Null
notepad "$env:USERPROFILE\.openclaw\openclaw.json"

openclaw models status

验证命令：openclaw models status

𝐗𝐀𝐈 𝐗𝐀𝐏𝐈

激活邮件已发送！

模型费用分布

模型调用分布

模型服务使用详情

每日趋势统计

账户额度查询

查询结果

🌐 支持的 AI 服务提供商

🧭 系统工作流程

统一接入

智能路由

多模型输出

💻 SDK 示例代码

OpenAI SDK 示例

Anthropic SDK 示例

🧪 cURL 调用示例

OpenAI /chat/completions

Anthropic /messages

创建新的子账户

API 调用示例

cURL

Python

JavaScript

向子账户充值/扣款

API 调用示例

cURL

Python

JavaScript

账户充值

微信支付

当前订单

技术支持

充值历史

配置说明

Codex CLI / Codex App

方案 A：wire_api = "responses"（推荐 Codex 模型）

方案 B：wire_api = "chat"（适配 OpenAI Chat 形态模型）

Windows CMD（启动与校验）

Windows PowerShell（启动与校验）

Claude Code（gpt-5.3-codex）

环境变量配置（Linux / macOS）

环境变量配置（Windows CMD）

环境变量配置（Windows PowerShell）

OpenCode（Responses: gpt-5.3-codex / Chat: MiniMax-M2.5）

方案 A（Responses API）配置文件（Linux / macOS）

方案 A（Responses API）配置文件（Windows）

方案 B（Chat API）配置文件（Linux / macOS）

方案 B（Chat API）配置文件（Windows）

请求示例 A：Responses API（gpt-5.3-codex）

请求示例 B：Chat API（MiniMax-M2.5）

OpenClaw

方式 1：OpenAI Chat API 兼容（api = "openai-completions"）

方式 2：Claude API 兼容（api = "anthropic-messages"）

方式 3：OpenAI Responses API 兼容（api = "openai-responses"）

Windows CMD（环境变量与配置文件路径）

Windows PowerShell（环境变量与配置文件路径）

查看子账户信息

API 调用示例

cURL

Python

JavaScript

更新子账户信息

基本信息

限额设置

速率限制

模型级限制

管控属性

API 调用示例

cURL

Python

JavaScript

子账户列表

暂无子账户

删除子账户

API 调用示例

cURL

Python

JavaScript

洞察子账户