扣子 Coze 入门教程：注册到发布 Agent 的第一步
如果你印象里的扣子还是那个搭聊天机器人的平台，可以先更新一下认知：现在的扣子是字节跳动旗下面向 Agent 时代的 AI 团队协作平台，主打让多个 Agent 像同事一样接活干活，还能直接操作电脑和手机交付结果。本教程按真实上手顺序，带你从注册一路走到第一个任务跑通，所有步骤与限制均取自官方文档（核实于 2026 年 9 月）。
先更新认知：扣子 3.0 是什么时候变的
官方文档把扣子定义为面向 Agent 时代的新一代 AI 团队协作平台：人和 Agent 像真正的团队一样共同工作，一人可调度多个 Agent，多人也能围绕同一个项目协同。
版本节点值得记一下：2026 年 5 月 29 日，扣子正式发布 3.0 版本（来源：扣子官方常见问题）。这次改版带来五个关键变化：
- 多人多 Agent 协作：支持一人加多 Agent、多人加多 Agent 的组合，需要谁加入 @ 一下即可。
- 多项目独立管理：每个项目有独立的对话、文件和资产，任务背景和产出持续沉淀，不再散落在聊天窗口里。
- 专业伙伴开箱即用：Coze Agent 支持在 Doubao-Seed、Kimi、GLM、Minimax 等主流模型间自由切换，配长期记忆与工作台。
- 你的 Agent 你来定义：本地 Agent 开放接入，Claude Code、Codex CLI、OpenClaw、Hermes 可一键托管接入。
- 手机电脑跨端同步：桌面端上线后可授权 Agent 处理本地文件，App 端同步推进编程与视频项目。
所以旧教程里注册完就去拖节点、配 Bot 人设的路线已经过时，跟着本文走新路线即可。
注册登录与三端下载
三端入口都在 扣子官网，建议先从网页端开始，零安装成本：
- 网页端：浏览器打开 coze.cn，手机号注册登录即可使用。
- 桌面端：官网指向下载桌面端，支持 macOS（含 Apple 芯片与 Intel 两个安装包）和 Windows。
- 移动端：官网扫码下载 App，手机上随时查看项目进度、继续调度任务。
同一账号登录后，项目、对话、文件和设置自动同步，在电脑上启动的任务，离开电脑后可以在手机上继续推进。这里补一个容易搞混的点：多端同步是打通的，多渠道对话不是打通的。官方说明，你在飞书看不到扣子账号在微信里的具体对话记录，但记忆是通的，飞书里的扣子会记得你在微信叮嘱过它的事。
第一个任务：在网页端让 Agent 交付结果
新扣子的逻辑是描述任务而不是配置机器人。跑通第一个任务只需三步：
- 登录后点击新任务，选择一个 Agent。
- 在输入框用自然语言说明任务目标、需要的产出和限制条件，例如：帮我调研三个主流开源 Agent 框架，输出一页对比表格，注明各自的许可证。
- 发送后 Agent 会自主执行，需要外部工具时按提示授权，最终在对话里交付结果，产物可存入项目文件。
判断跑通的标准：任务有明确交付物、过程中 Agent 的操作对你可见可控。如果任务太模糊导致结果发散，把要什么、不要什么写进指令里再试一次。官方在桌面端教程里给的示例提示词就是这个思路，比如整理文件时会明确要求「执行移动操作前先把方案和清单发给我确认，不要直接移动或删除文件」。
桌面端进阶：授权 Agent 操作你的电脑
桌面端是扣子当前最有辨识度的能力：Agent 获得授权后可以直接处理本地文件、使用本地软件和插件（来源：扣子桌面端快速上手）。官方教程以整理桌面文件为例，把四步写得非常具体：
- 下载安装桌面端并登录，支持 macOS 与 Windows。
- 点击左上角新任务，选 Agent 后描述任务。官方给的示例是：整理桌面上的文件，按照工作、学习、图片和其他分类，执行移动操作前先把整理方案和文件移动清单发给我确认。
- Agent 为了读取桌面文件会请求使用 Bash 执行命令，此时你要检查要执行的命令和使用的工具，确认无误点「允许一次」，不放心就点「拒绝」。
- Agent 盘点完成后会列出整理方案和文件移动清单并询问是否执行，确认符合预期就选「按方案执行（推荐）」再提交回答；需要调整就选「先不执行」，在对话里补充要求。
完成后 Agent 会返回各分类的文件数量和内容摘要，你可以对照桌面文件夹检查结果，也可以继续追加要求。桌面端还能通过插件连接 WPS、浏览器等本地软件，甚至直接在本机开发调试项目。
换模型、加插件、连 MCP：把 Agent 调教好
默认 Agent 不一定满足你的场景，扣子给三层扩展手段：换模型解决脑子问题，在支持的主流模型里按任务特点切换；加插件解决手脚问题，比如连 WPS 做 PPT、连浏览器查资料；接 MCP 解决数据问题，把外部工具、文件和服务接进来。行业技能包则按自媒体、法律、金融、互联网、医疗健康等职业一键加载。
插件还带一个叫 Panel 的工作界面，显示在对话区右侧，可以是一块设计画布、一个数据看板、一张表格或一条音视频时间线。你直接查看、选择或修改其中的内容，相关操作会成为 Agent 继续工作的上下文，对话继续时 Panel 仍会保留。
以连接 WPS 插件为例，官方给的是这套动作：登录桌面端，在左侧点「扩展 > 插件」，找到 WPS 插件后点「连接 > 去连接」，按提示选择要添加插件的 Agent 并确认添加，之后在对话里 @WPS Office 下指令即可。
想理解 MCP 在整个 Agent 体系里的位置，推荐先读这篇 什么是 AI Agent，再进阶看 AI Agent 工作流入门；如果你的自动化需求偏流程编排，可以对比一下 扣子与 n8n、Dify 的差异 再做技术选型。
免费能用多少：积分与套餐
扣子按积分计费，与 Agent 的每次交互、云手机云电脑使用、编程任务、内置集成等都会消耗积分（来源：官方套餐与定价文档）。除此之外，云盘、旁听、邮箱属于配套资源，其中邮箱功能目前限时免费。
官方当前列出的套餐比早期多了一档个人尊享版和多个团队、企业档位，完整结构如下：
| 套餐 | 月费 | 每月积分 | 关键权益 |
|---|---|---|---|
| 个人免费版 | 0 元 | 按平台发放 | 旁听单次 30 分钟、可连接 1 个本地 Agent（限时免费）、云盘 4GB |
| 个人进阶版 | 39.9 元 | 3 万 | 视频与图片去品牌水印、视频优先通道、导出剪映工程文件 |
| 个人高阶版 | 99 元 | 9.9 万 | 视频精选模型、免费兑换云手机与云电脑、云盘 10GB、本地 Agent 3 个、旁听 4 小时 |
| 个人旗舰版 | 199 元 | 19.9 万 | 旗舰模型优先体验、云盘 20GB、本地 Agent 10 个、项目协作者 30 人 |
| 个人尊享版 | 999 元 | 99.9 万 | 前沿模型抢先体验、云盘 50GB、本地 Agent 不限、项目协作者 50 人 |
| 团队高阶版 | 198 元 | 9.9 万 | 成员 1 个起购、最多增购至 50 个，本地 Agent 3 个/成员 |
| 团队旗舰版 | 398 元 | 19.9 万 | 成员最多增购至 100 个，本地 Agent 10 个/成员 |
| 团队尊享版 | 1998 元 | 99.9 万 | 成员无限增购，本地 Agent 不限 |
| 企业标准版 | 980 元起 | 34.5 万起 | 成员 5 个起购、最多 100 个 |
| 企业旗舰版 | 8980 元起 | 207 万起 | 成员 30 个起购、无限增购 |
免费版能完整走通本教程的全部基础流程，消耗型重度功能再按需升级，具体积分发放与权益以官网实时政策为准。
走出扣子：在飞书和微信里用 Agent
Agent 不必困在扣子应用里。官方计费文档明确提到，可以在飞书、微信等其他应用中与扣子 Agent 交互并下达任务指令，也就是说你把 Agent 配好后，日常工作在飞书群、微信里就能派活。其他渠道的最新支持情况以官网发布页为准。
跨端接力同样顺滑：电脑上让它整理文件，手机上收到完成通知后直接查看结果；移动端还支持会议旁听，免费版单次 30 分钟，结束后自动生成纪要和待办。
常见报错与卡点速查
下面这些是官方 FAQ 里明写的真实问题与排查路径，第一次用扣子的人大概率会撞上一两条。
本地 Agent 相关：
| 现象 | 原因 | 官方排查路径 |
|---|---|---|
| 终端提示 npm not found、npx not found | 运行环境里 Node.js 未安装或路径未生效（npm 与 npx 都随 Node.js 提供） | 先跑 node -v、npm -v、npx -v 三条命令，都能返回版本号说明是路径问题，重启终端重试；找不到命令就用 command -v nvm 检查 nvm，再执行 nvm install --lts 与 nvm use --lts，最后重新验证三条命令 |
| 本地 Agent 连接掉线 | 本地 Agent 与扣子的连接断开 | 点 Agent 设置里的「重新连接」，复制连接地址，在本地终端执行连接命令，回到页面点「我已执行」等待重连 |
| 对话框里找不到「授权模式」选项 | 该 Agent 版本较旧，或框架本身不支持 | 点「升级」按提示完成升级；官方说明 Codex CLI 与 Claude Code 支持授权模式，OpenClaw 不支持 |
| 深度截图快捷键没反应 | 快捷键未开启、被其他应用占用，或系统权限未给 | 确认客户端设置里的深度截图开关已打开，确认快捷键一致且未被占用，macOS 上还要开启屏幕录制与辅助功能权限，刚授权完建议重启扣子 |
使用与协作相关：
| 现象 | 原因 | 怎么处理 |
|---|---|---|
| 提过「记住：……」但扣子答不知道 | 首次描述太模糊，模型难以抽出可复用的事实 | 当成新同事重新讲清楚，或直接让它查记忆、搜历史话题 |
| 回忆里人名、时间、指标用错 | 同一件事被多次记忆，或记忆与对话上下文冲突，模型选了过时的一条 | 让 Agent 重新整理自己的记忆文件，把指定主题的信息整合成一条 |
| 找不到过去的对话 | 3.0 改版后旧对话被归档 | 在主页左上角点「对话 > 已归档对话」（App 端在首页选「历史对话」） |
| 想删除聊天记录或重置扣子 | 出于隐私与数据安全，官方不支持删除与清空 | 只能新建一个 Agent 重新开始；编程项目删除则要谨慎，删除后不可恢复 |
| 以前能 @ 收藏夹文档，现在不行 | 3.0 改版后不再支持 @ 或 / 引用收藏夹文档与标签 | 改用项目文件或云盘承载长期资料 |
边界与前提：三种 Agent 别混着用
扣子里现在有三种 Agent，官方 FAQ 专门做了区分，新手最容易混：
- 扣子 Agent：平台原生助手，开箱即用，适合大多数日常办公和内容类任务，也是唯一支持自定义模型的类型。
- 三方精选 Agent：运行在扣子云电脑里的专业 Agent，适合长任务、自动化、代码开发和团队协作，不依赖你的电脑在线。
- 本地 Agent：运行在你自己的电脑上，适合处理本机文件、代码、私有环境，能复用本机已装的插件、MCP、Hooks 和私有配置。
这里有两个必须提前知道的边界。第一，三方精选 Agent 不是 Anthropic 或 OpenAI 的官方应用：它基于 Claude Code、Codex CLI 等开源框架构建，不支持登录你自己的 Claude 账号，也不需要 OpenAI 账号或 API Key，模型由扣子统一提供（官方列出的模型包括 Deepseek-V4-Pro、GLM-5.3、Doubao-Seed-2.1-pro、Kimi K3 等），与直连官方账号的模型列表、上下文长度、限流都不同。第二，三方精选 Agent 跑在云端，与你的本地设备完全隔离，不会访问本地文件，也不会继承你本机装的插件和 MCP。
另外注意一个安全细节：桌面端本地项目模式里可以设置运行环境为本机并开启「本机操作免确认」，这会跳过逐条命令的授权确认。官方教程把它当作提效手段，但建议只在你完全信任的项目目录下开启，涉及删除或覆盖文件的任务仍然保持逐条确认。
常见问题
扣子是免费的吗？
答：个人免费版 0 元可用，能完成基础的 Agent 任务和项目协作，但积分与高级权益有限。重度使用或需要云设备、视频创作等能力时再升级付费套餐，个人进阶版 39.9 元起。
扣子 3.0 是什么时候发布的？
答：2026 年 5 月 29 日正式发布，核心变化是多人多 Agent 协作、项目制管理、本地 Agent 开放接入、行业专家技能和跨端同步。
零基础能学会扣子吗？
答：能。新扣子的交互以自然语言派任务为主，不要求写代码。先在网页端发一个小任务跑通流程，再逐步学插件和 MCP 扩展。
桌面端让 Agent 操作电脑安全吗？
答：执行命令前 Agent 必须逐次请求授权，你可以查看命令内容后选择允许一次或拒绝。建议保持官方推荐的先出方案再执行模式，并谨慎开启本机操作免确认，涉及删除文件的任务额外小心。
扣子还能发布到豆包等渠道吗？
答：官方文档确认支持在飞书、微信等应用中与扣子 Agent 交互，且渠道之间对话不互通但记忆互通；豆包等其他渠道的支持情况随版本调整，以官网最新发布说明为准。
扣子和扣子编程是什么关系？
答：扣子编程（code.coze.cn）是面向开发的分支，提供更完整的开发工作台与项目管理；扣子主站里的 AI 编程是它部分能力的封装，适合在对话里快速创建、修改、预览和部署网页、App、小程序。
京ICP备2024094994号-29