1. 为什么要在本地跑 Coze 开源版Coze 开源版Coze Studio是字节把可视化 Agent 开发平台放出来的版本核心能力是拖拽式编排工作流、插件调用、知识库挂载和多轮对话调试。它适合两类人一类是想把 Agent 逻辑跑在自己机器上、不想把数据传到第三方 SaaS 的开发者另一类是手头只有一台普通笔记本或 2 核 4G 小主机想低成本验证工作流可行性的团队。我这次部署的目标很明确用 Docker Compose 把 Coze Studio 拉起来模型侧不走各家官方 SDK 直连而是统一通过 TaoToken 的 API 通道接入 DeepSeek。这样做的好处是 Key 管理集中、切换模型只改一个 base_url后面想换 Qwen 或 Claude 也不用重新配环境变量。整个流程拆成四块环境准备、TaoToken 侧拿 Key、docker-compose 与模型配置、启动后验证连通性。按步骤走10 分钟内能打开http://localhost:8888看到界面。2. TaoToken 前置拿 Key 与确认通道TaoToken 在这里扮演的是「统一模型入口」的角色。Coze 的模型配置文件里需要填base_url和api_key如果每个模型都去对应厂商申请 Key配置会散落在多个文件里。用 TaoToken 之后所有模型共用同一个 API 地址和同一套 Key配置文件只改model字段即可。第一步打开官网注册并登录https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content登录后进入控制台在「API Keys」页面创建一个新 Key。建议按项目命名比如coze-local方便后面排查是哪个环境在用。https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建完 Key 后API 请求地址统一用https://taotoken.net/api注意这个地址不带任何查询参数直接作为base_url填入 Coze 的模型配置。如果你后面要接 Claude Code 或做长期编码任务可以另外看 Coding Plan 页面但本篇只聚焦 Coze 的模型接入。提示Key 只在创建时完整显示一次复制后先存到本地.env或密码管理器不要直接写进会提交到 Git 的配置文件。3. 可复制配置docker-compose 与模型文件3.1 拉源码与目录结构先克隆 Coze Studio 仓库进入 docker 目录git clone https://github.com/coze-dev/coze-studio.git cd coze-studio/docker cp .env.example .env目录里最关键的两个位置docker-compose.yml负责容器编排../backend/conf/model/负责模型定义。Coze 的模型配置是「一个模型一个 yaml 文件」启动时扫描该目录加载。3.2 docker-compose.yml 骨架官方 compose 文件已经包含 MySQL、Redis、Elasticsearch、coze-server 等服务。我实测下来不需要大改只需要确认端口不冲突、.env里的数据库账号不是 root。下面是我用的精简骨架保留核心服务services: mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: coze_root_pwd MYSQL_DATABASE: coze MYSQL_USER: coze_user MYSQL_PASSWORD: coze_pwd ports: - 3306:3306 volumes: - ./volumes/mysql:/var/lib/mysql redis: image: redis:7 ports: - 6379:6379 elasticsearch: image: elasticsearch:8.13.0 environment: - discovery.typesingle-node - xpack.security.enabledfalse ports: - 9200:9200 coze-server: build: .. depends_on: - mysql - redis - elasticsearch ports: - 8888:8888 volumes: - ../backend/conf/model:/app/backend/conf/model关键点coze-server把宿主机的模型配置目录挂载进容器这样改完 yaml 重启容器就生效不用重新 build 镜像。3.3 模型配置接入 DeepSeek进入模型配置目录复制模板并重命名cd ../backend/conf/model cp template/model_template_ark_volc_deepseek-r1.yaml deepseek-r1.yaml编辑deepseek-r1.yaml把连接信息改成 TaoToken 的通道id: 1 name: deepseek-r1 meta: conn_config: base_url: https://taotoken.net/api api_key: sk-你的TaoTokenKey model: deepseek-reasoner这里id必须全局唯一多个模型文件不能重复。model字段填 DeepSeek 对应的模型名base_url固定用 TaoToken 的 API 地址。保存后回到 docker 目录启动cd ../../docker docker compose --profile * up -d首次启动会拉镜像5 到 10 分钟不等。看到所有容器状态为running后浏览器打开http://localhost:8888。4. 验证请求确认模型真的通了界面能打开不代表模型通了。Coze 的模型调用是服务端发起的所以要在容器内部验证。先确认 coze-server 容器在运行docker compose ps然后进容器用 curl 直接打 TaoToken 的接口模拟一次对话请求docker exec -it docker-coze-server-1 sh curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: deepseek-reasoner, messages: [{role: user, content: 你好回复一个字}] }如果返回 JSON 里choices[0].message.content有内容说明 Key、base_url、模型名三者都对。接着回到 Coze 界面新建一个 Agent在模型下拉里选deepseek-r1发一条测试消息。能正常回复就说明整条链路打通了。实测下来最容易出问题的是model字段和 TaoToken 侧实际支持的模型名不一致。如果 curl 返回model not found先去模型对话页面确认可用模型列表再回来改 yaml。5. 本篇常见错排查5.1 端口被占用启动时报Ports are not available通常是 3306 或 6379 被本机已有服务占了。查占用进程netstat -ano | findstr :3306拿到 PID 后结束进程或者直接改docker-compose.yml里的端口映射比如把3306:3306改成13306:3306。5.2 MySQL 启动失败报错MYSQL_USER cannot be root说明系统环境变量里残留了MYSQL_USERroot。删掉这两个环境变量再重启unset MYSQL_USER unset MYSQL_PASSWORD docker compose --profile * up -d5.3 Elasticsearch 退出码 127这是setup_es.sh脚本换行符问题。用编辑器打开docker/volumes/elasticsearch/setup_es.sh把 CRLF 切成 LF 保存再重启容器。5.4 模型配置不生效改完 yaml 后必须重启 coze-server光重启界面没用docker compose --profile * restart coze-server如果还是旧配置检查挂载路径是否正确进容器cat /app/backend/conf/model/deepseek-r1.yaml看内容是不是你改的那份。5.5 请求返回 401401 基本是 Key 问题。确认三件事Key 有没有复制完整、Authorization头是不是Bearer开头、Key 有没有被禁用。可以到 API Keys 页面重新生成一个再试。6. 后续怎么用这套环境环境跑起来之后日常操作就三件事在 Coze 界面拖工作流、改模型 yaml 切模型、看容器日志排障。切模型时只改base_url和model两个字段Key 不用动这是用 TaoToken 统一通道最省事的地方。如果你后面要做长期编码或 Agent 任务可以看 Coding Plan 页面了解额度方案单纯验证模型连通性模型对话页面就够用接入文档里有完整的接口说明和参数列表遇到字段不确定时直接查。https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后留一个我踩过的坑Coze 的模型配置文件里id重复不会报错但会导致模型列表里只显示一个。每次新增模型文件先把id改成没出现过的数字再重启服务。