Raycast AI에서 사용자 지정 AI 명령어와 퀵 프리셋을 만들어 데스크톱 워크플로를 최적화하는 방법

코드 에디터, 터미널, 브라우저의 AI 챗봇 탭 사이를 수시로 오가는 작업은 개발자의 집중력을 분산시키는 주된 요인입니다. macOS용 생산성 런처인 Raycast AI는 대규모 언어 모델(LLM)을 시스템 레벨에 직접 통합하여 이러한 번거로움을 해결합니다. 텍스트를 복사해 브라우저를 열고 프롬프트를 붙여넣은 뒤 답변을 다시 가져오는 비효율적인 과정 대신, 단축키 하나로 모든 앱 위에서 맞춤형 AI 작업을 즉시 실행할 수 있습니다.

Raycast AI는 일상적인 자동화를 위해 상호보완적인 두 가지 핵심 도구를 제공합니다:

1. 사용자 지정 AI 명령어(Custom AI Commands): 선택한 텍스트나 클립보드를 대상으로 단 한 번의 실행으로 동작하는 프롬프트 기반 도구로, 결과를 플로팅 창에 표시하거나 제자리에서 즉시 텍스트를 대체합니다.
2. AI 프리셋 및 에이전트(AI Presets / Agents): 지속적인 대화형 작업을 위해 특화된 시스템 프롬프트, 지정 모델, 추론 강도, 도구 확장(AI Extensions)을 묶어 둔 템플릿입니다.

이 가이드에서는 맞춤형 AI 명령어 생성 방법, 동적 플레이스홀더 활용법, 전용 에이전트(프리셋) 설정, 글로벌 단축키 매핑까지 데스크톱 생산성을 극대화하는 전 과정을 상세히 다룹니다.

1. 사용자 지정 AI 명령어 생성하기

사용자 지정 AI 명령어는 코드 리팩터링, 타입 생성, 오류 진단, 문법 교정 등 입력과 출력이 명확한 단발성 반복 작업에 최적화되어 있습니다.

상세 생성 단계

