连接服务商
配置 Dream 可使用的编码代理 CLI 和模型。
Dream 与你计算机上已安装的编程代理命令行工具协同工作。
支持的提供商#
| 提供商 | 必需的 CLI |
|---|---|
| OpenAI | Codex CLI |
| Anthropic | Claude Code CLI |
| OpenCode | OpenCode CLI |
| Cursor | Cursor Agent CLI |
| Grok 构建 | Grok 构建 CLI |
从其提供商处安装 CLI,然后在 Dream 之外完成该 CLI 的正常登录或身份验证流程。
启用模型#
- 在 Dream 中打开设置。
- 选择 提供商。
- 安装或认证其 CLI 后,刷新提供者。
- 打开提供商的启用开关,然后启用其检测到的一个或多个模型。
- 打开 通用 → 模型,为新的聊天和提交及拉取请求草稿设置默认值。
在打开第一个项目之前,必须启用至少一个模型。聊天在启动后可以使用不同于默认模型的启用模型。
使用多个提供商#
启用您希望使用的每个提供商的模型。聊天编排器会列出已启用的模型,因此您可以为另一场对话选择不同的提供商,或在现有聊天中更改模型。
例如,你可以将你的实现聊天保留在一个提供商上,而使用另一个提供商创建审查聊天。你无需每次更改全局默认设置。请参考 模型与默认设置 来配置新聊天的默认设置、推理强度、速度以及独立的 Git 撰写模型。
了解不同提供商之间的差异#
已安装的 CLI 负责身份验证和执行代理工作。不同提供商之间的模型列表、支持的努力程度和速度选项、附件处理、使用信息以及权限行为可能有所不同。
Dream 为每个聊天提供了 询问、接受编辑 和 完全访问 三种权限。在选择之前,请阅读 智能体权限。Claude 通过可恢复会话进行聊天时,也支持 在终端中继续聊天。
技能适用于 Claude Code、Codex、OpenCode 和 Cursor。MCP 服务器和 Dream 的内置浏览器工具适用于 Claude Code、Codex、OpenCode 和 Grok Build;Cursor 不支持这些由 Dream 管理的工具连接。
检查 CLI 更新#
提供商卡片在可用时会显示已安装的 CLI 版本。Dream 还会检查是否有新版本,并在发现新版本时显示 更新可用:… 标签。该标签仅报告更新的可用性,并不会执行安装操作。请使用该 CLI 的常规安装方法进行更新,然后在 Dream 中刷新其提供商卡片。
使用提供商的启用开关将其模型从可用选择中隐藏,而无需卸载 CLI。在更改启用的提供商或模型后,请重新检查默认设置。
故障排查检测#
如果一个提供商显示 未检测到 CLI:
- 打开你的系统终端并验证 CLI 命令能否成功启动。
- 完成 CLI 所请求的任何登录或首次运行设置。
- 返回 设置 → 提供商 并刷新它。
- 对于 OpenCode,如果未显示模型,请运行其身份验证流程或配置
opencode.json文件。
如果在 Dream 启动时已安装了 CLI,如果刷新仍无法检测到它,请重新启动 Dream。该命令必须在 Dream 的环境中可用;仅一个 shell 别名并不等同于已安装的 CLI。
如果检测到 CLI 但所需的模型缺失,请检查提供商的账户/配置并刷新列表。如果模型已列出但在聊天中不可用,请通过其切换按钮启用模型,并确认提供商本身已启用。有关更多检查,请参见 故障排查。