← 문서로 돌아가기
macOS 설치 가이드
이 가이드는 macOS 시스템에 Sokuji를 설치하는 방법을 안내합니다. Sokuji는 향상된 오디오 처리 기능을 위한 가상 오디오 드라이버가 포함된 서명되지 않은 .pkg 설치 프로그램으로 제공됩니다.
macOS용 다운로드시스템 요구 사항
- macOS 10.15 (Catalina) 이상
- Apple Silicon (M1/M2/M3/M4) 또는 Intel (x86_64) 프로세서
- 최소 4GB RAM (8GB 권장)
- 200MB 사용 가능한 디스크 공간
- 관리자 권한 (가상 오디오 드라이버 설치에 필요)
- AI 번역 서비스를 위한 인터넷 연결
- 마이크와 스피커/헤드폰
설치 단계
단계 1: Sokuji 다운로드
공식 GitHub 릴리스 페이지를 방문하여 macOS용 Sokuji 최신 버전을 다운로드하세요.
PKG 설치 프로그램 다운로드
- Sokuji-x.x.x-arm64.pkg - Apple Silicon Mac (M1/M2/M3/M4) 용
- Sokuji-x.x.x-x64.pkg - Intel Mac 용
- 각 설치 프로그램에는 Sokuji 앱과 가상 오디오 드라이버가 포함되어 있습니다
- 파일 크기는 약 150-200MB입니다
팁: 어떤 버전을 다운로드해야 할지 모르시겠나요? Apple 메뉴() → "이 Mac에 관하여"를 클릭하여 칩 유형을 확인하세요. "Apple M1/M2/M3/M4"가 표시되면 arm64 버전을, "Intel"이 표시되면 x64 버전을 선택하세요.
PKG 설치 프로그램은 서명되지 않았으므로 설치하려면 특별한 단계가 필요합니다(다음 단계에서 설명합니다).
단계 2: 설치 준비
PKG 설치 프로그램이 서명되지 않았기 때문에 macOS가 기본적으로 차단합니다. 설치하기 전에 격리 속성을 제거해야 합니다.
격리 속성 제거 (필수)
- 터미널을 엽니다 (응용 프로그램 → 유틸리티 → 터미널)
- 다음 명령을 입력하거나 붙여넣습니다 (x.x.x를 버전 번호로 교체하세요):
sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-arm64.pkg
Intel Mac의 경우:sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-x64.pkg - Enter 키를 누르고 메시지가 표시되면 관리자 비밀번호를 입력합니다
- 명령이 조용히 완료됩니다 (출력이 없으면 성공을 의미합니다)
이것은 무엇을 하나요? 이 명령은 macOS가 다운로드한 파일에 추가하는 격리 플래그를 제거합니다. 서명되지 않은 PKG 설치 프로그램에 안전하고 필요합니다.
이 단계는 중요합니다! 격리 속성을 제거하지 않으면 PKG 설치 프로그램이 열리지 않거나 설치에 실패합니다.
단계 3: PKG 설치
이제 설치 프로그램을 준비했으므로 Sokuji와 가상 오디오 드라이버를 설치할 수 있습니다.
설치 과정
- 다운로드 폴더에서 다운로드한
.pkg파일을 찾습니다 (예:Sokuji-x.x.x-arm64.pkg또는Sokuji-x.x.x-x64.pkg) - PKG 파일을 더블 클릭하여 설치를 시작합니다
- macOS 설치 프로그램이 열립니다 - "계속"을 클릭하여 진행합니다
- 설치 세부 정보를 검토하고 "설치"를 클릭합니다
- 메시지가 표시되면 관리자 비밀번호를 입력합니다 (드라이버 설치에 필요)
- 설치가 완료될 때까지 기다립니다 (보통 1-2분)
- 설치가 완료되면 "닫기"를 클릭합니다
설치되는 항목
- Sokuji.app - /Applications에 설치됩니다
- SokujiVirtualAudio.driver - /Library/Audio/Plug-Ins/HAL에 설치되는 가상 오디오 드라이버
- 설치 프로그램이 자동으로 CoreAudio를 재시작하여 드라이버를 로드합니다
설치 프로그램이 시스템 수준 오디오 드라이버를 설치해야 하므로 관리자 비밀번호가 필요합니다. 가상 오디오 드라이버는 고급 오디오 처리 기능을 활성화합니다.
단계 4: 첫 실행
설치 후 App Store 외부에서 다운로드되었기 때문에 Sokuji 실행 권한을 부여해야 할 수 있습니다.
처음으로 Sokuji 열기
- 응용 프로그램 폴더로 이동합니다
- 목록에서 Sokuji를 찾습니다
- Sokuji를 마우스 오른쪽 버튼으로 클릭(또는 Control 클릭)합니다
- 컨텍스트 메뉴에서 "열기"를 선택합니다
- 보안 대화 상자가 나타나면 "열기"를 클릭하여 확인합니다
참고: 단계 2를 올바르게 완료했다면 보안 경고가 표시되지 않을 수 있습니다.
대체 방법
macOS가 Sokuji를 차단하는 경우:
- 시스템 환경설정 → 보안 및 개인 정보 보호를 엽니다
- 일반 탭으로 이동합니다
- Sokuji가 차단되었다는 메시지가 표시됩니다
- "확인 없이 열기"를 클릭합니다
이 보안 경고는 첫 실행 시에만 나타납니다. 그 후에는 Launchpad 또는 응용 프로그램에서 정상적으로 Sokuji를 열 수 있습니다.
단계 5: Sokuji 구성
이제 Sokuji가 실행되고 있으므로 첫 사용을 위해 구성해 보겠습니다:
초기 설정
- macOS가 메시지를 표시할 때 마이크 권한을 부여합니다
- 선호하는 인터페이스 언어를 선택합니다
- AI 공급자(OpenAI, Google Gemini 등)를 선택합니다
- 선택한 공급자의 API 키를 입력합니다
- 번역을 위한 소스 언어와 대상 언어를 선택합니다
- 오디오 장치를 선택합니다 (목록에 "Sokuji Virtual Audio"가 표시되어야 합니다)
- 마이크와 스피커 설정을 테스트합니다
축하합니다! 이제 Sokuji를 사용할 준비가 되었습니다. 가상 오디오 드라이버가 설치되었으며 오디오 장치 목록에서 사용할 수 있습니다. 마이크 버튼을 클릭하여 실시간 번역을 시작하세요.
문제 해결
"패키지가 손상되어 열 수 없습니다" 또는 PKG가 설치되지 않음
PKG 파일에서 격리 속성이 제거되지 않은 경우 발생합니다:
- 터미널을 엽니다 (응용 프로그램 → 유틸리티 → 터미널)
- 실행:
sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-*.pkg - 메시지가 표시되면 비밀번호를 입력합니다
- PKG 설치를 다시 시도합니다
"Sokuji는 확인되지 않은 개발자가 배포했기 때문에 열 수 없습니다"
설치하기 전에 xattr 명령을 실행하지 않은 경우 발생합니다:
- 응용 프로그램에서 Sokuji 앱을 마우스 오른쪽 버튼으로 클릭합니다
- 메뉴에서 "열기"를 선택합니다
- 나타나는 대화 상자에서 "열기"를 클릭합니다
마이크가 작동하지 않음
Sokuji가 마이크에 액세스할 수 없는 경우:
- 시스템 환경설정 → 보안 및 개인 정보 보호 → 개인 정보 보호를 엽니다
- 왼쪽 사이드바에서 마이크를 선택합니다
- 목록에서 Sokuji가 체크되어 있는지 확인합니다
- 목록에 없으면 Sokuji를 다시 시작하고 메시지가 표시되면 권한을 부여합니다
오디오 출력 없음
번역된 오디오가 들리지 않는 경우:
- 시스템 환경설정 → 사운드 → 출력을 엽니다
- 선호하는 출력 장치를 선택합니다
- 출력 볼륨이 음소거되지 않았는지 확인합니다
- Sokuji에서 올바른 출력 장치가 선택되었는지 확인합니다
Intel Mac에서 앱 충돌 또는 성능 문제
Mac에 맞는 올바른 설치 프로그램을 다운로드했는지 확인하세요:
- Apple Silicon (M1/M2/M3/M4):
Sokuji-x.x.x-arm64.pkg사용 - Intel:
Sokuji-x.x.x-x64.pkg사용 - 칩 유형 확인: Apple 메뉴() → "이 Mac에 관하여"
- 잘못된 설치 프로그램을 사용한 경우 릴리스 페이지에서 올바른 버전을 다운로드하세요
- 올바른 설치 프로그램으로도 충돌이 계속되면 콘솔.app에서 충돌 로그를 확인하고 GitHub에 보고하세요
가상 오디오 드라이버가 표시되지 않음
오디오 장치에 "Sokuji Virtual Audio"가 표시되지 않는 경우:
- 드라이버가 설치되었는지 확인합니다:
ls /Library/Audio/Plug-Ins/HAL/ - 존재하지 않으면 Sokuji를 다시 설치해야 할 수 있습니다
- 존재하는 경우 CoreAudio를 재시작해 보세요:
sudo killall coreaudiod - 시스템 환경설정 → 사운드에서 장치가 나타나는지 확인합니다
설치에 관리자 비밀번호가 필요함
이것은 정상이고 필요합니다:
- PKG 설치 프로그램은 시스템 수준 오디오 드라이버를 설치해야 합니다
- 시스템 오디오 드라이버를 설치하려면 관리자 권한이 필요합니다
- 메시지가 표시되면 비밀번호를 입력하세요 - 이것은 안전하고 예상되는 동작입니다
- 관리자 액세스 권한이 없으면 시스템 관리자에게 문의하세요