ZCode 安装并登录
这是路线开篇，不承接上一步 → 本篇只做一件事：安装 ZCode，并用 BigModel 账号登录。
🌟 核心目标：装好 ZCode 并登录成功，搞清安装卡点与三种登录入口的区别，后面三步才有基础。预计 5～10 分钟。
1. 下载并安装 ZCode
打开 ZCode 中文官网，下载与你电脑对应的版本。
| 系统 | 安装方法 |
|---|---|
| Windows | 下载 Windows 安装包，双击并按提示完成安装 |
| macOS | 打开 .dmg，把 ZCode 拖入“应用程序” |
| Linux | 在官网下载区选择 AppImage、DEB 或 RPM |
如果不确定芯片或版本，直接使用官网推荐的下载项即可。官方说明见 ZCode 安装文档。
为什么外贸新手建议选用官方客户端？很多外贸人习惯了在网页版对话框里打字聊天，但网页端 AI 无法直接帮你整理本地文件夹里的产品图片、无法批量重命名客户报价单，更无法调用本地工具排查代码报错；而安装客户端之后，AI 才能在受信任的本地工作区里读取文件、执行分析并给出落地结果。
安装失败常见排查
很多外贸新手第一次装软件，卡住往往不是软件损坏，而是操作系统默认的安全策略拦截：
- Windows 杀毒软件拦截安装包：Windows Defender 或第三方安全软件有时会误报拦截新版安装包。其机理在于很多软件刚发布更新时，在安全软件的云端信誉库中尚未累积足够的下载样本量。在确认是从官网下载的前提下，在拦截弹窗中点击“更多信息”，再选择 “仍要运行”，即可继续安装。
- macOS 提示“无法验证开发者”：macOS 默认对非 App Store 下载的应用做公证与签名检查。打开时若提示无法打开，不要直接把安装包扔进废纸篓；打开 系统设置 > 隐私与安全性，页面往下滚动，找到“安全性”区域，点击提示旁边的 “仍要打开”，输入开机密码确认即可正常启动。
- 公司办公电脑无管理员权限：部分外贸企业的办公电脑开启了 IT 组策略管控，普通用户双击
.exe会弹出管理员账号密码窗口。遇到这种情况不要反复强退或尝试下载破解程序，直接联系公司 IT 管理员协助输入凭据，或申请将 ZCode 加入本地办公软件白名单。 - 磁盘空间不足或下载中断：安装包损坏通常表现为解压报错或提示“文件已损坏”。先确认系统盘至少有 5GB 剩余空间，清理浏览器下载缓存后重新从官网下载完整安装包。
- 旧版本残留导致安装冲突：如果此前装过其他测试版本，可能由于后台进程未彻底退出导致安装包写入冲突。打开任务管理器（Windows）或活动监视器（macOS），结束残留的 ZCode 进程后再重新运行安装。
遇到上述任一情况，先对照原因排查，不要轻易怀疑电脑配置或放弃安装。
2. 首次启动
安装完成后打开 ZCode：
- 点击 “开始使用 ZCode”。
- 没有旧数据需要迁移时，直接跳过数据迁移。
- 进入登录选择页面。
这一步做到什么程度算对：看到欢迎界面的登录选项卡，能够清晰看清中央的 BigModel 登录入口，页面未发生卡死或白屏即可。
三种登录入口的区别
首次启动时，界面会同时展示三种登录入口，新手常会纠结该点哪一个：
- Z.ai 账号：面向国际站或特定海外账号体系的用户。如果你使用的是海外工作邮箱注册的 Z.ai 国际版账户，从此处登录。
- BigModel 账号（推荐新手首选）：智谱开放平台账号。为什么新手教程强推这一项？因为 BigModel 为新手提供了最平滑的内置套餐与原生模型接入，登录后直接无缝承接官方额度，不用手动折腾繁琐的调用参数与网络环境，对零基础外贸人最省心；后面的套餐与日常模型也是基于它无缝衔接。
- 使用 API Key 登录：适合已经拥有第三方模型账号、熟悉各种接口调用格式的技术用户。新手第一次用千万不要选这一项，否则会因为缺失 API Key 与接口配置经验而被卡在登录界面。
三种入口的核心差异与选用建议：
| 入口类型 | 适合谁 | 为什么新手不推荐 | 计费与结算机制 |
|---|---|---|---|
| BigModel（首选） | 零基础外贸人、教程学员 | 无门槛，内置套餐与模型开箱即用 | 支持官方内置套餐，免配置参数 |
| Z.ai | 海外业务团队、国际站用户 | 国内网络直连偶有延迟，海外账号体系为主 | 按国际站独立订阅计费 |
| API Key | 资深开发者、已有多家平台 Key 的技术人员 | 新手极易因 Base URL、密钥权限填错导致报错卡死 | 严格按 Token 调用量逐次计费 |
在三种入口之间做出明确选择的原则很简单：新手跟着本教程走，直接选 BigModel；已有其他模型 Key 且只打算按调用量计费的用户，才在后续需要时接入 API Key。
3. 连接 BigModel
在欢迎页面点击中间的：
👉 连接 BigModel 继续使用
这一步做到什么程度算对：点击按钮后，系统默认浏览器被自动唤起，并顺利打开 BigModel 的登录或授权网页；如果浏览器没有弹出，检查是否有安全软件拦截了外部程序唤起浏览器。
随后的授权流程只需三步：
- 登录自己的 BigModel 账号（未注册可按提示先用手机号完成注册验证）。
- 按页面提示确认授权，将 ZCode 与你的 BigModel 开放平台建立连接。
- 授权成功后系统提示可返回客户端，直接回到 ZCode 界面。
在浏览器完成授权后，系统会自动通过本地回调将认证凭据传回 ZCode 客户端。整个过程中请勿提前关闭正在授权的浏览器标签页，直到网页明确提示“授权成功”或页面跳转完毕。如果浏览器未自动回调，可手动切回 ZCode 客户端查看状态。
4. 确认登录成功
浏览器授权完成后回到 ZCode。软件能顺利进入新建任务或工作区主界面，并且不再显示登录选择页，就说明登录已经成功。
这一步做到什么程度算对：软件主窗口稳定停留在新建任务或工作区界面，不再弹回登录选单，左下角能看到账号相关信息。
如果想进一步确认，可以打开左下角齿轮进入 设置 → 模型设置：BigModel 显示“已启用”即可。本篇不要改套餐或模型，第 3 步会统一设置。
这一步做到什么程度算对：在模型设置中看到 BigModel 右侧亮起“已启用”状态，列表正常展示即可。
登录后看不到模型排查
有新手授权成功后进入界面，点模型列表却发现空空如也，或者提示暂无可用的模型，以为登录坏了。
这属于完全正常的现象：刚授权的新账号还没接入模型。模型接入（推荐 DeepSeek / GLM 按量 API，内置套餐备选）与日常默认模型的设定，全都在路线的 第 3 步 · 模型接入 统一进行。新账号在接入模型前，模型列表为空是正常机制，绝不是软件损坏。
为什么会出现这种现象？背后的授权机理是：
- 认证阶段（本篇）：完成账号身份凭证的建立，确认 ZCode 与 BigModel 开放平台完成了绑定。
- 能力授权阶段（第 2 步）：打通操作系统与工具控制权限，让 AI 具备读取文件和操作工具的资格。
- 资源绑定阶段（第 3 步）：由用户明确挑选使用的套餐类型与日常模型，平台才会将具体的 Token 额度与模型权限下发到客户端列表中。
因此，如果你在这一步遇到疑问，对照以下三条排查准则：
- 准则一：看设置项而非模型下拉单。只要在设置的模型设置里看到
BigModel处于“已启用”，就代表授权链路完全正常。 - 准则二：不要急于充值或配置第三方。很多新手看到列表为空就误以为必须马上花钱买 API Key，实际上内置套餐在下一步才开始配置。
- 准则三：保持网络稳定即可进入下一步。无需重复重启或重新授权，直接进入第 2 步开启核心能力即可。
📋 安装阶段避坑汇总
| 坑 | 后果 | 怎么避 |
|---|---|---|
| 🔴 从非官网渠道下载 | 可能装到假软件或夹带广告 | 只从 ZCode 中文官网 下载 |
| 🟡 登录入口点错（选了 Z.ai 或 API Key） | 后续套餐、模型对不上，新手被卡在配 Key 界面 | 认准中央 “连接 BigModel 继续使用” 这一项，最省心 |
| 🟡 安装包被拦截就放弃安装 | 软件无法装上，流程中断 | Windows 点“更多信息 > 仍要运行”；macOS 到“系统设置 > 隐私与安全性”点“仍要打开” |
| 🟡 刚登录见不到模型以为坏了 | 来回重复卸载重装，浪费时间 | 登录成功即完成本步，模型与额度由第 3 步统一分配设置 |
| 🟢 在这一步就改模型或套餐 | 和第 3 步来回冲突 | 本篇不动设置，第 3 步统一选 |
✅ 完成检查
- ZCode 已安装并能正常打开；
- 已搞清三种入口区别，选择了“连接 BigModel 继续使用”；
- 授权后可以回到 ZCode 的新建任务或工作区界面；
- 不再显示登录选择页；
- 设置中的 BigModel 显示为“已启用”。
📚 延伸阅读
- 📚 第 2 步 · 开启核心能力：下一步要做的，先知道可以放一放
- 📚 AI 工具学习路线：ZCode 四步各做什么、整体怎么走
- 👉 ZCode 安装文档：官网的系统要求和安装说明
📄 第 2 步 · 开启核心能力 —— 打开完全访问、电脑控制、浏览器控制、记忆和索引，让 ZCode 真正能动手。