Claude Code 接入指南
聚模平台提供 Anthropic Messages API 兼容接口(/v1/messages), 可直接用于 Claude Code。配置后即可用你自己的聚模 API Key, 在 Claude Code 中调用平台的文本对话、流式响应和 Tool Use(工具调用)能力, 让 Claude Code 读取文件、执行命令、修改代码成为可能。
能力说明
| 能力 | 说明 |
|---|---|
| 文本对话 | 支持多轮上下文对话(非流式) |
| 流式响应 | SSE 流式逐字输出 |
| Tool Use / 工具调用 | 支持 Claude Code 的 Read / Edit / Bash / Glob / Grep 等工具连续往返执行任务 |
Tool Use 需要模型支持工具调用。 请优先选择下方推荐的支持工具的模型;纯文本模型在 Claude Code 中只能进行普通对话。
推荐模型
以下模型支持工具调用,适合 Claude Code 进行代码开发(均可直接用于 ANTHROPIC_MODEL):
| 模型 | 说明 |
|---|---|
| deepseek-v4-flash | DeepSeek 高性价比 · 支持工具调用 · 推荐 |
| qwen3-coder-plus | Qwen 代码模型 · 面向软件开发 / Agent · 推荐 |
| qwen3.7-plus | 阿里新一代旗舰 · 通用与代码 |
| deepseek-v4-pro | DeepSeek 旗舰 · 复杂推理与代码 |
| ZHIPU/GLM-5.3 | 智谱高能力 · Coding / Agent |
配置方式
Claude Code 通过三个环境变量连接到平台,无需安装额外组件。 打开(或新建)配置文件 ~/.claude/settings.json,在 env 中填写即可。
Base URL
ANTHROPIC_BASE_URL 指向聚模平台的域名根地址(不要带 /v1/messages 后缀):
| 环境 | 取值 |
|---|---|
| 线上 | https://api.hejushuzi.com |
API Key
ANTHROPIC_AUTH_TOKEN 填写你控制台创建的聚模平台 API Key (即 sk-... 开头的令牌),平台会以 x-api-key 或 Authorization: Bearer 读取它进行鉴权、额度与余额扣费。
模型
ANTHROPIC_MODEL 填写要使用的平台模型名(见上方推荐模型)。 例如 deepseek-v4-flash 或 qwen3-coder-plus。
完整配置示例
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.hejushuzi.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的聚模APIKey",
"ANTHROPIC_MODEL": "deepseek-v4-flash"
}
} 修改 settings.json 后需重启 Claude Code 才会生效。 若不了解 API Key 如何获取,请先阅读 API Key 身份认证。 验证是否连通
配置完成后,在项目目录下启动 Claude Code:
claude
输入一句示例问题确认联通:
列出当前目录下的所有文件,并读取 README.md 的摘要
若返回了文件列表并正常读取文件,说明已成功接入平台,且 Tool Use 工具调用工作正常。
使用场景
- ✔ 对话问答:直接提问,模型流式回答
- ✔ 读取文件:让 Claude Code 读取项目中的指定文件/目录
- ✔ 执行命令:让 Claude Code 运行构建、测试等命令
- ✔ 分析代码:定位 Bug、解释逻辑、给出重构建议
- ✔ 修改代码:让 Claude Code 编辑或新建文件
注意事项
- API Key 请妥善保管,不要提交到公开仓库。
- Tool Use 需使用支持工具调用的模型(见上表);纯文本模型下 Claude Code 仅能对话。
- 平台按实际用量计费,扣费明细可在控制台「用量与账单」查看。
- 流式与工具调用均会产生 Token 用量,请确保账户余额充足。
