𝐗𝐀𝐈 𝐗𝐀𝐏𝐈

无需购买海外服务器, 无需搭建代理, 手把手教你通过 XAI Control 分发 Claude Code Max/Pro

Posted August 31, 2025 by XAI 技术团队 ‐ 9 min read

Claude Code 是 Anthropic 推出的一款强大的终端 AI 编码助手。通常，使用它需要官方订阅，但其开放的 API 端点配置为我们提供了更灵活的解决方案：在线注册 XAI Control 即刻拥有一个自己专属的中转服务，使用您自己的 Claude Code 账号来驱动它。

本指南将引导您完成整个过程，让您在享受 Claude Code 强大功能的同时，获得 XAI Control 带来的密钥安全管理、成本控制和统一入口等优势。

先决条件

在开始之前，请确保您已具备：

  1. 一个 Anthropic 官方 Claude Code Pro/Max 账号。
  2. 一个 XAI Control 账户：如果还没有，请访问 a.xaicontrol.com 免费注册, 并务必阅读使用说明 xaixapi.com/docs/products/xai-control。
  3. 本地已安装 Node.js 环境：如果尚未安装，请参考 步骤一。

步骤一：安装 Node.js 环境

Claude Code 是一个基于 Node.js 的命令行工具，因此需要先安装其运行环境。

MacOS 安装方法

方法一：使用 Homebrew（推荐）

# 更新 Homebrew
brew update
# 安装 Node.js
brew install node

方法二：官网下载

  1. 访问 https://nodejs.org/
  2. 下载适合 macOS 的 LTS (长期支持) 版本。
  3. 打开下载的 .pkg 文件，按照安装程序指引完成安装。

Windows 安装方法

方法一：官网下载（推荐）

  1. 访问 https://nodejs.org/
  2. 点击 "LTS" 版本进行下载。
  3. 下载完成后双击 .msi 文件，按照安装向导完成安装，保持默认设置即可。

方法二：使用包管理器 如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

# 使用 Chocolatey
choco install nodejs
# 或使用 Scoop
scoop install nodejs

验证安装是否成功

安装完成后，打开终端 (Terminal 或 PowerShell)，输入以下命令：

node --version
npm --version

如果能正确显示版本号，说明 Node.js 环境已准备就绪。

步骤二：安装 Claude Code CLI

现在，我们可以安装 Claude Code 命令行工具了。

MacOS 安装

打开 Terminal，运行以下命令：

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

如果遇到权限问题，可以尝试在命令前加上 sudo：

sudo npm install -g @anthropic-ai/claude-code

Windows 安装

打开 PowerShell (建议以管理员身份运行)，运行以下命令：

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

验证安装

安装完成后，输入以下命令检查是否安装成功：

claude --version

如果显示版本号，恭喜你！Claude Code 工具已经成功安装。

步骤三：获取 CLAUDE_CODE_OAUTH_TOKEN

这个令牌是您 Claude 账号的授权凭证。

  1. 在终端中执行以下命令，它会生成一个授权链接：
    claude setup-token
  2. 复制 https://claude.ai/oauth/authorize?... 链接，在浏览器中打开。
  3. 登录并点击 Authorize 授权。
  4. 浏览器会跳转并显示一个 Authentication Code，复制它。
  5. 回到终端，将复制的代码粘贴进去并按回车。
  6. 终端会生成一个以 sk-ant-oat01 开头的字符串，这就是我们需要的 CLAUDE_CODE_OAUTH_TOKEN。请妥善保管。

步骤四：在 XAI Control 中配置模型服务商

接下来，我们将 CLAUDE_CODE_OAUTH_TOKEN 安全地添加到 XAI Control，让它成为您的密钥代理。

  1. 登录您的 XAI Control 账户：a.xaicontrol.com。
  2. 导航至 「模型服务商」 菜单，然后点击 「新增 Provider Key」。
  3. 在表单中填写以下信息：
    • Name (可选): My-Claude-Code-Token (或任何您喜欢的名称，便于识别)。
    • Level: 1 (或任何正整数，用于分组)。
    • Provider: http://172.31.88.86:7789 (这是我们提供的多租户 Claude Code 转换服务)。
    • SecretKey: 填入您在 步骤三 获取到的 sk-ant-oat01... 令牌。
  4. 点击 「添加 Provider Key」。

步骤五：配置本地环境变量

这是最关键的一步。我们需要告诉本地的 claude 命令使用 XAI Control 的服务地址和您的 XAI API Key。

重要提示

  • 当您注册 XAI Control 成功后，系统会发送一封主题为 「Welcome to XAI - Your Account is Ready!」 的邮件到您的注册邮箱，其中包含了您的专属 XAI API Key。
  • 接下来配置的 ANTHROPIC_AUTH_TOKEN 必须是您的 XAI API Key，而不是上一步获取的 CLAUDE_CODE_OAUTH_TOKEN。

MacOS 配置

方法一：临时设置（仅当前终端会话有效）

export ANTHROPIC_BASE_URL="https://api.xaicontrol.com"
export ANTHROPIC_AUTH_TOKEN="你的 XAI API Key"

方法二：永久设置（推荐）

# 对于 zsh (macOS 默认)
echo 'export ANTHROPIC_BASE_URL="https://api.xaicontrol.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的 XAI API Key"' >> ~/.zshrc
source ~/.zshrc

# 对于 bash
echo 'export ANTHROPIC_BASE_URL="https://api.xaicontrol.com"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的 XAI API Key"' >> ~/.bash_profile
source ~/.bash_profile

Windows 配置

方法一：PowerShell 临时设置（仅当前窗口有效）

$env:ANTHROPIC_BASE_URL = "https://api.xaicontrol.com"
$env:ANTHROPIC_AUTH_TOKEN = "你的 XAI API Key"

方法二：PowerShell 永久设置（用户级）

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.xaicontrol.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的 XAI API Key", [System.EnvironmentVariableTarget]::User)

注意：设置后需要 重新打开一个新的 PowerShell 窗口 才能生效。

步骤六：开始使用！

🎉 恭喜！所有配置均已完成。现在您可以像使用官方服务一样在终端中与 Claude Code 交互了。

示例 1：直接提问

claude "用 Go 语言写一个简单的 HTTP 文件服务器"

示例 2：解释现有代码

cat main.go | claude "解释这段 Go 代码的逻辑"

示例 3：进入交互模式

claude

> How can I help you today?
> write a dockerfile for a node.js app

现在，所有通过 claude 命令发出的请求，都会经由 api.xaicontrol.com 智能路由到您在 XAI Control 中配置的 Claude 令牌，所有用量都可以在 XAI Control 后台 m.xaicontrol.com 清晰地看到。

为什么选择这种方式？

  • 统一管理：在 XAI Control 配置管理 a.xaicontrol.com 统一管理您的 OpenAI, Anthropic, Gemini 等所有模型密钥。
  • 分配账户：在 XAI Control 用户管理 m.xaicontrol.com 分配管理您的AI资源给子用户。
  • 安全可靠：您的原始令牌不暴露在本地环境中，全程零信任加密存储，杜绝泄露风险。
  • 成本与权限控制：可以利用 XAI Control 强大的子账户体系，为团队成员或不同项目创建独立的 Key，并精细化控制其额度、模型访问权限和速率限制。
  • 高可用性：享受 XAI Control 提供的故障切换、密钥轮换等企业级功能，确保服务稳定。