ZCode 自定义 API 教程：供应商管理、协议与桌面配置
按智谱 ZCode 官方模型文档添加兼容 OpenAI 或 Anthropic 的供应商，区分桌面配置与终端变量，核对模型 ID、推理参数、上下文和敏感配置文件。
内容复核中 官方配置已核对；本站接入未实测。 图解为本站原创示意，不是客户端运行截图。
查看教程占位服务地址
- 控制台
https://80321.cn- 创建 Key
https://80321.cn/keys- 钱包充值
https://80321.cn/wallet- 文档站
https://80321.cn/docs.html
以上服务地址仅为教程占位示例，不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。
本页目录
本页对应智谱的 ZCode 开发环境。2026 年 9 月 30 日读取的官方文档支持添加兼容 OpenAI、Anthropic 协议的自定义供应商。本文没有执行配置或发出真实模型请求，也不把某个终端 CLI 的登录状态当成桌面端已接通。
图中连线用于说明配置关系，不是接口测试结果。
从模型选择器进入管理
点击对话框中的模型名称，再点击列表底部“管理模型”，进入模型设置。左侧供应商列表底部提供“添加供应商”，用于输入自定义名称、地址和 Key。首次欢迎页的“使用 API Key”也是接入入口。
官方 FAQ 明确说明，终端环境变量与 ZCode 桌面模型设置是两套独立入口，不会自动同步。不要因为终端里已有一个变量，就省略桌面配置。
先确定供应商使用哪种协议
自定义供应商可以是公网服务、企业通道或内网自托管服务；应按实际协议填写对应的接口地址，再用“添加模型”输入服务支持的模型 ID，保存并开启供应商开关。
以下展示 OpenAI 兼容基础地址关系，地址只是占位；本站未提供可用的真实 API、Key 创建或充值服务。请勿用它直接测试。
供应商名称：教程测试通道
OpenAI 接口基础地址：https://80321.cn/v1
API Key：YOUR_API_KEY
模型 ID：YOUR_MODEL_ID如果实际通道只有 Anthropic Messages，改用其正式提供的 Anthropic 地址。编程套餐与通用 API 是不同通道，不能因域名相同就混用路径和额度。
新会话验证，能力逐项确认
在新会话选择刚添加的供应商与模型，先发一句短提示，然后在测试工作区验证只读文件任务。官方提醒图片支持会综合协议和模型配置判断；能力未知时可能由服务端报错，因此先不要发送图片。
上下文窗口应以真实服务限制为准。自定义模型窗口修改对新会话生效，套餐模型则可能由服务端重新下发，不能把显示值变化当成故障。
参数错误不靠手写未知字段解决
第三方部署接受的推理档位可能与同名官方模型不同。遇到 400 参数错误，先核对错误字段与服务支持档位。官方还说明供应商 options 只识别特定连接参数，手工加入任意请求体字段不会因此生效。
持续 Loading 时检查网络、账号权限和配额；不要先删除所有模型配置。若界面入口或字段与所读文档不同，记录版本并暂停，核对该版本说明。
备份和操作确认的边界
官方列出的 ~/.zcode/v2/config.json 包含供应商 Key、Base URL 和模型列表；设备加密登录凭据另有文件，不应混为一谈。
不要把整个配置目录贴到工单。密钥使用小范围权限并及时轮换；首次任务保留安全操作确认，文件写入、命令执行和提交代码分别审查，不把“模型能回复”当成放开电脑权限的理由。