設定と構成

Pluely で Claude Code を使う

Anthropic の AI CLI である Claude Code を接続すると、Pluely のオーバーレイでした質問はすべて、自分の Claude サブスクリプションを使って自分のマシン上でローカルに処理されます。Pluely がホストするモデルは一切使いません。

1. インストールしてサインインする

まだ持っていない場合は、Anthropic の Claude Code をインストールし（例：npm install -g @anthropic-ai/claude-code）、ターミナルで一度 claude を実行してサインインします。ターミナルで claude が応答すれば、Pluely からも使えます。

2. Pluely で接続する

ダッシュボード → Dev Space → CLI を接続を開きます。
Pluely が Claude Code を自動で検出します（バージョンも表示されます）。接続をクリックします。
オーバーレイのモデル選択メニューのいちばん上に、自分の CLI として表示されます。

インストールしたばかりの場合は、「CLI を接続」の見出しの横にある更新ボタンをクリックして再スキャンします。

3. モデルを選ぶ

接続した Claude Code の行のすぐ下に、モデルのパネルが表示されます。

デフォルト（CLI が決定）：Claude Code で設定されているモデルをそのまま使います。必ず動作します。
Sonnet / Opus / Haiku：各ファミリーの最新モデルを使います。Claude Code 自身のエイリアスなので、常に最新です。
カスタムモデル ID：特定のバージョンが必要な場合は、正確なモデル ID を入力します。

選んだモデルは、接続のカードとオーバーレイの選択メニューに表示されます（例：Claude Code · opus）。

画像も使えます

Pluely 経由の Claude Code は画像を読み取れます。質問にスクリーンショットや画像を添付すれば、Claude がその内容を読み取ります。「キャプチャ」「選択範囲」「画像を使用」のコントロールもすべて有効なままです。

思考モデルも使えます

拡張思考（extended thinking）の出力は自動で処理されます。表示されるのは最終的な回答だけで、生の思考過程（chain-of-thought）が表示されることはありません。

トラブルシューティング

「CLI が応答できませんでした」と表示される：ターミナルで claude -p "hello" を実行します。そこで失敗する場合（ログインの期限切れ、サブスクリプションがないなど）は、ターミナル側で解決すれば Pluely も動くようになります。
カスタムモデル ID でエラーになる：その ID が自分のアカウントで使えるか確認してください。デフォルトなら必ず動作します。
セッション：Pluely は会話ごとに Claude Code のセッションを 1 つ保持するので、フォローアップでは新しいメッセージだけが送られ、回答も早く返ってきます。オーバーレイの「新規メッセージ」で新しいセッションが始まります。
Homebrew や npm でインストールした場合：macOS ではどちらも検出されます。npm でインストールした Codex は Windows でも動作します。