Mac 설치 안내

1. Mac에 맞는 파일 다운로드

Apple 메뉴 → 이 Mac에 관하여에서 칩을 확인하세요. Apple M 시리즈는 Apple Silicon용, Intel 프로세서는 Intel용을 선택합니다. 공식 다운로드 페이지에서 받으세요.

0.1.0·0.1.1에서 “손상되었기 때문에 열 수 없습니다”가 나타났거나 0.1.2에서 개발자 확인 경고가 나타났다면, 서명·공증을 완료한 0.1.3 이상을 새로 다운로드하세요.

2. 응용 프로그램 폴더에 설치

DMG를 열고 zside.app을 응용 프로그램(Applications) 폴더로 드래그하세요. 기존 앱이 실행 중이면 작업을 저장하고 직접 종료한 뒤 교체합니다. DMG를 꺼내고 응용 프로그램 폴더의 zside를 실행하세요.

앱 교체를 위해 사용자 데이터나 로그인 정보를 삭제할 필요는 없습니다.

3. 처음 실행

인터넷에서 다운로드한 앱을 열 것인지 묻는 일반 확인창이 나타나면 파일 출처가 공식 사이트인지 확인한 뒤 열기를 선택하세요. 0.1.3 이상은 Apple 공증을 받았으므로 앱 실행을 위해 격리 속성을 제거하거나 Gatekeeper를 끌 필요가 없습니다.

Apple 공식 보안 안내 ↗

4. 그래도 보안 오류가 나타나면

앱 버전과 Mac 칩 종류에 맞는 다운로드인지 먼저 확인하세요. 이전 DMG를 다시 사용하지 말고 현재 공식 다운로드로 앱을 교체합니다. 문제가 계속되면 다운로드한 파일의 SHA-256을 공식 SHA256SUMS.txt의 같은 파일명 옆 값과 비교하세요. 아래는 Apple Silicon용 예시이며 Intel용은 파일명을 zside-mac-x64.dmg로 바꿉니다.

shasum -a 256 "$HOME/Downloads/zside-mac-arm64.dmg"
codesign --verify --deep --strict --verbose=2 /Applications/zside.app
spctl --assess --type execute --verbose=2 /Applications/zside.app

서명 검사는 “valid on disk”, Gatekeeper 평가는 “accepted”, “source=Notarized Developer ID”를 표시해야 합니다. 체크섬이 다르거나 검증이 실패하면 실행하지 말고 다시 다운로드하거나 문의하세요. macOS의 시스템 보안 설정을 해제하지 마세요. 회사·학교의 관리 정책으로 차단되면 관리자에게 문의하세요.

5. AI 연결

ChatGPT를 쓰려면 Codex CLI, Claude를 쓰려면 Claude Code CLI를 설치하고 해당 계정으로 로그인해야 합니다. 두 CLI는 Node.js 설치 후 npm으로 설치할 수 있습니다. Claude는 공식 네이티브 설치 방식도 지원합니다.

npm install -g @openai/codex
codex

npm install -g @anthropic-ai/claude-code
claude

CLI 설치·로그인 후 zside를 다시 여세요. 0.1.1부터 Finder 실행 시에도 터미널의 CLI 경로를 가져옵니다. 연결이 안 되면 앱 설정의 실행 명령 경로를 확인하세요.

배포판 검증

0.1.3부터 Apple Silicon·Intel용 앱을 Tera 팀(G4FUUJYLRJ)의 Developer ID 인증서로 서명하고 Apple 공증 티켓을 첨부합니다. 배포 전에 실제 DMG 내부 앱의 서명·티켓·Gatekeeper 검사를 수행합니다. macOS의 일반 다운로드 확인창이나 조직별 설치 정책은 적용될 수 있습니다.

해결되지 않으면 Mac 칩 종류, macOS 버전, 앱 버전과 오류 화면을 teracokr@gmail.com으로 보내주세요. 비밀번호나 인증 키는 보내지 마세요.