Raycastで外部サブスクリプションとカスタムAPIキーを連携し、AIクレジットの消費をゼロにする方法

macOSの開発環境において、Raycastをメインランチャーとして日常的に活用しているエンジニアにとって、Raycast v2で導入された「AIクレジット」の消費上限は大きな課題になりがちです。Raycastの有料プランに含まれる月間クレジット枠は、Proプランで500クレジット、Pro+で3,000クレジット、Maxで7,500クレジットに設定されています。しかし、検索バーからTabキーで「Quick AI」を起動してコードレビューや正規表現の生成を頻繁に行ったり、コンテキスト長の長い推論モデルを活用したりすると、月の半ばでクレジットを使い切ってしまうことがあります。

もしすでに月額20ドルのChatGPT PlusやClaude Proを契約している場合、あるいはAnthropic Console、OpenAI Platform、Google AI Studio、OpenRouterのAPI残高を保有している場合、Raycastの追加クレジット購入（Top-up）や高額プランへのアップグレードによる「二重課金」を避ける方法があります。

Raycastには、外部のアカウントやAPIキーを直接接続して利用できる「Bring Your Own AI」機能がネイティブに備わっています。これらを設定することで、RaycastのAIクレジットを一切消費せずに、快適なキーボードショートカットワークフローを維持できます。

3つのクレジット消費ゼロ連携方式の比較

設定を行う前に、手元の契約状況やユースケースに合わせて最適な連携パターンを選択してください。

重要な前提条件: 外部のサブスクリプションやAPIキーをRaycastに接続するには、Raycast Proなどの有料プランの契約が必要です（無料プランではAI機能全般が利用できません）。ただし、ベースとなるRaycast Proに外部サブスクリプションを紐付けることで、上位プランへの移行や追加課金を行わずにモデルを無制限感覚で利用できます。

方法1: 外部サブスクリプション直結（Claude Pro / ChatGPT Plus）

すでに個人またはチームで月額20ドルのサブスクリプションを契約している開発者にとって、最もコストパフォーマンスが高いのが**Bring Your Own Subscription（BYOS）**です。トークンごとの従量課金が発生せず、Web版サブスクリプションの定額枠をそのままRaycast内で利用できます。

仕組みとアーキテクチャ

Raycastはローカル環境にインストールされたAnthropicの公式CLIツール「Claude Code」、またはOpenAIの「Codex CLI」と通信します。Quick AIやAI Chatに入力したプロンプトは、マシンのローカルプロセスから直接AnthropicやOpenAIのサーバーへ送信され、Raycastのサーバーを経由しません。Raycastが認証トークンを閲覧・保存することもありません。

セットアップ手順

1. プロバイダーのCLIツールをインストールする
   • Claudeの場合: npmを使用してClaude Codeをインストールします。

     npm install -g @anthropic-ai/claude-code
     

   • ChatGPTの場合: Codex CLIをインストールするか、ChatGPTデスクトップアプリ/Codexデスクトップアプリが導入されていることを確認します。
2. ターミナルでログイン認証を実行する
   • Claude: ターミナルで claude を起動し、/login コマンドを入力してブラウザ上でClaude Pro/Teamアカウントの認証を完了させます。
   • ChatGPT: ターミナルで codex login を実行し、ChatGPT Plus/Teamのアカウントでサインインします（APIキーではなく、必ずサブスクリプションアカウントでログインしてください）。
3. Raycast側でローカルサブスクリプションを有効化する
   • Raycastの設定画面を開き（⌘ ,）、AI → Models & Providers に移動します。
   • Local AI Subscriptions セクションまでスクロールし、Enable Local AI Subscriptions をオンにします。
   • 画面上の Claude Account または ChatGPT Account の項目に自身のアカウントとプラン名が表示されていることを確認します。反映されていない場合は Refresh account status をクリックします。
4. サブスクリプションモデルを選択する
   • Tab キーでQuick AIを開くか、AI Chatを起動します。
   • モデル選択ドロップダウンを開き、Claude Subscription または ChatGPT Subscription カテゴリ内のモデル（Claude 3.7 Sonnet、Claude 3.5 Sonnet、GPT-4o、oシリーズ推論モデルなど）を選択します。

使用量と制限の確認方法

外部サブスクリプションモデルを利用する場合、Raycastのクレジットではなく、各プロバイダーが定めているローリング利用枠（例: Claudeの5時間枠やOpenAIの週単位枠）が適用されます。

• AI Chat内で /usage と入力すると、現在の利用率とリセットまでの時間が表示されます。
• ルート検索から Show Claude Usage または Show ChatGPT Usage コマンドを実行しても確認できます。

方法2: 自前のAPIキーを登録する（BYOK）

トークン単位の従量課金（Pay-as-you-go）で運用したい場合や、iPhone/iPadなどのiOS端末からも同一の環境で利用したい場合は、Bring Your Own Key（BYOK） が適しています。

課金と通信の挙動

• 課金: 推論コストは各プロバイダーのAPIアカウント（登録クレジットカードまたはプリペイド残高）から直接差し引かれます。Raycastの月間AIクレジットは消費されません。
• 通信経路: OpenRouterのキーを使用する場合、リクエストは端末から直接OpenRouterへ送信されます。Anthropic、OpenAI、Googleの場合は、API仕様の統一とフォールバック処理のためにRaycastサーバーを経由しますが、課金は登録したカスタムAPIキーに対して行われます。
• モデルラインナップ: OpenRouterのキーを接続すると、Raycastの標準ラインナップにとどまらず、OpenRouterが提供する多種多様なモデル（DeepSeek-V3、DeepSeek-R1、オープンソースモデル群）が即座にアンロックされます。

