튜토리얼: macOS 설정
이 튜토리얼에서는 설치부터 첫 드래그 선택(drag-select) 명령 실행까지, macOS에 특화된 Rephlo 온보딩 과정 전체를 안내합니다. 이미 일반 설치 및 설정을 완료하셨다면, 이 튜토리얼에서는 macOS 관련 세부 사항을 더 깊이 다룹니다.
목적
macOS에는 Rephlo의 작동 방식에 영향을 미치는 고유한 보안 및 개인정보 보호 요구 사항이 있습니다. 전역 단축키가 별 도 설정 없이 바로 작동하는 Windows와 달리, macOS에서는 손쉬운 사용(Accessibility)과 화면 기록(Screen Recording)에 대한 명시적인 사용자 동의가 필요합니다. 이 튜토리얼을 따라 하면 처음부터 Rephlo의 모든 기능을 사용할 수 있도록 올바르게 설정할 수 있습니다.
사전 요구 사항
| 요구 사항 | 세부 내용 |
|---|---|
| macOS 버전 | 10.15 Catalina 이상 |
| 아키텍처 | Apple Silicon (M1/M2/M3/M4) 또는 Intel (x64) |
| 디스크 공간 | 애플리케이션 번들용 약 250 MB |
| Ollama (선택 사항) | 로컬 모델을 사용하려면 Ollama를 별도로 설치하세요 |
1단계: 다운로드 및 설치
1.1 Rephlo 다운로드
https://rephlo.app/download로 이동하여 최신 macOS 패키지를 다운로드합니다:
- Apple Silicon Mac(M1/M2/M3/M4)의 경우
Rephlo-macos-arm64.dmg - Intel Mac의 경우
Rephlo-macos-x64.dmg
1.2 응용 프로그램 폴더에 설치
- 다운로드한
.dmg파일을 엽니다. Rephlo.app을/Applications폴더로 드래그합니다.- 디스크 이미지를 꺼냅니다.
1.3 첫 실행 — Gatekeeper
Rephlo를 처음 열 때 macOS Gatekeeper가 다음과 같은 메시지로 실행을 차단할 수 있습니다: "Rephlo.app cannot be opened because the developer cannot be verified."(개발자를 확인할 수 없기 때문에 Rephlo.app을 열 수 없습니다.)
다음 단계를 따르세요:
- 앱을 더블클릭하지 마세요. 대신
/Applications에서Rephlo.app을 마우스 오른쪽 버튼으로 클릭(또는 Control 키를 누른 채 클릭)합니다. - 컨텍스트 메뉴에서 **"Open"**을 선택합니다.
- 확인 대화 상자에서 다시 **"Open"**을 클릭합니다.
macOS는 이 선택을 기억합니다. 이후에는 더블클릭만으로 정상적으로 실행됩니다.
왜 이런 일이 발생하나요? macOS Gatekeeper는 Mac App Store 외부에서 다운로드한 앱에 대해 경고를 표시합니다. 마우스 오른쪽 버튼 클릭 > Open 방법을 사용하면 현재 앱에 한해 이 검사를 건너뛸 수 있습니다.
2단계: 필요한 권한 부여하기
권한이 필요한 이유
Rephlo는 전역 단축키를 감지하고, 명령을 실행할 때 현재 선택된 텍스트를 읽어옵니다. macOS에서는 이를 위해 Accessibility 권한이 필요합니다. 화면 캡처(스크린샷)를 위해서는 별도로 Screen Recording 권한이 필요합니다.
이 권한들이 없으면 Rephlo의 시스템 전역 통합 기능이 작동하지 않습니다.
2.1 PermissionPreCheckDialog
첫 실행 직후, Rephlo는 PermissionPreCheckDialog를 표시합니다:
2.2 Accessibility 권한 부여하기
- PermissionPreCheckDialog에서 Accessibility 옆에 있는 **"Open System Settings"**를 클릭합니다.
- macOS에서 System Settings > Privacy & Security > Accessibility가 열립니다.
- 앱 목록에서 Rephlo를 찾습니다.
- 스위치를 ON으로 전환합니다.
- 메시지가 표시되면 macOS 암호 또는 Touch ID로 인증합니다.
- Rephlo 대화 상자로 돌아갑니다.
2.3 Screen Recording 권한 부여하기
- PermissionPreCheckDialog에서 Screen Recording 옆에 있는 **"Open System Settings"**를 클릭합니다.
- macOS에서 System Settings > Privacy & Security > Screen Recording이 열립니다.
- 앱 목록에서 Rephlo를 찾습니다.
- 스위치를 ON으로 전환합니다.
- 메시지가 표시되면 인증합니다.
- Rephlo 대화 상자로 돌아갑니다.
2.4 확인 및 재시작
- Rephlo 대화 상자로 돌아가서 **"Check Again"**을 클릭합니다.
- 이제 두 권한 모두 Granted로 표시되어야 합니다.
- Rephlo를 완전히 종료합니다(메뉴 막대 아이콘을 마우스 오른쪽 버튼으로 클릭 > Exit, 또는
Cmd+Q). /Applications에서 Rephlo를 다시 실행합니다. 일부 macOS 권한 변경 사항은 적용되려면 완전한 재시작이 필요합니다.
Tip: 권한을 켠 후에도 체크박스가 여전히 "Not Granted"로 표시된다면, Rephlo를 종료하고 몇 초 기다린 다음 다시 실행해 보세요. macOS가 이전 권한 상태를 캐시하는 경우가 있습니다.
3단계: 첫 번째 AI 제공업체 설정하기
권한 부여가 완료되면, Rephlo가 명령을 처리할 수 있도록 AI 제공업체를 설정합니다.
- 메뉴 막대에서 Rephlo 아이콘을 클릭한 다음 **"Settings"**를 선택합니다(또는 Dashboard를 열어 Settings로 이동합니다).
- Settings > LLM Providers로 이동합니다.
- 목록에서 제공업체를 선택합니다:
| 제공업체 | 필요한 항목 |
|---|---|
| OpenAI | platform.openai.com에서 발급받은 API 키 |
| Anthropic | console.anthropic.com에서 발급받은 API 키 |
| aistudio.google.dev에서 발급받은 API 키 | |
| Groq | console.groq.com에서 발급받은 API 키 |
| xAI (Grok) | console.x.ai에서 발급받은 API 키 |
| OpenRouter | openrouter.ai에서 발급받은 API 키 |
| Azure OpenAI | Azure 포털에서 발급받은 엔드포인트 URL + API 키 |
| Ollama | 로컬 설치, 키 불필요(엔드포인트: http://localhost:11434) |
| OpenAI-Compatible | 호환되는 서비스의 엔드포인트 URL + API 키 |
- API Key를 입력합니다(해당하는 경우 엔드포인트 URL도 입력).
- Test Connection을 클릭하여 확인합니다.
- Save를 클릭합니다.
빠른 시작 추천: AI API를 처음 사용하신다면 OpenAI 또는 Anthropic이 설정하기 가장 간단합니다. 클라우드에 의존하지 않는 완전한 개인정보 보호를 원하신다면 Ollama를 설치하여 로컬 모델을 사용하세요.
4단계: macOS 단축키 익히기
Rephlo는 플랫폼별 기본 단축키를 사용합니다. 다음은 Windows/Linux와 비교한 macOS 기본값입니다:
| 동작 | macOS | Windows / Linux |
|---|---|---|
| 컨텍스트 메뉴 오버레이 | Shift+Cmd+C | Ctrl+Shift+Alt+C |
| 스크린샷 캡처 | Shift+Cmd+S | Ctrl+Shift+Alt+S |
| 드래그 선택 보조키 | Cmd | Ctrl |
| 확대 | Cmd+Plus | Ctrl+Plus |
| 축소 | Cmd+Minus | Ctrl+Minus |
| 확대/축소 초기화 | Cmd+0 | Ctrl+0 |
단축키 사용자 지정하기
모든 단축키는 완전히 사용자 지정할 수 있습니다:
- Settings > Hotkeys를 엽니다.
- 변경하려는 단축키 필드를 클릭합니다.
- 원하는 키 조합을 누릅니다.
- Save를 클릭합니다.
Tip: 단축키가 다른 애플리케이션(예: Spotlight, Alfred, Raycast)과 충돌하는 경우 다른 조합을 선택하세요. 선택한 단축키가 이미 시스템에서 사용 중이면 Rephlo가 경고를 표시합니다.
5단계: 드래그 선택으로 테스트하기
드래그 선택 워크플로는 macOS에서 Rephlo를 사용하는 가장 빠른 방법입니다. 직접 시도해 봅시다:
5.1 텍스트 애플리케이션 열기
TextEdit, Notes, Safari, 또는 텍스트를 선택할 수 있는 아무 앱이나 엽니다.
5.2 드래그 선택 수행하기
Cmd키를 누른 상태를 유지합니다(macOS의 기본 드래그 선택 보조키입니다).Cmd키를 누른 채로 텍스트 위에서 마우스를 클릭한 상태로 드래그하여 선택합니다.- 마우스 버튼을 놓으면 커서 근처에 Rephlo 오버레이가 즉시 나타납니다.
5.3 명령 실행하기
- 오버레이에서 "Summarize"(또는 다른 명령)를 클릭합니다.
- Rephlo가 선택한 텍스트를 설정된 AI 제공업체로 전송합니다.
- 오버레이에 결과가 표시됩니다.
- 결과를 클립보드에 복사하려면 Copy를, 원본 텍스트를 결과로 바꾸려면 Insert를 클릭합니다.
Note: 드래그 선택 보조키는 사용자 지정이 가능합니다. Settings > Hotkeys > Text Selection Trigger로 이동하면
Cmd를 원하는 다른 키로 변경할 수 있습니다.
macOS 관련 문제 해결
단축키가 작동하지 않는 경우
증상: Shift+Cmd+C를 눌러도 아무 반응이 없습니다. 오버레이가 나타나지 않습니다.
원인: Accessibility 권한이 부여되지 않았거나, 권한을 부여한 후 앱을 재시작하지 않았습니다.
해결 방법:
- System Settings > Privacy & Security > Accessibility를 엽니다.
- Rephlo가 ON으로 설정되어 있는지 확인합니다.
- 이미 켜져 있었다면 OFF로 껐다가 다시 ON으로 켭니다.
- Rephlo를 종료 후 다시 실행합니다.
스크린샷 캡처가 작동하지 않는 경우
증상: 스크린샷 명령이 실패하거나 빈 이미지가 생성됩니다.
원인: Screen Recording 권한이 부여되지 않았습니다.
해결 방법:
- System Settings > Privacy & Security > Screen Recording을 엽니다.
- Rephlo가 ON으로 설정되어 있는지 확인합니다.
- Rephlo를 종료 후 다시 실행합니다.
오버레이가 나타나지 않는 경우
증상: 단축키를 누르거나 드래그 선택을 해도 오버레이 창이 나타나지 않습니다.
가능한 원인 및 해결 방법:
| 가능한 원인 | 해결 방법 |
|---|---|
| Accessibility 권한이 부여되지 않음 | Accessibility 권한을 부여하고 재시작 |
.app 번들로 실행되지 않음 | dotnet run이 아니라 /Applications/Rephlo.app에서 실행 |
| 다른 앱과의 단축키 충돌 | Settings > Hotkeys에서 충돌 여부를 확인하고 조합을 변경 |
| 앱이 일시 중지됨 | 메뉴 막대 아이콘을 마우스 오른쪽 버튼으로 클릭하여 "Resume Rephlo"가 표시되면 클릭 |
실행할 때마다 Gatekeeper가 앱을 차단하는 경우
증상: macOS가 계속해서 "developer cannot be verified"(개발자를 확인할 수 없음) 경고를 표시합니다.
해결 방법: 첫 실행 시 마우스 오른쪽 버튼을 클릭하고 **"Open"**을 선택했는지 확인하세요. 문제가 계속되면:
- System Settings > Privacy & Security를 엽니다.
- Security 섹션까지 아래로 스크롤합니다.
- Rephlo가 차단되었다는 메시지가 표시됩니다. **"Open Anyway"**를 클릭합니다.
권한 목록에 Rephlo가 표시되지 않는 경우
증상: System Settings > Accessibility를 열었지만 Rephlo가 목록에 없습니다.
해결 방법: Rephlo를 최소 한 번 실행하세요. macOS는 앱이 보호된 기능을 처음 사용하려고 시도한 후에만 해당 앱을 권한 목록에 추가합니다. 실행 후 권한 목록을 다시 확인하세요.
다음 단계
이제 macOS에서 모든 설정이 완료되었습니다. 다음은 권장하는 다음 단계입니다:
- 첫 사용 안내 — 첫 AI 명령을 단 계별로 실행해 봅니다.
- Commands — 나만의 명령을 만들고 사용자 지정하는 방법을 알아봅니다.
- Spaces — 문서를 AI 컨텍스트로 추가하여 근거 있는 응답을 받습니다.
- Template Gallery — 일반적인 작업을 위한 미리 만들어진 명령을 둘러봅니다.
- Advanced Use Cases — 파워 유저를 위한 워크플로 및 자동화 레시피를 확인합니다.