字节跳动于2025年7月26日开源其AI智能体开发平台Coze（中文名“扣子”），包含Coze Studio可视化开发工具和Coze Loop运维管理系统两大核心组件。短短48小时内GitHub星标数突破9000+，最大亮点在于其极致亲民的硬件要求——普通家用电脑即可流畅运行。本文将提供一步一图的完整本地部署指南，即使你是零基础小白也能轻松搞定。
2025测试开发全景图：人工智能测试、智能驱动、自动化、测试开发、左移右移与DevOps的持续交付
一、环境准备：安装Docker
Docker是唯一前置依赖，用于创建隔离运行环境：
- 下载安装包
Docker官网下载地址：(www.docker.com/products/do…)
国内用户若下载慢，可使用飞书镜像包：(ay6exk7fyt.feishu.cn/drive/folde…) - 安装设置
-
- Windows系统：安装时勾选启用Hyper-V（安装过程中若提示重启需同意）
- Mac系统：直接拖拽安装，无需特殊设置
- 安装完成后打开Docker Desktop**，确认状态栏显示 “Running” ✅
二、获取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包(github.com/coze-dev/co…
三、关键步骤：配置模型服务
未配置模型将无法创建智能体！ 以配置DeepSeek模型为例：
# 进入模型配置目录（Windows用start替换open）
open ../backend/conf/model/
# 复制DeepSeek模板文件
cp ../backend/conf/model/template/model_template_ark_volc_deepseek-r1.yaml backend/conf/model/deepseek-r1.yaml
- 用文本编辑器打开
deepseek-r1.yaml - 修改以下参数：
base_url: "https://api.deepseek.com/v1"
api_key: "sk-xxxxxxxx" # 在[DeepSeek平台](https://platform.deepseek.com/)申请
model: "deepseek-reasoner"
💡 支持多模型切换：OpenAI、Claude、Qwen、Gemini、豆包等配置方法类似
2025测试开发全景图：人工智能测试、智能驱动、自动化、测试开发、左移右移与DevOps的持续交付
四、一键启动服务
在coze-studio/docker目录执行：
docker compose --profile '*' up -d
- 首次运行需下载镜像（约5-10分钟，取决于网络）
- 出现
Container coze-server Started提示即启动成功 - 访问控制台：👉 http://localhost:8888
五、避坑指南：高频错误解决方案
| 错误类型 | 现象 | 解决方案 | |
|---|---|---|---|
| 端口冲突 | 提示Ports are not available | 执行 `netstat -ano | findstr :3306 查PID后结束进程，或修改docker-compose.yml`端口 |
| MySQL启动失败 | 报错MYSQL_USER cannot be "root" | 删除系统环境变量中的MYSQL_USER和MYSQL_PASSWORD | |
| Elasticsearch报错127 | 启动时异常退出 | 用VSCode打开docker/volumes/elasticsearch/setup_es.sh，右下角切换CRLF为LF格式 |
六、进阶技巧：切换模型实战（以Qwen为例）
-
复制模板文件到配置目录：
cp ../backend/conf/model/template/model_template_basic ../backend/conf/model/qwen.yaml -
修改
qwen.yaml内容：id: 2 # 保持唯一性，不可与其他模型重复 name: "qwen3-235b" meta.conn_config: base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1" api_key: "阿里百炼申请的KEY" model: "qwen3-235b-a22b-instruct-2507" -
重启服务生效：
docker compose --profile '*' restart coze-server
为什么选择开源Coze？
- 零成本商用：采用Apache 2.0协议，允许免费商业使用无隐藏条款
- 全链路开源：覆盖Agent开发（Studio）、测试/运维（Loop）、部署（SDK）
- 硬件平民化：告别动辄16G显存的GPU，普通笔记本即可运行AI工作流
部署完成后访问 http://localhost:8888 ，输入任意邮箱密码即可注册登录，你的第一个AI Agent已就绪！
此刻，你已站在AI智能体开发的最前沿。从拉取代码到界面打开，操作时间不足10分钟——这种“无痛感”正是Coze开源的革命性意义：让每个有想法的普通人，都能成为AI创造者。
