설치와 첫 실행
설치
macOS
Howse-<버전>-mac-arm64.dmg(Apple Silicon) 또는Howse-<버전>-mac-x64.dmg(Intel)를 엽니다. Apple 메뉴 → 이 Mac에 관하여에서 "칩: Apple M…"이 보이면 Apple Silicon입니다.- 창에 함께 보이는
Applications폴더로Howse.app을 끌어 놓습니다.
Windows 10·11 (64비트)
Howse-<버전>-win-x64-setup.exe를 실행합니다.- Howse가 현재 Windows 계정에 설치되고(관리자 권한 필요 없음) 바로 열리며, 시작 메뉴에 바로 가기가 생깁니다. 제거는 설정 → 앱에서 합니다.
서명과 공증
0.6.0부터 공개 macOS 설치 파일은 Apple Developer ID로 서명하고 공증합니다. Windows 버전은 아직 코드 서명이 없는 베타입니다. 설치 파일을 실행할 때 Windows SmartScreen이 "Windows의 PC 보호" 창을 띄우면 "추가 정보 → 실행"을 누르세요. Windows 11의 스마트 앱 컨트롤이 켜져 있거나 회사 정책이 서명 없는 앱을 막으면 실행할 수 없을 수 있으며, 서명된 빌드가 나오기 전까지 그 PC에는 설치할 수 없습니다. 공식 다운로드 링크에서 받은 설치 파일을 사용하세요.
첫 실행에서 보이는 것
- Howse는 브라우저를 따로 열지 않습니다. 앱 창 하나에서 모든 일이 이루어집니다.
- Node.js를 따로 설치하지 않아도 됩니다. 앱에 들어 있습니다.
- 처음 실행하면 예시 프로젝트(
demo-project),general채널, 환영 스레드, 그리고 두 에이전트가 준비되어 있습니다. Codex로 동작하는 Builder와 Claude Code로 동작하는 Reviewer입니다. - Codex CLI나 Claude Code CLI가 없거나 제대로 동작하지 않아도 앱과 설정 화면은 열립니다. 어떤 에이전트를 실행할 수 있는지 화면에 표시됩니다.
- Git이 없어도 앱과 컨텍스트 저장소는 준비됩니다. 이 경우 예시 프로젝트는 Git 저장소가 아닌 일반 폴더로 표시됩니다.
업데이트
빌드는 자기 플랫폼의 릴리스로만 업데이트됩니다(Intel Mac 빌드가 Apple Silicon용을 받거나 그 반대가 되는 일은 없습니다). 같은 메이저·마이너 계열의 패치는 앱과 진행 중인 작업 세션을 재시작하지 않고 자동 적용됩니다. 메이저·마이너 업데이트는 앱에서 업데이트 버튼으로 승인한 뒤 재시작해 적용합니다. 작업이 진행 중이면 재시작을 미룹니다.
macOS에서 기존 서명되지 않은 베타를 사용 중이라면 현재 공개 DMG를 내려받아 앱을 직접 교체해야 합니다.