API Key 配置

ZCode 当前支持三种接入模型服务的方式：

配置入口

方式一：首次启动欢迎页

首次打开 ZCode、还没有可用模型时，欢迎页面会直接提供接入选项：

• 连接 Z.ai 继续使用：通过 Z.ai 账号授权登录。
• 连接 BigModel 继续使用：通过智谱 BigModel 账号授权登录。
• 使用 API Key：直接填写 API Key，进入模型供应商配置。

选择「连接 Z.ai」或「连接 BigModel」后，应用会弹出授权窗口并等待平台完成认证，认证通过后即自动绑定账号：

方式二：模型选择器

进入 ZCode 后，点击对话框中的模型名称打开模型选择器，在列表底部点击「管理模型」，即可进入 设置 -> 模型设置 面板，管理 ZCode Agent 可用的模型通道。

智谱 / Z.ai API 端点说明

在 BigModel 或 Z.ai 供应商页面切换到 API Key 连接方式后，你会看到 Anthropic 接口地址 与 OpenAI 接口地址 两个字段。系统一共提供 三类端点（分属 Anthropic 协议 与 OpenAI 兼容协议 两套接口），请按账号类型选用，不要混用。

重要

• 使用 GLM Coding Plan 时，OpenAI 接口地址必须填 Coding 专用端点（/api/coding/paas/v4），不能填通用端点（/api/paas/v4）。
• Coding 端点仅限 Coding 场景，不适用于通用 API 调用；反之，通用端点也不能替代 Coding 端点消耗编程套餐额度。
• 若通过右上角 「编程套餐」 完成账号授权绑定（非 API Key 模式），ZCode 会自动走正确通道，无需手动填写上述地址。

快速对照：

• 已购 GLM Coding Plan，用 API Key 接入 → OpenAI 地址填 Coding 专用端点
• 使用开放平台资源包 / 余额，走 OpenAI 协议 → OpenAI 地址填 通用端点 .../api/paas/v4
• 使用开放平台资源包 / 余额，走 Anthropic 协议 → Anthropic 地址保持默认 .../api/anthropic（见下方 BigModel / Z.ai API Key 配置）

连接 BigModel

1. 通过上述任一方式进入 模型设置 面板
2. 在左侧供应商列表中选择「BigModel」
3. 完成账号连接并开启启用开关，即可按账号权限使用 GLM-5.2、GLM-5-Turbo 等内置模型
4. 右上角可切换连接方式：使用「编程套餐」绑定 GLM Coding Plan，或改用 API Key 接入

免费体验额度

新用户连接 BigModel 账号即可享受 体验套餐：无需付费，每天提供免费的 GLM 旗舰模型体验额度。供应商页面会实时展示今日余额和已用量，先体验、再决定是否升级。

在 ZCode 内订购编程套餐

体验额度不够用？不用离开 ZCode：在 BigModel 供应商页面即可浏览 GLM Coding 编程套餐（Lite / Pro / Max），支持包月、包季、包年三种订购方式，登录后直接在应用内完成购买；已订阅用户也能在这里管理当前套餐、查看额度状态。

使用 API Key 接入

根据你的账号类型选择连接方式：

方式 A：GLM Coding Plan（编程套餐 API Key）

1. 在 BigModel 供应商页面右上角，将连接方式切换为「API Key」
2. OpenAI 接口地址填写 Coding 专用端点：https://open.bigmodel.cn/api/coding/paas/v4
3. 填入从智谱开放平台获取的 API Key
4. 可用模型以账号权限和供应商返回的模型列表为准

注意：Coding 端点不能替换为通用端点 https://open.bigmodel.cn/api/paas/v4。

方式 B：模型资源包 / 充值余额

1. 在 BigModel 供应商页面右上角，将连接方式切换为「API Key」
2. 任选一种协议：
   • Anthropic 协议（默认）：Anthropic 接口地址保持 https://open.bigmodel.cn/api/anthropic
   • OpenAI 协议：OpenAI 接口地址填写 https://open.bigmodel.cn/api/paas/v4
3. 填入从智谱开放平台获取的 API Key
4. 可用模型以账号权限和供应商返回的模型列表为准；也可以点击「添加模型」补充其他可用模型

连接 Z.ai

Z.ai 是面向海外用户的接入方式，配置流程与 BigModel 基本一致：

1. 通过上述任一方式进入 模型设置 面板
2. 在左侧供应商列表中选择「Z.ai」
3. 完成账号连接并开启启用开关，即可使用 GLM-5.2、GLM-5-Turbo 等内置模型
4. 右上角同样可以在「编程套餐」与「API Key」两种连接方式之间切换

连接后，供应商页面会展示当前套餐与今日各模型的余额、已用量：

体验额度与订购套餐

与 BigModel 相同，新用户可享受每日免费的 GLM 旗舰模型体验额度；也可以直接在页面内浏览并订购 GLM Coding 编程套餐（Lite / Pro / Max，美元计价），支持包月、包季、包年。

使用 API Key 接入

根据你的账号类型选择连接方式：

方式 A：GLM Coding Plan（编程套餐 API Key）

1. 在 Z.ai 供应商页面右上角，将连接方式切换为「API Key」
2. OpenAI 接口地址填写 Coding 专用端点：https://api.z.ai/api/coding/paas/v4
3. 填入从 Z.ai 平台获取的 API Key
4. 可用模型以账号权限和供应商返回的模型列表为准

