Claude Code 플러그인

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

에이전트가 빌드를 끝내거나 판단이 필요한 지점에 이르면 폰이 울리고, 답을 탭하면 세션이 이어진다. 터미널로 돌아갈 필요가 없다.

빠른 시작

# 1. Claude Code 플러그인 추가
claude plugin marketplace add hwipit/plugin
claude plugin install hwip@hwip

# 2. CLI를 설치하고 전부 연결 (브라우저 로그인이 열린다)
npm install -g @hwip/cli
hwip install

Claude Code를 재시작하면 알림이 자동으로 시작된다. hwip install은 로그인 한 번으로 짝이 맞는 API 키와 훅을 발급하고, 컴퓨터에서 찾은 지원 에이전트를 모두 설정한다. iPhone에 Hwip 앱도 로그인되어 있어야 한다. 그렇지 않으면 푸시를 받을 곳이 없다.

브라우저가 없는 환경이면 헤드리스 방식을 다른 에이전트에서 본다.

전역 hwip가 hwip cc를 구동하고, 에이전트 훅과 플러그인의 MCP 서버가 npx 콜드 스타트를 건너뛰게 해준다. npx @hwip/cli install도 알림 전용 설정으로는 여전히 동작한다. PATH에 hwip가 없으면 훅과 MCP 서버는 npx -y @hwip/cli로 대체한다.

무엇을 얻나

프롬프트가 필요 없는 알림

푸시가 오는 때…	발동 조건
Claude가 질문할 때	모든 `AskUserQuestion`
세션이 5분간 유휴일 때, 즉 끝났다는 뜻	매 턴이 아니라 세션이 조용해질 때
Claude가 한 턴을 중요로 표시할 때	그 응답의 `high` Push Signal
Claude가 실제 작업을 끝낼 때	`/hwip-mode normal`(도구를 두 번 이상 써서 무언가를 바꾼 턴) 또는 `/hwip-mode loud`(매 턴)

이들은 훅 위에서 동작한다. 훅은 Claude 이벤트에 발동하는 셸 명령이라 모델이 알려주기를 기억하는지와 무관하다.

기본값에서는 턴마다 보내는 푸시가 꺼져 있어(quiet), 긴 세션이 질문할 때와 정말 끝났을 때만 울리고 중간에 서른 번씩 울리지 않는다. 푸시는 hwip cc로 띄운 세션만이 아니라 모든 Claude Code 세션에서 발동한다. 그 명령은 폰 조종 브리지이지 알림 스위치가 아니다.

볼륨 조절은 Mute와 Push Mode를 본다.

세션으로 곧바로 들어가는 답장

Hook ID가 설정되어 있으면(hwip install이 자동으로 설정한다) Claude는 버튼 과 텍스트 입력란을 함께 붙여 질문할 수 있다. Continue, Review, Done을 탭하거나 commit and push / /ship / fix the tests를 입력한다. 답은 즉시 실행된다.

세션이 폰으로 구동되기 시작하면 Claude는 매 턴 끝에 다시 질문한다. 이것이 Ask Loop이며 Done을 탭하거나 터미널에서 입력할 때까지 이어진다. 동작 원리를 본다.

도구	보여주는 것	Claude가 쓰는 때
`hwip_ask`	버튼 과 텍스트 입력 (`actions` 없으면 텍스트만)	판단, 다음 단계, 직접 지시, 자유 입력
`hwip_notify` · `hwip_clipboard` · `hwip_file`	단방향 푸시	사용자가 명시적으로 요청할 때
`hwip_agent_send`	다른 에이전트 세션에 메시지를 입력	다른 에이전트에 무언가 전달하라고 할 때
`hwip_agent_list` · `hwip_agent_read`	이 컴퓨터의 에이전트 세션을 나열하고 마지막 작업을 읽음	여기 있는 다른 에이전트가 뭘 하는지 물을 때

hwip_ask에는 Hook ID가 필요하며 로그인할 때 발급되어 ~/.hwip/config.json에 저장되므로, 이를 위해 환경 변수를 설정할 필요는 없다. 파라미터는 MCP 도구 페이지에 있다.

위험한 명령을 위한 승인 게이트

/hwip-mode approve on은 되돌리기 어려운 Bash 명령(rm -rf, 강제 푸시, 프로덕션 배포, 파괴적 SQL)을 실행 전에 붙잡는다. 터미널에 있을 때는 Claude Code의 권한 프롬프트가 묻는다. 자리를 비웠거나 세션이 폰으로 구동되는 중이면 폰에 승인과 거부 버튼이 뜬다. 75초 안에 답이 없으면 거부다.

사고를 막는 과속방지턱이지 보안 경계가 아니다. 기본값은 꺼짐이고, 프로젝트가 mute된 동안에도 꺼진다.

다른 에이전트

hwip install은 Claude 전용이 아니다. 컴퓨터에 있는 에이전트를 감지해, 각 에이전트의 기본 상시 적용 위치에 MCP 서버, 알림 훅, 동작 규칙 파일을 설정한다.

npm install -g @hwip/cli
hwip install

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

에이전트별 페이지는 에이전트를 본다.

브라우저가 없는 헤드리스 머신: 브라우저가 있는 아무 컴퓨터에서 로그인한 뒤, 그 컴퓨터의 ~/.hwip/config.json에서 두 값을 복사한다.

hwip install --key ak_... --hook hook_...

MCP 수동 설정

설치 프로그램을 돌리고 싶지 않다면:

Gemini CLI

gemini mcp add -s user hwip hwip -- mcp

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

{
  "mcpServers": {
    "hwip": {
      "command": "hwip",
      "args": ["mcp"],
      "env": { "HWIP_API_KEY": "ak_..." }
    }
  }
}

hwip mcp는 @hwip/cli 프로세스 안에서 MCP 서버를 실행한다. 예전의 "command": "npx", "args": ["-y", "@hwip/mcp-server"] 형태도 여전히 동작한다.

세션 명령어

명령어	하는 일
`/hwip-config`	안내식 설정: CLI 설치, 로그인, 테스트 푸시 전송
`/hwip-mode [quiet\|normal\|loud\|mute\|unmute] [--global]`	푸시 모드 보기·변경. Mute와 Push Mode 참고
`/hwip-mode approve on\|off`	폰 승인 게이트 켜기·끄기
`/hwip-auto [duration] [task]`	시간 제한 자율 작업. 동작 원리 참고

제거

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

hwip install이 한 일을 모든 곳에서 되돌린다. MCP 항목, 훅, 규칙 파일이 대상이다. Hwip 자신의 산출물만 건드리며, 공유 규칙 파일은 … 블록만 지우고 내용은 남긴다.

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

Claude Code 플러그인

이 페이지에서