MaaS 产品文档

1 从现有安装迁移 ​

已安装 Claude Code 时，只需配置 Base URL、APIKEY 和模型映射。

bash
export ANTHROPIC_BASE_URL="https://maas-api.cn-huabei-1.xf-yun.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="<你的 APIKEY>"
export ANTHROPIC_MODEL="spark-x2.5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="spark-x2.5"
export CLAUDE_CODE_SUBAGENT_MODEL="spark-x2.5"
powershell
$env:ANTHROPIC_BASE_URL="https://maas-api.cn-huabei-1.xf-yun.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 APIKEY>"
$env:ANTHROPIC_MODEL="spark-x2.5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="spark-x2.5"
$env:CLAUDE_CODE_SUBAGENT_MODEL="spark-x2.5"

~/.claude/settings.json

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://maas-api.cn-huabei-1.xf-yun.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<你的 APIKEY>",
    "ANTHROPIC_MODEL": "spark-x2.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "spark-x2.5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "spark-x2.5"
  }
}

2 从零安装 ​

  1. 安装 Claude Code

npm

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

验证安装

bash
claude --version
  1. 配置环境变量

使用上方任一种配置方式。ANTHROPIC_BASE_URL 填写 Anthropic 协议 Base URL，Claude Code 会自动请求 /v1/messages。

  1. 启动

启动

bash
cd /path/to/your/project
claude

接入验证

检查项说明
基础问答验证正文与流式事件
工具调用验证 tool_use / tool_result 循环
长任务验证长时间请求与上下文处理
子 Agent验证模型映射变量是否生效