iPhone에서 OpenCode를 사용하는 방법

저는 WhatCode라는 앱을 만들었습니다. 이 앱을 사용하면 iPhone에서 직접 OpenCode를 사용할 수 있습니다. 에이전트(agent)는 사용자의 기기에서 계속 실행되며, 휴대폰은 인터페이스가 됩니다.

왜 이것을 만들었을까요? OpenCode는 제가 대부분의 사고 과정을 수행하는 곳입니다. 기능을 계획하고, 코드를 리뷰하며, 버그를 해결하는 작업 말이죠. 문제는 OpenCode가 제 책상에만 존재했다는 점입니다. 책상을 떠나는 순간, 연결이 끊겼습니다. 휴대폰에서 브라우저를 여는 것은 고통스러웠습니다. 느리고, 어색하며, 제대로 된 키보드 지원도 없었습니다. 결코 제대로 된 도구처럼 느껴지지 않았습니다. 저는 네이티브(native)한 무언가를 원했고, 그래서 직접 만들었습니다.

작동 방식
WhatCode는 OpenCode와 함께 실행되는 경량 데몬(daemon)을 통해 사용자의 기기에 연결됩니다. 데몬은 OpenCode를 시작하고, 로컬 네트워크(local network)에 노출시킨 뒤, 터미널(terminal)에 QR 코드를 출력합니다. 앱에서 이를 스캔하면 바로 접속됩니다. 그 시점부터 프로젝트를 탐색하고, 메시지를 읽고 보낼 수 있으며, 에이전트가 작업을 마치는 즉시 알림을 받을 수 있습니다.

제공 기능

• 모든 OpenCode 프로젝트를 탐색하고 전환할 수 있습니다.
• 에이전트와 채팅하며 응답이 실시간으로 스트리밍되는 것을 확인할 수 있습니다.
• 에이전트는 데스크톱과 동일한 컨텍스트(context)로 사용자의 코드베이스(codebase)에 대한 전체 액세스 권한을 가집니다.
• 작업이 완료되거나 에이전트의 주의가 필요할 때 알림을 보냅니다.
• 기술(skills), 명령(commands) 및 기타 기능.

시작하기

1. 기기에 OpenCode를 설치합니다.
2. 터미널에서 npx @whatcode-ai/sdk를 실행합니다.
3. App Store에서 WhatCode를 다운로드합니다.
4. 터미널에 표시된 QR 코드를 스캔합니다.

끝입니다. 데몬이 OpenCode 시작, 네트워크 노출, 연결 유지 등 모든 것을 처리합니다. 만약 로컬 네트워크 외부에서 연결하고 싶다면, --tailscale 옵션을 전달하세요. 그러면 Tailscale 네트워크를 통해 보안 HTTPS 터널을 자동으로 설정합니다.

데몬이 꼭 필요한가요?
아니요. WhatCode는 일반 OpenCode 서버와도 작동합니다. 직접 opencode --serve --hostname <your-ip>를 실행한다면, 앱에 URL을 수동으로 추가할 수 있습니다. 다만 데몬을 사용하면 QR 페어링(pairing), 푸시 알림(push notifications), 더 나은 프로젝트 정렬, 연결이 끊겼을 때의 자동 재연결 등 훨씬 더 나은 경험을 제공합니다.

개발자가 아니신가요? 이미 OpenCode가 설치되어 있다면, 시작하는 방법은 명령어를 두 번 복사해서 붙여넣는 것뿐입니다. 그 이후부터 WhatCode는 그저 하나의 앱일 뿐입니다. AI 코딩 에이전트 (AI coding agents)는 진정으로 강력해지고 있지만, 대부분의 사람들은 컴퓨터 앞에 앉아 있을 때만 이를 사용합니다. WhatCode는 그 제약을 제거합니다. 무료 체험 + 향후 업데이트 예정: 다운로드는 무료입니다. WhatCode Pro는 무제한 세션 (unlimited sessions)을 제공합니다. 아직 초기 단계입니다. 로드맵 (roadmap) 상의 계획: 휴대폰을 통한 파일 편집 (file editing), 더 나은 프로젝트 관리 (project management), Android 지원. 직접 사용해 보시고 의견을 알려주세요 🫡 WhatCode 다운로드 · 문서 (Documentation)