Apple Watch와 Claude Code를 위한 Claude Watch

Claude Watch: Apple Watch에서 실시간으로 Claude Code 제어

개발자 shobhit99가 Claude Watch를 소개했습니다 — Apple Watch에서 바로 Claude Code 세션을 제어할 수 있는 오픈소스 앱입니다. 이 시스템은 주요 작업 공간을 떠나지 않고 터미널을 모니터링하고 명령어를 전송할 수 있게 하며, 음성 명령도 지원합니다. 개발 중 AI 도구 알림에 빠르게 대응하는 문제를 해결합니다.

아키텍처는 세 가지 구성 요소로 이루어집니다: Mac의 네트워크 브리지, iPhone 앱, watchOS 클라이언트. Node.js 브리지는 webhooks를 통해 Claude Code CLI와 연동되어 터미널 이벤트를 가로채집니다. iPhone은 동기화를 위한 중개 역할을 하며, 워치는 출력을 표시하고 입력을 받습니다.

시스템 구성 요소

네트워크 브리지

Node.js로 구축되어 Claude Code에 연결하고 세션을 모니터링합니다. 이벤트(터미널 출력, 요청)가 도착하면 브리지는 알림을 생성해 로컬 네트워크를 통해 iPhone으로 라우팅합니다. Node.js와 Claude Code CLI 설치가 필요합니다.

iPhone 앱

브리지와 워치 간 통신을 처리합니다. Wi-Fi를 통해 데이터를 수신하고 세션 상태를 캐시한 후 watchOS로 전달합니다. 지속적인 모니터링을 위한 백그라운드 모드를 지원합니다.

watchOS 클라이언트

워치의 UI를 관리합니다: 스와이프 모드로 터미널 로그 표시, 키보드나 음성 입력으로 텍스트 입력. 새 이벤트 알림을 위한 햅틱 피드백을 지원합니다.

요구 사항 및 설치

배포하려면 다음이 필요합니다:

• macOS 13 이상의 Mac.
• iOS 17+의 iPhone.
• watchOS 10+의 Apple Watch.
• 모든 기기가 동일한 Wi-Fi 네트워크에 연결.

실행 과정:

• Mac에 Node.js와 Claude Code CLI 설치.
• GitHub 레포 클론 후 Xcode로 앱 빌드.
• 브리지 시작: npm install && npm start.
• iPhone 앱과 watchOS 클라이언트 연결.

레포에는 자동 빌드 스크립트와 문제 해결 섹션이 포함되어 있습니다: 포트 수정, 방화벽 권한, 네트워크 장애 시 브리지 재시작.

개발자를 위한 이점

Claude Watch는 Claude Code의 기능을 모바일로 확장합니다. 시니어 개발자들은 TDD 세션에서 이를 높이 평가합니다: Mac으로 전환하지 않고 테스트나 로그 확인. 멀티태스킹 환경(예: 여러 터미널)에서 워치는 중요한 AI 이벤트에 빠른 응답을 가능하게 합니다.

// Example webhook in the bridge (Node.js)
app.post('/webhook', (req, res) => {
  const { event, data } = req.body;
  if (event === 'terminal_output') {
    sendToWatch(data);
  }
  res.status(200).send('OK');
});

브리지 코드는 엔드포인트를 위한 Express와 iPhone으로의 실시간 전송을 위한 WebSocket을 사용합니다.

주요 포인트

• 아키텍처: 로컬 네트워크에서 낮은 지연을 보장하는 세 부분 시스템(브리지-iPhone-워치).
• 입력: 워치의 음성 명령과 텍스트가 컨텍스트를 잃지 않고 Claude Code와 통합됩니다.
• 오픈 소스: GitHub 레포에 전체 빌드 지침과 수정 사항 포함.
• 제한 사항: 단일 Wi-Fi 필요, macOS 13 이상; 원격 액세스 미지원.
• 사용 사례: 개발 중 AI 세션 모니터링에 이상적.

— Editorial Team