集成 · Claude Code

Claude Code 通过 Swarmix 已支持的 /v1/messages 指向上游 Anthropic-compatible 模型。

协议说明
Claude Code 原生走 Anthropic 的 /v1/messages 协议,不是 OpenAI 的 /v1/chat/completions。Swarmix 会在平台侧使用已配置的阿里 Token Plan / 火山 Coding Plan / 腾讯 TokenHub 上游 Key,客户侧只需要配置 Swarmix API Key。

配置环境变量

bash
# ~/.bashrc or ~/.zshrc
export ANTHROPIC_AUTH_TOKEN="sk-swx-xxxxxxxxxxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="http://router.swarmixtoken.com"

# 重新加载
source ~/.zshrc

安装 Claude Code

bash
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# 启动
claude

选择模型

Claude Code 启动后会请求 /v1/messages。模型名必须是 Swarmix 已上架、 且后台配置到 Anthropic-compatible 上游的模型。

text
推荐先确认:
1. Console 模型页是否有你要使用的模型
2. GET /v1/models 是否返回对应模型 ID
3. 管理端该模型的 provider 是否指向 Token Plan / Coding Plan / TokenHub 的 Anthropic 端点

你可以在 /model 里直接写 Swarmix 模型列表中的模型名。也可以在 模型页查看当前可用模型。

在 Claude Code 中切换模型

bash
/model aliyun/qwen-max # 直接切到 Swarmix 公开模型 ID
/model qwen3-coder     # 切到后台已映射到 Anthropic-compatible 上游的模型

计费说明

使用量通过 Swarmix 钱包结算(不走 Anthropic 账户)。在 Console → 用量 & 日志 查看 Claude Code 产生的请求。

Claude Code 会产生大量高上下文请求(读整个项目)。建议:
  • 给它开一把独立 Key
  • 设 daily budget 阈值,防止意外暴走
  • 优先用 aliyun/deepseek-r1 等便宜模型