설치 안내
아래 한 줄을 붙여넣고, 중간에 뜨는 창에서 이 페이지가 알려 주는 버튼만 누르면 됩니다. 관리자 비밀번호는 필요 없습니다.
지금 안내하는 설치판은 v0.3.0-rc.4입니다.
01 · 준비물
02 · 설치
curl -fsSL https://waveainetworks.com/mac | bash
복사한 뒤 아래 순서대로 하세요.
이 설치는 Wave 의 세 작업 칸(마스터·CSO·워커)이 권한 확인 창 없이 바로 일하도록 설정합니다. 되돌리려면 reset 을 실행하세요.
03 · 중간에 뜨는 창
| 이런 화면이 뜨면 | 이렇게 하세요 |
|---|---|
| 브라우저가 열리며 Claude 로그인 화면 | 유료 계정으로 로그인하고 승인을 누르세요. |
| 터미널이 코드를 붙여넣으라고 함 | 브라우저에 나온 코드를 복사해 터미널에 붙여넣고 Return. |
| Mac이 허용 여부를 묻는 창 (2번 뜰 수 있음) | 두 번 모두 허용을 누르세요. |
| Wave 창이 폴더를 믿을지 묻는 선택 | 이 폴더를 믿는 쪽을 고르세요. 세 작업 칸의 권한 확인 창은 이번 판에서 뜨지 않도록 미리 설정됩니다. |
| 이런 화면이 뜨면 | 이렇게 하세요 |
|---|---|
| 브라우저가 열리며 Claude 로그인 화면 | 유료 계정으로 로그인하고 승인을 누르세요. |
| PowerShell이 코드를 붙여넣으라고 함 | 브라우저에 나온 코드를 복사해 붙여넣고 Enter. |
| 파란색 Windows의 PC 보호 (SmartScreen) | 추가 정보를 누르고, 이어서 실행. |
| 백신(V3·알약·Defender 등)이 경고하거나 파일을 막음 | 예외로 등록하지 마세요. 경고 창을 사진으로 찍어 문의로 보내 주세요. |
| Wave 창이 폴더를 믿을지 묻는 선택 | 이 폴더를 믿는 쪽을 고르세요. 세 작업 칸의 권한 확인 창은 이번 판에서 뜨지 않도록 미리 설정됩니다. |
PowerShell 창이 갑자기 닫혀도 같은 한 줄을 다시 붙여넣으면 끝난 단계는 건너뛰고 이어서 진행합니다.
04 · 설치 후 첫 실행
Wave Terminal은 아직 Apple·Microsoft의 정식 인증을 받지 않은 앱입니다. 그래서 처음 열 때 운영체제가 경고를 보여 줍니다. 앱이 변조되지 않았는지는 설치 프로그램이 파일 지문(SHA256)으로 이미 확인했습니다.
계속 열리지 않으면 더 시도하지 말고 화면 사진과 함께 문의해 주세요.
시작 메뉴에 앱이 보이지 않으면 문의해 주세요.
05 · 막혔을 때
브라우저에서 유료 Claude 계정 로그인을 끝낸 뒤 설치 창으로 돌아와 안내대로 이어 가세요. 로그인 코드는 다른 사람에게 보내지 마세요.
그 파일은 실행하지 말고 삭제하세요. 한 줄을 처음부터 다시 실행해도 같으면 설치를 멈추고 문의해 주세요.
세 작업 칸(master·cso·worker)은 켜져 있고, 마지막 확인만 덜 끝난 상태입니다. Wave 창에 확인 창이 남아 있으면 그 창에서 안내대로 고른 뒤, 같은 설치 명령을 한 번만 다시 실행해 주세요. 다시 실행해도 같은 문구가 나오면 그대로 사용하셔도 됩니다. 그때는 master 칸의 첫 답을 사진으로 찍어 문의로 보내 주세요.
같은 한 줄을 다시 붙여넣으세요. 윈도우는 끝난 단계를 건너뜁니다. 맥은 아래 안내를 따라 주세요. 그래도 멈추면 아래 내용을 보내 주세요.
맥에서 다시 실행했는데 「Wave Terminal 앱을 종료한 뒤 다음 한 줄을…」 안내가 나오면 고장이 아닙니다. Wave Terminal 앱을 끄고, 안내에 나온 한 줄을 그대로 복사해 터미널에서 실행한 다음, 설치 명령을 한 번 더 실행하세요.
이때 열려 있던 Wave 작업 칸은 닫힙니다. 다른 안내가 나오거나 계속 멈추면 화면을 사진으로 보내 주세요.
wave-install-0.3.0.zip을 내려받아 압축을 풀면 wave-install-0.3.0 폴더가 생깁니다. 터미널에서 cd ~/Downloads/wave-install-0.3.0 && bash bootstrap.sh 한 줄만 실행하세요(위의 설치 명령은 칠 필요 없음).
공식 저장소 greatson79/wave-terminal의 Release에서 받은 파일인지, 설치기에 고정된 SHA256 지문과 일치하는지를 확인합니다. macOS는 앱 codesign 검증을 추가로 합니다. 이 검증은 파일이 변조되지 않았다는 확인이며 Apple 공증을 대신하지 않습니다. 현재 macOS 공증은 받지 않았고(spctl 거부), Windows는 Authenticode 코드서명이 없습니다. 전체 설치 실측은 진행 중입니다.
출처와 지문을 확인했고, 위의 열기 방법으로도 열리지 않을 때만 사용하세요. 설치된 Wave Terminal 앱에 한해 xattr -dr com.apple.quarantine "$HOME/.wave/apps/Wave Terminal.app"을 실행합니다. 다른 위치에 복사했다면 실제 앱 경로로 바꾸세요. 서명 문제를 고치지는 않습니다.
steps.json을 불러오는 중…
macOS·Windows의 최신 지원 범위와 셸 조건을 확인한 뒤, 조건이 맞지 않으면 문의해 주세요.
파일을 실행하거나 재사용하지 말고 삭제한 뒤, 공식 Release에서 다시 받아 비교하세요. 계속 다르면 다운로드를 중단합니다.
브라우저에서 유료 Claude 계정 로그인을 완료한 뒤 설치기의 해당 단계로 돌아옵니다. 인증 코드는 공개 채널에 남기지 마세요.
기본값은 켜짐이지만 선택 단계입니다. 로그 한 파일을 보존하고, 재설치 전에 오류 ID와 운영체제를 기록하세요.
상태 파일과 로그를 확인한 뒤 필요한 작업만 선택하세요. 초기화 전에는 보존할 로그를 먼저 복사합니다. reinstall.sh는 설치 파일을 다시 적용하고, reset.sh --list는 삭제 대상을 미리 보여 줍니다.
ORIGIN & LICENSE
Wave Terminal은 원개발자 idoforgod의 CYSJavis 및 cys-terminal을 기반으로 Wave AI Networks가 빌드·배포하는 파생본입니다. 원본 라이선스는 MIT이며, 배포 패키지에는 원문 LICENSES가 포함됩니다.
원본 저장소 보기Wave Terminal 은 idoforgod/cys-terminal(MIT)을, 설치 도우미는 oogisoogi/jarvis-install(MIT)을 바탕으로 합니다