Claude Code 通过 Anthropic 协议接入云智 Token Hub。云智的 Anthropic 兼容端点为根端点 https://maas.piteyun.com（Claude Code 自动拼接 /v1/messages），与 OpenAI 兼容端点共用同一枚 API Key。
POST /v1/messages 返回标准 Anthropic message 格式（未包裹）；流式为标准 SSE：message_start → thinking block → text block → message_delta / message_stop。推理模型（glm-5.3 等）的推理过程经 thinking block 流出，Claude Code 可直接处理。
按官方方式安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash claude --version
Windows PowerShell 使用 irm https://claude.ai/install.ps1 | iex；CMD 使用 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd。npm 备用方式需要 Node.js 22+，且不要使用 sudo npm install -g。若提示 command not found，把安装目录加入 PATH：export PATH="$HOME/.local/bin:$PATH"。
准备 API Key
在控制台创建并复制一枚密钥（详见密钥管理与安全），然后在主菜单选择 输入 API Key 粘贴，等待 /v1/models 验证显示 设置成功。
配置四个模型角色
在 Helper 主菜单依次选择 配置编码工具 → Claude Code → 配置模型 - (选择 Haiku/Sonnet/Opus/Fable 模型)，从实时列表逐项选择。推荐映射：
| Claude Code 角色 | 推荐模型 | 说明 |
|---|---|---|
| Haiku | glm-5.3-flash | 快速、轻量（输入 ¥0.8/1m） |
| Sonnet | glm-5.3 | 日常主力，编码/推理 |
| Opus | kimi-k2.7 | 复杂任务、长上下文 |
| Fable | qwen3.7-max | 长程规划、通义旗舰 |
提示 是否立即将配置应用到 Claude Code? (Y/n) 时回车接受 Yes。
写入位置
Helper 会把配置写入用户级 ~/.claude/settings.json 的 env（ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL、ANTHROPIC_SMALL_FAST_MODEL 与 ANTHROPIC_DEFAULT_HAIKU/SONNET/OPUS/FABLE_MODEL），并在 ~/.claude.json 标记 hasCompletedOnboarding。已有字段全部保留。
ANTHROPIC_BASE_URL 写成 https://maas.piteyun.com/v1 会请求到不存在的 /v1/v1/messages，报 403 或"不可访问路径"。Helper 会自动规范化为根端点。
验证真实请求
- 在新的空目录运行
claude，出现目录信任提示时只确认该空目录。 - 执行
/status：确认 base URL 为https://maas.piteyun.com，认证来源为ANTHROPIC_AUTH_TOKEN。 - 发送：只回复"配置成功"，不要创建、修改或删除任何文件。
- 收到回复后
/exit退出，确认目录仍为空。
常见问题
仍然打开 Anthropic 登录页
说明配置未生效。运行 Helper → 配置编码工具 → Claude Code → 配置装载/配置刷新，完全退出并重启 Claude Code 再 /status。不要用网页登录绕过网关。
想恢复官方登录
Helper → Claude Code 管理菜单 → 清除网关配置，会移除 settings.json 中所有 ANTHROPIC_* 环境变量。
Fable 角色不生效
Fable 是 Claude Code 2.1.x 的新槽位，旧版本会忽略 ANTHROPIC_DEFAULT_FABLE_MODEL 但不报错。升级 Claude Code 后运行 /status 核对。