セットアップ手順

1. 各社コンソールからAPIキーを発行する
   • Anthropic: Console → Settings → API Keys
   • OpenAI: Platform → API Keys
   • Google: Google AI Studio → Get API Key
   • OpenRouter: Account Settings → Keys
2. デスクトップ（macOS / Windows）での設定
   • Raycastの Settings → AI → Models & Providers を開きます。
   • API Keys セクションにある +（Plus） アイコンをクリックします。
   • プロバイダーを選択してキーを貼り付け、Verify をクリックして検証が成功したら Save を押します。
3. iOSでの設定
   • Raycast iOSアプリを開き、右上のアカウントアイコンから AI → Custom API Keys を選択します。
   • 対象プロバイダーを選択してキーを入力し、Verify をタップします。

設定完了の確認

キーが正常に保存されると、モデル選択メニュー内の該当モデル名の横に 鍵マーク（Keyアイコン） が表示されます。この鍵マークが付いたモデルを選択している限り、Raycastの月間クレジットが消費されることはありません。

方法3: providers.yaml によるカスタムプロバイダー設定

チーム共通のLiteLLMプロキシを経由させたい場合や、Vercel AI Gateway、AWS Bedrock、あるいはローカルマシンで起動しているLM Studioなどの自前環境をRaycastから呼び出したい場合は、YAML設定ファイルによる「Custom Providers」を利用します。

設定手順と設定ファイル例

1. Raycastの Settings → AI → Models & Providers を開きます。
2. Custom Providers セクションまでスクロールし、Reveal Providers Config をクリックします。
3. Finderで ~/.config/raycast/ai/ フォルダが開き、公式テンプレートの providers.template.yaml が表示されます。
4. 同一フォルダ内に providers.template.yaml をコピーして、名前を providers.yaml に変更します。
5. ファイルを編集し、接続先エンドポイントやモデル情報を記述します。

例: Vercel AI Gatewayを接続する場合

providers:
  - id: vercel_gateway
    name: "Vercel AI Gateway"
    base_url: https://ai-gateway.vercel.sh/v1
    api_keys:
      vercel: YOUR_GATEWAY_API_KEY
    models:
      - id: anthropic/claude-3-7-sonnet
        name: "Claude 3.7 Sonnet"
        context: 200000
        abilities:
          temperature:
            supported: true
          vision:
            supported: true
          system_message:
            supported: true
          tools:
            supported: true
          reasoning_effort:
            supported: true

例: ローカルで起動しているLM Studioを完全無料で接続する場合

providers:
  - id: lmstudio_local
    name: "LM Studio Local"
    base_url: http://localhost:1234/v1
    models:
      - id: qwen2.5-coder-32b-instruct
        name: "Qwen 2.5 Coder 32B"
        context: 32768
        abilities:
          temperature:
            supported: true
          system_message:
            supported: true

6. ファイルを保存すると、Raycastが自動で変更を検知してリロードします。Quick AIやAI Chatのモデル選択一覧に、登録したプロバイダーとモデルが即時反映されます。

注意点とトラブルシューティング

外部連携を活用するにあたり、以下の技術仕様と注意点を把握しておくとトラブルを未然に防げます。

1. Raycast Proプランの契約が必須 無料版のRaycast FreeではAI機能そのものが提供されていないため、BYOKやBYOSを有効化することはできません。ただし、Raycast Proを契約した上で手持ちのChatGPT PlusやClaude Proを紐付ける構成は、Raycastの最上位プラン（Max）を契約したり追加クレジットを買い足したりするよりも圧倒的に経済的です。
2. 一部のネイティブサーバーツールはクレジットを消費する 通常の対話、コード生成、Webページの読み込みなどはすべて外部接続側で処理されます。ただし、Raycastのクラウドサーバー上で専用に実行される「画像生成（Image Generation）」などの一部機能は、Raycast側のAIモデルを使用するため、例外的にRaycast AIクレジットが消費されます。
3. プロバイダー側のレートリミットに注意 外部サブスクリプション利用中にレートリミット（利用頻度上限）に達した場合、Raycastのクレジットを追加購入してもエラーは解消されません。/usage コマンドで解除時間を確認するか、一時的に別のBYOKモデルやローカルモデルに切り替えて作業を継続してください。
4. macOSでのCLIツールのPATH認識問題 Raycast側で Claude Code や Codex が認識されない場合、ターミナルで設定したPATHがGUIアプリに反映されていない可能性があります。Raycastはシステムの PATH、Homebrewの標準パス（Apple Siliconの /opt/homebrew/bin など）、npmのグローバルbinパス、~/.local/bin を自動探索します。ターミナルで正常に動作することを確認した上で、Raycastを一度再起動してください。

外部サブスクリプションやAPIキーを適切に設定することで、Raycastの圧倒的な操作スピードとショートカット連携の利便性をフルに活かしながら、クレジット上限に悩まされない開発環境を構築できます。

参考文献

• AI | Raycast Manual
• Bring Your Own Subscription | Raycast Manual
• Bring Your Own Key | Raycast Manual
• Custom Providers | Raycast Manual
• AI Credits | Raycast Manual