Raycast

快速的 macOS 启动器，AI 可用你自己的密钥运行在任意 OpenAI 兼容端点上。

Raycast 是什么

Raycast 是一款快速的 macOS 启动器和效率中枢，可用来启动应用、管理剪贴板和窗口，以及运行 AI 命令。它的 Custom Providers（自定义供应商）功能允许添加任意 OpenAI 兼容端点，因此你可以用自己的密钥，让 Raycast AI 运行在 TokenMix 上，使用 Claude、GPT 或 DeepSeek。

开始之前

从 raycast.com 安装 Raycast，它运行在 macOS 上。
在 tokenmix.ai 注册，打开控制台，进入 API Keys，创建一个以 sk-tm- 开头的密钥。

开启 Custom Providers

Custom Providers 是实验功能，默认关闭，需要先手动开启。

打开 Settings（设置），进入 AI，再打开 Experiments（实验功能）。
开启 Custom Providers（自定义供应商），它也叫 Bring Your Own Model（自带模型）。

接入 TokenMix

仍在 Settings（设置）和 AI 下，找到 Custom Providers（自定义供应商）这一项，打开它的配置文件（providers.yaml）。
添加一个供应商。字段为 id、name、base_url、api_keys 和 models。base_url 填 TokenMix 的地址 https://api.tokenmix.ai/v1（带 /v1），并至少列出一个模型：

- id: tokenmix
  name: TokenMix
  base_url: https://api.tokenmix.ai/v1
  api_keys:
    - sk-tm-your-key
  models:
    - id: claude-sonnet-4.6
      name: Claude Sonnet 4.6

保存文件。字段名以你的 Raycast 版本在 providers.yaml 中生成的模板为准。

验证是否生效

打开 Raycast AI，选择你的 TokenMix 模型，提一个简短的问题。能收到回复就说明已接入成功。你可以在 TokenMix 控制台查看消费。

常见问题

Custom Providers 在哪里：它位于 Settings（设置）、AI、Experiments（实验功能）之下，默认关闭。这是一项实验特性，不同 Raycast 版本的具体措辞可能不同。

看不到模型：确认每个模型都已在 providers.yaml 的 models 下列出，并填了有效的 TokenMix 模型 id。

选哪些模型：对于启动器中的快速操作，Claude Haiku 4.5 和 DeepSeek V4 Flash 这类快速模型很合适；较重的任务用 Claude Sonnet 4.6 或 GPT-5.4。