文档 · 指南

让团结 Cowork 用任意模型

团结 Cowork(Tuanjie Cowork)是 Unity 中国推出的 AI 协作应用,核心运行 Codely 会话。它设置里的“自定义模型”保存在 ~/.codely/settings.json。magpie 在这里加一个自己的供应商和一个模型,Cowork 就能用 DeepSeek、GLM、Kimi、Qwen、GPT 或 ChatGPT 订阅等 magpie 里的任意模型。

接入团结 Cowork

  1. 在 magpie 里添加供应商在 供应商 页添加 API Key,或登录一个订阅。
  2. 在 Agent 页给团结 Cowork 选模型选一个 via magpie 的模型,magpie 把它写进 Cowork 的自定义模型。
  3. 在 Cowork 的模型菜单里选它只需选一次,见下文。
终端
magpie tuanjie-cowork deepseek/deepseek-v4-pro

写了哪些内容

终端
{
  "customModelProviders": [
    …your own providers, left as they are…,
    {"id": "magpie", "name": "magpie",
     "baseUrl": "http://127.0.0.1:3425/v1",
     "apiKey": "",
     "authType": "openai"}
  ],
  "customModels": [
    …your own models…,
    {"id": "magpie", "providerId": "magpie",
     "model": "deepseek/deepseek-v4-pro",
     "displayName": "deepseek/deepseek-v4-pro",
     "roles": ["model"], "wireApi": "chat",
     "supportsMultimodal": false}
  ]
}

供应商和模型的 id 都是 magpie。供应商指向网关的 /v1,用 magpie 给团结 Cowork 的专用 Key,网关靠这个 Key 认出 Cowork。模型走 Chat Completions(wireApi 为 chat),模型能看图时 supportsMultimodal 为 true。

Cowork 每次查找都重新读这个文件,并把整份写回、保留其他键。会话开始时,它把供应商的 baseUrl 和 Key 作为 OPENAI_BASE_URL 和 OPENAI_API_KEY 传给会话。你自己的供应商和模型保持原样。你在 Cowork 里给 magpie 条目改的名称、角色等字段也会保留。文件不存在时,magpie 用 0600 权限新建,因为里面有 Key。

如果你自己已经有一个 id 为 magpie 的供应商或模型,或者文件不是 Cowork 能读的设置,magpie 会报错,并且不改动文件。Cowork 启动时的迁移只处理没有 providerId 的模型,所以不会动 magpie 的条目。

在 Cowork 里选模型

对话用哪个模型,由 Cowork 自己的模型菜单决定,按工作区记住所选模型的 id。magpie 不写这个选择,所以第一次要在 Cowork 的模型菜单里选 magpie 的模型。因为模型 id 一直是 magpie,之后在 magpie 里换模型,Cowork 选中的这一项就会发新的模型,不用再选。

Cowork 在运行时,magpie 会提示你在模型菜单里选 magpie 的模型。如果菜单里还没有,就重启团结 Cowork。

切回

切回默认时,magpie 删掉自己的供应商和模型。如果 settings.json 是 magpie 新建的,而且删完后没有别的内容,就删掉整个文件。你自己的模型要在 Cowork 的模型菜单里选,magpie 不替你设。

终端
magpie tuanjie-cowork default

常见问题

团结 Cowork 怎么用 DeepSeek、GLM 或 ChatGPT 订阅?

在 magpie 的 Agent 页给团结 Cowork 选一个 via magpie 的模型,magpie 会在 ~/.codely/settings.json 加一个 magpie 供应商和模型。然后在 Cowork 的模型菜单里选它一次。

在 magpie 换了模型,要在 Cowork 里重新选吗?

不用。magpie 的模型 id 始终是 magpie,Cowork 选中的还是这一项,发出去的就是你在 magpie 新选的模型。

我自己的自定义模型会被改吗?

不会。magpie 只增删 id 为 magpie 的条目。如果你已有同 id 的条目,magpie 会报错,不改动文件。

模型菜单里看不到 magpie 的模型怎么办?

重启团结 Cowork。Cowork 在运行时,magpie 也会这样提示。

更多桌面应用用同样的模型:让 OpenBot 用任意模型、让 miniQ 用任意模型、让 Cindy 用任意模型。遇到报错?见 常见错误排查,或到 Discord 提问。