Coze平台指南（2）：开发环境的搭建与配置

1. Coze开源概述与环境准备

字节跳动于2025年7月26日正式开源其AI智能体开发平台"扣子"（Coze），包含Coze Studio可视化开发工具和Coze Loop运维管理系统两大核心组件。它采用Apache 2.0许可证，允许免费商业使用，无隐藏条款。

1.1 硬件要求

Coze的硬件要求非常亲民：

• CPU：2核或以上

• 内存：4GB或以上

• 存储空间：至少2GB可用空间

这意味着普通家用电脑即可流畅运行，真正将AI开发门槛拉低到"家用电脑级"。

1.2 软件依赖

Coze本地部署的唯一前置依赖是Docker，它的作用是为Coze创建隔离的运行环境，避免了繁琐的环境配置工作。
 

2. 安装Docker

Docker是容器化平台，允许你轻松打包、分发和运行应用程序。

2.1 安装步骤

1. 访问Docker官网下载适合你操作系统的安装包。

2. 双击安装包，按照向导完成安装（Windows用户需要启用Hyper-V功能，安装过程中若提示重启请同意）。

3. 安装完成后打开Docker Desktop，确认状态栏显示"Running"。

💡 提示：如果从Docker官网下载速度慢，可以使用国内镜像包。

2.2 验证安装

安装完成后，打开终端或命令提示符，运行以下命令验证Docker是否安装成功：

docker --version
docker compose version

如果这两个命令都能正确输出版本信息，说明Docker已成功安装。
 

3. 获取Coze源码

Coze的源代码托管在GitHub上，我们可以通过git命令获取：

1. 打开终端（Docker Desktop内置终端或系统终端）

2. 执行以下命令克隆代码仓库：

# 克隆Coze Studio代码仓库
git clone https://github.com/coze-dev/coze-studio.git

# 进入docker配置目录
cd coze-studio/docker

# 复制环境配置文件
cp .env.example .env

⚠️ 注意：Windows用户如果使用命令提示符（CMD），可能需要将cp命令替换为copy：

copy .env.example .env

对于不熟悉git的用户，可以直接在GitHub下载ZIP压缩包并解压，然后手动进入coze-studio/docker目录创建.env文件。
 

4. 配置模型服务（关键步骤）

这是最关键的一步，不配置模型将无法创建智能体。Coze支持多种大语言模型，包括DeepSeek、OpenAI、Claude、Qwen、Gemini、豆包等。以下以配置DeepSeek模型为例：

4.1 创建模型配置文件

1. 进入模型配置目录：

   # Mac/L