你可能还没意识到,Coze 开源这步棋,藏着多大的能量!
对开发者来说,开源从来不是简单的 "代码共享"------ 它意味着你能拿到完整源码,可以基于开源协议做二次开发时,你不再受限于固定框架:可以定制专属功能适配细分场景,能嫁接自有技术栈打造差异化产品,甚至能从这些创新中孵化出全新的商业模式。
说白了,开源给了开发者一把 "万能钥匙",过去 Coze 的云服务模式,确实让对数据安全零容忍的企业望而却步,只能聚焦 C 端场景。
但现在,Coze 开源了。 这对企业意味着数据安全可控,满足合规要求,适配企业个性化需求。降低长期成本,摆脱供应商依赖。

该项目采用Apache2.0许可证,这意味着相关代码:
- 可商用:可商业使用,无附加条款
- 专利授权:明确授权,无后顾之忧
- 社区共建:与全球开发者一起,共建未来
基础概念速览
- GitHub 是什么 可以理解为「代码的网盘」,开发者们在这里存放和共享代码。我们通过GitHub下载Coze的代码,就像从网盘下载文件一样简单。
- 用到的下载工具git:可以理解为「网盘软件」,开发者通常使用这个软件下载代码到本地。
- Docker是什么 想象成「软件集装箱」,把应用程序和它需要的环境打包成一个标准箱子(容器),这样无论用Windows/Mac都能正常运行,避免出现"我电脑上好好的啊"这类问题。
安装环境,门槛超低,双核CPU+4G内存即可运行。基本上就是,是个电脑都能使用。

流程一共分为四步:
- 下载并安装Docker。Docker简单理解就是一个运行Coze等工具的软件,里面有各种Coze需要的组件,所以是安装Coze的前提,一定要安装。
- 下载Coze安装包。GitHub上下载源码或压缩包文件,这个文件码蜂AI已经为大家准备好了,不会下载的同学可以私信我领取。
- 进入到Coze安装包文件夹,用安装命令进行安装。
- 初始化Coze后台,设置用户名和密码等,然后登录使用就可以了。
就这么简单,我们来一步一步操作一下吧~
一、下载并安装Docker
因为大部分同学使用的都是Windows系统的电脑,所以这里为大家讲解的是Windows系统上的安装方法。
- 下载Docker
访问网址:www.docker.com/products/do...
下载如图所示的安装包:

注意:安装docker需要win10以上版本,也就是win10或win11都可以安装。如果是 Windows 10 ,需要且必须开启 Hyper-V,系统版本需要v19044 及以上版本。这里要注意一下,如果低于这个版本是安装不上的。
- 开启Hyper-V
- 打开 控制面板 - 程序 - 启动或关闭windows功能
- 在对话框中分别选中打开:

或者安装wsl2,打开命令窗,输入wsl --install

- 运行安装包
下载后我们就获得了一个安装包文件:

双击这个文件进行安装,这个就是正常的客户端安装包,直接安装即可。

wsl2和Hyper是两种不得同的虚拟机技术,可自行选择。
可以看到如下的安装状态:

安装完成后,不登录,打开Docker。

在安装Coze之前,我们要先进行Docker中镜像网站的设置,因为默认的镜像是国外的网址,访问不到,国内或没有加速器的需要配置docker镜像源,修改方式如下:
点击右上角设置--选择Docker Engine。

配置内容如下:
json
{
"debug": true,
"default-address-pools": [
{
"base": "10.255.0.0/16",
"size": 24
}
],
"log-level": "debug",
"max-concurrent-downloads": 20,
"registry-mirrors": [
"https://mirrors-ssl.aliyuncs.com/",
"https://hub-mirror.c.163.com",
"https://docker.mirrors.ustc.edu.cn",
"https://registry.docker-cn.com",
"https://k4lo9gcp.mirror.aliyuncs.com",
"https://docker.registry.cyou",
"https://docker-cf.registry.cyou",
"https://dockercf.jsdelivr.fyi",
"https://docker.jsdelivr.fyi",
"https://dockertest.jsdelivr.fyi",
"https://mirror.aliyuncs.com",
"https://dockerproxy.com",
"https://mirror.baidubce.com",
"https://docker.m.daocloud.io",
"https://docker.nju.edu.cn",
"https://docker.mirrors.sjtug.sjtu.edu.cn",
"https://docker.mirrors.ustc.edu.cn",
"https://mirror.iscas.ac.cn",
"https://docker.rainbond.cc",
"https://do.nark.eu.org",
"https://dc.j8.work",
"https://dockerproxy.com",
"https://gst6rzl9.mirror.aliyuncs.com",
"https://registry.docker-cn.com",
"http://hub-mirror.c.163.com",
"http://mirrors.ustc.edu.cn/",
"https://mirrors.tuna.tsinghua.edu.cn/",
"http://mirrors.sohu.com/"
]
}
好了,到这里,Docker已经安装配置好了。
二、下载Coze安装包

