사용자를 위해 Hwip를 설정합니다. 전체 설정 과정은 CLI를 설치한 후 hwip install을 실행하는 것입니다. 이 스킬의 다른 모든 내용은 확인을 위한 것입니다.
설정
npm install -g @hwip/cli
hwip install
설치 프로그램은 대화형입니다(브라우저 로그인 + 에이전트 선택기). 따라서 Bash 도구가 아닌 사용자의 터미널에서 실행되어야 합니다. 사용자에게 실행하라고 요청하세요. — Claude Code 세션 내에서 ! 접두사를 사용하여 입력할 수 있습니다:
! npm install -g @hwip/cli && hwip install
npx가 아닌 전역으로 설치하세요. hwip cc (휴대폰에서 세션 제어)는 hwip이 PATH에 있어야 하며, 설치 프로그램이 작성하는 에이전트 훅(이 플러그인의 훅 및 MCP 서버 등)은 command -v hwip || npx …를 사용합니다. 전역 바이너리는 모든 알림 및 세션 시작 시 npx 콜드 스타트를 방지합니다. 전화 제어 없이 알림 전용 설정의 경우 npx -y @hwip/cli install도 여전히 작동하지만, 기본적으로 전역 설치를 사용합니다.
hwip install이 하는 일:
- 새 머신: 브라우저 로그인을 엽니다. 웹 앱이 API 키와 대화형 훅을 자동으로 일치하는 쌍으로 발급합니다. — 설정에서 키를 복사할 필요가 없습니다. CLI는 모든 것(
apiKey,hookId,baseUrl,wsUrl)을~/.hwip/config.json에 저장합니다. - 이미 로그인한 경우: 저장된 자격 증명을 유지하고 에이전트 통합만 (재)설치합니다. 언제든지 다시 실행해도 안전합니다.
- 감지된 모든 에이전트(Claude Code, Gemini CLI, Codex CLI, Cursor, …)에 대한 훅/MCP를 설치합니다.
확인 (사용자가 완료되었다고 말한 후)
hwip verify(또는npx -y @hwip/cli verify) — API 키와 훅이 설정되었다고 보고해야 합니다. 절대cat ~/.hwip/config.json을 사용하지 마세요. API 키가 포함되어 있으며, 출력하면 키가 기록에 남습니다.- 테스트 푸시 보내기:
hwip_notify를 사용하거나hwip notify --title "Hwip 연결됨 ✅"를 실행합니다. - 휴대폰이 진동했습니다 → 완료. 사용자에게 에이전트 세션을 다시 시작하여 SessionStart 훅이 원격 제어 규칙을 주입하도록 알려주세요.
규칙 — 예전 수동 흐름을 다시 도입하지 마세요
- 단일 진실 공급원:
~/.hwip/config.json. 모든 Hwip 구성 요소(CLI, MCP 서버, 플러그인 훅)가 이를 읽습니다.HWIP_API_KEY/HWIP_HOOK_ID를~/.zshrc,~/.bashrc또는~/.claude/settings.json에 추가하지 마세요. — 셸 내보내기는 불필요하며, 두 번째로 표류하기 쉬운 복사본을 만듭니다. - 환경 변수는 고급 재정의(다중 계정, CI)로만 존재합니다. 일반 설정 중에는 절대 제안하지 마세요.
- 웹 앱에서 수동으로 키나 훅을 생성하는 과정을 사용자에게 안내하지 마세요. 머신이 헤드리스인 경우(아래 참조)는 예외입니다.
헤드리스 머신 (브라우저 없음)
브라우저가 있는 어떤 머신에서든 로그인합니다. 사용자는 해당 머신의 ~/.hwip/config.json에서 두 값(apiKey, hookId)을 직접 읽습니다. — 파일을 세션에 출력하지 마세요. API 키가 포함되어 있습니다. 헤드리스 머신에서 사용자는 자신의 터미널에서 다음 명령어를 실행합니다(직접 실행하면 키가 기록에 남습니다):
npm install -g @hwip/cli
hwip install --key ak_... --hook hook_...
문제 해결
hwip_ask 403 Forbidden — 키/훅 페어링이 오래되었습니다. hwip install을 다시 실행하세요. 새 로그인 시 일관된 페어링이 발급됩니다.
알림을 받지 못함 — command -v jq (훅에 jq 필요: brew install jq / apt install jq), 그리고 휴대폰 앱이 브라우저 로그인에 사용된 동일한 계정으로 로그인되어 있는지 확인하세요.
hwip_ask 시간 초과 — 휴대폰 앱이 열려 있습니까? 제한 시간(기본값 300초) 내에 응답했습니까? hwip verify로 설치 상태를 확인하세요.
config.json 누락 또는 손상 — hwip install을 다시 실행하세요. 파일을 다시 작성합니다.