INSTALL GUIDE · 준비된 시작점

내 컴퓨터에
Wave Terminal을 설치하세요.

마스터 비서와 부서 1명으로 구성된 설치팩입니다. 현재 좌석 수는 역할 정의에서 확인하며, 실제 기동과 주입량은 미검증입니다. 출처와 무결성을 확인한 뒤 진행하세요.

원개발자 idoforgod · CYSJavis · 라이선스 MIT

WAVE / LIGHT SETUP
first-run

$ cys identify

seat 01 / master

seat 02 / dept

wave-pack / 편성 정의

01 / INSTALL

운영체제에 맞는 한 줄을 복사하세요.

전체 설치팩 v0.1.3을 내려받아 압축을 풀고, 터미널에서 해당 폴더로 이동한 뒤 실행하세요. Claude Code 2.1.278 이상이 필요합니다. 설치기 한 파일만으로는 설치할 수 없습니다.

macOS · 사용자 폴더 설치
curl -fsSL https://raw.githubusercontent.com/greatson79/wave-install/main/bootstrap.sh -o bootstrap.sh && bash bootstrap.sh

전체 설치팩 폴더에서 실행하세요. v0.1.3 전체 설치 검증은 진행 중입니다.

A

로컬 범위

설치 파일과 상태 파일은 사용자 폴더 안에서만 다룹니다.

B

검증 우선

서명되지 않은 앱은 실행 전에 Release·SHA256·minisign을 확인합니다.

C

실패를 숨기지 않음

단계별 오류와 건너뜀·미측정을 기록합니다. 예외가 있으면 complete_with_exceptions로 마무리하고, 전체 검증 완료로 표시하지 않습니다.

02 / FLOW

설치 과정을 한눈에.

steps.json을 불러오는 중…

    03 / FIRST RUN

    macOS 공증 미완: 실행 전에 현재 상태를 확인하세요.

    두 DMG 모두 Apple 공증 없음 · spctl 거부됨. arm64 앱은 리소스 봉인 검증에 실패했고, x64 앱은 미서명입니다. SHA256·minisign 검증은 배포 파일의 무결성 확인이며 Apple 공증을 대신하지 않습니다.

    macOSGatekeeper
    1. 공식 Release에서 받은 DMG의 SHA256SUMS·minisign 검증부터 확인합니다.
    2. DMG에서 사용자 폴더로 복사한 앱의 위치를 확인합니다.
    3. 앱을 Control-클릭(또는 우클릭)하고 열기를 선택합니다.
    4. 출처와 무결성을 확인하고 격리속성 해제를 직접 선택한 경우에만, 설치된 해당 앱에 한해 xattr -dr com.apple.quarantine "$HOME/.wave/apps/Wave Terminal.app"을 실행합니다. 다른 위치에 복사했다면 실제 앱 경로로 바꾸세요.
    5. 격리속성 해제는 서명 결함을 고치거나 공증을 추가하지 않습니다. 실행 성공은 확인되지 않았으며, 계속 차단되면 중단하고 오류를 전달하세요.

    해시가 다르거나 출처를 확인할 수 없으면 실행하지 마세요.

    WindowsSmartScreen
    1. 공식 Release에서 받은 .exe의 SHA256SUMS·minisign 검증부터 확인합니다.
    2. 백신이 경고하면 예외를 등록하지 말고 백신 이름·대상 파일·조치를 사진으로 남겨 전달해 주세요.
    3. 실행 시 Windows Defender SmartScreen 창이 뜨면 추가 정보를 클릭한 뒤 실행을 선택합니다.
    4. Claude 로그인 승인 화면이 뜨면 브라우저에서 유료 계정으로 승인합니다.
    5. 설치가 끝나면 안내된 화면을 그대로 두고, PowerShell 창이 강제로 닫혀도 같은 한 줄 명령을 다시 실행하면 끝난 단계는 건너뛰고 이어집니다.

    이 설치기는 Authenticode 코드서명이 없습니다(minisign으로 대체 검증). 해시가 다르거나 출처를 확인할 수 없으면 실행하지 마세요. 막히면 화면의 오류 코드(J-*)를 그대로 전달해 주세요.

    04 / TRUSTED DOWNLOAD

    다운로드는 세 줄로 검증합니다.

    공개 릴리스에서 아래 기준을 모두 만족하는 파일만 사용하세요. 버전과 파일명은 Release의 고정 URL과 대조합니다.

    02

    SHA256

    다운로드한 파일의 SHA256을 Release의 SHA256SUMS와 비교합니다.

    03

    minisign

    공개된 서명 파일과 Wave의 공개키로 minisign 검증을 통과시킵니다.

    i

    설치팩 v0.1.3은 Wave Terminal v0.1.0 DMG를 사용합니다. v0.1.3 전체 설치 검증과 macOS 공증은 미완입니다. 공개 설치 안내: waveainetworks.com/get · kylechoi.com/get.

    05 / HELP

    막힌 단계에서 다시 시작하세요.

    오류 ID는 설치기의 troubleshooting/ 키와 맞춥니다.

    OS_UNSUPPORTED 운영체제 또는 셸이 지원 대상이 아닌가요?

    macOS·Windows의 최신 지원 범위와 셸 조건을 확인한 뒤, 조건이 맞지 않으면 문의해 주세요.

    CHECKSUM_MISMATCH SHA256이 일치하지 않나요?

    파일을 실행하거나 재사용하지 말고 삭제한 뒤, 공식 Release에서 다시 받아 비교하세요. 계속 다르면 다운로드를 중단합니다.

    MINISIGN_INVALID minisign 검증이 실패했나요?

    공개키·서명 파일·릴리스 태그가 같은 버전인지 확인하세요. 확인할 수 없다면 실행하지 말고 지원 주소로 알려 주세요.

    CLAUDE_LOGIN_REQUIRED Claude 로그인이 멈췄나요?

    브라우저에서 유료 Claude 계정 로그인을 완료한 뒤 설치기의 해당 단계로 돌아옵니다. 인증 코드는 공개 채널에 남기지 마세요.

    DAEMON_START_FAILED 데몬 등록에 실패했나요?

    기본값은 켜짐이지만 선택 단계입니다. 로그 한 파일을 보존하고, 재설치 전에 오류 ID와 운영체제를 기록하세요.

    ORIGIN & LICENSE

    Wave Terminal은 CYSJavis의 흐름에서 출발했습니다.

    Wave Terminal은 원개발자 idoforgod의 CYSJavis 및 cys-terminal을 기반으로 Wave AI Networks가 빌드·배포하는 파생본입니다. 원본 라이선스는 MIT이며, 배포 패키지에는 원문 LICENSES가 포함됩니다.

    원본 저장소 보기