掀桌子！Coze开源啦，十分钟部署到本地

发布日期：2025/7/27 16:06:27 浏览量：

掀桌子！Coze开源啦，十分钟部署到本地

字节跳动于2025年7月26日正式宣布，将AI智能体开发平台“扣子（Coze）”的开源版本——Coze Studio开源，具体信息如下：

• Coze Studio：用于AI Agent开发，提供可视化设计与编排工具，支持零代码或低代码方式快速打造智能体、应用和工作流，适合构建低代码AI产品。
• Coze Loop：用于运维管理（类似罗盘）。
• 许可证：采用Apache‑2.0许可证，允许自由使用、修改及商用，限制极少。
• 技术架构：后端基于Golang开发，前端使用React + TypeScript，整体为微服务架构，遵循领域驱动设计（DDD）原则，具备高性能、高扩展性，便于二次开发。

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

本地部署步骤

• 安装 Docker
• 下载并安装 Coze Studio
• 启动并访问系统界面
• 配置模型（用来运行智能体）
• 更换模型（比如切换到 OpenAI 或智谱）

一. 安装Docker

去 Docker 官网下载：
https://www.docker.com/products/docker-desktop/

二、安装 Coze Studio

首先，打开 Docker Desktop，点击右下角“终端 Terminal”，输入：

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

含义是：
从 GitHub 下载 Coze Studio 的官方代码

按下回车，东西就被拉取下来了。

第二步，输入：

cd coze-studio/docker
意思是：进入 Coze 的 docker 配置文件夹

第三步，输入：

cp .env.example .env
这句话的意思是，把环境配置模板，复制为实际配置

其中，cp：是 copy（复制）的缩写，用于复制文件或目录。然后将当前目录下的 .env.example 文件复制一份，并命名为 .env

最后，输入：

docker compose --profile ’*’ up -d
这个指令的意思是，安装所有配置，然后 Coze Studio 需要的所有服务

docker compose：使用 Docker Compose 运行服务

--profile ’*’：启用所有 profile 配置， * 代表所有

up：启动服务（没有就创建容器，有就重启）。

-d：detached 模式，即后台运行

首次部署，需要构建本地镜像，这可能需要一些时间，请耐心等待

很好，一切部署完成，打开浏览器，访问:

http://localhost:8888/
localhost:8888 是打开本地运行的项目，然后监听的 8888 端口

于是，就可以看到 Coze Studio 的首页了

三、配置模型服务
这时候虽然可访问 UI，但没有模型无法创建智能体或工作流

1、在 terminal 里输入：

open ../backend/conf/model/
如果你是 windows，则输入

start ../backend/conf/model/
意思是，打开上级目录中的 backend/conf/model/ 文件夹

2、这里，我们以配置豆包模型为例，打开文件 ark_doubao-seed-1.6.yaml

修改其中的 model 和 api_key

meta:
conn_config:
api_key: "你的密钥"
model: "doubao-seed-1.6"

Api Key 在哪里获取？

答：各 API 平台都行

比如豆包的 API Key，来自火山（字节的云服务平台）
https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey?apikey=%7B%7D

在这里新建即可

3、保存后，需要重启 Coze 服务生效

docker compose --profile "*" restart coze-server

四、重启后体验 Coze
打开浏览器访问：

http://localhost:8888
此时，就能完整地体验 Coze Studio 了，可以创建智能体、组合工作流

五、如果想更换模型？
1、重新打开 model 配置文件夹，打开 template 文件夹：

open ../backend/conf/model/
2、打开 template 文件夹，找到一个模板，然后复制到上一级目录

3、比如说，我想使用智谱的模型，就复制model_template_basic到上一层文件夹，改名 glm.yaml（名字不影响）

4、修改里面的各种简介，url、 model、api_key等各种信息，然后保存

5、重启 coze-server 服务生效：

docker compose --profile "*" restart coze-server
6、再次访问 Coze，就可以选择新模型了

PS：
插件是第三方服务，你可以在 ../backend/conf/plugin 中定义任何插件。
Apache 2.0 是常见开源协议中最开放的：

• 可商用：可商业使用，无附加条款
• 专利授权：明确授权，无后顾之忧