Coze开源版当地部署指南
2核CPU+4GB内存即可运行，10分钟无痛部署AI智能体开发平台字节跳动于2025年7月26日开源其AI智能体开发平台Coze（中文名“扣子”），包罗Coze Studio可视化开发工具和Coze Loop运维管理系统两大核心组件。短短48小时内GitHub星标数突破9000+，最大亮点在于其极致亲民的硬件要求——平凡家用电脑即可流畅运行。本文将提供一步一图的完备当地部署指南，纵然你是零根本小白也能轻松搞定。
一、环境准备：安装Docker
Docker是唯一前置依赖，用于创建隔离运行环境：
1. 下载安装包
[*]Docker官网下载地址：(https://www.docker.com/products/docker-desktop)
[*]国内用户若下载慢，可使用飞书镜像包：(https://ay6exk7fyt.feishu.cn/drive/f**older/IccNf2B4JlJOIvd2kWfcpYnRn4l)
2. 安装设置
[*]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包(
https://github.com/coze-dev/coze-studio/archive/refs/heads/main.zip)，解压后进入coze-studio/docker目次手动创建.env文件。
三、关键步骤：配置模型服务
未配置模型将无法创建智能体！ 以配置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" # 在(https://platform.deepseek.com/)申请
model: "deepseek-reasoner"
支持多模型切换：OpenAI、Claude、Qwen、Gemini、豆包等配置方法雷同
四、一键启动服务
在coze-studio/docker目次实行：
docker compose --profile '*' up -d
[*]初次运行需下载镜像（约5-10分钟，取决于网络）
[*]出现Container coze-server Started提示即启动乐成
[*]访问控制台： http://localhost:8888
五、避坑指南：高频错误办理方案
https://dis.qidao123.com/imgproxy/aHR0cHM6Ly9pLWJsb2cuY3NkbmltZy5jbi9kaXJlY3QvMzM5YmI5NTU2MjlmNDM1ZDg3OTZlMjY0M2QyOGRlZDIucG5n
六、进阶技巧：切换模型实战（以Qwen为例）
1. 复制模板文件到配置目次：
cp ../backend/conf/model/template/model_template_basic ../backend/conf/model/qwen.yaml
2. 修改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"
3. 重启服务见效：
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创造者。
人工智能（Coze）技能学习交流群
https://dis.qidao123.com/imgproxy/aHR0cHM6Ly9pLWJsb2cuY3NkbmltZy5jbi9kaXJlY3QvYzhhOWY5OThiZGQ5NDM0NDhlMDU2NTg5NWI1ODJjMmYucG5nI3BpY19jZW50ZXI=
https://dis.qidao123.com/imgproxy/aHR0cHM6Ly9pLWJsb2cuY3NkbmltZy5jbi9kaXJlY3QvZTM3ODAwMTI3NGQzNGY4N2IyODE4NTQzMWZiYTEyYzYucG5nI3BpY19jZW50ZXI=
推荐阅读：
[*] 手把手教你搭建MCP服务器
[*] Playwright-MCP欣赏器会话复用全解析
[*] Playwright 自动化测试系列（7）| 第三阶段：测试框架集成Page Object 模式
[*] Playwright 自动化测试系列（6）| 第三阶段：测试框架集成指南：参数化测试 + 多欣赏器并行实行
[*] Playwright自动化测试系列课（5） | 调试神器实战：Trace Viewer 录屏分析 + AI 辅助定位修复
[*] Playwright自动化测试系列课（4） | 异步加载克星：自动等待 vs 智能等待计谋深度解析
[*]Playwright自动化测试系列课（3） | 第二阶段：核心技能与调试 交互操作大全
[*]Playwright系列课（2） |元素定位四大法宝：CSS/文本/XPath/语义化定位实战指南
[*]Playwright 极速入门：1小时搞定环境搭建与首个测试脚本
[*] Agent的深度解析：从原理到实践
[*] Kimi K2开源炸场，1万亿参数碾压GPT-4.1，成本仅Claude 4的1/5！
[*] 10+热门 AI Agent 框架深度解析：谁更适合你的项目？
页:
[1]