Skip to main content
ZCode 是智谱推出的 AI 编程助手，支持通过自定义供应商接入兼容 OpenAI、Anthropic 协议的模型服务。对 HaiToken 来说，OpenAI 模式通常最稳、兼容性最好；如果你明确需要走 Claude / Anthropic 生态，也可以改用 Anthropic 模式。

​
先准备好这些信息

  • HaiToken API Key
  • HaiToken OpenAI 兼容地址：https://api.haitoken.ai/v1
  • HaiToken Claude / Anthropic 兼容地址：https://api.haitoken.ai
  • 至少一个可用模型 ID，例如 gpt-5.4
ZCode 的配置全程通过图形界面完成，Windows、macOS、Linux 的操作步骤基本一致。不同系统下若菜单位置或窗口样式略有差异，请以实际 UI 为准，但 API Key、Base URL 和模型 ID 的填写逻辑不变。

​
接入步骤

​
先选哪种协议

在 ZCode 中，常见有两种接法：
  • OpenAI：更推荐，兼容面更广，当前文档主流程也按这条路径来写
  • Anthropic：也很常用，适合你希望按 Claude / Messages 生态去接入的场景
如果你没有明确理由，建议优先选 OpenAI。

​
步骤 1：打开模型设置

在 ZCode 主界面左侧边栏，点击 模型设置 进入模型供应商管理页面。

​
步骤 2：添加自定义供应商

在模型设置页面的 自定义供应商 区域，点击 + 添加供应商 按钮，打开供应商配置表单。

​
步骤 3：填写 HaiToken 配置

在供应商配置表单中，按以下信息填写：
HaiToken 同时支持 OpenAI Chat Completions 和 OpenAI Responses 协议。如果 API 格式选择 OpenAI 后，Base URL 下方出现 /responses 后缀，表示 ZCode 将通过 POST /v1/responses 请求；该路径现已支持，可直接使用。仅当你明确需要 Chat Completions（POST /v1/chat/completions）时，再选择不含 /responses 的 OpenAI 选项。
如果你选择的是 Anthropic 模式，请不要把 Base URL 写成 https://api.haitoken.ai/v1。这一条路径应当填写 Anthropic 风格的网关前缀 https://api.haitoken.ai，由客户端去请求 /v1/messages。

​
步骤 4：添加模型

在 模型列表 区域，点击 + 添加模型，输入你要使用的 HaiToken 模型 ID，例如 gpt-5.4。可重复添加多个模型。

​
步骤 5：保存供应商

填写完成后，点击表单底部的 添加供应商 按钮保存配置。

​
步骤 6：测试连通性

保存后，在 ZCode 的对话或编码面板中切换到刚配置的 HaiToken 模型，发送一条简单消息（如 hello）验证连通性。

​
补充说明

如果你还需要配置温度、最大输出长度、系统提示词等高级参数，第一次接入时建议先保留默认值，优先确认连通性。

​
常见问题

​
下一步