メインコンテンツまでスキップ

チュートリアル: macOS セットアップ

このチュートリアルでは、インストールから最初のドラッグ選択コマンドの実行まで、Rephlo の macOS 専用オンボーディングを一通り説明します。すでに一般的なインストールとセットアップを完了している場合、このチュートリアルでは macOS 固有の詳細についてさらに詳しく説明します。

目的​

macOS には、Rephlo の動作に影響を与える独自のセキュリティおよびプライバシー要件があります。グローバルホットキーがそのまま動作する Windows とは異なり、macOS では Accessibility（アクセシビリティ）と Screen Recording（画面収録）に対してユーザーの明示的な同意が必要です。このチュートリアルに従ってすべてを正しく設定することで、初日から Rephlo のすべての機能を利用できるようになります。

前提条件​

RequirementDetails
macOS バージョン10.15 Catalina 以降
アーキテクチャApple Silicon（M1/M2/M3/M4）または Intel（x64）
ディスク容量アプリケーションバンドル用に約 250 MB
Ollama（任意）ローカルモデルを使用する予定がある場合は、Ollama を別途インストールしてください

ステップ 1: ダウンロードとインストール​

1.1 Rephlo のダウンロード​

https://rephlo.app/download にアクセスし、最新の macOS 用パッケージをダウンロードしてください。

  • Apple Silicon Mac（M1/M2/M3/M4）の場合: Rephlo-macos-arm64.dmg
  • Intel Mac の場合: Rephlo-macos-x64.dmg

1.2 アプリケーションフォルダへのインストール​

  1. ダウンロードした .dmg ファイルを開きます。
  2. Rephlo.app を /Applications フォルダにドラッグします。
  3. ディスクイメージを取り出します。

1.3 初回起動 — Gatekeeper​

初めて Rephlo を開くとき、macOS の Gatekeeper が次のようなメッセージでブロックすることがあります。「"Rephlo.app" は、開発元を確認できないため開けません。」

続行するには:

  1. アプリをダブルクリックしないでください。代わりに、/Applications 内の Rephlo.app を右クリック（または Control キーを押しながらクリック）します。
  2. コンテキストメニューから "Open" を選択します。
  3. 確認ダイアログで、もう一度 "Open" をクリックします。

macOS はこの選択を記憶します。以降の起動はダブルクリックで通常どおり行えます。

なぜこうなるのですか？ macOS の Gatekeeper は、Mac App Store 以外からダウンロードされたアプリについて警告します。右クリック → Open の方法を使うと、そのアプリに限りこのチェックを回避できます。

ステップ 2: 必要な権限を付与する​

権限が必要な理由​

Rephlo はグローバルホットキーを監視し、コマンドを実行したときに現在選択されているテキストを読み取ります。これには macOS では Accessibility（アクセシビリティ）の権限が必要です。スクリーンショットのキャプチャには、別途 Screen Recording（画面収録）の権限が必要です。

これらの権限がないと、Rephlo のシステム全体との連携機能は動作しません。

2.1 PermissionPreCheckDialog​

初回起動の直後、Rephlo は PermissionPreCheckDialog を表示します。

2.2 Accessibility 権限の付与​

  1. PermissionPreCheckDialog で、Accessibility の横にある "Open System Settings" をクリックします。
  2. macOS が System Settings > Privacy & Security > Accessibility を開きます。
  3. アプリ一覧から Rephlo を探します。
  4. スイッチを ON に切り替えます。
  5. 求められた場合は、macOS のパスワードまたは Touch ID で認証します。
  6. Rephlo のダイアログに戻ります。

2.3 Screen Recording 権限の付与​

  1. PermissionPreCheckDialog で、Screen Recording の横にある "Open System Settings" をクリックします。
  2. macOS が System Settings > Privacy & Security > Screen Recording を開きます。
  3. アプリ一覧から Rephlo を探します。
  4. スイッチを ON に切り替えます。
  5. 求められた場合は認証します。
  6. Rephlo のダイアログに戻ります。

2.4 確認と再起動​

  1. Rephlo のダイアログに戻り、"Check Again" をクリックします。
  2. 両方の権限が Granted と表示されるはずです。
  3. Rephlo を完全に終了します（メニューバーアイコンを右クリックして Exit を選択するか、Cmd+Q を押します）。
  4. /Applications から Rephlo を再起動します。macOS の権限変更の一部は、完全な再起動をしないと反映されません。

ヒント: 権限をオンに切り替えた後もチェックボックスが "Not Granted" のままの場合は、Rephlo を終了し、数秒待ってから再起動してみてください。macOS は古い権限状態をキャッシュすることがあります。

ステップ 3: 最初のプロバイダーを設定する​

権限の付与が完了したら、Rephlo がコマンドを処理できるように AI プロバイダーを設定します。

  1. メニューバー の Rephlo アイコンをクリックし、"Settings" を選択します（またはダッシュボードを開いて Settings に移動します）。
  2. Settings > LLM Providers に移動します。
  3. リストからプロバイダーを選択します。
ProviderWhat You Need
OpenAIplatform.openai.com から取得した API キー
Anthropicconsole.anthropic.com から取得した API キー
Googleaistudio.google.dev から取得した API キー
Groqconsole.groq.com から取得した API キー
xAI (Grok)console.x.ai から取得した API キー
OpenRouteropenrouter.ai から取得した API キー
Azure OpenAIAzure ポータルのエンドポイント URL + API キー
Ollamaローカルインストールのみ、キー不要（エンドポイント: http://localhost:11434）
OpenAI-Compatible互換サービス用のエンドポイント URL + API キー
  1. API Key を入力します（該当する場合はエンドポイント URL も）。
  2. Test Connection をクリックして確認します。
  3. Save をクリックします。

