接入 Zcode

关于 ZCode

ZCode 是智谱的编程 Agent 客户端，支持在模型设置中添加 Anthropic 或 OpenAI 兼容的自定义提供商。

安装 ZCode

从 ZCode 官方安装页面下载并安装客户端。

配置基元律动API

登录或注册基元律动账号，完成实名认证后在用户中心创建并保存 API Key。从模型页复制支持工具调用和 Chat Completions 的模型 ID。

以下以 ZCode 中文桌面界面为例，使用 OpenAI 兼容的 Chat Completions 接口。

1. 创建自定义供应商

点击左下角的 齿轮图标，进入设置，在左侧选择 模型设置。点击右上角的 添加供应商，然后在 其他 区域选择 创建自定义供应商。

打开设置，进入“模型设置”，添加供应商并选择“创建自定义供应商”

2. 填写基元律动 API 配置

在新建的供应商页面填写以下配置，再点击 模型列表 右侧的 添加模型：

配置项	填写内容
Base URL	https://tokenrhythm.studio/v1
API 格式	OpenAI 兼容的 Chat Completions 格式
API Key	用户中心创建的 API Key

下图的 API 格式显示为 Anthropic Messages。按本教程接入时，请将这一项切换为 OpenAI 兼容的 Chat Completions 格式，其余字段按上表填写。

填写 Base URL 和 API Key，切换为教程指定的 API 格式后点击“添加模型”

3. 添加模型并保存

在 模型 ID 中填入从基元律动模型页复制的模型 ID。图中的 kimi-k3 仅作填写示例，请以当前实际可用的模型为准。

如果界面提示 已匹配到智能配置，先核对自动填入的 上下文窗口 和 最大输出 Token 是否符合所选模型的实际参数。需要手动填写时，按模型实际支持的数值设置，完成后点击 保存。

填写模型 ID，核对模型参数后点击“保存”

4. 启用并选择模型

回到供应商页面，确认模型已经出现在 模型列表 中，并打开供应商右上角的 启用开关。

点击 返回工作区，在聊天输入框的模型选择器中选中新添加的模型。开启新会话，输入“请只回复：接入成功”发送测试消息。收到正常回复后，可在基元律动用户中心查看对应调用记录。