EN
开始使用
核心功能
深度集成
帮助
查看旧版文档 →
开始使用

API key 配置

Z Code 支持以下方式获取 AI 服务：

  • 智谱 GLM Coding Plan 编程套餐、智谱开放平台模型资源包&充值余额
  • 智谱 Z.AI
  • Claude Code / Codex / Gemini 原生订阅套餐
  • OpenRouter 平台
  • 支持任何兼容 Anthropic / OpenAI 协议的 AI 服务，包括本地批量部署的 AI 服务。

GLM Coding Plan 编程套餐

订购 GLM Coding Plan，即刻解锁 GLM-5.1 等强大编程模型，享受高性价比的 AI 编程体验。

立即订购
GLM-5.1 编程模型高性能高性价比

API 配置入口

方式一：通过 Connect

适用于通过账号快速登录并开始使用 Z Code。打开 Z Code 桌面应用后，会看到欢迎弹窗。

点击「继续使用 Z.AI」即可通过账号登录并进入工作区；如果暂时不想登录，也可以点击「暂时跳过」，后续再到模型供应商页面继续配置 API Key。

Connect 欢迎弹窗

方式二：通过模型选择器

进入 Z Code 后，点击对话框中的模型名称打开模型选择器下拉菜单，在列表底部点击「管理模型」。

模型选择器下拉菜单

即可进入 Agents 设置/模型 配置面板，在此管理所有 AI 服务提供商。

模型配置界面

智谱 BigModel

  1. 通过上述任一方式进入 Agents 设置/模型 面板
  2. 在左侧提供商列表中选择「BigModel」
  3. 开启右上角的启用开关
  4. 点击「获取 API 密钥」跳转智谱开放平台获取 key，或点击「使用订阅」绑定 GLM Coding Plan 套餐
  5. 填入 API 密钥，即可使用 glm-5.1、glm-5-turbo、glm-5 等内置模型

BigModel 配置

智谱 Z.AI

  1. 通过上述任一方式进入 Agents 设置/模型 面板
  2. 在左侧提供商列表中选择「Z.AI」
  3. 开启启用开关并完成账号绑定，需提前充值或购买 GLM Coding Plan

Z.AI 配置

Anthropic（Claude API）

  1. 通过上述任一方式进入 Agents 设置/模型 面板
  2. 在左侧提供商列表中选择「Anthropic」
  3. 开启右上角的启用开关
  4. 点击「获取 API 密钥」跳转 Anthropic 官网获取 API key
  5. 填入 API 密钥后，即可使用 claude-sonnet-4.5、claude-opus-4.5 等内置模型
  6. 也可通过「添加模型」手动添加 Anthropic 支持的其他模型

Anthropic 配置

OpenRouter 平台

1. 创建 API key

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

2. 在 Z Code 中配置

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

OpenRouter 平台模型名称列表：https://openrouter.ai/models

OpenRouter 配置

Moonshot

1. 创建 API key

前往 KIMI 开放平台，新建并复制对应的 API key。

2. 在 Z Code 中配置

  1. 进入 Agents 设置/模型 面板
  2. 在左侧提供商列表底部点击「添加提供商」，或选择已有的 Moonshot 提供商
  3. 名称填写「Moonshot」
  4. API 基础 URL 选择 https://api.moonshot.cn/anthropic
  5. 填入 API 密钥，即可使用 kimi-k2.5、kimi-k2-turbo-preview 等模型

Moonshot 配置

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

Z Code 支持添加任何兼容 Anthropic / OpenAI 协议的 AI 服务作为自定义提供商。

新版在这里的体验更完整：当你选择对应厂商的 Base URL，或填入兼容的接口地址后，系统会自动识别并加载可用模型列表，不需要再手动一个个补模型名称。

配置步骤

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

自定义提供商配置

以 GLM 兼容接口为例：

  • 名称填写「BigModel」
  • Base URL 填写 https://open.bigmodel.cn/api/anthropic
  • 填入 API Key
  • 如有需要，可继续补充对应模型
  • 点击保存即可

验证配置

配置完成后，可以在对话框的模型选择器中选择对应的模型进行测试。

下一步

安装

下载并安装 Z Code 新版桌面应用。

用户反馈与支持

遇到问题时，了解如何提供有效反馈。

常见问题解答 (Q&A)

查看配置、安装与使用中的常见疑问。