クイックスタートのおすすめ: AI API を初めて使う場合は、OpenAI または Anthropic が最も簡単に設定できます。クラウドに依存せず完全なプライバシーを重視する場合は、Ollama をインストールしてローカルモデルを使用してください。

ステップ 4: macOS のホットキーを覚える​

Rephlo はプラットフォームごとに異なるデフォルトのホットキーを使用します。macOS のデフォルトを Windows/Linux と比較すると次のとおりです。

ActionmacOSWindows / Linux
コンテキストメニューオーバーレイShift+Cmd+CCtrl+Shift+Alt+C
スクリーンショットキャプチャShift+Cmd+SCtrl+Shift+Alt+S
ドラッグ選択の修飾キーCmdCtrl
ズームインCmd+PlusCtrl+Plus
ズームアウトCmd+MinusCtrl+Minus
ズームをリセットCmd+0Ctrl+0

ホットキーのカスタマイズ​

すべてのホットキーは自由にカスタマイズできます。

  1. Settings > Hotkeys を開きます。
  2. 変更したいホットキーのフィールドをクリックします。
  3. 希望するキーの組み合わせを押します。
  4. Save をクリックします。

ヒント: ホットキーが他のアプリケーション（Spotlight、Alfred、Raycast など）と競合する場合は、別の組み合わせを選んでください。選択したホットキーがすでにシステムで使用されている場合、Rephlo が警告を表示します。

ステップ 5: ドラッグ選択でテストする​

ドラッグ選択のワークフローは、macOS で Rephlo を使う最も速い方法です。実際に試してみましょう。

5.1 任意のテキストアプリを開く​

TextEdit、Notes、Safari など、テキストを選択できる任意のアプリを開きます。

5.2 ドラッグ選択を実行する​

  1. Cmd キーを押したままにします（macOS のデフォルトのドラッグ選択修飾キーです）。
  2. Cmd を押したまま、テキストの上でマウスをクリックしてドラッグし、選択します。
  3. マウスボタンを離すと、カーソルの近くにすぐに Rephlo オーバーレイ が表示されます。

5.3 コマンドを実行する​

  1. オーバーレイで "Summarize"（または任意のコマンド）をクリックします。
  2. Rephlo が選択したテキストを、設定済みの AI プロバイダーに送信します。
  3. オーバーレイに結果が表示されます。
  4. Copy をクリックすると結果がクリップボードにコピーされ、Insert をクリックすると元のテキストが結果で置き換えられます。

注記: ドラッグ選択の修飾キーはカスタマイズ可能です。Settings > Hotkeys > Text Selection Trigger から、Cmd を別のキーに変更できます。

macOS 特有の問題のトラブルシューティング​

ホットキーが動作しない​

症状: Shift+Cmd+C を押しても何も起こりません。オーバーレイが表示されません。

原因: Accessibility の権限が付与されていないか、権限を付与した後にアプリを再起動していません。

対処法:

  1. System Settings > Privacy & Security > Accessibility を開きます。
  2. Rephlo が ON になっていることを確認します。
  3. すでに ON になっていた場合は、一度 OFF にしてから、再度 ON にします。
  4. Rephlo を終了して再起動します。

スクリーンショットキャプチャが動作しない​

症状: スクリーンショットコマンドが失敗するか、空白の画像が生成されます。

原因: Screen Recording の権限が付与されていません。

対処法:

  1. System Settings > Privacy & Security > Screen Recording を開きます。
  2. Rephlo が ON になっていることを確認します。
  3. Rephlo を終了して再起動します。

オーバーレイが表示されない​

症状: ホットキーを押したり、ドラッグ選択を行ったりしても、オーバーレイウィンドウが表示されません。

考えられる原因と対処法:

Possible CauseFix
Accessibility が許可されていないAccessibility の権限を付与して再起動する
アプリが .app バンドルとして実行されていないdotnet run ではなく /Applications/Rephlo.app から起動する
ホットキーが他のアプリと競合しているSettings > Hotkeys で競合を確認し、組み合わせを変更する
アプリが一時停止しているメニューバーアイコンを右クリックし、"Resume Rephlo" が表示されていればクリックする

起動のたびに Gatekeeper がアプリをブロックする​

症状: macOS が「開発元を確認できません」という警告を表示し続けます。

対処法: 初回起動時に右クリックして "Open" を選択したことを確認してください。問題が解決しない場合:

  1. System Settings > Privacy & Security を開きます。
  2. Security セクションまでスクロールします。
  3. Rephlo がブロックされている旨のメッセージが表示されているはずです。"Open Anyway" をクリックします。

Rephlo が権限リストに表示されない​

症状: System Settings > Accessibility を開いても、Rephlo が一覧に表示されません。

対処法: 一度は Rephlo を起動してください。macOS は、アプリが保護された機能を初めて使用しようとしたときにのみ、権限リストにそのアプリを追加します。起動後、もう一度権限リストを確認してください。

次のステップ​

これで macOS 上でのセットアップがすべて完了しました。以下は推奨される次のステップです。

  • 初回利用ウォークスルー — 最初の AI コマンドを順を追って実行します。
  • Commands — 独自のコマンドを作成・カスタマイズする方法を学びます。
  • Spaces — ドキュメントを AI のコンテキストとして追加し、根拠に基づいた回答を得ます。
  • Template Gallery — よくあるタスク向けの既製コマンドを閲覧します。
  • Advanced Use Cases — 上級者向けのワークフローと自動化のレシピです。