AI 工具接入指南

聚模平台同时提供 OpenAI 兼容接口（/v1/chat/completions）与 Anthropic 兼容接口（/v1/messages），因此 Cursor、Trae、Claude Code、Cline、Continue、Codex 等主流 AI 编程工具都能通过一个 API Key 统一接入平台，并在这些工具中调用多家主流 AI 模型。

通用接入信息

接入任一 AI 工具只需要 3 项信息：

配置项	取值	说明
Base URL（OpenAI 兼容）	`https://api.hejushuzi.com/v1`	用于 Cursor、Trae、Cline、Continue、Codex 等 OpenAI 兼容工具
Base URL（Anthropic 兼容）	`https://api.hejushuzi.com`	用于 Claude Code 等 Anthropic 兼容工具
API Key	`sk-xxxxxxxx`	在控制台「API Key」创建，用于鉴权、额度与余额扣费
模型	如 `deepseek-v4-flash`	填写平台模型名（见控制台模型列表）

工具选择模型时，请优先选择支持 Tool Calling 的模型（如 deepseek-v4-flash、qwen3-coder-plus），才能让 AI 编程工具正常进行「读文件 / 执行命令 / 改代码」等工具调用。

Base URL 只需配置到 /v1 根地址，工具会自动在末尾拼接具体接口路径（如 /chat/completions、/models）。无需（也不应）手动补全为完整接口地址，否则会重复拼接导致请求失败。

Cursor

Cursor 使用 OpenAI 兼容接口。在 Cursor 的模型设置（Settings → Models）中启用或新增一个使用自定义 Base URL 的 Provider，填写：

配置项	取值
Base URL	`https://api.hejushuzi.com/v1`
API Key	`sk-你的平台APIKey`
模型	`deepseek-v4-flash` 或 `qwen3-coder-plus` 等

Trae

Trae 支持 OpenAI 兼容接口。在 Trae 的模型配置中选择自定义 / OpenAI 兼容供应商，同样填写上面的 Base URL、API Key 与模型名即可。Trae 也可通过 Anthropic 兼容地址接入，方式与 Claude Code 一致。

Claude Code

Claude Code 使用 Anthropic 兼容接口，通过环境变量配置：

环境变量	取值
`ANTHROPIC_BASE_URL`	`https://api.hejushuzi.com`
`ANTHROPIC_AUTH_TOKEN`	`sk-你的平台APIKey`
`ANTHROPIC_MODEL`	`deepseek-v4-flash` 等

完整配置与示例见 Claude Code 接入页面。

其他 OpenAI 兼容工具

Cline、Continue、Codex 等支持 OpenAI 兼容 API 的工具，按各自工具的「自定义供应商 / OpenAI Base URL / Anthropic Base URL」配置，填入对应地址、API Key 与模型名即可。一个 API Key 即可复用，无需分别为每家工具创建密钥。

快速连通测试

配置前可先用 curl 验证平台接口是否可被 OpenAI 兼容客户端识别：

curl -X POST "https://api.hejushuzi.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-你的平台APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [ { "role": "user", "content": "你好" } ]
  }'

返回形如（不含 usage）：

{
  "id": "chatcmpl-xxxx",
  "object": "chat.completion",
  "created": 1710000000,
  "model": "deepseek-v4-flash",
  "choices": [
    { "index": 0, "message": { "role": "assistant", "content": "你好！..." }, "finish_reason": "stop" }
  ]
}

也可用 OpenAI SDK：

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的平台APIKey",
    base_url="https://api.hejushuzi.com/v1",   # OpenAI 兼容
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

注意事项

请妥善保管 API Key，不要提交到公开仓库。
Tool Calling 需选择支持工具调用的模型；纯文本模型下 AI 编程工具只能进行普通对话。
平台按实际用量计费，扣费明细可在控制台「用量与账单」查看；API 对外响应不返回 usage。
请确保账户余额充足，余额不足时接口返回 402。