在 ZCode 中配置 DeepSeek 模型

想在 ZCode 里用上 DeepSeek V4（模型名：deepseek-v4-flash 或 deepseek-v4-pro）时，只需两步：先装客户端，再在「模型设置」里加自定义供应商。

本文按实际界面走一遍，配图与配置字段一一对应。DeepSeek 官方同时提供 OpenAI 兼容与 Anthropic 兼容接口；本文采用 Anthropic 兼容路径（与 ZCode 内 kind=anthropic 一致），思考模式等能力对接更顺。

第一步：下载 ZCode

打开官方下载页：

https://zcode.z.ai/cn#all-downloads

按你的系统（macOS / Windows / Linux）下载安装包并完成安装。装好后打开 ZCode，进入设置即可继续第二步。

第二步：添加 DeepSeek 供应商并配置模型

进入 模型设置（侧栏「模型设置」）。这里可以管理自定义模型供应商，配置后可在聊天时选择使用。

整体界面与关键字段如下：

按图中标注，依次完成这些操作：

1. 添加供应商

在左侧「自定义供应商」区域点击 + 添加供应商，新建一个供应商，名称可设为 deepseek，并确保状态为 已启用。

2. 填写 Base URL

在右侧 Base URL 中填入 DeepSeek 官方 Anthropic 兼容 地址：

https://api.deepseek.com/anthropic

注意路径以 /anthropic 结尾。若误写成 https://api.deepseek.com 或 .../v1 却仍选 Anthropic 格式，请求会失败。

若你更习惯 OpenAI 兼容协议，可改用 Base URL https://api.deepseek.com（或带 /v1），API 格式选 Chat Completions；本文不展开该路径。

3. 选择 API 格式（重要）

API 格式 必须选择：

Anthropic Messages (/anthropic/v1/messages)

不要选成 Responses 或 Chat Completions——那是给 Grok / 通用 OpenAI 兼容网关用的。选对 Anthropic Messages 后，ZCode 才会走 Messages 协议，并与 DeepSeek 的 Anthropic 兼容端点对齐。

4. 填写 API Key

在 API Key 输入框中粘贴你的密钥。可在 DeepSeek 开放平台 创建。

界面会默认脱敏显示；可用右侧眼睛图标切换显隐。密钥请自行保管，不要提交到公开仓库或截图外泄。

5. 添加模型

在 模型列表 中点击 + 添加模型，按需填入模型 ID。当前官方主推：

deepseek-v4-flash

或更高规格：

deepseek-v4-pro

可只加其中一个，也可两个都加，聊天时再切换。保存后列表里应能看到对应模型（图中示例为 deepseek-v4-flash，上下文窗口以你实际配置/服务端为准）。

旧别名 deepseek-chat / deepseek-reasoner 已退役，请直接用 deepseek-v4-*。

配置对照表

用起来

1. 确认供应商为 已启用。
2. 回到聊天工作区。
3. 在模型选择器里选中 deepseek-v4-flash 或 deepseek-v4-pro（或你添加的模型名）。
4. 需要深度推理时可在思考档位里选 high / max（以客户端展示为准）。
5. 发一条简单消息，确认能正常流式返回。

若请求失败，优先检查：Base URL 是否带 /anthropic、API 格式是否仍为 Anthropic Messages、Key 是否有效、模型名是否为 deepseek-v4-*。

小结

• 下载： ZCode 全部下载
• 配置：添加供应商 → Base URL（.../anthropic）→ Anthropic Messages → API Key → 添加 deepseek-v4-flash 或 deepseek-v4-pro
• 关键：本文走 Anthropic 兼容；Base URL 与 API 格式必须成对匹配

配置一次后，后续在 ZCode 里直接切模型即可继续用 DeepSeek。