ZCode
ZCode 是智谱 AI 推出的桌面 AI 编程工具，支持 Windows、macOS 和 Linux。ZCode 支持自定义 OpenAI 兼容供应商，配置后可以直接使用 ModelGo 的模型和 API Key。
接入前准备
- 已安装 ZCode 桌面客户端。
- 已在 ModelGo 控制台创建 API Key。
- 已在模型广场确认一个当前 API Key 可调用的逻辑模型名。
1. 安装 ZCode
访问 ZCode 官方下载页，根据操作系统下载对应安装包。ZCode 提供 macOS、Windows 和 Linux 版本，Linux 用户可以选择 .deb、.rpm 或 AppImage。
下载完成后，按系统提示完成安装并启动 ZCode。首次启动时可以选择工作区；完成引导后进入主界面。
2. 添加 ModelGo 供应商
在 ZCode 左下角点击设置图标，进入 Model settings，然后在供应商列表底部点击 Add provider。
填写以下配置：
| 配置项 | ModelGo 填写内容 |
|---|---|
| Name | ModelGo |
| Base URL | https://api.modelgo.com/v1 |
| API Key | 在 控制台 创建的 ModelGo API Key |
| API format | Chat completions (/chat/completions) |
| Model list | 点击 Add model，填写模型广场中的逻辑模型名 |
| Context window | 按模型实际上下文长度填写；不确定时可先填 200000 |
点击 Add provider 保存。配置时请注意：
3. 添加模型并开始对话
点击 Add model，输入一个 ModelGo 逻辑模型名并保存。可以按需添加多个模型。
回到对话界面，在模型下拉菜单中选择 ModelGo 和刚添加的模型，输入一条简单的任务，例如“用三句话介绍这个项目”。能够正常返回结果，即表示接入成功。
如需确认 API Key 可调用的模型，可以执行：
curl https://api.modelgo.com/v1/models \
-H "Authorization: Bearer $MODELGO_API_KEY"常见问题
返回 401 或提示认证失败
检查 API Key 是否复制完整、没有多余空格，并确认填写在 API Key 输入框中。
返回 403 或模型不可用
确认 Model list 中填写的是模型广场中的逻辑模型名，且当前 API Key 策略允许调用该模型。
返回 404 或接口路径错误
Base URL 应为 https://api.modelgo.com/v1，API format 请选择 Chat completions (/chat/completions)，不要把完整接口路径填入 Base URL。
模型列表为空或无法保存
确认至少添加了一个模型，并检查 Base URL 是否可以访问。必要时先用 GET https://api.modelgo.com/v1/models 验证 API Key 和接口。
相关文档
- 首次调用：获取 API Key、查询模型并验证 ModelGo 接口。
- 认证鉴权：了解 API Key 的安全使用方式。
- ZCode 安装文档：查看最新安装说明。
- ZCode 连接模型文档：查看自定义供应商和模型配置说明。