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-flashDeepSeek 高性价比 · 支持工具调用 · 推荐
qwen3-coder-plusQwen 代码模型 · 面向软件开发 / Agent · 推荐
qwen3.7-plus阿里新一代旗舰 · 通用与代码
deepseek-v4-proDeepSeek 旗舰 · 复杂推理与代码
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 用量,请确保账户余额充足。