Claude Code、Codex、OpenCode、OpenClaw 国内怎么接？这里直接给你可复制配置 How do you connect Claude Code, Codex, OpenCode, or OpenClaw? This page gives you copy-ready configuration blocks.

三步快速上手 Three-step Quick Start

统一前置条件 Shared Prerequisites

本页所有示例都基于同一条接入链路和同一个 key 变量名： Every example on this page uses the same gateway and the same API key variable:

• Gateway：https://api.xai-router.com Gateway: https://api.xai-router.com
• 环境变量：XX_API_KEY Environment variable: XX_API_KEY

Codex CLI / Codex App

Codex 最常见的搜索问题是“base_url 怎么换、wire_api 该写什么、环境变量怎么放”。这里直接给你能跑的配置。 The most common Codex questions are how to replace base_url, what wire_api should be, and where the environment variable belongs. The snippet below is the direct working configuration.

配置文件路径：Linux / macOS 用 ~/.codex/config.toml，Windows 用 %USERPROFILE%\.codex\config.toml。 Config file path: use ~/.codex/config.toml on Linux / macOS and %USERPROFILE%\.codex\config.toml on Windows.

model_provider = "xai"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
model_reasoning_summary = "none"
model_verbosity = "medium"
approval_policy = "never"
sandbox_mode = "danger-full-access"

[model_providers.xai]
name = "OpenAI"
base_url = "https://api.xai-router.com"
wire_api = "responses"
requires_openai_auth = false
env_key = "XX_API_KEY"

echo 'export XX_API_KEY="sk-..."' >> ~/.bashrc
source ~/.bashrc

codex

echo 'export XX_API_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

codex

setx XX_API_KEY "sk-..."

:: Reopen CMD, then run
codex

[Environment]::SetEnvironmentVariable("XX_API_KEY", "sk-...", "User")

# Reopen PowerShell, then run
codex

Claude Code

Claude Code 在这个站点上的核心思路是：继续使用它熟悉的 Anthropic 兼容变量名，但把请求映射到 XAI Router 的 GPT 链路上。 For Claude Code, the practical pattern is to keep using Anthropic-compatible environment variables while routing traffic to the XAI Router GPT stack underneath.

顺序上，先设置环境变量，再运行 claude。 Set the environment variables first, then launch claude.

export XX_API_KEY="sk-..."
export ANTHROPIC_AUTH_TOKEN="$XX_API_KEY"
export ANTHROPIC_BASE_URL="https://api.xai-router.com"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

claude

set XX_API_KEY=sk-...
set ANTHROPIC_AUTH_TOKEN=%XX_API_KEY%
set ANTHROPIC_BASE_URL=https://api.xai-router.com
set ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6
set ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
set ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

claude

$env:XX_API_KEY="sk-..."
$env:ANTHROPIC_AUTH_TOKEN=$env:XX_API_KEY
$env:ANTHROPIC_BASE_URL="https://api.xai-router.com"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

claude

OpenCode

OpenCode 更适合“我就想把工具跑起来”的用户，所以这里给你两套配置： Responses API 推荐配置 和 Chat API 兼容兜底配置。 OpenCode is often used by people who simply want the tool to run, so this page gives you both a recommended Responses API profile and a Chat API-compatible fallback profile.

全局配置文件路径：Linux / macOS 用 ~/.config/opencode/opencode.jsonc，Windows 用 %USERPROFILE%\.config\opencode\opencode.jsonc。 Global config file path: use ~/.config/opencode/opencode.jsonc on Linux / macOS and %USERPROFILE%\.config\opencode\opencode.jsonc on Windows.

方案 A：Responses API Profile A: Responses API

{
  "$schema": "https://opencode.ai/config.json",
  "model": "openai/gpt-5.5",
  "small_model": "openai/gpt-5.4-mini",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://api.xai-router.com/v1",
        "apiKey": "{env:XX_API_KEY}"
      }
    }
  }
}

方案 B：Chat API 兼容兜底 Profile B: Chat API-compatible fallback

{
  "$schema": "https://opencode.ai/config.json",
  "model": "xai-router-chat/gpt-5.4-mini",
  "small_model": "xai-router-chat/gpt-5.4-mini",
  "provider": {
    "xai-router-chat": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.xai-router.com/v1",
        "apiKey": "{env:XX_API_KEY}"
      },
      "models": {
        "gpt-5.4-mini": {}
      }
    }
  }
}

export XX_API_KEY="sk-..."
opencode debug config
opencode run "hello"

set XX_API_KEY=sk-...
opencode debug config
opencode run "hello"

$env:XX_API_KEY="sk-..."
opencode debug config
opencode run "hello"

OpenClaw

OpenClaw 支持走 Responses API 或 Chat API。推荐优先用 api = "openai-responses"，如果你需要兼容路径，再退到 Chat API。 OpenClaw can be configured against either the OpenAI Responses API or the OpenAI Chat API. Prefer api = "openai-responses" first, and only fall back to Chat compatibility when needed.

配置文件路径：Linux / macOS 用 ~/.openclaw/openclaw.json，Windows 用 %USERPROFILE%\.openclaw\openclaw.json。 Config file path: use ~/.openclaw/openclaw.json on Linux / macOS and %USERPROFILE%\.openclaw\openclaw.json on Windows.

模式 1：Responses API（推荐） Mode 1: Responses API compatible (recommended)

{
  "agents": {
    "defaults": {
      "model": { "primary": "xai-router/gpt-5.5" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "xai-router": {
        "baseUrl": "https://api.xai-router.com/v1",
        "apiKey": "${XX_API_KEY}",
        "api": "openai-responses",
        "models": [{ "id": "gpt-5.5", "name": "gpt-5.5" }]
      }
    }
  }
}

模式 2：Chat API 兼容 Mode 2: OpenAI Chat API compatible

{
  "agents": {
    "defaults": {
      "model": { "primary": "xai-router/gpt-5.4-mini" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "xai-router": {
        "baseUrl": "https://api.xai-router.com/v1",
        "apiKey": "${XX_API_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.4-mini", "name": "gpt-5.4-mini" }]
      }
    }
  }
}

export XX_API_KEY="sk-..."
openclaw models status

set XX_API_KEY=sk-...
openclaw models status

$env:XX_API_KEY="sk-..."
openclaw models status

常见问题与避坑 FAQ and Common Pitfalls

下一步去哪里 Where to go next