注意：Coding 端点不能替换为通用端点 https://api.z.ai/api/paas/v4。

方式 B：模型资源包 / 充值余额

1. 在 Z.ai 供应商页面右上角，将连接方式切换为「API Key」
2. 任选一种协议：
   • Anthropic 协议（默认）：Anthropic 接口地址保持 https://api.z.ai/api/anthropic
   • OpenAI 协议：OpenAI 接口地址填写 https://api.z.ai/api/paas/v4
3. 填入从 Z.ai 平台获取的 API Key
4. 可用模型以账号权限和供应商返回的模型列表为准；也可以点击「添加模型」补充其他可用模型

Anthropic（Claude API）

1. 通过上述任一方式进入 模型设置 面板
2. 在左侧供应商列表底部点击「添加供应商」
3. 名称填写「Anthropic」
4. Anthropic 接口地址填写 https://api.anthropic.com
5. 在「API Key」输入框中填入从 Anthropic 平台 获取的 API Key（可在平台内查看用量与套餐）
6. 保存后，ZCode 会按供应商返回的可用模型列表展示模型
7. 如未自动加载，可通过「添加模型」手动补充 Anthropic 支持的模型

OpenRouter 平台

1. 创建 API Key

前往 OpenRouter 平台，注册账号并创建 API Key。

2. 在 ZCode 中配置

1. 进入 模型设置 面板
2. 在左侧供应商列表底部点击「添加供应商」
3. 名称填写「OpenRouter」
4. API 基础 URL 填写 https://openrouter.ai/api
5. 填入 API Key
6. 开启启用开关即可使用

Moonshot

1. 进入 模型设置 面板
2. 在左侧供应商列表底部点击「添加供应商」
3. 名称填写「Moonshot」
4. Anthropic 接口地址填写 https://api.moonshot.cn/anthropic
5. 前往 KIMI 开放平台 获取 API Key（可在平台内查看资源包与用量），并填入「API Key」输入框
6. 保存后，ZCode 会按供应商返回的可用模型列表展示模型；如未自动加载，可通过「添加模型」手动补充 Moonshot 支持的模型

OpenAI

1. 进入 模型设置 面板
2. 在左侧供应商列表底部点击「添加供应商」
3. 名称填写「OpenAI」
4. API 基础 URL 填写 https://api.openai.com
5. 在「API Key」输入框中填入从 OpenAI 平台 获取的 API Key
6. 保存后，ZCode 会按供应商返回的可用模型列表展示模型；如未自动加载，可通过「添加模型」手动补充 OpenAI 支持的模型

MiniMax

1. 进入 模型设置 面板
2. 在左侧供应商列表底部点击「添加供应商」
3. 名称填写「MiniMax」
4. Anthropic 接口地址填写 https://api.minimaxi.com/anthropic
5. 前往 MiniMax 开放平台 获取 API Key（可在平台内查看套餐与计费），并填入「API Key」输入框
6. 保存后，ZCode 会按供应商返回的可用模型列表展示模型；如未自动加载，可通过「添加模型」手动补充 MiniMax 支持的模型

小米 MiMo

1. 进入 模型设置 面板
2. 在左侧供应商列表底部点击「添加供应商」
3. 名称填写「Xiaomi MiMo」
4. API 基础 URL 填写 https://api.xiaomimimo.com/v1
5. 前往 小米 MiMo 开放平台 获取 API Key（平台提供 Token Plan 套餐，可按需开通），并填入「API Key」输入框
6. 保存后，ZCode 会按供应商返回的可用模型列表展示模型；如未自动加载，可通过「添加模型」手动补充 Xiaomi MiMo 支持的模型

自定义供应商（兼容 Anthropic / OpenAI 协议）

ZCode 支持添加任何兼容 Anthropic / OpenAI 协议 的模型服务作为自定义供应商——既可以是公网模型服务，也可以是团队统一维护的企业模型通道或内网自托管服务。

当你选择对应厂商的 Base URL，或填入兼容的接口地址后，系统会自动识别并加载可用模型列表，无需手动逐个补充模型名称。

配置步骤

1. 进入 模型设置 面板
2. 在左侧供应商列表底部点击「添加供应商」
3. 自定义填写名称：为供应商命名（如 claude、deepseek 等）
4. 选择对应厂商 Base URL：从下拉列表中选择或手动输入 API 基础 URL
5. 填写 API Key：输入对应服务的 API 密钥
6. 自动加载模型列表：接口地址确认后，系统会自动拉取并填充可用模型列表
7. 开启启用开关后即可开始使用

以 DeepSeek 兼容接口为例：

• 名称填写「DeepSeek」
• Anthropic 接口地址填写 https://api.deepseek.com/anthropic
• OpenAI 接口地址填写 https://api.deepseek.com/v1
• 填入从 DeepSeek 开放平台 获取的 API Key
• 可用模型以供应商实际返回的模型列表为准；必要时手动添加团队约定的模型 ID
• 点击保存即可

团队使用建议：企业模型通道建议由团队统一管理 Base URL、API Key、模型列表与访问权限，保证长任务执行过程中的连接稳定性和可追踪性。

验证配置

配置完成后，在对话框的模型选择器中选择对应通道，发送一句简单指令测试。确认模型可用、响应稳定即可开始使用。

下一步