Maccy가 실행하자마자 종료된다면? 10분 안에 원인 진단하고 해결하기

TL;DR: 가장 빠른 해결 순서

1. 사용 중인 macOS 버전이 Maccy 버전의 요구 사양을 충족하는지 확인합니다.
2. Maccy를 완전히 종료하고, /Applications에 새로 설치한 뒤 다시 실행합니다.
3. 터미널 명령어 한 줄로 환경설정을 초기화합니다.
4. 히스토리 저장소를 따로 옮겨 둡니다(반드시 백업 먼저).
5. 크래시 리포트를 열어 실제로 무엇이 실패하는지 확인합니다.

정말 크래시가 난 걸까요, 아니면 그냥 안 보이는 걸까요?

Maccy Mac는 메뉴 막대 앱입니다. 설정에 따라 Dock 아이콘도 없고 실행 시 창도 뜨지 않을 수 있어서, “아무 일도 안 일어났다”와 “크래시가 났다”는 같은 말이 아닙니다. 먼저 아래 세 가지를 확인해 보세요.

• 활성 상태 보기(Activity Monitor)를 확인하세요. Maccy가 목록에 있고 CPU 사용량이 정상이라면 실행 중인 것입니다. 메뉴 막대 아이콘이 노치나 메뉴 막대 관리 앱 뒤에 가려져 있을 수 있습니다.
• 단축키를 눌러 보세요. 기본값은 Shift+Command+C입니다. 팝업이 뜬다면 Maccy는 멀쩡하고 아이콘만 가려진 것입니다.
• 실행 직후 종료되는 패턴인지 보세요. 아이콘이 잠깐 나타났다 사라지거나 macOS에 “Maccy가 예기치 않게 종료되었습니다”라는 메시지가 뜬다면 진짜 크래시이며, 아래 단계를 따라가면 됩니다.

내 증상에는 어떤 해결책이 맞을까요?

해결 1: macOS 버전이 Maccy 버전을 지원하는지 확인하기

Maccy Clipboard 2.x부터는 0.x, 1.x 릴리스보다 최소 macOS 요구 사양이 높아졌습니다. 최신 빌드는 비교적 최근의 macOS를 필요로 하기 때문에, 오래된 Mac에서 최신 빌드를 실행하면 아예 시작되지 않을 수 있습니다.

1. Apple 메뉴 → 이 Mac에 관하여를 열어 macOS 버전을 확인합니다.
2. Maccy 릴리스 페이지에 적힌 최소 요구 버전과 비교합니다.
3. Mac이 최신 macOS를 실행할 수 없다면, 최신 버전 대신 사용 중인 시스템을 지원하는 이전 Maccy 릴리스를 내려받으세요.

반대 경우도 있습니다. macOS를 메이저 업그레이드한 뒤 오래된 Maccy 빌드가 오작동하는 것입니다. 이때는 Maccy를 업데이트하면 해결됩니다.

해결 2: 깨끗하게 다시 설치하기

앱 번들이 반만 복사되었거나, 다운로드 폴더에서 바로 실행했거나, 격리 플래그가 남아 있으면 모두 실행 실패의 원인이 될 수 있습니다.

1. Maccy를 종료합니다. 종료되지 않으면 활성 상태 보기를 열어 Maccy를 선택하고 중단 버튼을 누르세요.
2. /Applications에서 Maccy.app을 삭제합니다. 히스토리와 설정은 삭제되지 않습니다.
3. 처음 설치했던 방법으로 다시 설치합니다.
   • Homebrew: brew reinstall --cask maccy
   • GitHub 릴리스: 최신 .zip 파일을 받아 압축을 풀고, Maccy.app을 (다운로드 폴더가 아닌) /Applications로 드래그합니다.
   • Mac App Store: 구입 항목에서 다시 설치합니다.
4. /Applications에서 실행합니다.

macOS가 앱이 손상되었거나 확인되지 않은 개발자의 앱이라고 알려 주면, 앱을 우클릭하고 열기를 선택한 뒤 확인하세요. 시스템 설정 → 개인정보 보호 및 보안 하단에 차단된 앱이 표시되는데, 여기서 허용할 수도 있습니다. 이 방법은 공식 GitHub 릴리스나 App Store에서 받은 사본에만 사용하세요.

