Coze 扣子桌面端安装与配置教程

适用系统：Windows 与 macOS
作者：伯伦
更新日期：2026 年 10 月 18 日

这篇教程带你装好国内版扣子桌面端，登录账号、发起任务，再按需要连接电脑里的文件夹。遇到 Node.js 或本地连接报错，后面也有对应的处理步骤。

装过类似软件的，可以先看快速版；第一次用，就跟着详细步骤往下做。文中会给出下载入口和配置方法。遇到界面或价格变化，以官网和自己的账户页面为准。

安装前准备

先看电脑系统和芯片

Windows：打开“开始 → 设置 → 系统 → 关于”，看清系统版本和系统类型。

• 显示“基于 x64 的处理器”，选择 Windows x64、64 位或 AMD64 安装包。
• 显示“基于 ARM 的处理器”，选择 Windows ARM64 安装包，并确认软件支持该架构。

Mac：点击左上角苹果菜单 → 关于本机。

• Apple M 系列芯片，选择 Apple Silicon、ARM64 或 aarch64。
• Intel 处理器，选择 Intel 或 x64。
• 看到 Universal 通用包时，按下载页说明选择，通常可以同时支持两种芯片。

下载扣子桌面端前，先核对官网要求的系统版本和芯片，再选对应的安装包。

账号和工作目录

准备可接收验证码的手机号，或当前登录页支持的其他个人账号。已有扣子账号的，沿用原来的登录方式并核对所处空间。

先建一个 AI-Workspace 文件夹。Windows 可以放在用户目录或数据盘，Mac 可以放在“文稿”中，再在里面建一个测试目录：

AI-Workspace/
  coze-test/

第一次验证用空文件夹，权限保留询问或手动确认。选了工作目录，仍要留意后续的权限提示。几款智能体一起处理同一个项目时，先分好各自负责的文件，避免同时改同一份内容。

下载或登录失败时

下载或登录卡住时，先看具体报错，再检查网络、系统时间和官方服务状态。也要确认软件支持你的系统和使用地区，账号符合要求。公司或学校的电脑，还要看管理员是否允许安装和连接。

页面提示地区、账号或付款方式不符合要求时，按官方说明处理。条件暂时不满足，就先用自己能正常访问的工具。

扣子下载入口与账号准备

本教程安装国内版扣子桌面端。打开 扣子官网，找到“下载桌面端”。当前有 Windows 和 macOS 入口，具体架构与最低系统版本按下载页说明选择。参见 扣子桌面端快速开始。

已经用过扣子的，继续用原来的账号和登录方式，免得登录后发现以前的内容不见了。

快速版

1. 从官网下载与电脑兼容的桌面安装包。
2. 安装并启动，注册或登录。
3. 新建任务，选择账户可用的 Agent。
4. 发送最小连接消息。
5. 需要处理本地文件时，再按客户端提示连接当前电脑并授权目录。

详细步骤

第一步 下载并安装

Windows 选择兼容的安装包，运行后按提示安装。Mac 根据芯片选择 Apple 或 Intel 版本，将应用安装到“应用程序”。

下载页中的手机二维码用于移动端，电脑安装使用桌面下载入口。

第二步 登录并新建任务

启动扣子，按当前页面选择个人登录方式，完成协议确认与验证。需要区分个人或组织空间时，进入自己准备使用的空间。

新建任务，先选一个账号可用的 Agent，试试能不能正常回复。工作流、知识库和插件等有需要时再配。

第三步 验证基础连接

发送：

只回复“连接成功”。不要读取或修改文件，也不要调用插件或运行命令。

收到回复后重开应用，确认仍能进入账号和任务。

第四步 按需要连接本地目录

要让扣子读写电脑文件，再从本地设备或项目目录入口连接电脑，选择 coze-test，保留操作确认。聊天能回复以后，还要看本机是否连上、目录是否已授权。

相关入口和用途见 扣子本地连接常见问题。

提示缺少 Node.js 时

看到 npm not found、npx not found，或者本地目录提示缺少环境依赖时，再来检查 Node.js。扣子官方 FAQ 说明，部分本地连接需要它。

打开 Node.js 官网，选择当前支持自己系统的 LTS 长期支持版，按系统与架构下载官方安装包。

Windows 通常使用 .msi 安装程序；Mac 使用官方下载页提供的兼容安装包。完成后，关闭原来的终端和扣子，再重新打开终端，逐行运行：

node -v
npm -v
npx -v

每行都返回版本号后，重开扣子，再试本地连接。如果仍报错，结合 官方 FAQ 检查版本和路径。

只有遇到这类依赖问题时，才需要补这一步。基础安装没有报错，可以先继续用。

常见问题

更新用客户端内的入口，或从官网下载新版。从手机、网页发起本地任务时，记得让那台电脑保持在线，并运行所需的桌面服务。

装好后检查这几项

• 扣子桌面端能正常启动并登录自己的账号。
• 能创建任务并收到最小连接验证回复，退出并重开后仍可进入任务。
• 需要本地能力时，另外检查本机连接、目录授权和必要依赖；若安装 Node.js，核对 node、npm、npx 均可输出版本号。

常用词

常用快捷键

Mac 的终端里，停止程序用 Control + C。记不住快捷键时，直接从软件菜单操作也可以。