ZCode 安装教程：从下载到接入 DeepSeek 模型

ZCode 的安装包里已经自带了运行所需要的环境, 一般来说大家不用提前去安装 Node.js。Windows 系统、macOS 系统还有 Linux 系统都支持进行安装。

等到安装完成之后, 要去 DeepSeek 开放平台那里创建 API Key。然后在 ZCode 软件里面添加 DeepSeek 服务商标, 并且再添加两个模型配置, 这样就可以开始正常使用了。整个过程的时间长度是10–15分钟。

一、安装前准备

• 系统:可以是Windows 10或者Windows 11, 也可以用macOS, 这里面包括Intel芯片的, 也包括Apple Silicon芯片的, 还可以使用那些常见的Linux发行版本。
• 磁盘:需要预留1GB左右的空间, 这部分空间是用来存放程序本体以及工作区索引和缓存的。
• 账号:你需要准备一个属于 DeepSeek 开放平台的账号。这个 API Key 是在开放平台这边创建的, 它和网页聊天入口不是一个东西。

二、下载并安装

1. 打开 ZCode 官网，按系统下载对应安装包。
2. 在 Windows 系统下, 执行 .exe 程序, 根据界面提示选中安装的目标位置, 待安装流程结束后勾选启动选项。
3. 如果是处于macOS系统里面, 请先启动磁盘映像文件, 也就是那个.dmg文件, 随后把ZCode这个程序文件夹直接拖动到应用程序所在的目录之中, 如果此时界面弹出关于隔离的提醒通知, 那就需要执行xattr -dr com.apple.quarantine /Applications/ZCode.app这行命令来进行处理, 然后再尝试打开它。
4. 对于Linux系统, AppImage格式的软件文件需要先用 chmod +x 这个命令来赋予其可执行权限, 然后才能直接运行, 而deb和rpm这些软件包则是要依托系统的软件包管理器来进行安装。

三、首次启动与工作区

1. 程序启动以后, 需要按照屏幕上的提示进行操作, 以便进入到主界面去, 历史迁移的提示是可以跳过去看的。
2. 请选择一个项目文件夹并将其设定为当前工作区间, 请避开直接选取诸如C盘或者用户主目录这样的范围。
3. 对于需要代理的网络来说, 大家应该去把设置中的常规选项点开, 然后在里面检查一下代理配置情况到底怎么样, 千万不要说只是觉得浏览器那边可以正常上网, 就以为万事大吉了。

四、获取 DeepSeek API Key

1. 打开 platform.deepseek.com/api_keys 并登录。
2. 你需要去创建 API Key, 然后把用途这一项填写为 ZCode 在创建完成并且成功生成之后你要立刻复制密钥, 因为密钥通常情况下只会显示一次。
3. 需要去确认一下账户里面是不是真的有余额, 如果发现余额不够的话, 即便那个 Key 是正确的, 调用也会失败。

安全提醒:Key 这个东西是调用的凭证, 千万不要把它贴到聊天工具里去, 也不要贴到文章里, 或者 Git 仓库里面去。如果怀疑它已经泄露了, 就需要把旧的 Key 删除掉, 然后重新再创建一个新的。

五、添加服务商与模型

请点击 ZCode 界面左下角的设置按钮, 然后进入模型设置这一部分。如果在列表中能够看到 DeepSeek 这个模板的话, 就直接去选择它, 这样系统就会自动帮你填好 Base URL 这个信息。如果列表里没有对应选项的话, 就需要选择自定义供应商, 并且根据下面这张表格的内容来填写相应的数据。

1. 在把服务商的数据给存下来以后, 就可以接着去添加模型了。第一个要提到的模型是 deepseek-chat, 这个模型主要拿来做日常的问答以及修改代码这些东西, 它的运行速度是相当快的。第二个需要添加的模型是 deepseek-reasoner, 这个模型专门处理那些逻辑非常复杂的推理工作, 或者是需要花费比较长周期的任务。
2. 你需要把启用开关给打开, 这样的话那两个模型就会出现了, 如果开关是关闭状态的话, 那么对应的模型是不会出现在选择器里的。
3. 你回到工作区里, 然后在模型选择器里面选一个模型出来, 之后发一条测试消息过去, 以便确认连通性是否没有问题。

六、常见报错速查

• 连不上模型但账号正常:先查代理与防火墙设置, 再测官网连通。
• 遇到一个错误提示, 具体内容是401/invalidkey:这个情况是因为密钥复制不完整或者被删除了, 所以需要重新构建密钥, 然后再次填写相关内容。
• 402/余额不足:请您前往开放平台进行充值操作, 或者, 选择切换成免费额度可供使用的模型。
• macOS提示已损坏:, 这多半是因为隔离标记的问题, 你应当按照第二节的命令进行处理, 然后重新启动。