Zcode 配置方法
Zcode 是智谱推出的 AI 编程客户端。除内置的 BigModel 服务外,Zcode 支持通过自定义 Provider 接入兼容 OpenAI 协议的模型服务。
1. 添加 wylon Provider
- 点击客户端左下角的设置按钮(齿轮图标)。
- 在左侧 Basics → Model settings 进入模型设置页。
- 在 Providers 面板的 Custom providers 分组下,点击「+ Add provider」。
填写 Provider 信息
在「Add model provider」表单中填写以下配置。
| 界面字段 | 填写内容 |
|---|---|
| Name | wylon-cloud,仅作为显示名称,也可以自行命名 |
| Base URL | https://api.wylon.cn/v1 |
| API key | <你的_wylon_API-Key> |
| API format | Chat completions (/chat/completions) |
Base URL 与 API format
Base URL 填写到 /v1 为止。
https://api.wylon.cn/v1
API format 选择 Chat completions (/chat/completions),Zcode 会自行拼接请求路径。
warning
不要手动补全接口路径
Base URL 中不要填写
/chat/completions,否则可能形成重复路径并返回 404。
2. 添加模型
在 Model list 区域点击「+ Add model」,然后填写模型信息。
| 界面字段 | 填写内容 |
|---|---|
| Model ID | wylon 提供的模型 ID,例如 ZhipuAI/GLM-5.3 |
| Context window | 1000000 |
| Max output tokens | 128000 |
| Input types | 仅勾选 Text,Image 和 Video 保持不勾选 |
| Output types | Text,默认勾选且不可取消 |
Model ID
Model ID 会原样作为 model 参数发送给 wylon API,大小写和组织前缀必须与服务端一致。请从 模型广场复制,或通过 GET /v1/models 获取完整合法 ID。
Input types
Input types 需要根据模型的实际能力设置。例如,ZhipuAI/GLM-5.3 不是多模态模型,应只勾选 Text,不要勾选 Image 或 Video。
模型保存后回到 Provider 表单,点击右下角「Add provider」完成添加。
3. 验证配置
- 确认左侧 Custom providers 列表中已经出现
wylon-cloud。名称右侧的绿色圆点表示该 Provider 已启用。 - 返回对话界面,在模型选择器中选择该 Provider 下的
ZhipuAI/GLM-5.3。 - 发送一条简单消息确认链路连通。模型正常返回内容,即表示配置成功。
4. 更换或新增模型
- 访问 模型广场,或请求
GET https://api.wylon.cn/v1/models。 - 复制模型的完整模型 ID。
- 在 Model settings 中选中
wylon-cloudProvider。 - 在 Model list 中点击「+ Add model」新增模型,或编辑已有模型的 Model ID。
- 保留相同的 Base URL 和 API key,只替换 Model ID。
warning
模型列表不等于当前可调用范围
GET /v1/models 返回的列表中可能包含已下线或当前 API Key 无权访问的模型。添加前可以通过最小文本请求验证模型是否可用,测试调用会产生实际模型用量。