使い方ガイド
クリップボード履歴
ClipboxAI は メニューバー から動作します。何かをコピーするたびに、履歴に追加されます。
- メニューバーのアイコンをクリックして履歴パネルを開きます。
- 項目にカーソルを合わせてアクションショートカットを押すか、クリックしてペーストボードへ再コピーします。
- 検索フィールドを使って、テキストで項目を探します。
AI ツールウィンドウ
AI ツール ウィンドウはアクションを実行する場所です。分割レイアウトになっています。
- 左側 — ツールの一覧。次のグループに分かれています：
- Built-in AI（内蔵 AI） — 要約、翻訳、その他の AI アクション。
- Built-in Local（内蔵ローカル） — オフラインツール（リンク抽出、集計、空白行削除）。
- Installed（インストール済み） — Marketplace から追加したアクション。ドラッグして並び順を変更できます。
- 右側 — 2 つのペイン：original（元のクリップ） が一方、result（結果） がもう一方に表示されます。
AI ツールには「cloud（クラウド）」のバッジが、ローカルツールには「device（端末）」のバッジが表示されるため、アクションがネットワークを使うかどうかは常にわかります。
アクションの実行
- 左の一覧からツールを選択します（またはスマートな提案を受け入れます）。
- 現在のクリップが original ペインに表示されます。
- 結果が result ペインに生成されます。
自動実行（Auto-run）
ウィンドウのフッターにある Auto-run on output（出力時の自動実行） をオンにします。有効にすると、コピーした瞬間に選択したツールが自動的に実行され、手動でクリックする必要はありません。ローカルツールはペーストボードを上書きすることはないため、自動実行は安全です。
内蔵のローカルツール
これらは Mac 上で完全にオフラインで動作します。
- Extract Links（リンク抽出） — テキスト内のすべての URL を返します。
- Count Stats（集計） — 単語数 / 文字数 / 行数 / 文の数をカウントします。
- Collapse Blank Lines（空白行削除） — 貼り付けたテキストから空行を削除します。
クラウド AI の設定
AI アクションを使うには、設定 → AI でプロバイダーに接続します。
- プロバイダーを選択します — DeepSeek、MiniMax、Zhipu GLM、Kimi (Moonshot)、Mistral、Ollama（ローカル）、またはその他の OpenAI 互換サービス。
- API key を貼り付けます。これは Keychain に保存され、平文でディスクに書き込まれることはありません。
- モデルを選択します。
- クラウド AI は既定でオフです。有効にした場合、クリップが送信されるのは自分で設定したプロバイダーだけです。
キーが設定されていない場合、AI ツールウィンドウ内に設定バナーで通知されます。
マーケットプレイス
- AI ツールウィンドウから Marketplace を開きます（またはサイトの Marketplace ページ）。
- アクションの Install をクリックします。これによりディープリンク
clipboxai://install?action=<id>を通じてアプリが開き、アクションが Installed（インストール済み） 一覧に追加されます。
キーボードショートカット
| ショートカット | アクション |
|---|---|
Cmd+Shift+V | クリップボード履歴を開く |
Cmd+, | 設定を開く |
Cmd+W | ウィンドウを閉じる |
Cmd+Q | アプリケーションを終了 |
正確なショートカットはビルドによって異なる場合があります。アプリ内の 設定 → Shortcuts をご確認ください。
設定
ClipboxAI → 設定（または Cmd+,）を開きます。
- General（一般）: 言語、ログイン時の起動、外観テーマ。
- AI: クラウドプロバイダー、モデル、API key（Keychain）。
- Actions（アクション）: 自動実行の切り替え、除外アプリ、ツールの順序。
- Privacy（プライバシー）: クラウド AI のオプトイン、除外アプリ、履歴の管理。
- Marketplace（マーケットプレイス）: インストール済みアクションの閲覧と管理。