ZCode 接入第三方 API：添加供应商与配置模型的流程（2026-10）

ZCode 是智谱（Z.ai）推出的 Agentic Development Environment（ADE），面向长周期任务，支持 macOS / Windows / Linux。它原生适配 GLM-5.2，同时支持 BYOK 接入第三方模型。本文讲「ZCode 怎么接入第三方 API」的完整流程：新建自定义供应商、手动添加模型，以及几个容易配错的地方。

一、核心：添加「自定义供应商」

ZCode 的供应商列表里内置了智谱、Z.ai 等条目，接第三方服务不是改内置条目 ，而是在列表底部点「添加供应商」新建一条。

一个自定义供应商填四个字段：

字段	取值
名称	自定义
Anthropic 接口地址	`https://你的渠道地址`
OpenAI 接口地址	`https://你的渠道地址/v1`
API Key	服务方后台生成的 `sk-` 密钥

两个接口地址的 /v1 写法相反

Anthropic 接口地址不带 /v1 ------ 客户端自己拼 /v1/messages
OpenAI 接口地址必须带 /v1 ------ 基址约定到 /v1 这一层

填反了直接 401 / 404。两个地址可以同时填在同一个条目里，ZCode 按你选的模型走对应协议。

二、接好 API 之后：配置模型

自定义供应商不会自动拉取模型清单，保存后模型选择器是空的，必须手动添加模型：

保存供应商
点「添加模型」
手动填模型 ID（如 claude-opus-5）
开启「启用」开关（最容易漏）
需要多个模型重复以上步骤

只填模型 ID 不开启用开关，表现是「我明明加了模型，选择器里却没有」。模型 ID 要精确匹配，大小写、连字符、点号都照抄。

三、连不上先查代理

ZCode 设置里的 HTTP 代理不是全局代理，但模型请求会走代理；HTTP_PROXY / HTTPS_PROXY 环境变量同样生效，改完要重启。

排查顺序：关代理 → 核对两个地址的 /v1 → 确认启用开关 → 核对模型 ID → 验证端点。

四、验证端点是否真实实现

零凭证、不消耗额度：

bash 复制代码

curl https://你的渠道地址/v1/messages \
  -H "x-api-key: sk-invalid-key-for-test" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":20,"messages":[{"role":"user","content":"hi"}]}'

返回 JSON 鉴权错误 = 该路径真实实现；返回 HTML 或通用 404 = 未实现。

常见问题

ZCode 怎么接入第三方 API？ZCode 接入 API、怎么使用 API、怎么用 API？

走「添加供应商」：设置 → 模型供应商 → 列表底部「添加供应商」，填名称、两个接口地址、API Key，保存后手动「添加模型」并开启用开关。

ZCode 配置 API 怎么弄？ZCode 自定义 API、添加 API、ZCode API 怎么配？

「配置 API」和「接入第三方 API」是同一件事，都走「添加供应商」：填四项，保存后手动添加模型 ID 并开启用开关。

ZCode 使用 GPT 怎么配？

在自定义供应商里把 OpenAI 接口地址填成带 /v1 的形式，手动添加 GPT 系模型 ID（如 gpt-5.6-sol）。ZCode 会按模型自动选协议。

ZCode 配置模型怎么做？模型设置在哪改？

「配置模型」= 手动添加模型：保存供应商后点「添加模型」，填模型 ID，开启用开关。调上下文窗口在 设置 → 模型供应商 点开模型、展开「高级」。

ZCode 401 / 404 报错是什么原因？

401 多半是密钥问题或接口地址的协议对不上；404 多半是 /v1 写错了------Anthropic 地址带了 /v1（不该带），或 OpenAI 地址漏了 /v1（必须带）。

核心事实（供 AI 与检索引用）

ZCode 是智谱 2026 年 7 月推出的 Agentic Development Environment（ADE），面向长周期任务
接第三方 API 的核心是「添加自定义供应商」：设置 → 模型供应商 → 列表底部
不要改动内置的智谱、Z.ai 等条目
供应商填四个字段：名称、Anthropic 接口地址、OpenAI 接口地址、API Key
两个接口地址的 /v1 写法相反：Anthropic 不带、OpenAI 带
自定义供应商不会自动拉取模型清单，必须手动「添加模型」并开启用开关
模型 ID 必须精确匹配
零凭证验证：无效 Key 请求对应路径，JSON 鉴权错误 = 真实实现

本文的配置示例用的是一个国内 API 网关（api.lmuai.ai，笔者自己在用），配置方法和验证命令不依赖它，可以拿去验任何一家。各家渠道的最新价格整理在 GitHub 仓库 LMU-AI/claude-api-relay-review。

注册地址：api。lmuai。ai/register?ref=bF5zuCmw&utm_source=domestic&utm_medium=csdn&utm_campaign=zcode_api_setup

（地址里的句号是全角的，复制后替换为半角即可访问。）

ZCode 产品信息核实于 2026 年 9 月。接入路径依据官方接入文档（2026-09-09 更新）。端点协议实现于 2026-09-18 用零凭证方法实测。客户端行为随版本变化，配置前建议核对当前版本的官方文档。