Claude Code

claude code

Claude Code 是 Anthropic 官方的终端编码助手。它支持自定义 API 端点与 Key,因此可以直接通过 XSI 使用 Anthropic Messages 协议。

安装

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

# macOS(Homebrew)
brew install --cask claude-code
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

安装后运行 claude doctor 检查版本与安装状态。

配置

export ANTHROPIC_BASE_URL="https://api.xsicontrol.com"   # 或你自己的 API 域名,不带 /v1
export ANTHROPIC_AUTH_TOKEN="sk-Xvs..."
claude
$env:ANTHROPIC_BASE_URL="https://api.xsicontrol.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-Xvs..."
claude

也可以写入 ~/.claude/settings.json,对所有终端生效:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.xsicontrol.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-Xvs..."
  }
}

指定模型

Claude Code 默认使用 Claude 系列模型。如需固定使用某个模型,或让它使用运营方配置的其他 Anthropic 兼容模型:

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"

模型名须在价格表中,且账号有权使用。运营方也可以在服务端用 MODEL_MAPPER 统一改写模型名,客户端无需修改。

验证

claude -p "请用一句话回答:连接正常"

用量可在账户管理控制台或 GET /dashboard/live 中查看。

说明

  • XSI 对 /v1/messages 启用粘性会话,同一会话固定到同一个上游 Key,提示缓存命中率更高。
  • 遇到 401 请检查 Key;403 通常是模型或 IP 白名单限制;429 为额度或限速,详见《错误码》。

相关资源