내 Mac에서 실행되나요?
- 칩
- Apple 실리콘(M1 이상)
Intel Mac 버전은 없습니다. 칩은 Apple 메뉴 › 이 Mac에 관하여에서 확인할 수 있습니다. - 운영체제
- macOS 14.2 이상
- 메모리
- 최소 8 GB, 16 GB 권장
8 GB 미만이면 앱이 이유를 설명하고 모델을 내려받지 않습니다. - 설치 파일
- 약 9MB의 .dmg 파일
- 모델용 디스크 공간
- 1.3 GB(Lite 팩) 또는 2.5 GB(Standard 팩)
내려받는 동안에는 1GB의 여유 공간이 더 필요합니다. - 인터넷
- 모델 다운로드와 Free 체험 등록에 필요
그 뒤로 번역은 오프라인으로 실행됩니다.
기본형 M1 Mac에서는 성능을 측정하지 않았으므로 그곳에서의 지연은 약속할 수 없습니다. 8 GB Mac에서는 Lite 팩이 알맞은 선택입니다.
빠른 방법: 명령 하나로 설치
- 터미널을 엽니다: ⌘ + Space를 누르고 터미널을 입력한 뒤 Enter를 누릅니다.
- 아래 명령을 붙여 넣고 Enter를 누릅니다. 암호는 필요 없습니다.
curl -fsSL https://aitranslator.vn/install.sh | bash
- 1분 정도 기다립니다. 명령이 최신 AI Translator를 내려받고, SHA-256을 대조하고, 앱의 서명을 확인한 뒤, 앱을
/Applications(쓸 수 없으면~/Applications)에 복사하고 엽니다. - macOS가 시스템 오디오 녹음 권한을 요청하면 ‘허용’을 고릅니다. 이어서 빠른 시작 가이드를 따르세요.
왜 ‘그래도 열기’ 단계가 없나요? macOS는 ‘인터넷에서 다운로드함’ 표시(브라우저가 붙임)가 있는 파일의 앱만 차단합니다. 터미널의 curl로 내려받은 파일에는 이 표시가 없으므로, Apple이 공증하지 않았어도 앱이 바로 열립니다.
이 명령이 무엇을 하는지 알아 두세요.
이 명령은 aitranslator.vn에서 스크립트를 내려받고, 스크립트는 releases.aitranslator.vn에서 설치 파일을 내려받아 SHA-256을 대조한 뒤 설치합니다. sudo를 쓰지 않고 데이터도 보내지 않습니다. SHA-256은 파일과 같은 곳에서 제공되므로 주로 손상된 다운로드를 막아 줍니다. 여전히 aitranslator.vn을 신뢰하는 것입니다. 스크립트를 먼저 읽으려면: curl -fsSL https://aitranslator.vn/install.sh -o install.sh && less install.sh && bash install.sh. 같은 명령을 언제든 다시 실행하면 최신 버전으로 업데이트되며, 스크립트가 실행 중인 앱을 스스로 종료합니다.
문제가 생겼나요? 스크립트가 멈추고 이유를 알려 줍니다(지원하지 않는 Mac, 네트워크 없음, SHA-256 불일치 등). 설치할 때 흔한 문제를 참고하세요.
다른 방법: .dmg 파일로 설치
.dmg를 이메일로 받았거나 터미널을 쓰고 싶지 않다면 이 방법을 쓰세요. 브라우저로 내려받은 파일에는 macOS가 ‘인터넷에서 다운로드함’ 표시를 붙이므로, 첫 실행에 ‘그래도 열기’ 단계가 추가로 필요합니다.
설치 파일 확인(SHA-256)
설치 파일은 공식 출처에서만 내려받으세요.
진짜 .dmg는 저희가 support@aitranslator.vn에서 보내 드리는 것이나 aitranslator.vn에 링크된 것입니다. 다른 곳에서 받은 파일은 가짜이거나 변조되었을 수 있습니다. 이름이 AI Translator라도 열지 마세요.
이메일로 보내 드리는 설치 파일에는 모두 SHA-256 체크섬이 함께 있습니다. 설치하기 전에 대조하세요:
- 터미널을 엽니다(응용 프로그램 › 유틸리티).
shasum -a 256을 입력하고 공백을 하나 넣은 뒤, Finder에서 .dmg 파일을 터미널 창으로 끌어 경로를 채우고(파일 이름의 공백도 포함됨) Enter를 누릅니다. 또는 아래 명령을 입력합니다. 파일 이름에 공백이 있으면 예처럼 큰따옴표로 감싸세요.
shasum -a 256 ~/Downloads/"<file-name>.dmg"- 출력된 64자 문자열을 저희가 보내 드린 것과 비교합니다. 완전히 같아야 합니다.
- 다르다면 파일을 열지 마세요. 다시 내려받고, 그래도 다르면 지원팀에 문의하세요.
AI Translator를 응용 프로그램으로 끌기
.dmg파일을 두 번 클릭해 엽니다.- 나타난 창에서 AI Translator를 응용 프로그램 폴더로 끌어 놓습니다.
첫 실행: macOS가 차단하는 이유와 허용 방법
macOS는 Gatekeeper로 인터넷에서 내려받은 앱을 검사합니다. 현재 AI Translator 빌드는 애드혹 서명이며, 아직 Apple Developer ID가 없어 Apple의 공증을 받지 않았습니다. 그래서 macOS가 첫 실행을 차단하고 개발자를 확인할 수 없다고 알립니다. 파일이 저희에게서 왔고 SHA-256이 일치한다면, 이 빌드에서는 이것이 정상적인 과정입니다.
- 응용 프로그램에서 AI Translator를 엽니다. macOS가 개발자를 확인할 수 없다고 하면 완료를 누릅니다(대화상자를 닫는 버튼이며, macOS 버전에 따라 이름이 조금 다를 수 있습니다).
- 시스템 설정 › 개인정보 보호 및 보안을 엽니다.
- 페이지 맨 아래로 스크롤해 AI Translator 옆의 그래도 열기를 누릅니다.
- 로그인 암호나 Touch ID로 확인합니다.
- 앱이 열리고 초기 설정이 나타납니다. 이어서 빠른 시작 가이드를 따르세요.
macOS 15부터는 오른쪽 클릭 › 열기 방법이 통하지 않습니다.
위처럼 ‘개인정보 보호 및 보안’을 거치세요. ‘그래도 열기’ 버튼은 보통 macOS가 앱을 여는 시도를 한 번 차단한 뒤에만 나타납니다. 보이지 않으면 앱을 한 번 더 연 다음 돌아오세요.
이 단계는 브라우저로 내려받은 .dmg에만 해당하며, 한 줄 명령으로 설치하면 필요 없습니다. Developer ID를 받아 앱을 공증하면 어떤 방법으로 설치하든 이 단계는 사라집니다.
업데이트할 때마다 macOS가 다시 묻는 것
먼저 업데이트 방식입니다: 앱은 열린 지 1분쯤 뒤에 새 버전을 확인하고, 그 뒤로는 24시간마다 확인하며 백그라운드에서 내려받습니다. 준비되면 앱이 ‘다시 시작’ 또는 ‘나중에’를 묻고(트레이 메뉴에도 ‘다시 시작하여 업데이트’가 있음), 다시 시작하거나 ‘종료’를 고를 때 새 버전이 설치됩니다. 업데이트 채널(안정 버전 또는 Beta)은 ‘설정 › 일반’에서 고르며, 바꾸면 바로 확인합니다. 바로 확인하려면 ‘설정 › 일반’에서 업데이트 확인을 누르거나 앱 아이콘 메뉴에서 ‘업데이트 확인…’을 고릅니다.
나머지는 애드혹 서명의 결과입니다: 새 빌드마다 서명이 달라서 macOS가 키체인 접근을 다시 묻습니다. 0.1.1 버전부터 AI Translator는 모든 민감한 데이터(기록 암호화 키, 라이선스 토큰, 번역 시간 카운터)를 하나의 키체인 항목에 보관하므로, 업데이트할 때마다 다음이 나타납니다:
- Mac 로그인 암호를 묻는 키체인 대화상자 1개(macOS 26을 쓰는 Mac 한 대에서 측정: 새 빌드를 흉내 내려고 앱을 두 번 다시 서명했을 때 매번 대화상자는 1개뿐이었습니다): 암호를 입력하고 항상 허용을 고릅니다. ‘거부’는 고르지 마세요. 앱이 라이선스와 번역 시간을 읽지 못하게 됩니다. 실수로 골랐다면 앱을 완전히 종료하고 다시 연 뒤 ‘항상 허용’을 고르세요.
- 시스템 오디오 녹음 권한을 한 번 더 물을 수 있습니다(이전 측정에서 대화상자 1개를 기록했습니다): 허용하세요.
0.1.0에서 0.1.1로의 첫 업데이트만 다릅니다: 앱이 예전 키체인 항목 5개를 새 항목으로 옮겨야 해서, 키체인 대화상자가 한 번에 5개 나타납니다(정확히 5개와 녹음 허용 대화상자 1개를 측정했습니다). 그 뒤의 업데이트는 1개뿐입니다.
‘항상 허용’을 고르면 이후 실행에서는 다시 묻지 않습니다. 데이터, 요금제, 번역 시간을 잃지 않습니다. 새로 설치할 때는 키체인 대화상자가 측정되지 않았습니다(녹음 권한과, 브라우저로 내려받은 .dmg로 설치한 경우의 ‘그래도 열기’뿐). 그래도 macOS가 묻는다면 ‘항상 허용’을 고르세요. 앱은 업데이트 안내에서 미리 알려 드립니다. Developer ID를 받으면 이 일은 사라집니다. 같은 설치 명령으로 업데이트할 수도 있으며, 같은 이유로 키체인 대화상자가 나타납니다.
제대로 제거하기
macOS는 앱을 지울 때 앱이 정리할 기회를 주지 않으므로, 먼저 모델과 데이터를 지운 다음 앱을 휴지통에 버리세요:
- AI Translator를 열고 설정 › 개인정보 보호로 갑니다.
- 모델 및 데이터 삭제를 누르고 모두 삭제로 확인합니다. 앱이 내려받은 모든 모델(1.3 GB 또는 2.5 GB), 기록, 용어집을 지웁니다.
- 메뉴 막대의 AI Translator 아이콘에서 종료를 고릅니다.
- 응용 프로그램에서 AI Translator를 휴지통으로 끌어 놓습니다.
라이선스와 남은 번역 시간은 유지되므로, 다시 설치해도 구매한 요금제를 잃지 않을 것입니다. Free 체험은 Mac에 묶여 있어 다시 설치해도 10일이 다시 시작되지 않습니다. 모델을 지우지 않고 앱을 이미 지웠다면, 모델은 ~/Library/Application Support/com.aitranslator.desktop/models에 있습니다.
설치할 때 흔한 문제
- 설치 명령이 https://releases.aitranslator.vn/stable/latest.json을 읽지 못했다고 합니다. Mac이 네트워크에 연결되어 있지 않거나, 프록시/VPN이
releases.aitranslator.vn을 막고 있습니다. 연결을 확인하고 다시 실행하세요. - 설치 명령이 SHA-256이 일치하지 않는다고 합니다. 내려받는 도중 파일이 손상되었거나 변조되었습니다. 스크립트는 아무것도 설치하지 않습니다. 다시 실행하고, 그래도 다르면 지원팀에 메일을 보내 주세요.
- 설치 명령이 앱이 아직 실행 중이라고 합니다. AI Translator를 완전히 종료하고(메뉴 막대의 AI Translator 메뉴 › 종료) 명령을 다시 실행하세요.
- 설치 명령이 Apple 실리콘이나 macOS 14.2가 필요하다고 합니다. Mac이 요구 사항을 충족하지 않습니다. Intel Mac용 빌드는 없습니다.
- ‘그래도 열기’ 버튼이 없습니다.(브라우저로 내려받은 .dmg로 설치할 때만.) macOS가 차단을 기록하도록 앱을 한 번 더 연 다음 ‘개인정보 보호 및 보안’으로 돌아가세요.
- Intel Mac에 설치되지 않습니다. AI Translator는 Apple 실리콘 전용입니다.
- 앱에 ‘이 컴퓨터는 RAM이 8 GB 미만이어서 AI Translator가 아직 지원하지 않습니다.’라고 표시됩니다. RAM이 8 GB 미만인 Mac은 모델을 내려받을 수 없습니다.
- 앱에 ‘이 AI Translator는 정품이 아니므로 Free만 사용할 수 있습니다.’라고 표시됩니다. 설치한 파일이 변경되었거나 잘못된 출처에서 왔습니다. 공식 출처에서 다시 내려받으세요.
- 업데이트 후 macOS가 키체인에 대해 여러 번 묻습니다. 애드혹 서명 빌드에서는 정상입니다. 암호를 입력하고 ‘항상 허용’을 고르세요.
설치한 뒤 자막이 나오지 않으면 시스템 오디오 녹음 권한을 허용하는 방법을 참고하세요.