Claude Code 플러그인

플러그인을 설치하면 프롬프트 없이 알림과 폰 응답이 동작한다.

에이전트가 빌드를 끝내거나 판단이 필요한 지점에 닿으면 폰이 울리고, 답을 누르면 세션이 계속 간다. 터미널로 돌아갈 일이 없다.

빠른 시작

# 1. Claude Code 플러그인 추가
claude plugin marketplace add zeph-to/plugin
claude plugin install zeph@zeph

# 2. CLI 설치 및 전체 연결 (브라우저 로그인이 열린다)
npm install -g @zeph-to/cli
zeph install

Claude Code를 재시작하면 알림이 자동으로 시작된다. zeph install은 한 번 로그인시키고, API 키와 hook을 한 쌍으로 발급하며, 머신에서 찾은 모든 AI 에이전트를 설정한다.

브라우저를 쓸 수 없다면 다른 에이전트의 헤드리스 방식을 보면 된다.

전역 zeph가 zeph cc를 가능하게 하고, 에이전트 hook이 매 푸시마다 npx 콜드 스타트를 건너뛰게 해준다. 알림 전용 설정이라면 npx @zeph-to/cli install도 된다.

무엇을 얻나

프롬프트가 필요 없는 알림

이럴 때 푸시를 받는다	발동 시점
Claude가 질문할 때	모든 `AskUserQuestion`
세션이 5분간 조용할 때, 즉 끝났을 때	매 턴이 아니라 세션이 조용해지는 시점
Claude가 그 턴을 중요하다고 표시할 때	그 응답의 `high` Push Signal
Claude가 실제 작업을 끝낼 때마다	`/zeph-normal` 이후에만

이것들은 hook을 타고 동작한다 — Claude 이벤트에 반응하는 셸 명령이라, 모델이 알림을 "기억"하는지와 무관하다.

기본 상태에서 턴마다 나가는 푸시는 꺼져 있으므로(quiet), 긴 세션은 무언가를 물을 때와 실제로 끝났을 때 알리지, 도중에 서른 번 알리지 않는다. 이 알림은 zeph cc로 띄운 세션뿐 아니라 모든 Claude Code 세션에서 발동한다 — zeph cc는 폰 조종 브리지이지 알림 스위치가 아니다.

볼륨 조절은 Mute와 push mode에서 한다.

Hook ID가 설정돼 있으면 — zeph install이 자동으로 해준다 — Claude는 턴을 질문으로 끝낸다. 버튼 과 텍스트 입력창이 함께 온다. Continue·Review·Done을 누르거나 commit and push / /ship / fix the tests를 입력한다. 답은 즉시 실행되고 Claude가 다시 묻는다. 이것이 Ask Loop이며 Done을 누를 때까지 이어진다.

도구	보여주는 것	Claude가 집는 때
`zeph_ask`	버튼 과 텍스트 입력	판단, 다음 단계, 직접 지시
`zeph_prompt`	버튼 2~4개	단순 예·아니오 또는 하나 고르기
`zeph_input`	텍스트 입력창	자유 입력만
`zeph_notify` · `zeph_clipboard` · `zeph_file`	단방향 푸시	명시적으로 요청했을 때

zeph_ask·zeph_prompt·zeph_input에는 Hook ID가 필요하다. 로그인할 때 발급돼 ~/.zeph/config.json에 저장된다. 환경변수는 필요 없다.

다른 에이전트

zeph install은 Claude 전용이 아니다. 머신의 모든 에이전트를 감지해, 각각에 MCP 서버·알림 hook·그 에이전트의 네이티브 상시 위치에 놓이는 행동 규칙 파일을 설정한다:

npm install -g @zeph-to/cli
zeph install

에이전트	자동 알림	MCP 도구	방식
Claude Code	✓ Stop hook	✓	플러그인
Cursor	✓ stop hook	✓	MCP + hook + rules
Windsurf	✓ response hook	✓	MCP + hook + rules
Gemini CLI	✓ AfterAgent hook	✓	MCP + hook
Codex CLI	✓ Stop hook	—	hook + rules
Copilot CLI	✓ sessionEnd hook	—	hook + rules
Cline	LLM 기반	—	rules 파일
Aider	LLM 기반	—	conventions 파일

브라우저 없는 헤드리스 머신: 브라우저가 있는 아무 머신에서 로그인한 뒤, 그 ~/.zeph/config.json에서 값 두 개를 옮긴다:

zeph install --key ak_... --hook hook_...

MCP 수동 설정

설치기를 돌리고 싶지 않다면:

Gemini CLI

gemini mcp add zeph -- npx -y @zeph-to/mcp-server

Cursor — ~/.cursor/mcp.json에 추가한다. Windsurf는 같은 형태로 ~/.codeium/windsurf/mcp_config.json을 쓴다.

{
  "mcpServers": {
    "zeph": {
      "command": "npx",
      "args": ["-y", "@zeph-to/mcp-server"],
      "env": { "ZEPH_API_KEY": "ak_..." }
    }
  }
}

세션 명령

/zeph-config(안내형 설정) · /zeph-auto [duration] [task] · /zeph-mute · /zeph-unmute · /zeph-status · /zeph-quiet · /zeph-loud · /zeph-normal.

제거

zeph uninstall              # 감지된 모든 에이전트에서 Zeph 제거
zeph uninstall --dry-run    # 먼저 미리보기
zeph uninstall --purge      # ~/.zeph/config.json까지 삭제

zeph install이 한 일을 전부 되돌린다 — MCP 항목, hook, rules 파일. Zeph 자신의 산출물만 건드린다: 공유 rules 파일은 내용을 유지한 채 … 블록만 제거된다.

Claude Code 플러그인 자체는 claude plugin uninstall zeph@zeph로 제거한다.