Happy - Claude Code Mobile Client

Happy Coder는 사용자의 하드웨어에서 구동되며, 다수의 Claude Code 인스턴스를 병렬로 생성하고 제어할 수 있도록 설계된 오픈소스 애플리케이션입니다. 데스크톱과 모바일 기기(iOS, Android, Web) 모두에서 접근 가능하며, 무료로 제공됩니다. 핵심 기능은 "hands-free" 음성 에이전트를 통한 코딩 제어이며, 단순한 받아쓰기가 아닌 실제 음성 명령 실행을 지원하여 사용자가 프로젝트를 관리하고 디버깅하며 코딩할 수 있게 합니다.

Happy Coder는 기존 개발 워크플로우에 최소한의 방해를 주도록 설계되었습니다. 사용자는 선호하는 도구, 편집기 및 개발 환경을 그대로 사용할 수 있으며, Happy는 기존 설정에 매끄럽게 통합됩니다. 여러 프로젝트에 걸쳐 다수의 Claude Code 인스턴스를 동시에 실행하여, 프론트엔드, 백엔드, DevOps 작업 간에 컨텍스트 손실 없이 전환할 수 있습니다. 터미널에서 작동하는 모든 Claude Code 기능(예: plan mode, custom agents)은 모바일 기기에서도 동일하게 접근 가능합니다. 보안 측면에서는 End-to-End Encryption (E2EE)을 사용하여 메시지와 코드의 기밀성을 보장하며, 스마트 푸시 알림을 통해 입력 필요 시, 코드 검토 준비 시, 또는 오류 발생 시 사용자에게 알림을 보냅니다.

Happy Coder의 핵심 동작 방식은 세 가지 주요 구성 요소의 협업에 기반합니다.

CLI Program (happy): 사용자의 컴퓨터에서 실행되는 프로그램입니다. 이 프로그램은 Claude Code를 시작하고 그 활동을 감시합니다. 감지된 정보는 암호화되어 Relay Server로 전송됩니다.

Mobile App: 사용자의 스마트폰이나 웹 브라우저에서 실행됩니다. 이 앱은 Relay Server로부터 암호화된 데이터를 수신하여 Claude Code의 활동을 사용자에게 시각적으로 보여줍니다. 모든 디스플레이 로직은 이 모바일 앱 내에 구현되어 있습니다.

Relay Server: 사용자의 컴퓨터와 모바일 앱을 연결하는 중계 서버 역할을 합니다. 이 서버는 암호화된 메시지, 즉 encrypted blobs를 양방향으로 전달하기만 할 뿐, 사용자 데이터를 해독하거나 읽을 수 없습니다. 이는 서버가 사용자 정보에 대한 접근 권한 없이 오직 암호화된 데이터의 전달만을 담당함으로써 보안을 강화합니다.

이러한 아키텍처를 통해 Happy Coder는 사용자가 언제 어디서든 자신의 개발 환경에 안전하게 접근하고 제어할 수 있도록 지원하며, 특히 음성 제어 및 다중 세션 관리 기능을 통해 생산성을 향상시키는 것을 목표로 합니다.