管理适配器与模型

本指南说明如何连接模型提供商，以及如何为智能体选择运行平台。

这里的一切都在同一个页面上：设置 → 服务器 → 模型提供商。子侧边栏中的条目名为“模型提供商”；页面标题为“适配器”。

适配器是什么

适配器是执行智能体回合的_运行器_。共有两个，且列表是固定的——你无法添加第三个。

适配器	CLI	传输方式
Control Center (built-in)	无	进程内智能体循环，通过 HTTP 与提供商通信
Claude Code	`claude`	`claude -p --output-format stream-json`

Cursor、Codex、Anthropic、OpenAI 以及其他都是内置适配器上的提供商，而不是各自独立的 CLI。你_可以_添加的是另一个提供商——任何兼容 OpenAI 或兼容 Anthropic 的端点。那就是下一节的内容。

连接模型提供商

内置适配器在能够运行之前，至少需要一个已连接的提供商。目录中随附了十四个。

前往 设置 → 服务器 → 模型提供商
滚动到提供商与模型
找到你的提供商并连接它：

提供商	连接方式
Anthropic	API 密钥。Claude Pro/Max 订阅不是 Anthropic API 登录——该套餐请使用 Claude Code 适配器
OpenAI、Codex、Cursor	浏览器 OAuth 登录，或 API 密钥。Codex 是通过 Codex Responses 后端提供的 ChatGPT Plus/Pro，而不是派生出的 CLI
Kimi Code	仅支持浏览器 OAuth——一种设备码流程。它是统一费率的套餐，因此没有按 token 计费的价格
OpenRouter、Google Gemini、DeepSeek、Mistral、xAI、z.ai、z.ai GLM Coding Plan、Moonshot (Kimi API)	API 密钥

检查点：该行的徽章会变为已连接，展开后它会列出该提供商所提供的模型，每个模型都带有每百万 token 的价格和上下文窗口。

OAuth 令牌会存入服务器自己的凭据存储，并会在过期前刷新。提供商凭据是主机全局的——它们由该安装上的每个工作区共享，而不是只属于某一个工作区。

添加自定义提供商

适用于 Ollama、LM Studio、vLLM 或私有部署。

在提供商与模型中，于自定义提供商下，按添加提供商
填写名称，选择 API 类型（兼容 OpenAI 或兼容 Anthropic），并给出基础 URL（例如 http://localhost:11434/v1）
如果端点需要，再添加一个 API 密钥，然后按添加提供商

自定义提供商会出现在同一个列表中，并带有一个其内置同类所没有的删除按钮。

为智能体选择模型

前往 设置 → 工作区 → 智能体 并选择该智能体
在设置标签页上，选择适配器
从旁边的下拉列表中选择模型

对于内置适配器，该下拉列表是根据每个已连接提供商自己的目录实时组装的。没有存储凭据的提供商贡献零个模型，这正是空下拉列表几乎总是意味着“尚未连接任何提供商”、而不是“没有可用模型”的原因。

内置适配器的模型 id 是带限定符的 provider/model，并且可以带一条以 | 分隔的回退链。在存在回退时，费用按实际服务该回合的模型计价，而不是按你请求的那个模型计价。

每个工作区都会预置五个智能体——一位 CEO 加上 qa、architect、engineer 和 librarian——它们都没有适配器，也没有模型。派发会回退到 Control Center (built-in)，而不是本页上的默认运行器设置；后者是客户端偏好，派发路径从不读取它。运行日志会为这些运行记录 cc-harness，因此转录会写明实际运行的到底是什么。

同样没有模型时，内置循环会向 Anthropic 索取其默认模型。因此，完全未做设置的智能体，只有在你已连接 Anthropic 账号时才能运行，否则会以 No credential for provider "anthropic" 失败。

完成入门流程的适配器步骤时，会用你选择的这一组适配器与模型回填每一个仍然缺少适配器或模型的智能体——CEO 与各专家，覆盖当时已存在的所有工作区。之后创建的工作区仍然会把五个智能体全部预置为未设置状态。请在你打算使用的每个智能体上显式设置适配器和模型。

安装运行器 CLI

内置适配器无需安装。对于 Claude Code，请用该工具自己的包管理器在服务器主机上安装它的 CLI，例如：

npm install -g @anthropic-ai/claude-code

然后按页面顶部的刷新。每个检测到的行都会显示解析出的版本和路径，并附有标明它是否支持 JSON 模式和模型选择的标签。

外部 CLI 在服务器主机上以自己的配置保存自己的凭据。Control Center 不管理它们。

限制工作区可使用的提供商

提供商治理按工作区进行，并采用最后匹配胜出的方式评估。

在提供商与模型中，将提供商行上的允许开关关闭

这会在活动工作区中为该提供商写入一条 deny 语句，其模型也会从该工作区的目录中消失。重新打开该开关即会移除这条语句。

故障排查

运行器显示为未找到

检查 CLI 是否位于服务器主机的 PATH 上，而不只是你自己的 PATH
通过 GUI 启动的桌面应用会用最小化的 PATH 派生其服务器；安装在仅 shell 可见路径下的 CLI 可能对它不可见
安装后按刷新

模型下拉列表为空

适配器是内置的那个，且没有连接任何提供商——请在提供商与模型中连接一个
或者提供商已连接，但被该工作区的治理开关拒绝

模型可以运行，但价格显示为未知

实时模型列表带有 id；价格和上下文来自 models.dev。一个全新的模型，或来自自定义提供商的模型，还没有目录条目。