扣子（Coze）本地安装过程，多图详解，小白也可以学会

2025年7月26日，字节跳动旗下AI开发平台“扣子（Coze）”宣布开源两大核心项目——Coze Studio（扣子开发平台）和Coze Loop（扣子罗盘），采用Apache 2.0协议，支持免费商用及本地化部署。

欢迎来到涛涛聊AI

下面是我的部署过程，各种坑。

对于没有软件开发或者运维经验的人还是有挑战的，有很多基础的概念第一次听到会更蒙的。

先看项目地址:
https://github.com/coze-dev/coze-studio

为啥不直接放在放在coze.cn上呢，看看github.com的介绍

GitHub是全球领先的代码托管和协作平台，基于Git版本控制系统开发。它提供代码存储、版本管理、团队协作等核心功能，支持开发者通过分支、合并请求（PR）和问题追踪（Issue）高效合作。作为全球最大的开源社区，GitHub托管了数亿个项目，包括知名开源软件如React和Vue.js 。平台还集成自动化工具（如GitHub Actions）实现CI/CD流程，并兼具社交属性，开发者可展示项目、参与开源贡献或搭建个人技术博客。

既然是全球网站，那可能就要科学的上网了。

Git 是一个开源的分布式版本控制系统，由 Linus Torvalds 开发，主要用于高效管理代码和文本文件的修改历史。它的核心特点包括：

1. 分布式架构：每个开发者拥有完整的代码仓库，支持离线工作。
2. 高效版本控制：记录文件变更，允许回溯、分支合并与冲突解决。
3. 协作友好：通过推送（push）、拉取（pull）等操作实现多人协同开发。

广泛应用于软件开发，是 GitHub、GitLab 等平台的基础技术。

知道了管理代码的软件后，就可以去搜索，然后下载和安装了。

Git 是个软件，clone（克隆）是软件的一个命令，可以简单的理解为拷贝或者下载

再看命令

YAML（YAML Ain’t Markup Language）是一种人类友好的数据序列化格式，广泛用于配置文件（如Kubernetes、Docker Compose）和数据交换。其核心特点包括：

1. 简洁易读：使用缩进和自然语言风格（如 key: value），比JSON/XML更直观。
2. 数据类型丰富：支持字符串、数字、列表、嵌套对象等，用 – 表示列表，: 表示键值对。
3. 跨语言兼容：主流编程语言（Python、Java等）均有解析库。

典型应用场景包括DevOps工具链、API配置和自动化脚本。

Docker 是一种开源的容器化平台，用于快速构建、部署和运行应用程序。其核心特点包括：

1. 轻量级隔离：基于容器技术（非虚拟机），共享主机系统内核，资源占用低，启动秒级。
2. 跨环境一致性：通过镜像（Image）打包应用及其依赖，确保开发、测试、生产环境一致。
3. 高效编排：支持 Docker Compose 定义多容器服务，或与 Kubernetes 集成实现集群管理。

典型应用场景包括微服务部署、CI/CD 流水线和云原生开发。

是 Docker 官方推出的桌面端开发工具（支持 Windows/macOS），为开发者提供本地容器化开发环境。核心功能包括：

1. 一键管理容器：可视化界面管理镜像、容器和卷，简化 Docker CLI 操作。
2. 集成 Kubernetes：内置单机版 K8s 集群，方便微服务测试与编排。
3. 多平台兼容：支持 Linux 容器（WSL2/Win）和 ARM 架构（M1/Mac），优化性能与资源分配。

适用于本地开发调试、学习容器技术及快速搭建云原生应用原型。

先建立目录，在电脑上新建一个目录，记住路径中不要有中文。下面是我的目录

克隆代码 ，如果出现错误，再重试下，还是不行就得科学上网了。

看着我的截图界面是五颜六色的，因为我用的git bash命令终端。习惯了linux了。

git clone https://github.com/coze-dev/coze-studio.git 

Git 常用命令速览：

1. 基础操作
2. git init：初始化仓库
3. git clone [url]：克隆远程仓库
4. git add [file]：暂存文件变更
5. git commit -m “msg”：提交更改
6. 分支管理
7. git branch：查看/创建分支
8. git checkout/switch [branch]：切换分支
9. git merge [branch]：合并分支
10. 远程协作
11. git pull：拉取远程更新
12. git push：推送本地提交
13. git fetch：获取远程变更（不自动合并）
14. 状态与日志
15. git status：查看工作区状态
16. git log：查看提交历史
17. 撤销操作
18. git reset [commit]：回退版本
19. git revert [commit]：撤销指定提交

适用于日常代码版本控制与团队协作场景。

下面就是开源软件的常规操作，把一个样例模版配置文件拷贝为正式文件。

下面的界面就是我用的PowerShell操作的。其实进入到目录直接复制是一样的效果。但习惯了命令行的都喜欢显摆一把，显的高大上。哈哈。

用记事本打开，或者其他的文本编辑器，不要使用word，写字板啥的，可能会保存时产生多余的字符，或者把格式搞乱了。我用的是一个特殊的记事本，所以有颜色区分，这样的文本编辑器也是程序员，运维，必备。

支持的模型还不少

豆包1.5系列

豆包1.6系列

deepseek系列

Claude系列

Gemini系列

ChatGPT（openai）系列

Qwen（通义）系列

以及可搭载多个大模型的平台（Ollama）

设置 id、meta.conn_config.api_key、meta.conn_config.model 字段，并保存文件。

id：Coze Studio 中的模型 ID，由开发者自行定义，必须是非 0 的整数，且全局唯一。模型上线后请勿修改模型 id 。

meta.conn_config.api_key：模型服务的 API Key，在本示例中为火山方舟的 API Key，获取方式可参考获取火山方舟 API Key。

meta.conn_config.model：模型服务的 model ID，在本示例中为火山方舟 doubao-seed-1.6 模型接入点的 Endpoint ID，获取方式可参考获取 Endpoint ID。

其实，id不用动，就按原来的使用就行。但必须设定api_key和model

帮助文档：
https://www.volcengine.com/docs/82379/

先启动 Docker Desktop，没安装的先去下载安装，如果出现启动失败，删除后重新安装最新版。

https://www.docker.com/

扣子 Coze 教程

Coze Studio 首次部署启动需要获取镜像并构建本地镜像，这可能需要一些时间，请耐心等待。

# Start the service cd docker cp .env.example .env docker compose --profile '*' up -d 

遇到Docker Desktop提示WSL update failed的问题，自行搜索解决。

第一次失败了。

然后用个电梯

这样可以在desktop中管理coze了。

输入网址：http://127.0.0.1:8888/

图像相关组件也没有了，视频也没有了。哈哈。需要自己搞了。

缺少了一些提示词的对比功能和AI生成提示词

只剩19个插件，飞书系的产品都在。

支持API调用和SDK集成

不能从线上版直接复制粘贴工作流，需要重新新建

哈哈，不能让你太方便了。

赶紧动手安装试试吧