ZCode 配置教程：接入 NextHub API

ZCode 是智谱推出的智能体开发环境（ADE），支持添加任何兼容 Anthropic / OpenAI 协议的模型服务作为自定义供应商。配置好 NextHub 后，可以在 ZCode 里直接使用 Claude 与 GPT 模型。

接入步骤

1. 安装 ZCode

前往 ZCode 官网 下载 Windows / macOS / Linux 安装包并完成安装。首次启动的欢迎页可以跳过账号连接，直接进入主界面。

2. 进入模型设置

点击输入框的模型名称 → 管理模型（或从设置进入 模型设置 面板），在左侧供应商列表底部点击 添加供应商。

3. 填写供应商信息（Claude 渠道）

字段	填写内容
名称	NextHub
接口协议	Anthropic
接口地址（Base URL）	https://api.nexthub.cc
API Key	你的 NextHub ApiKey（Claude 系分组）

Base URL 不要带 /v1

Anthropic 协议的接口地址与 Claude Code 的 ANTHROPIC_BASE_URL 同口径：填裸域 https://api.nexthub.cc，末尾不要加 /v1，Messages 接口路径由 ZCode 自动拼接。

4. 添加模型并启用

点击 添加模型，手动填写该服务支持的模型 ID，例如 claude-opus-5-5、claude-fable-5（完整清单见渠道与模型，以模型广场实时数据为准）。保存后打开供应商的启用开关。

5. 验证

回到对话框，在模型选择器里选中刚添加的模型，发送一条消息，能收到回复即接入成功。

也可以接入 GPT 渠道

再添加一个供应商：接口协议选 OpenAI，接口地址填 https://api.nexthub.cc/v1（带 /v1），API Key 用 GPT-Azure（0.47x）或 GPT-Pro（0.11x）分组的密钥，模型 ID 填 gpt-5.6、gpt-6-astra 等。两个供应商可以并存，随时在模型选择器里切换。

常见问题

ZCode 的供应商配置与终端环境变量是两套独立入口，互不同步。若连接一直转圈，优先检查接口地址是否多写了路径——OpenAI 协议下 ZCode 会自动拼接 /chat/completions，地址里带多余路径会 404；模型 ID 需与模型列表完全一致。