正常情况下,我们需要通过git clone的方式从Github上进行获取。
bash
git clone https://github.com/coze-dev/coze-studio.git
但是由于网络访问、git工具使用等的原因,这里也直接为大家下载好了。
需要的同学评论区留言:coze学习,并截图发送给码蜂AI,我会把coze安装包发给大家。
解压后的文件目录

三、安装并启配置模型(官方)
Coze Studio 是一个基于 LLM 的 AI 应用开发平台。首次部署并启动 Coze Studio 开源版本之前,您需要在 Coze Studio 项目中配置模型服务。否则,在创建代理或工作流时将无法正确选择模型。
- 从模板目录复制doubao-seed-1.6模型的模板文件,并粘贴到配置文件目录中。
首先,进入根目录coze-studio下,在地址栏中输入"cmd"并按回车键。

执行复制模型文件命令(这是windows系统命令):
arduino
copy backend\conf\model\template\model_template_ark_doubao-seed-1.6.yaml backend\conf\model\ark_doubao-seed-1.6.yaml
可以看到对应文件:

2.修改配置文件目录中的模板文件
使用记事本或notepad等工具打开ark_doubao-seed-1.6.yaml文件
填入对应的参数
-
id:Coze Studio 中的模型 ID,由开发者自主定义,必须为非零整数,全局唯一。模型上线后请勿修改模型 ID。
-
meta.conn_config.api_key:在线模型服务的 API Key,获取方式 见下方获取Key和Model接入点的api_key。
-
meta.conn_config.model:在线模型服务的模型 ID。本例中为 Volcengine Ark doubao-seed-1.6 模型接入点的 Endpoint ID,获取方式 见下方获取Key和Model接入点的model。
3,获取Key和Model接入点
进入火山官网后注册登录,官网如下:
console.volcengine.com/auth/login
登录完成后进入火山方舟,地址如下:
console.volcengine.com/ark/region:...
首先获取model的模型ID。
点击左侧在线推理,选择自定义推理接入点,点击创建推理接入点

输入一些基本信息,接入点名称填入:Coze本地化部署,接入点描述填入:Coze本地化部署,随意填写的内容。

选择对应模型,自行选择,这里选择的是doubao-seed-1.6大模型。

开通模型并接入

随后自动跳转以下界面,左上方的ID即为对应的model模型ID。

接着获取api_key。

创建成功后,自动跳转页面,点开小眼睛,就是对应的api_key,复制出来。

获取成功后,使用记事本或notepad等工具打开ark_doubao-seed-1.6.yaml文件。
第一行的id就是这个coze模型的id,随便填就行,我填的是155166

接着往下滑动文件,大概110行,复制输入上方获取的model和api_key即可。

四、安装并启动Coze
大家可以看到,上面这个图中有一个名叫docker的目录,我们要进入到这个项目文件夹中,进行安装。

在目录框里输入cmd,回车键,验证docker安装是否有问题

输入docker,点击回车键后,返回下图这样的结果,表明安装是成功的,没有任何问题。

故障排查:
• 如果提示"command not found",请检查:
◦ 安装时是否勾选了"添加到PATH"
◦ 可能需要重启电脑使PATH生效
现在进行环境变量配置。
执行如下命令,重命名环境配置文件
bash
cp .env.example .env
如果提示'cp' 不是内部或外部命令,也不是可运行的程序。
则执行:copy .env.example .env

Docker就是运行Coze等工具的软件,所以我们要在Docker里启动Coze,首次启动可能需要5-10分钟(依赖网络速度),运行一下这条命令:
arduino
docker compose --profile '*' up -d

安装结束后,查看运行状态:
docker compose ps
最后我们打开安装好的docker客户端,正常就可以看到docker启动起来了。

五、初始化并访问Coze管理界面
安装好后,我们打开浏览器,访问http://localhost:8888/来打开 Coze Studio ,可以看到如下界面。

登录进去,即可正常使用了

关于Coze的使用,以及工作流的搭建,我也会在之后的教程中为大家讲解, 大家可以关注我们,持续发布新的教程,下期见~