해결 3: Maccy 환경설정 초기화하기

환경설정 파일 손상은 실행할 때마다 반복되는 크래시의 전형적인 원인입니다. 초기화하면 클립보드 히스토리는 건드리지 않고 Maccy를 기본 설정 상태로 되돌릴 수 있습니다.

1. Maccy를 종료합니다.
2. 터미널을 열고 다음 명령어를 실행합니다.

   defaults delete org.p0deje.Maccy

3. Maccy를 다시 실행합니다.

사용자 지정 단축키, 무시 목록, 표시 설정은 다시 입력해야 합니다. 명령어가 해당 도메인이 없다고 응답한다면 샌드박스가 적용된 App Store 빌드를 사용 중일 가능성이 높습니다. 이 빌드의 환경설정은 컨테이너 안에 저장됩니다. 이 경우에는 해결 4 또는 크래시 리포트 확인 단계로 넘어가세요.

해결 4: 히스토리 저장소를 따로 옮겨 두기

Maccy는 클립보드 히스토리를 로컬 데이터베이스에 보관합니다. 강제 종료나 디스크 공간 부족 같은 상황 이후에 이 데이터베이스가 손상되면, Maccy가 불러오는 도중에 크래시가 날 수 있습니다. 삭제하지 말고, 나중에 복원할 수 있는 곳으로 옮겨 두세요.

1. Maccy를 종료합니다.
2. Finder에서 이동 → 폴더로 이동…(Shift+Command+G)을 선택합니다.
3. 설치 방식에 맞는 저장 위치를 엽니다. 직접 다운로드하거나 Homebrew로 설치했다면 ~/Library/Application Support/Maccy, App Store 빌드라면 ~/Library/Containers/org.p0deje.Maccy 안의 해당 폴더입니다.
4. Maccy 데이터 파일을 백업용으로 데스크탑에 드래그합니다.
5. Maccy를 다시 실행합니다. 비어 있는 새 히스토리가 만들어집니다.

Maccy가 정상적으로 실행된다면 문제는 예전 저장소였던 것입니다. 백업해 둔 파일에서 고정 항목과 히스토리를 일부 복구할 수도 있지만, 새로 시작한다고 생각하는 편이 좋습니다. 그래도 크래시가 난다면 파일을 원래 위치로 복원하고 다음 단계로 넘어가세요. 그래야 데이터를 헛되이 잃지 않습니다.

해결 5: 크래시 리포트 읽기

간단한 해결책이 통하지 않을 때는 크래시 리포트가 실제로 무엇이 문제인지 알려 줍니다. 2분이면 충분합니다.

1. 콘솔(Console.app)을 열고 사이드바에서 충돌 보고서를 선택합니다. ~/Library/Logs/DiagnosticReports 폴더를 직접 열어도 됩니다.
2. 이름에 “Maccy”가 들어 있는 가장 최근 리포트를 엽니다.
3. Exception Type, Termination Reason, 그리고 Crashed Thread의 스택, 이 세 항목을 확인합니다.

원인이 분명하지 않다면 이슈를 등록할 때 리포트를 첨부하세요(아래 참고). 리포트에는 사용자 이름이 포함된 파일 경로가 들어 있을 수 있으니, 개인 정보는 먼저 지우고 올리세요.

해결 6: 실행은 잘 되는데 붙여넣기가 안 될 때

“Maccy가 고장 났다”는 제보 중 크래시가 아닌 경우로는 이것이 가장 흔합니다. 다른 앱에 바로 붙여넣으려면 Maccy에 손쉬운 사용 권한이 필요합니다. 시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용을 열고 Maccy가 목록에 있으며 켜져 있는지 확인하세요. 이미 켜져 있는 것처럼 보여도 껐다가 다시 켜 보세요. 앱을 업데이트하거나 재설치하면 macOS가 새 바이너리를 다른 앱으로 인식하는 경우가 있어서, 기존 항목을 지우고 Maccy를 다시 추가하면 문제가 풀리는 일이 많습니다.

다른 앱이 크래시의 원인일 수도 있을까요?

