开始使用
安装
本章介绍如何下载并安装 ZCode 桌面应用。完成安装后，您即可开始体验自研 ZCode Agent 驱动的端到端开发工作流。
下载
ZCODE
适用于 macOS (Apple Silicon)
目前支持 macOS（Apple Silicon / Intel）、Windows 10 及以上，以及主流 Linux 发行版。
操作系统
macOS 12+ / Windows 10+ / 主流 Linux
推荐配置
8 GB+ 内存 · 2 GB+ 可用磁盘
网络
需访问模型服务与远程仓库
快速安装指南
按照您所使用的操作系统，依次完成以下步骤即可完成部署。
macOSApple Silicon / Intel
- 1下载并打开 ZCode.dmg 安装镜像。
- 2将 ZCode.app 拖动到 Applications 文件夹。
- 3在启动台中找到 ZCode 并启动；首次启动如系统提示，请在「系统设置 → 隐私与安全性」中允许运行。
WindowsWindows 10 / 11
- 1下载 ZCode Setup.exe 安装程序。
- 2双击运行，按照安装向导提示选择安装路径。
- 3安装完成后从开始菜单或桌面快捷方式启动 ZCode。
Linuxx64 / arm64
- 1下载与发行版匹配的 .deb、.rpm 或 .AppImage 文件。
- 2Debian/Ubuntu 系：
sudo dpkg -i zcode_*.deb；RHEL/Fedora 系：sudo rpm -i zcode-*.rpm。 - 3或直接为 AppImage 添加可执行权限：
chmod +x ZCode-*.AppImage后双击运行。
验证安装
安装完成并启动后，您会看到「首次启动设置」页面：
按照以下步骤确认 ZCode 可以正常使用：
- 启动 ZCode 桌面应用。
- 使用 Z AI 账号 登录，开启完整能力；如暂不希望登录，也可以选择免登录方式继续体验。
- 进入主界面后，新建一个工作区，确认侧边栏、对话区与终端面板正常加载。
- 在对话框输入一句简单指令，比如让 Agent 列出当前目录的文件，观察响应是否正确。
完成以上步骤即代表安装成功，您可以继续配置 API Key 与模型服务。
故障排查
macOS 提示「ZCode 已损坏，无法打开」
在终端执行 xattr -dr com.apple.quarantine /Applications/Z\ Code.app 即可解除隔离属性。
Windows 安装时被防火墙/杀软拦截
请暂时关闭实时防护或将安装目录加入白名单后重试；安装包可从官方渠道校验来源。
Linux AppImage 双击无响应
确认已添加可执行权限：chmod +x ZCode-*.AppImage；部分发行版需额外安装 fuse 依赖。