我们拿 ZCode 3.16.x 这个版本当作例子来讲。先说在 Windows、macOS、Linux 这三个系统里分别要怎么做, 才能装好它。
然后去 ZCode 里面加上 DeepSeek 这个服务商的配置。接着把 deepseek-chat 和 deepseek-reasoner 这两个模型给它设置上。最后再附带一下那些常见的报错要去排查什么。
我们以 ZCode 3.16.x 为例。带你完成安装。你可以在 Windows 系统上操作。你也能在 macOS 系统上操作。你也可以在 Linux 系统上操作。我们还会介绍怎么把 DeepSeek 服务商添加到 ZCode 里去。
你要配置 deepseek-chat 模型。你还需要配置 deepseek-reasoner 模型。你先按照那些步骤来操作一下, 然后大概就会花费10到15分钟的样子, 之后这个事情就可以完成了。
一、安装前准备
ZCode 是一种在桌面上使用的 AI 编程工具。因为这个安装包里已经自带了运行环境, 所以一般情况下, 是不需要再单独去安装 Node.js 的。在进行开始操作之前, 需要确认三件事。
- 操作系统：Windows 10/11、macOS（Apple Silicon 或 Intel）、主流 Linux 发行版。
- 磁盘空间:建议至少预留 1GB, 用于程序本体, 工作区索引, 和缓存。
- DeepSeek账号:你要去准备一个能够正常使用的 DeepSeek 开放平台的账号。API Key 登录的地方, 和你平时用网页版聊天的那个账号入口, 并不是同一个通道, 所以你需要去单独把它创建出来。
二、下载并安装 ZCode
1. 打开 ZCode 官网
访问 https://zcode.z.ai/cn，点击首页的“立即下载 Zcode”。
2. 选择对应系统的安装包
| 系统 | 安装包 | 说明 |
|---|---|---|
| Windows x64 | .exe |
大多数 Intel/AMD 电脑选择这一项 |
| Windows ARM64 | .exe |
骁龙 X 系列等 ARM 设备选择 ARM64 版本 |
| macOS | .dmg |
区分 Apple Silicon 与 Intel，按机器选择 |
| Linux | .AppImage / .deb / .rpm |
按发行版选择；AppImage 需要先赋予执行权限 |
3. Windows 安装步骤
- 运行安装程序
双击下载的 .exe。如果出现 Windows SmartScreen 提示，点击“更多信息 → 仍要运行”。
- 关于应当把安装的位置进行一个什么样的选择这件事, 是要去考虑的。
建议您继续使用默认路径, 或者去选择一个没有空格、全是英文字母的目录位置, 这样能够减少各种与路径相关的兼容性麻烦。
- 把安装的事情都搞定了, 然后把那个启动开关给弄开了。
在安装操作全部完成之后, 你需要去勾选那个叫做启动ZCode的选项；当然你也可以选择另一种方式, 就是在你的电脑开始菜单里面进行搜索, 搜索的内容是“ZCode”, 这样就完成了打开ZCode这个动作。
4. macOS / Linux 简要步骤
- macOS:请打开那个格式为 .dmg 的文件, 随后就把 ZCode 这个程序, 拖拽到“应用程序”这个文件夹里面去。如果系统发出了“已损坏”这样的提示, 那么这通常指的是Gatekeeper隔离标记所造成的影响。这种情况下, 你可以通过在终端里面执行那一条命令来解决问题。具体的操作是输入
xattr -dr com.apple.quarantine /Applications/ZCode.app。在完成这一步之后, 再去打开相应的程序就可以了。 - Linux AppImage：执行
chmod +x ZCode-*.AppImage，再运行./ZCode-*.AppImage。部分发行版需要安装fuse。 - Linux deb/rpm：使用系统包管理器安装，例如
sudo dpkg -i ZCode-*.deb，或sudo rpm -i ZCode-*.rpm。
三、首次启动与工作区
- 你可以把开始利用ZCode的这个事情当作一个重点。
在首次启动的时候按照提示进入到主界面, 如果遇到历史数据迁移的提示可以选择跳过, 之后再手动导入还是可以的。
- 请选择一下当前的这个工作区是什么, 然后把它给选定下来。
你需要选择一个合适的项目文件夹来作为工作区用着。ZCode 只会在这个具体的目录内部读取文件和修改文件, 所以我们建议你不要直接去选择整个 C 盘或者是用户的主目录这样做。
- 检查网络连接的情况, 并且查看代理的设置是否存在问题。
如果你所在的网络需要代理, 你要打开设置菜单里的常规选项, 检查代理配置。当出现账号正常但是模型连不上的情况时, 要优先排查这个问题。在必要的时候, 要手动填写代理地址。不要仅仅依赖浏览器能上网来判断代理没问题。
四、获取 DeepSeek API Key
为了调用DeepSeek这个模型, 用户得先拿一个API Key才行。想要获得这个API Key的话, 大家需要先去开放平台那边进行创建操作。
- 打开浏览器, 在地址栏里面输入这个链接, 然后找到那个叫做开放平台的地方, 点击进入登录页面。
访问 platform.deepseek.com/api_keys，登录账号。
- 创建 API Key
当你点击“创建 API Key”这个按钮之后, 你需要填写用途名称, 比如在括号里面写上 ZCode 这样的内容, 然后在生成完成之后, 你要立即把生成的密钥复制下来, 因为在通常的情况之下, 这个密钥只会完整地显示一次, 一旦你关闭了当前的页面或者窗口, 它就再也无法被查看到了。
- 确认余额
关于DeepSeek API的计费方式, 它是根据调用的次数来进行收费的。具体的收费标准以及平台方面会赠送的额度情况, 请以该平台当前的页面显示为准。需要特别提醒的是, 如果您的账户余额不足, 那么即使您提供的Key是完全正确无误的, 依然会导致调用任务失败, 无法正常执行接口请求。
五、在 ZCode 添加 DeepSeek 服务商
打开 ZCode 左下角的“设置”，进入“模型设置”。这里可以管理内置供应商和自定义供应商。
方式 A：使用内置 DeepSeek 模板
- 点击“添加供应商”
在“模型设置”这个页面里面, 找到那个添加按钮, 在某些版本里它可能会被显示为加号或者叫做添加供应商。
- 用户正在进行操作, 其具体动作是做出某个决策, 这个决策的内容是选定DeepSeek, 而在这个选定的过程中, DeepSeek是一个需要被明确提到的选项和对象。
假如在列表里能够看到有 DeepSeek 模板存在的话, 请直接就去选择那个选项。因为相关的模板会自动去把 Base URL 和 API 格式给填好。
- 请将 API Key 粘贴到此处, 这一步操作非常重要, 请不要忽视它的具体含义与作用所在。
把刚才从别的什么地方复制的, 那个是以 sk- 这几个字母为开头的那个密钥, 给粘贴到, 名为 API Key 的那个输入框里面去。
- 点击保存选项, 然后马上进行测试活动。
点击保存这个动作, ZCode将会用来测试连接的状态, 等到确认连接成功之后, 再继续执行添加模型这一步骤。
方式 B：使用自定义供应商
如果你没有看到 DeepSeek 这个模板的话, 你就去选择那个自定义供应商这个选项, 然后呢, 按照下面的这种填写方式来操作就可以了。
| 字段 | 填写内容 | 说明 |
|---|---|---|
| 供应商名称 | DeepSeek |
仅用于本地显示，可自定义 |
| API 格式 | OpenAI Compatible |
DeepSeek 提供 OpenAI 兼容接口 |
| Base URL | https://api.deepseek.com |
使用官方地址，通常不需要手动加 /v1 |
| API Key | sk-你的密钥 |
只保存在本机 ZCode 配置中 |
六、添加模型
当供应商进行保存操作之后, 需要在该供应商的模型列表里面添加可用的模型, 一般情况下, 内置的 DeepSeek 模板是会直接展示出相关模型的, 用户只需要把启用开关打开就好了, 假如说里面没有自动带出模型的, 那么就要点击“添加模型”这个按钮来手动填写模型的 ID。
- 添加 deepseek-chat
这句话比较适合用来回答日常的问题、修改代码以及进行工具的调用, 它的运行速度相对会更加快一些。
- 添加 deepseek-reasoner
它适用于那些包含复杂推理的过程, 同时也适用于需要处理长任务以及进行多步骤分析的情况, 而且它的响应时间往往是更长的。
- 打开启用开关
在右侧的位置上面都有启用开关, 当把开关关闭的时候, 那么这些模型是不会出现在工作区的选择器里面的。
- 先完成保存的动作, 然后从当前的工作区域返回去。
在完成保存操作之后, 需要返回到主要的界面位置, 然后去进行准备选择模型这一环节的考虑和执行。
| 模型 ID | 适合场景 | 说明 |
|---|---|---|
deepseek-chat |
通用对话、代码、工具调用 | 建议作为默认模型 |
deepseek-reasoner |
复杂推理、长链任务 | 更擅长深度分析，耗时可能更长 |
deepseek-v4-pro |
高级复杂任务 | 如果当前版本/账户提供该模型再添加 |
deepseek-v4-flash |
日常轻量任务 | 如果当前版本/账户提供该模型再添加 |
关于上下文窗口, 也就是 Context Window 这个参数, 您要么填入 128000 这个数字。或者, 您也可以选择不填东西让它留空。这样的话系统就会根据模型自身的默认值来自动处理。
至于最大输出 Token 的数量, 一般情况下保持默认的设定就可以了, 不需要进行额外的修改操作。模型 ID 这个地方特别重要, 它必须和服务商那边实际提供出来的 ID 完全一致。在核对的时候请注意, 大小写不能出错, 中间的连字符也不能弄错, 否则可能会出现问题。
七、选择模型并测试
- 用户正在进行操作, 其具体动作是做出某个决策, 这个决策的内容是选定DeepSeek, 而在这个选定的过程中, DeepSeek是一个需要被明确提到的选项和对象。
返回到工作区域中去, 然后找到输入框边上的那个模型选择器。在这个选择器中挑选之前新加入的 DeepSeek 这种型号的大语言模型来进行使用。
- 发送测试指令
请你去把当前这个工作区域里面存在的全部的文件都给列出来, 并且再讲清楚一下说这个项目的主要用途或者说它主要是用来做什么的。
- 确认权限
ZCode 在读取文件或者执行命令的时候, 是需要请求权限的, 如果是第一次使用这个工具, 建议只给它当前工作区的权限, 绝对不要直接把整个磁盘的访问权限都放开。
- 观察回复
说明你的服务商、API Key、Base URL 以及模型 ID, 这些项目都已经成功连通了, 现在是可以正常读取文件并且做出回复的。
八、常见报错排查
| 现象 | 可能原因 | 处理方法 |
|---|---|---|
| 提示 401 / Authentication Fails | Key 错误、复制时带了空格、Key 已删除 | 重新创建 DeepSeek API Key，完整粘贴并保存 |
| 提示 402 / Insufficient Balance | 账户余额不足 | 到 DeepSeek 开放平台充值后重试 |
| 提示 404 / model not found | 模型 ID 写错，或 Base URL/API 格式不对 | 核对 deepseek-chat 拼写；Base URL 用 https://api.deepseek.com |
| 提示 429 | 请求频率或并发超限 | 等待后重试，或降低并发；查看平台限流说明 |
| 连接超时 | 网络、代理或防火墙问题 | 在“设置 → 常规”填写代理；先确认浏览器能打开 DeepSeek 平台 |
| 保存按钮不可用 | 必填字段为空，或模型未启用 | 检查名称、Base URL、API Key、模型 ID |
| 模型列表没有 DeepSeek | 当前版本未内置模板 | 升级 ZCode，或改用“自定义供应商”按本文填写 |
九、常见问题
关于DeepSeek这个API是不是免费的, 具体的答案是需要看当前的官方规定是什么样的存在。
DeepSeek 这个网页版以及 API 它们其实是两个不同的产品。关于 API 这一块, 它通常是按照调用的次数来收取费用的。
至于说会不会送你一些免费的使用额度、具体的价格又是多少的这些信息, 都是以那个开放平台上面当前显示的页面的内容为准的。所以在开始使用调用功能之前, 你得先确认一下你自己账户里面的余额情况。
一定要用 DeepSeek 吗？
答案并不一定。
大家都会来问一个十分现实的问题, 那就是deepseek-chat和deepseek-reasoner这两个名字听起来很像的东西, 到底应该怎么做选择呢。
现在很多人都会用到deepseek-chat, 因为这个模型在处理日常聊天、修改那些程序代码以及调用各种工具的时候, 表现得非常合适, 而且它运行起来的速度比较快；相比之下, deepseek-reasoner 则是在面对那些需要复杂推理能力、处理特别长的任务或者是要进行多重步骤分析的情况时更加占优势, 但是它带来的一个缺点就是, 它给出的回答速度可能会慢一点, 大家如果觉得不好把握, 那么就建议您先去尝试一些相对简单的任务来进行测试, 然后再根据自己在实际操作过程中的具体感受, 来决定是不是要把使用的模型切换一下。
您拥有DeepSeek网页版账号的具体相关情况, 为什么在当前的状态下依然无法正常地完成调用的操作, 这一现象产生的原因到底是什么。
网页版登录的账号并不等同于 API 凭证, 因此你需要在开放平台那里创建一个 API Key, 并且要确认你的账户里是有可用余额的, 然后把这个 Key 填到 ZCode 的服务商配置中去, 绝对不要把它填进网页版的聊天窗口里面。
API Key 应该保存在哪里？
这一信息仅仅是保存在 ZCode 的模型服务商配置里的。你绝对不可以把它写进项目文件里, 也不可以写进 README 里面, 更不要在代码注释里出现这种内容, 截图里也不能有。如果有多个人共用一台电脑的情况, 那么你在使用完之后, 建议一定要退出账号, 或者是把本地的密钥给删除掉。
把ZCode这个软件进行更新, 在更新操作完成之后, 之前保存在里面的那些设置信息, 会出现全部忘记, 不再存在的情况吗。
正常的升级操作通常会把本地的配置给保存下来, 所以在进行升级之前, 建议去确认一下 API Key 在 DeepSeek 这个平台上目前是不是还能够在正常工作, 要是发现那个模型的列表里发生了改变的情况, 那么就只需要把那些你自己需要的模型重新打开让它启用就行。
十、完成检查清单
- ZCode 已安装并能正常启动
- 目前的情况下, 独立的工作区文件夹这个选项已经被确认选择了。
- DeepSeek 平台已创建 API Key
- 账户当中的余额是足够的, 可以用来进行调用操作。
- 在ZCode这个系统里面哦, 现在的情况是已经添加上了那个DeepSeek服务的那个东西。
- Base URL 为 https://api.deepseek.com
- 已经将 deepseek-chat 添加了, 并且也把它启用了一下。
- 已经把测试消息发送出去了, 并且已经收到了回复。
官方资源
免责声明：网所有文字、图片、视频、音频等资料均来自互联网，不代表本站赞同其观点，内容仅提供用户参考，若因此产生任何纠纷，本站概不负责，如有侵权联系本站删除！邮箱:207985384@qq.com https://www.ainiseo.com/ai/61779.html
