Raycast

빠른 macOS 런처로, AI를 자신의 키로 임의의 OpenAI 호환 엔드포인트에서 실행할 수 있습니다.

Raycast란

Raycast는 앱 실행, 클립보드와 창 관리, AI 명령 실행에 쓰이는 빠른 macOS 런처이자 생산성 허브입니다. 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를 사용하세요.