新手必看！详细图文教程教你轻松掌握扣子（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的介绍。

1、GitHub

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

既然这是一个全球性的网站，使用时可能需要科学上网。

2、Git

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

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

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

了解了代码管理工具后，就可以开始搜索、下载和安装了。

Git 是一种软件，而clone（克隆）是其命令之一，可以简单理解为复制或下载。

接下来看看相关命令

3、Yaml

YAML（YAML Ain’t Markup Language）是一种人性化的数据序列化格式，广泛应用于配置文件（如Kubernetes、Docker Compose）及数据交流。其主要特点包括：

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

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

4、Docker

Docker 是一个开源的容器化平台，旨在快速构建、部署和运行应用程序。其主要特点包括：

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

其典型的应用场景包括微服务部署、CI/CD流程及云原生开发。

5、Docker Desktop

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

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

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

二、安装步骤1、下载代码

首先需要创建一个目录，在电脑上新建一个文件夹，确保路径中不包含中文字符。以下是我创建的目录示例。

高效掌握Git命令与操作流程

参考文章：电费暴涨？AI写作神器助你省下50%电费，方法超简单！

在克隆代码时，如果遭遇问题，可以尝试重新执行命令，如果仍然无法解决，就需要使用翻墙工具了。

如图所示，我的命令行界面色彩斑斓，原因在于我使用的是git bash终端，已经习惯了Linux的操作。

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

参考文章：提升写作效率，AI写作助手如何助力个人创作成就？

以下是常用的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，由开发者自行设定，务必是一个非零整数，并且在全局范围内唯一。模型上线后，请勿更改该ID。

meta.conn_config.api_key：这是模型服务的API密钥，在本例中是火山方舟的API密钥，获取方法请参考火山方舟API密钥获取说明。

meta.conn_config.model：该字段表示模型服务的模型ID，在本示例中为火山方舟的doubao-seed-1.6模型的接入点ID，获取方式请参见获取Endpoint ID的相关说明。

实际上，id部分无需修改，可以保持原样使用。但必须确保api_key和model字段已被设置。

api_key的获取方法

参考文档：
https://www.volcengine.com/docs/82379/1541594

如何获取模型

四、服务的部署与启动

首先，确保 Docker Desktop 已经启动。如果尚未安装，请前往官方网站下载并安装，若遇到启动失败的情况，建议卸载后重新下载最新版本进行安装。

Home

进行 Coze Studio 的首次部署时，需先下载并构建本地镜像，该过程可能会占用一些时间，请耐心等待。

# 启动服务
cd docker
cp .env.example .env
docker compose --profile '*' up -d

如果遇到 Docker Desktop 提示 WSL 更新失败的问题，请自行查找解决方案。

第一次尝试失败了。

接下来，我们乘坐电梯。

这样就可以在桌面上管理 Coze 了。

三、运行效果展示

1、账户注册与登录

请访问网址：http://127.0.0.1:8888/

2、界面整体展示

三、节点模块

与图像相关的组件也已不复存在，视频内容也消失了，真是让人哭笑不得，我们需要自己去处理这些了。

四、智能体编排界面

对比功能和AI生成的提示词有些缺失。

五、插件模块

目前仅存19个插件，飞书系列的产品依旧在列。

6、发布相关内容

系统支持API接口调用及SDK的集成。

7、复制工作流

无法直接从线上版本复制工作流，需要重新创建

哈哈，不能让你轻松使用哦。

快来动手安装体验一下吧！