1. ⌥ Space(또는 사용자가 지정한 Raycast 실행 단축키)를 눌러 런처를 엽니다.
2. 검색창에 Create AI Command를 입력하고 Enter를 누릅니다. (또는 Search AI Commands에서 기존 기본 명령어를 선택한 뒤 ⌘D를 눌러 복제하여 수정할 수도 있습니다).
3. 설정 양식의 항목을 작성합니다:
   • Name & Icon(이름 및 아이콘): 역할을 쉽게 알아볼 수 있는 명칭(예: Refactor to TypeScript 또는 Explain SQL Query)을 지정하고 적절한 아이콘을 선택합니다.
   • Prompt(프롬프트 지시문): 모델이 수행할 구체적인 지침을 입력합니다. {를 입력하면 동적 플레이스홀더를, @를 입력하면 도구 확장을 연결할 수 있습니다.
   • Model(모델): 실행에 사용할 모델(Claude 3.5 Sonnet, GPT-4o, 추론 모델인 o1/o3-mini 등)을 선택합니다. 비워둘 경우 기본 설정(Settings → AI → Models & Providers)의 모델을 사용합니다.
   • Creativity(창의성/온도): None, Low, Medium, High, Maximum 중 선택합니다. 엄격한 코드 변환이나 데이터 추출 작업에는 None 또는 Low를 권장합니다.
   • Reasoning Effort(추론 강도): 지원되는 추론 모델을 사용할 때 생각하는 시간 예산을 조정합니다.
   • Output Behavior(출력 동작):
     • Open in Raycast: 별도의 Raycast 플로팅 창에 결과를 서식화하여 표시합니다. 손쉽게 검토 및 복사할 수 있으며, ⌘J를 눌러 전체 대화 기록을 유지한 채 AI Chat으로 전환할 수 있습니다.
     • Replace Selection: 현재 활성화된 앱에서 마우스나 커서로 선택한 텍스트를 AI가 생성한 결과물로 제자리에서 즉시 덮어씁니다.
   • Highlight Editing Changes(수정 내용 강조): Replace Selection과 함께 사용 시, 변경된 diff 내용을 시각적으로 하이라이트합니다.
4. ⌘ Enter를 눌러 저장합니다. 저장 즉시 루트 검색창에서 검색하여 실행할 수 있습니다.

2. 동적 플레이스홀더(Dynamic Placeholders) 활용하기

Raycast의 동적 플레이스홀더를 사용하면 수동으로 복사하고 붙여넣지 않아도 작업 환경의 실시간 맥락을 프롬프트에 자동으로 주입할 수 있습니다.

파이프 수정자(Modifiers)

파이프 기호를 이용해 플레이스홀더 입력값을 가공할 수 있습니다:

• {clipboard | trim}: 앞뒤 공백과 줄바꿈을 제거합니다.
• {selection | lowercase} 또는 {selection | uppercase}: 대소문자를 일괄 변환합니다.
• {selection | json-stringify}: 따옴표와 특수 문자를 이스케이프하여 JSON 문자열에 안전하게 포함합니다.
• {clipboard | raw}: Raycast가 자동으로 따옴표를 감싸는 동작을 방지합니다.

실전 프롬프트 예시

예시 1: 제자리 TypeScript 타입 정의 및 JSDoc 생성

• 출력 동작: Replace Selection
• Creativity: Low
• Prompt:

Analyze the following code selection:
{selection}

Add strict TypeScript types, explicit interface definitions, and JSDoc documentation. Return only the updated code block without surrounding explanations or markdown wrappers.

예시 2: 대화형 Git 커밋 메시지 생성기

• 출력 동작: Open in Raycast
• Prompt:

Write a concise, conventional git commit message based on the following diff or staged summary:
{clipboard}

Focus on type: {argument name="Commit Type" default="feat"}.
Format as:
<type>(<scope>): <summary>

- Optional body explaining the why behind the change.

3. AI 프리셋(Presets)과 커스텀 에이전트(Agents) 구축

단발성 AI 명령어와 달리 복잡한 아키텍처 논의나 지속적인 코드 리뷰를 진행할 때는 일관된 페르소나, 코딩 표준, 도구 접근 권한이 설정된 대화 환경이 필요합니다.

Raycast v1에서 AI Chat Presets로 불리던 이 기능은 Raycast v2에서 **Agents(에이전트)**로 진화하였으며, 기존 프리셋 설정 및 커뮤니티 Preset Explorer와 완전히 호환됩니다.

커스텀 에이전트 만들기

1. Settings → AI → Agents로 이동합니다(또는 런처에서 Search Agents 실행 후 Create Agent 선택).
2. 에이전트 세부 속성을 설정합니다:
   • Name & Icon: 명확한 역할 이름(예: PostgreSQL 쿼리 튜닝 전문가 또는 시니어 코드 리뷰어).
   • Model: 특정 모델을 고정하거나, 대화창 설정을 따르는 Inherit을 지정합니다.
   • Instructions(시스템 프롬프트): 지켜야 할 아키텍처 원칙, 금지 사항, 응답 스타일을 정의합니다.
   • AI Extensions(도구 권한): 에이전트가 호출할 수 있는 도구 확장(@calendar, @github, @file-search 등)만 선별하여 권한을 부여합니다.
3. ⌘ Enter를 눌러 저장합니다.

에이전트 호출 및 전환

• AI Chat 내 빠른 전환: 입력창에서 /를 입력해 전환 메뉴를 띄우거나 ⌘K → Change Agent를 사용합니다.
• 루트 검색에서 바로 실행: 런처에서 에이전트 이름을 검색하고 Enter를 누르면 해당 페르소나가 적용된 새 채팅 창이 바로 열립니다.
• 커뮤니티 프리셋 가져오기: presets.ray.so에서 검증된 프리셋을 원클릭으로 로컬 Raycast에 등록할 수 있습니다.

4. 글로벌 단축키와 Quick Fix를 통한 무지연 실행

자주 사용하는 도구를 키보드 단축키에 매핑하면 작업 전환 비용을 완전히 없앨 수 있습니다:

1. 전용 Hotkey 할당:

   • Settings → Extensions → AI로 이동합니다(또는 원하는 명령어에서 ⌘K → Configure Command 실행).
   • 해당 명령어 또는 에이전트 항목의 Hotkey 영역을 클릭하고 단축키 조합을 등록합니다(예: 커밋 생성기에 ⌃⌥C, 코드 리팩터링에 ⌃⌥R).
   • 이제 VS Code나 Xcode에서 텍스트를 드래그하고 ⌃⌥R만 누르면 Raycast 검색창을 열 필요도 없이 그 자리에서 코드가 변환됩니다.

2. Quick Fix 활용:

   • Raycast에는 맞춤법 및 문법 교정을 위해 특화된 Quick Fix 기능이 내장되어 있습니다.
   • 기본적으로 오른쪽 Shift 키를 연속 두 번(Double Right Shift) 누르면 포커스된 입력창의 문장을 그 자리에서 바로 검사하고 교정합니다.
   • Settings → AI → Quick Fix에서 Preserve Formatting을 켜두면 Slack, Notion 등의 리치 텍스트 에디터에서 볼드, 링크, 서식을 그대로 보존하면서 교정이 이루어집니다.

5. 시스템 권한, 요금제 및 모델 연동 안내

macOS 손쉬운 사용(Accessibility) 권한

Replace Selection을 통한 텍스트 자동 치환이나 Quick Fix를 정상 작동시키려면 macOS 접근성 권한이 필수적입니다.

• 시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용(최신 macOS에서는 "기기 제어 및 데이터 접근")으로 이동합니다.
• Raycast의 권한이 켜져 있는지 확인합니다.

요금제 및 BYOK(자체 API 키) 옵션

• Raycast 무료 버전: 기본 런처 도구(계산기, 스니펫, 클립보드 히스토리, 확장 프로그램 스토어) 제공.
• Raycast Pro(월 $10 또는 연 $96): Raycast AI 잠금 해제, 매월 정기 AI 크레딧 지급, 클라우드 동기화 및 사용자 지정 AI 명령어 지원.
• Pro+ 및 Max 요금제: 고성능 프론티어 모델을 대량으로 사용하는 전문 개발자를 위한 확장 크레딧 플랜.
• BYOK 및 기존 구독 연동: Pro 등급 이상 사용자는 OpenAI, Anthropic, Google, OpenRouter의 API Key를 등록하거나, 기존에 사용 중인 ChatGPT 및 Claude 구독 계정을 직접 연결하여 모델 추론 비용을 유연하게 관리할 수 있습니다.

단발성 AI 명령어의 속도감과 맞춤형 에이전트의 깊이 있는 문맥을 결합하면, 브라우저 창 전환 없이 매끄럽게 연결되는 강력한 macOS 개발 환경을 구축할 수 있습니다.

참고 자료

• AI Commands | Raycast Manual
• Dynamic Placeholders | Raycast Manual
• Agents | Raycast Manual
• AI Chat | Raycast Manual