시작하기

설치부터 첫 에이전트까지.

설치하고, 머신을 추가하고, 프로젝트를 열면 에이전트가 tmux 안에서 시작합니다.

1. 설치

다운로드 페이지에서 이 컴퓨터에 맞는 설치 파일을 받습니다. 아직 Apple 공증을 받지 않은 빌드라, 처음 한 번만 아래처럼 엽니다.

macOS

  1. DMG를 열고 starkryu를 응용 프로그램 폴더로 끌어다 놓습니다.
  2. 응용 프로그램 폴더에서 starkryu를 Control-클릭 → 열기로 열고, 확인 창에서 열기를 누릅니다.
  3. “손상되었습니다”라고 나오면 터미널에서 다음을 실행한 뒤 다시 엽니다.
xattr -dr com.apple.quarantine /Applications/starkryu.app

Windows

  1. 설치 파일을 실행합니다.
  2. SmartScreen 경고가 나오면 추가 정보 → 실행을 누릅니다.
  3. 메뉴는 사이드바 위쪽의 ☰에서 엽니다. Mac의 ⌘ 단축키는 Ctrl+Shift로 씁니다.

설치한 뒤에는 앱이 새 버전을 알려 주고, 동기화에 로그인되어 있으면 스스로 업데이트합니다.

2. 로그인

Apple 또는 Google로 로그인합니다. 로그인한 계정마다 머신·에이전트 계정·프로젝트·설정이 담긴 작업 공간이 따로 있고, 같은 이메일이면 어느 방식으로 들어와도 같은 작업 공간이 열립니다. 로그인 없이 이 컴퓨터에서만 쓸 수도 있습니다.

3. 머신 추가

설정 → 머신에서 SSH 머신을 추가합니다. ~/.ssh/config에서 가져올 수도 있습니다. 저장 후 테스트로 연결과 필요한 도구를 확인합니다.

필요한 것 설명
SSH 접속 키, SSH 에이전트, 비밀번호 모두 지원. Tailscale SSH도 됩니다. 비밀번호는 OS 키체인에 암호화해 보관합니다.
tmux 세션을 유지해 연결이 끊겨도 에이전트가 계속 일합니다.
claude / codex 머신에 Claude Code 또는 Codex CLI를 설치해 둡니다.
python3 프로젝트 자동 발견과 지식베이스 연동에 씁니다.

Windows 머신은 OpenSSH의 기본 셸을 WSL(bash.exe)로 두면 tmux와 에이전트를 Linux처럼 씁니다. 처음 보는 호스트 키는 지문을 확인한 뒤 저장하고, 바뀌면 경고합니다.

4. 에이전트 계정

설정 → 에이전트에서 계정을 추가합니다. 두 번째 계정은 예를 들어 이름 Claude (work), 설정 폴더 ~/.claude-work처럼 따로 둡니다. 그 계정으로 터미널을 한 번 열어 /login(Codex는 codex login)으로 로그인하면 끝입니다.

계정 화면에서 한도·사용률·리셋권을 보고, Claude 계정은 claude.ai 연결로 다음 결제일까지 읽어 올 수 있습니다.

5. 프로젝트

계정 메뉴의 머신에서 프로젝트 찾기…가 각 머신의 ~/Workspace를 읽기 전용으로 살펴 프로젝트를 만듭니다. 사이드바의 +로 직접 추가해도 됩니다.

  • 같은 git 원격 주소는 같은 프로젝트로 묶습니다. 원격이 없으면 폴더 이름으로 묶습니다.
  • 가장 최근에 커밋한 머신이 기본 머신이 되고, 다른 사본은 “다른 위치”로 남습니다.
  • 프로젝트를 열면 기본 머신의 tmux 안에서 에이전트 터미널이 시작합니다.

6. 동기화와 폰

설정 → 동기화를 켜면 프로젝트·머신·에이전트 계정·설정이 같은 계정의 모든 컴퓨터와 폰에서 맞춰집니다. 비밀번호와 키는 동기화하지 않습니다.

폰은 계정 메뉴의 휴대폰 연결…에서 나오는 QR 코드로 연결합니다. 자세한 내용은 모바일 페이지에 있습니다.

단축키

macOS Windows 동작
⌘ K Ctrl Shift P 명령 팔레트
⌘ ⇧ K Ctrl Shift K 여러 프로젝트에 프롬프트
⌘ / Ctrl Shift / 단축키 도움말
⌘ ⇧ T Ctrl Shift T 새 터미널
⌘ ⇧ B Ctrl Shift B 브로드캐스트 입력
⌘ , Ctrl Shift , 설정
⇧ ⏎ Shift Enter 터미널에서 줄바꿈

정확한 목록은 앱의 단축키 도움말에서 확인하세요.

자주 묻는 질문

사이트 비밀번호가 맞는데 안 들어가져요.

브라우저에 저장된 예전 비밀번호가 자동으로 채워졌을 수 있습니다. 로그인 화면의 보기로 입력된 값을 확인하고, Caps Lock 안내가 뜨는지 보세요. 들어간 뒤 브라우저가 묻으면 저장된 비밀번호를 업데이트하세요.

노트북을 닫으면 에이전트도 멈추나요?

원격 머신의 tmux 안에서 돌기 때문에 멈추지 않습니다. 다시 열면 그대로 이어 붙습니다. 이 컴퓨터에서 실행 중인 로컬 터미널만 컴퓨터가 잠들면 멈춥니다.

Windows에서 “Failed to connect to agent”가 떠요.

Windows의 OpenSSH 에이전트는 기본으로 꺼져 있습니다. 최신 버전은 에이전트가 없으면 키 파일로 접속하니 업데이트해 주세요. 그래도 안 되면 머신 설정에서 키 파일 경로를 확인하세요.

비밀번호나 API 키가 서버로 가나요?

아니요. SSH 비밀번호·패스프레이즈·키는 각 컴퓨터의 OS 키체인에만 있고 동기화되지 않습니다. 동기화 서버에는 프로젝트 구성과 상태만 갑니다.

폰에서 보낸 지시가 실행되지 않아요.

폰의 명령은 그 머신에 연결된 데스크탑이 대신 실행합니다. 데스크탑 앱이 켜져 있고 동기화에 로그인되어 있는지 확인하세요.

Android 미러링에서 한글이 입력되지 않아요.

에뮬레이터의 텍스트 입력은 영문만 지원합니다. 한글은 기기 화면의 키보드를 사용하세요.