PluelyPluely文档

使用指南

如何把本地 AI CLI 连接到 Pluely

让 Pluely 的问题通过你已经在用的 CLI 运行（Claude Code、Gemini CLI、OpenAI Codex、Qwen Code 或 Ollama），回答就来自你自己电脑上的工具。连接后，你的 CLI 会出现在悬浮窗模型选择器的最上方。

Pluely 中的“你的 CLI”是什么

悬浮窗的模型选择器分为几组：你的 CLI、联网搜索 / Pluely 模型，以及你的服务商。“你的 CLI”是安装在你电脑上、由 Pluely 直接连接的本地 AI 命令行工具。连接 CLI 后，它就是当前选用的选项：回答通过它在本地运行，而不经过任何托管模型。

支持的 CLI

  • Claude Code：Anthropic 的 CLI；使用你的 Claude 订阅运行 Sonnet / Opus / Haiku。
  • Gemini CLI：Google 的 CLI，搭配你的 Google AI 方案或 Gemini API 密钥。
  • OpenAI Codex：使用你的 ChatGPT 方案运行 GPT-6 级别的模型。
  • Qwen Code：搭配阿里云 Coding Plan 或 Model Studio API 密钥使用 Qwen3-Coder 模型。
  • Ollama：在你的硬件上完全离线运行的开源模型。

分步操作：连接 CLI

  1. 确认 CLI 已安装，并能在终端中正常运行（如果需要账户，请先在终端中登录）。
  2. 打开仪表板（悬浮窗左上角的“首页”图标）→ Dev Space → 连接你的 CLI。
  3. Pluely 会自动检测已安装的 CLI，并显示各自的版本，无需输入路径。刚刚才安装？点击该区域标题旁边的刷新按钮重新扫描。
  4. 在你想要的 CLI 上点击连接。
  5. 已连接的行下方会出现一个模型面板：选择一个常见模型，输入自定义模型 ID，或保持默认（由 CLI 决定）。Ollama 是例外：必须从你在本地拉取的模型中选择一个。
  6. 打开悬浮窗的模型选择器：你的 CLI 是第一项，并显示其模型（例如 Claude Code · opus）。

截屏与思考模型

  • 模型面板会告诉你当前设置能否识别图片：Claude Code、Gemini CLI、OpenAI Codex 和 Qwen Code 都支持视觉；Ollama 取决于你拉取的模型（llava、gemma3、qwen-vl 及其他多模态系列）。
  • 每个 CLI 都支持推理/思考模型：思维链会被自动去除，你只会看到最终回答。

为什么本地优先很重要

已连接的 CLI 在你自己的电脑上运行，因此请求无需离开你的设备去访问 Pluely 的托管基础设施。如果你已经在为某个 CLI 付费或维护订阅，Pluely 就成了你已信任的工具之上的一个便捷悬浮窗，中间不会引入新的托管模型。

切换回托管模型

打开模型选择器，选择“Pluely 模型”或“你的服务商”下的任意选项：这会暂时停用 CLI 模式，之后在 Dev Space 中一键即可重新连接。要彻底移除连接，请在该 CLI 所在的行上使用断开连接。

CLI 无法回答时的故障排除

  • 在 Pluely 之外，直接在终端中运行该 CLI：如果在终端里也失败（登录已过期、缺少订阅），先在终端中解决，Pluely 会随之恢复。
  • 出问题时，Pluely 会显示 CLI 自身的错误信息，因此解决办法通常就直接写在悬浮窗里。
  • 刚刚安装或更新了 CLI？点击“连接你的 CLI”旁边的刷新按钮重新检测。
  • 选择的自定义模型 ID 报错？切换回默认（由 CLI 决定）：它始终可用。
  • Gemini CLI 的“受信任目录”要求和 Codex 的 git 仓库检查都由 Pluely 自动处理，无需任何参数。

小贴士

  • Claude Code、Gemini CLI、OpenAI Codex 和 Qwen Code 都需要各自的账户：Pluely 不管理这部分计费，只连接你已安装的工具。
  • 如果想要完全离线、零成本的本地推理，Ollama 是个不错的选择。
  • 请自行保持 CLI 为最新版本；Pluely 调用的是你电脑上的现有版本。
  • 如果你经常在 CLI 和托管模型之间切换，悬浮窗顶部的模型选择器让切换只需一键。

相关内容

最后更新：2026年7月10日 · pluely.com