ガイド

Pluely にローカルの AI CLI を接続する方法

ふだん使っている CLI（Claude Code、Gemini CLI、OpenAI Codex、Qwen Code、Ollama）を通じて Pluely の質問を処理すれば、回答は自分のマシン上のツールから返ってきます。接続すると、その CLI がオーバーレイのモデル選択メニューのいちばん上に表示されます。

Pluely の「自分の CLI」とは

オーバーレイのモデル選択メニューは、「自分の CLI」「ウェブ検索／Pluely のモデル」「自分のプロバイダ」のグループに分かれています。「自分の CLI」とは、自分のマシンにインストールされていて、Pluely が直接接続するローカルの AI コマンドラインツールのことです。CLI が接続されている間はそれが選択された状態になり、回答はホストされたモデルではなく、その 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：Alibaba Cloud Coding Plan か Model Studio の API キーで Qwen3-Coder のモデルを使えます。
Ollama：自分のハードウェアで完全にオフラインで動くオープンなモデル。

手順：CLI を接続する

その CLI がインストールされていて、ターミナルで動作することを確認します（アカウントが必要な場合は、先にターミナルでサインインします）。
ダッシュボード（オーバーレイ左上のホームアイコン）→ Dev Space → CLI を接続を開きます。
Pluely がインストール済みの CLI を自動で検出し、それぞれのバージョンを表示します。パスを入力する必要はありません。インストールしたばかりの場合は、セクションの見出しの横にある更新ボタンをクリックして再スキャンします。
使いたい CLI の接続をクリックします。
接続した行の下にモデルのパネルが表示されます。よく知られたモデルを選ぶか、カスタムモデル ID を入力するか、「デフォルト（CLI が決定）」のままにします。Ollama だけは例外で、ローカルにプルしたモデルを 1 つ選ぶ必要があります。
オーバーレイのモデル選択メニューを開くと、自分の CLI がいちばん上の項目として、モデルとともに表示されています（例：Claude Code · opus）。

スクリーンショットと思考モデル

モデルのパネルには、現在の設定で画像を読み取れるかどうかが表示されます。Claude Code、Gemini CLI、OpenAI Codex、Qwen Code は画像を読み取れます。Ollama はプルしたモデルによって異なります（llava、gemma3、qwen-vl などのマルチモーダル系のモデル）。
推論モデル／思考モデルはすべての CLI で使えます。思考の過程（chain-of-thought）は自動で取り除かれるので、表示されるのは最終的な回答だけです。

ローカルファーストが大切な理由

接続した CLI は自分のマシン上で動くので、リクエストが Pluely のマネージドな基盤に届くためにデバイスの外に出る必要はありません。すでに CLI のサブスクリプションに料金を払っていたり、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 とは別に最新の状態に保ちましょう。Pluely は、マシンに入っているバージョンをそのまま呼び出します。
CLI とマネージドモデルを頻繁に切り替えるなら、オーバーレイ上部のモデル選択メニューからワンクリックで切り替えられます。