1.png

字节跳动于2025年7月26日开源其AI智能体开发平台Coze（中文名“扣子”），包含Coze Studio可视化开发工具和Coze Loop运维管理系统两大核心组件。短短48小时内GitHub星标数突破9000+，最大亮点在于其极致亲民的硬件要求——普通家用电脑即可流畅运行。本文将提供一步一图的完整本地部署指南，即使你是零基础小白也能轻松搞定。

一、环境准备：安装Docker

Docker是唯一前置依赖，用于创建隔离运行环境：
下载安装包

• Docker官网下载地址：(https://www.docker.com/products/docker-desktop)
• 国内用户若下载慢，可使用飞书镜像包：(https://ay6exk7fyt.feishu.cn/drive/f**older/IccNf2B4JlJOIvd2kWfcpYnRn4l)

安装设置

• Windows系统：安装时勾选启用Hyper-V（安装过程中若提示重启需同意）
• Mac系统：直接拖拽安装，无需特殊设置
• 安装完成后打开Docker Desktop，确认状态栏显示 “Running” ✅
• 无需通过用户名密码登录Docker

二、增加Docker镜像

1、启动Docker 点击右下角docker图标 点击change settings

2、点击Docker Engine 修改json文件

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "registry-mirrors": [
    "https://docker.xuanyuan.me",
    "https://docker.m.daocloud.io",
    "https://docker.1ms.run"
  ]
}

三、获取Coze源码

打开Docker Desktop内置终端（右下角Terminal图标）
逐行执行以下命令👇：

# 克隆官方仓库代码
git clone https://github.com/coze-dev/coze-studio.git
# 进入docker配置目录
cd coze-studio/docker
# 复制环境配置文件
cp .env.example .env

无Git用户替代方案：
在GitHub直接下载ZIP包(https://github.com/coze-dev/coze-studio/archive/refs/heads/main.zip)，解压后进入coze-studio/docker目录手动创建.env文件。

四、关键步骤：配置模型服务

未配置模型将无法创建智能体！ 以配置Qwen模型为例：

进入模型配置目录

在coze-studio文件夹下

cd backend/conf/model/template

复制DeepSeek模板文件

在template文件夹中找到Qwen相关配置文件复制一份 model_template_qwen.yaml
在将复制的文件放到上一层model文件夹中进行配置文件修改，model_template_qwen.yaml 文件中的所有字段都不要删除，只要修改id、name、base_url、api_key、model就可以了，特别注意id不要重复，特别注意id不要重复，特别注意id不要重复。

model.png

💡 支持多模型切换：OpenAI、Claude、Qwen、Gemini、Doubao等配置方法类似，都是在backend/conf/model/template文件夹中找到对应的模型模板文件，复制一份到backend/conf/model文件夹中在修改id、name、base_url、api_key、model就可以了，特别注意id不要重复，特别注意id不要重复，特别注意id不要重复。

五、一键启动服务

在coze-studio文件夹中的docker文件夹中执行：

docker compose --profile '*' up -d

• 首次运行需下载镜像（约5-10分钟，取决于网络）
• 出现Container coze-server Started提示即启动成功
• 访问控制台：👉 http://localhost:8888

恭喜您，本地扣子空间部署完毕~

本文参考链接地址：https://developer.aliyun.com/article/1674357
有哪里不懂得还可以留言咨询我哦~