# Bring Your Own Subscription > Available on: Mac, Windows > Tier: Pro Exclusive Connect a Claude or ChatGPT subscription to Raycast AI through Claude Code or Codex CLI, then use those models across Raycast's AI features. Bring Your Own Subscription lets you use your Claude or ChatGPT subscription inside Raycast. Sign in using the provider's command line tool, and the models included in your plan show up in Raycast's model picker alongside everything else. Usage counts towards that subscription, not your Raycast AI credits. ![Quick AI in Raycast answering with Claude Fable 5.1, with the model picker open showing Claude Subscription and ChatGPT subscription models](https://fz1sd71lwhbqy6sh.public.blob.vercel-storage.com/raycast/images/app/ai/mac-bring-your-own-subscription-quickai.png) > [!NOTE] > Your prompts go straight from the provider's tool on your machine to Anthropic or OpenAI, never through Raycast's servers. Raycast never sees or stores your Claude or ChatGPT credentials. ## Get Started You'll need a paid Raycast plan, plus an active Claude or ChatGPT subscription. Accounts that only have API access don't qualify; use [Bring Your Own Key](https://manual.raycast.com/ai/bring-your-own-key) for those instead. 1. Open **Settings → AI → Models & Providers**. 2. Scroll to **Local AI Subscriptions** section and turn on **Enable Local AI Subscriptions**. 3. Install the provider's command line tool (if not installed already): - **Claude**: Install [Claude Code](https://code.claude.com/docs/en/overview). - **ChatGPT**: Install the [Codex CLI](https://learn.chatgpt.com/docs/codex/cli). 4. Sign in to the tool from Terminal: - **Claude**: Run `claude`, then enter `/login`. - **ChatGPT**: Run `codex login` and sign in with your ChatGPT account. 5. Back in Raycast, check that the **Claude Account** or **ChatGPT Account** row shows your account and plan. If it doesn't, click **Refresh account status**. You're all set. Open the model picker in AI Chat, Quick AI, or an AI Command and choose a model from the **Claude Subscription** or **ChatGPT Subscription** section. > [!NOTE] > Raycast finds `claude` and `codex` in the usual places: your `PATH`, Homebrew, npm's global folder, and the Codex or ChatGPT desktop apps. If you installed a tool somewhere else, add it to your `PATH` and restart Raycast. ![The Local AI Subscriptions section in Raycast's AI settings, with Enable Local AI Subscriptions turned on and connected Claude and ChatGPT accounts](https://fz1sd71lwhbqy6sh.public.blob.vercel-storage.com/raycast/images/app/ai/mac-bring-your-own-subscription-settings.png) ## Using Subscription Models Subscription models work in [AI Chat](https://manual.raycast.com/ai/ai-chat), [Quick AI](https://manual.raycast.com/ai/quick-ai), and [AI Commands](https://manual.raycast.com/ai/ai-commands), and for [Automations](https://manual.raycast.com/ai/automations). Raycast reads the list of models available to your account, and the list updates when the provider adds models. Subscription models carry a small Claude or OpenAI badge in the picker and in the selected model text under the chat title so you can tell them apart from Raycast AI models. Most of what you're used to carries over: - **Attachments**: Send images and files as you normally would. - **Reasoning**: Models that support it show a **Reasoning Effort** option in the picker. - **Prompt suggestions**: With a Claude subscription model selected, an empty composer in AI Chat or Quick AI shows Claude's suggested next prompt as the placeholder. Press `Tab` or `→` to insert it. - **Tools**: AI Extensions, MCP servers, and Skills all work. Raycast stays the tool host, so your tool permissions apply as usual. - **Web search**: Runs through the provider's own search rather than Raycast's. > [!NOTE] > A few tools that Raycast runs on its own servers, such as image generation, still use a Raycast AI model for that step and count against your [AI credits](https://manual.raycast.com/ai/usage-limits). The conversation itself stays on your subscription. ## Usage Limits Your subscription usage limits are determined by the provider, not Raycast. Claude and ChatGPT both have rolling limits, typically a five-hour window and a weekly cap, that are shared with anything else you use the subscription for. When you hit one, Raycast tells you which limit you've reached and when it resets, and the chat pauses until then. Raycast doesn't switch you to Raycast AI credits automatically. Wait for the limit to reset, or change the chat's model to a Raycast AI model or a different provider and continue. Open **Settings → Account** if you want to check your AI credit balance first. ## Manage Subscriptions The **Local AI Subscriptions** section in **Settings → AI → Models & Providers** shows the status of each account in the **Claude Account** and **ChatGPT Account** rows: connected with your plan title, signed out, or not installed. - **Pause everything** by turning off **Enable Local AI Subscriptions**. Subscription models disappear from the picker, and any chat using one will ask you to pick another model. Turn it back on and they return; you won't need to sign in again. - **Switch accounts or sign out** using the provider's own tool: run `claude` and enter `/logout`, or run `codex logout`. Raycast picks up the change the next time it checks the account. After you sign out, subscription models stay in the picker but appear muted, and a chat using one shows a notice above the composer with **Check Connection** and **Provider Settings** buttons. - **Refresh** with **Refresh account status** if you've just signed in or changed plan and Raycast hasn't noticed. ## FAQ ### Which Claude and ChatGPT plans work? Any Claude or ChatGPT subscription that lets you sign in to Claude Code or the Codex CLI. Raycast checks that the account is a subscription rather than API-only access, and reads the models it includes. If your plan changes, refresh the account in Settings and the model list updates. ### How is this different from Bring Your Own Key? [Bring Your Own Key](https://manual.raycast.com/ai/bring-your-own-key) uses an API key and bills you per token at the provider's API rates, with requests routed through Raycast's servers. Bring Your Own Subscription uses your flat-rate consumer subscription, runs through the provider's tool on your computer, and is bound by that subscription's limits. If you already pay for Claude or ChatGPT, subscriptions are usually the cheaper option. ### Do subscription models use my Raycast AI credits? Not for the conversation itself. The exception is tools that Raycast has to run on its own servers, such as image generation, which use a Raycast AI model for that single step. Everything else counts towards your Claude or ChatGPT plan. ### Do I need to set this up on each computer? Yes. The connection depends on the provider's tool being installed and signed in on that machine, so repeat the setup on each Mac or PC. Subscription models synced from another device show as unavailable until you do. ### Can I use subscription models on iOS? Bring Your Own Subscription is only available on Mac and Windows, where the provider's tool runs. Subscription models can't run directly on your iPhone or iPad. ## Troubleshooting ### Settings says Claude Code or Codex isn't installed, but I have it Raycast may not be able to see where the tool lives. Confirm it runs from a fresh Terminal window with `claude --version` or `codex --version`, then restart Raycast so it picks up your current `PATH`. If you installed it in an unusual location, add that folder to your `PATH`. Raycast checks these locations: - **Mac**: your shell's `PATH`, Homebrew, npm's global folder, `~/.local/bin`, and the copy of Codex bundled inside Codex.app or ChatGPT.app in your Applications folder. - **Windows**: your `PATH`, the app's folder under `%LOCALAPPDATA%\Programs`, and Codex Desktop's install under `%LOCALAPPDATA%\OpenAI\Codex\bin`. ### Raycast says the tool is installed but I need to sign in Sign in from Terminal: run `claude` then `/login` for Claude, or `codex login` for ChatGPT. Make sure you sign in with your subscription account rather than an API key. Then click **Refresh account status** in Settings. ### "This account doesn't include a supported subscription" The signed-in account has API access but no consumer subscription, or Codex is signed in with an API key. Sign out and back in with the account that holds your Claude or ChatGPT plan. For API-only accounts, use [Bring Your Own Key](https://manual.raycast.com/ai/bring-your-own-key) instead. ### "This version is incompatible with Raycast's local subscription protocol" Your copy of Claude Code or the Codex CLI is too old or too new for the version of Raycast you're running. Raycast needs Claude Code 2.1.245 or newer, or Codex CLI 0.142.5 or newer. Update the tool with the provider's instructions, make sure Raycast is up to date, then refresh the account in Settings. ### A chat shows "Sign in to Claude" or "Sign in to ChatGPT" Your sign-in with the provider has expired or been revoked. Choose **Provider Settings**, sign in again from Terminal, then click **Check Connection** in the notice above the composer or resume the chat. ### Still having issues? If none of the above resolves it, gather the following and send it to us via the [Send Feedback](raycast://extensions/raycast/raycast/send-feedback) command so we can investigate (see [Contact Support](https://manual.raycast.com/contact-support) for more ways to get in touch): 1. **Your OS version** and **Raycast version** (found in **Settings → About**). 2. Which provider you're connecting, and the output of `claude --version` or `codex --version`. 3. The **status message** shown under the account in **Settings → AI → Models & Providers → Local AI Subscriptions**. 4. The **model** you selected and the **AI feature** you used when the problem occurred. 5. **Your Raycast logs**: use the built-in **Copy Raycast Logs** command to copy your latest log files to the clipboard, or **Reveal Raycast Logs** to open your log folder. --- ## Need Help? Contact Raycast Support if you have any questions or would like help with Bring Your Own Subscription. Use the **Send Feedback** command directly in Raycast to report bugs and billing issues, log feature requests, or any other queries you would like to speak to us about. You can view all Raycast Support contact options at https://manual.raycast.com/contact-support