시작하기
빈 컴퓨터에서 에이전트가 내 폰에 닿기까지, 세 단계.
Zeph은 두 가지를 잇는다. 코딩 에이전트가 도는 컴퓨터, 그리고 주머니 속 휴대폰.
컴퓨터부터 시작한다. 거기서 로그인하는 것이 곧 계정 생성이라, 기기 사이로 자격 증명을 옮겨 적을 일이 한 번도 없다.
1. 컴퓨터 설정
npm install -g @zeph-to/cli
zeph installzeph install이 브라우저 로그인을 연다. Google이나 Apple로 로그인하면 되고, Zeph을 처음
쓴다면 그 첫 로그인이 곧 가입이다. 연결을 승인하면 웹 앱이 API 키와 hook을 CLI에 넘기고,
CLI가 둘을 ~/.zeph/config.json에 저장한다. 복사할 것도, 붙여넣을 것도 없다.
이어서 CLI가 컴퓨터에서 찾은 AI 에이전트를 나열하고 어느 것을 연결할지 묻는다. 고른 에이전트에 rules·hooks·MCP 설정을 설치하고, 테스트 푸시를 보낸 뒤 이렇게 끝난다.
✓ Test push sent: push_01J...
Done! Restart your agents.이 테스트 푸시를 기억해 두자. 2단계가 됐는지 확인하는 수단이다.
이 컴퓨터에 브라우저가 없다면? SSH 접속이나 컨테이너 안이라면, 브라우저가 있는 컴퓨터에서
zeph install을 한 번 돌린 뒤 그쪽 ~/.zeph/config.json의 두 값을 넘긴다.
zeph install --key ak_... --hook hook_...2. 받을 곳 고르기
받을 곳이 최소 하나는 있어야 한다. 아래 넷 다 되고, 에이전트의 질문에 버튼으로 답하는 것도 전부 동일하다. 지금은 하나만 고르고 나머지는 나중에 추가해도 된다.
| 어디서 | 받기 | |
|---|---|---|
| iPhone, iPad | App Store | 책상을 떠나 있을 때 닿는다. 이 제품이 상정한 기본 경로 |
| Android | Google Play | 위와 동일 |
| Chrome | Chrome 웹 스토어 | 가장 빠르다. Sign in 버튼이 1단계에서 막 열린 브라우저 세션을 그대로 쓴다 |
| 아무 브라우저 | app.zeph.to | 설치할 것 없음 |
1단계에서 쓴 같은 계정으로 로그인한다. 폰이라면 앱이 물어볼 때 알림을 허용한다. 화면이 잠겨 있을 때도 에이전트가 나에게 닿을 수 있게 해주는 게 그 권한이다.
1단계의 테스트 푸시가 이미 피드 맨 위에 와 있다. 그게 보이면 양쪽 끝이 같은 계정에 물렸고 왕복 경로가 살아 있다는 확인이다.
3. 에이전트 재시작
에이전트는 hook 설정을 시작할 때 읽는다. 그래서 zeph install을 돌릴 때 이미 열려 있던
세션에는 아직 적용돼 있지 않다. Claude Code·Codex·Cursor·Gemini를 껐다 켜면, 그 에이전트가
다음에 끝내는 작업부터 폰에 도착한다.
얼마나 시끄러운가
알림은 연결한 에이전트의 모든 세션에서 발생한다. zeph cc로 띄운 세션만이 아니다.
Claude Code의 기본값은 조용한 쪽이다. 에이전트가 무언가 물어볼 때와 세션이 끝날 때 푸시가
오고, 매 턴마다 오지는 않는다.
| 명령 | 효과 |
|---|---|
/zeph-normal | 실제 작업을 한 모든 턴에 푸시 |
/zeph-loud | 모든 턴에 푸시 |
/zeph-mute | 현재 프로젝트 완전 무음 |
/zeph-status | 지금 적용된 설정 보기 |
전체 다이얼은 Claude Code 플러그인 → Push Modes에 있다.
뭔가 이상하다면
zeph verify감지된 모든 에이전트의 설치 상태를 점검하고 빠진 것을 알려준다. --ping을 붙이면 실제 API
호출까지 해본다.
다음으로
- CLI & SDK — 어떤 스크립트에서든 푸시를 보내고, 살아 있는 세션을 폰에서 조종한다.
- MCP 서버 — 에이전트가 스스로 호출하는 도구. 질문하기, 파일 보내기, 클립보드에 복사하기.
- Claude Code 플러그인 — 1단계에서 이미 설치된 hook과 skill.