Dream
DocumentationDownload
入门

连接服务商

配置 Dream 可使用的编码代理 CLI 和模型。

Dream 与你计算机上已安装的编程代理命令行工具协同工作。

支持的提供商#

提供商必需的 CLI
OpenAICodex CLI
AnthropicClaude Code CLI
OpenCodeOpenCode CLI
CursorCursor Agent CLI
Grok 构建Grok 构建 CLI

从其提供商处安装 CLI,然后在 Dream 之外完成该 CLI 的正常登录或身份验证流程。

启用模型#

  1. 在 Dream 中打开设置。
  2. 选择 提供商。
  3. 安装或认证其 CLI 后,刷新提供者。
  4. 打开提供商的启用开关,然后启用其检测到的一个或多个模型。
  5. 打开 通用 → 模型,为新的聊天和提交及拉取请求草稿设置默认值。

在打开第一个项目之前,必须启用至少一个模型。聊天在启动后可以使用不同于默认模型的启用模型。

刷新提供商卡片,然后启用您想要使用的模型。

使用多个提供商#

启用您希望使用的每个提供商的模型。聊天编排器会列出已启用的模型,因此您可以为另一场对话选择不同的提供商,或在现有聊天中更改模型。

例如,你可以将你的实现聊天保留在一个提供商上,而使用另一个提供商创建审查聊天。你无需每次更改全局默认设置。请参考 模型与默认设置 来配置新聊天的默认设置、推理强度、速度以及独立的 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:

  1. 打开你的系统终端并验证 CLI 命令能否成功启动。
  2. 完成 CLI 所请求的任何登录或首次运行设置。
  3. 返回 设置 → 提供商 并刷新它。
  4. 对于 OpenCode,如果未显示模型,请运行其身份验证流程或配置 opencode.json 文件。

如果在 Dream 启动时已安装了 CLI,如果刷新仍无法检测到它,请重新启动 Dream。该命令必须在 Dream 的环境中可用;仅一个 shell 别名并不等同于已安装的 CLI。

如果检测到 CLI 但所需的模型缺失,请检查提供商的账户/配置并刷新列表。如果模型已列出但在聊天中不可用,请通过其切换按钮启用模型,并确认提供商本身已启用。有关更多检查,请参见 故障排查。