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 的「trusted directory」要求和 Codex 的 git 儲存庫檢查，Pluely 都會自動處理，不需要任何旗標。

小技巧

  • Claude Code、Gemini CLI、OpenAI Codex 和 Qwen Code 都需要各自的帳號：Pluely 不負責這些帳單，只會連接你已經安裝的工具。
  • 想要完全離線、零成本的本機推論，Ollama 是很好的選擇。
  • 請自行更新你的 CLI；Pluely 會直接呼叫你電腦上現有的版本。
  • 如果你經常在 CLI 和託管模型之間切換，浮動視窗上方的模型選擇器讓你按一下就能切換。

相關內容

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