가능성이 있습니다. Maccy는 시스템 페이스트보드를 감시하기 때문에, 클립보드를 다루는 다른 소프트웨어와 충돌할 수 있습니다. 두 번째 클립보드 매니저, 텍스트 확장 도구, 클립보드 기능이 있는 비밀번호 관리자를 설치한 직후부터 크래시가 시작되었다면, 그 앱을 잠시 종료하고 Maccy를 다시 실행해 보세요. 클립보드 매니저를 두 개 돌리는 건 대개 수고에 비해 얻는 게 적습니다. 보안 프로그램이나 “클리너” 유틸리티가 Maccy를 의심스러운 파일로 분류해 일부를 격리하지 않았는지도 확인해 보세요.

재발을 막으려면 어떻게 해야 할까요?

• Maccy를 최신 상태로 유지하세요. 새 macOS 릴리스와 관련된 시작 시 크래시는 대개 포인트 릴리스에서 수정됩니다.
• /Applications에서 실행하세요. 다운로드 폴더나 디스크 이미지에서 직접 실행한 앱은 격리 및 업데이트 문제를 겪을 가능성이 더 높습니다.
• 복사하는 도중에 강제로 전원을 끄지 마세요. 갑작스러운 전원 차단은 로컬 데이터베이스가 손상되는 가장 흔한 원인입니다.
• 히스토리나 고정 항목이 중요하다면 저장 폴더를 가끔 백업하세요.

그래도 계속 종료된다면? 제대로 제보하는 방법

Maccy는 오픈 소스라서 좋은 버그 리포트가 곧 수정 속도를 높여 줍니다. 먼저 기존 이슈에서 같은 증상을 검색해 본 다음, Maccy GitHub 저장소에 이슈를 등록하세요. macOS 버전, Maccy 버전과 설치 방법, 이 가이드에서 이미 시도한 단계, 개인 정보를 지운 크래시 리포트를 함께 적어 주세요. 이 정보가 갖춰진 리포트는 “크래시가 나요”라는 한 줄보다 답변을 받을 가능성이 훨씬 높습니다.

자주 묻는 질문

Maccy를 열자마자 왜 종료되나요?

가장 흔한 원인은 Maccy 빌드의 최소 요구 버전보다 낮은 macOS, 손상된 환경설정, 손상된 클립보드 히스토리 데이터베이스, 깨진 설치입니다. 환경설정을 초기화하고 /Applications에서 다시 설치하면 대부분 해결됩니다.

Maccy를 초기화하면 클립보드 히스토리가 사라지나요?

환경설정 초기화는 히스토리를 삭제하지 않습니다. 히스토리 저장소를 옮겨 두면 새 히스토리로 시작하게 되므로, 먼저 기존 파일을 백업 위치에 복사해 두어야 합니다.

Maccy를 완전히 삭제하고 다시 설치하려면 어떻게 하나요?

앱을 종료하고 Maccy.app을 삭제한 뒤, 필요하면 defaults delete org.p0deje.Maccy로 환경설정을, 저장 폴더는 직접 삭제하세요. 그다음 Homebrew, GitHub, App Store 중 하나로 다시 설치합니다.

메뉴 막대 아이콘이 안 보여도 Maccy는 실행 중일 수 있나요?

그럴 수 있습니다. 활성 상태 보기를 확인하고 기본 단축키 Shift+Command+C를 눌러 보세요. 메뉴 막대가 꽉 찼거나 MacBook의 노치 때문에 앱이 정상이어도 아이콘이 가려질 수 있습니다.

Maccy의 크래시 로그는 어디에서 볼 수 있나요?

콘솔(Console.app)을 열고 충돌 보고서를 선택하거나, ~/Library/Logs/DiagnosticReports 폴더에서 이름에 “Maccy”가 들어간 파일을 찾아보세요.

마무리

되돌리기 쉽고 부담이 적은 해결책(버전 확인, 깨끗한 재설치, 환경설정 초기화)부터 시작하고, 히스토리 저장소는 그다음에 건드리되 항상 백업을 해 두세요. 그래도 해결되지 않는다면 크래시 리포트가 원인을 거의 정확히 짚어 줍니다. Maccy가 다시 안정적으로 돌아간다면, 무시할 앱을 정리하는 데 1분만 투자해 보세요. 어떤 앱에서 복사한 내용을 히스토리에 가장 남기고 싶지 않으신가요?