오픈 소스
휴대폰으로 쓰는 OpenCode, 내 서버에서
OpenCode에는 이미 서버와 웹 UI가 있고, 커뮤니티 앱도 그 위에 만들어집니다. 다만 서버의 포트를 휴대폰까지 안전하게 연결하는 일은 사용자 몫으로 남습니다. Maude는 포트를 열지 않고 그 부분을 처리합니다.
빠른 답변
OpenCode에는 자체 모바일 앱이 없습니다. 흔한 방법은 휴대폰 브라우저에서 opencode web을 쓰거나 opencode serve에 커뮤니티 앱을 연결하는 것인데, 둘 다 LAN, Tailscale, 터널 등으로 포트를 노출해야 합니다. Maude는 고정된 버전의 OpenCode를 SSH로 서버에 설치하고, 아웃바운드 방향의 종단 간 암호화 릴레이로 연결하므로 포트를 열지 않습니다. 내 모델 키나 ChatGPT 또는 Copilot 로그인으로 24시간 실행됩니다.
OpenCode는 거의 모든 모델 제공자와 함께 쓸 수 있는 오픈 소스(MIT) 코딩 에이전트입니다. 한 업체의 구독에 묶이고 싶지 않은 사람들에게 인기가 많습니다. 원격 조작도 염두에 두고 만들어졌습니다. opencode serve는 헤드리스 HTTP API를 실행하고, opencode web은 그 위에 브라우저 UI를 더합니다. 그러니 문제는 휴대폰에서 접근할 수 있느냐가 아니라, 어떻게 안전하게 접근하고 계속 실행해 두느냐입니다.
휴대폰에서 OpenCode를 쓰는 방법
| 방법 | 휴대폰에 닿는 방식 | 적합한 용도 |
|---|---|---|
모바일 브라우저에서 opencode web | 0.0.0.0에 바인딩하거나(또는 --mdns 사용) 네트워크 주소를 엶 | 같은 Wi-Fi에서 빠르게 사용, 휴대폰에 설치할 것 없음 |
| OpenCode Mobile 같은 커뮤니티 앱 | LAN, Tailscale, 터널, 리버스 프록시, SSH 포트 포워딩으로 앱을 opencode serve에 연결 | 네트워크 설정에 익숙하다면 무료 오픈 소스 네이티브 클라이언트 |
| SSH 앱 + tmux | 서버에 SSH로 접속해 터미널 UI에 연결 | 완전한 제어, 추가 소프트웨어 없음. 다만 소프트 키보드로 터미널 UI 사용 |
| Maude | 서버가 종단 간 암호화된 릴레이로 먼저 연결. 인바운드 포트 없음 | 다른 에이전트와 함께 24시간 실행되는 서버, 승인과 git 포함 |
앞의 두 가지는 좋은 선택지이고 비용도 들지 않습니다. OpenCode Mobile은 OpenCode와 무관하다고 분명히 밝힌 커뮤니티 프로젝트입니다. 집의 한 네트워크에서만 OpenCode를 쓴다면 opencode web으로 충분할 수 있습니다. Maude가 겨냥하는 것은 자리를 비운 동안에도 계속 돌아가야 하는 원격 서버의 OpenCode를, Claude Code나 Codex 같은 다른 에이전트와 함께 쓰는 경우입니다. 더 넓은 선택지는 코딩 에이전트 휴대폰 앱 총정리에서 비교합니다.
보안: 4096 포트를 인터넷에 노출하지 마세요
opencode serve는 기본적으로 127.0.0.1:4096에서 수신하고, opencode web은 임의의 로컬 포트를 고릅니다. 안전한 기본값입니다. 문제는 휴대폰에서 닿도록 범위를 넓힐 때 시작됩니다. OpenCode의 공식 설명에 따르면 "OPENCODE_SERVER_PASSWORD가 설정되지 않으면 서버는 보호되지 않습니다." 에이전트가 명령을 실행할 수 있기 때문에, 열린 OpenCode API는 그 머신의 열린 셸과 같습니다.
직접 연결을 구성한다면 다음을 지키세요.
OPENCODE_SERVER_PASSWORD를 반드시 설정하세요.serve와web모두에서 HTTP 기본 인증이 켜집니다.- 공개 터널보다 Tailscale 같은 사설 네트워크를 쓰고, 공인 IP가 있고 방화벽이 없는 VPS에서는 절대
0.0.0.0에 바인딩하지 마세요. - 공개 터널을 꼭 써야 한다면 그 앞에도 인증을 두세요.
Maude는 이 문제 자체를 피합니다. OpenCode는 서버 안에만 머물고, Maude의 데몬이 Agent Client Protocol을 사용해 stdio로 OpenCode와 통신하며, 데몬은 Maude 릴레이로 밖을 향해 연결해 휴대폰과 이어집니다. 트래픽은 서버별 키로 종단 간 암호화되므로 릴레이는 암호문만 봅니다. SSH는 대체 수단입니다. 직접 네트워크를 구성하는 방법은 tmux, mosh, Tailscale 가이드에서 더 자세히 다룹니다.
VPS에서 OpenCode를 24시간 실행하기
OpenCode 자체는 가볍습니다. 필요한 서버 규모는 프로젝트의 빌드와 테스트에 달려 있으며, 사양은 코딩 에이전트용 VPS 가이드에서 다룹니다. Maude에서는 이렇게 설정합니다.
- 앱에서 서버를 추가합니다. 주소를 입력하거나,
ssh …명령을 붙여넣거나,curl -fsSL https://maude.pilotdev.fr/setup | sh가 출력하는 QR 코드를 스캔합니다. x86-64나 ARM의 모든 Linux 또는 macOS 머신에서 작동합니다. - 앱이 SSH로 데몬을 배포합니다. 데몬은 고정된 검증 버전의 OpenCode를 릴리스 체크섬으로 확인해 설치하며, Alpine(musl)용과 AVX2가 없는 구형 CPU용 빌드도 포함합니다. OpenCode는 최신 상태로 유지됩니다.
- 휴대폰에서 제공자에 로그인하고(다음 섹션 참고) 프로젝트 디렉터리에서 세션을 시작합니다. 원한다면 별도의 git worktree에서 시작할 수 있습니다.
그 이후로 세션은 앱이 열려 있든 아니든 서버에서 실행됩니다. OpenCode가 무언가를 실행할 권한을 요청하면, 그 요청은 채팅의 카드, 받은함의 인라인 표시, 허용과 거부가 있는 푸시 알림으로 나타납니다. OpenCode의 두 기본 에이전트는 Maude의 모드 칩에 대응합니다. Build(기본, 모든 도구 사용)와 Plan(분석용 제한 에이전트로, 편집이나 명령 전에 묻습니다)입니다. /compact가 작동하며, 각 세션에는 파일, Git(diff 검토, 커밋, 푸시, gh를 통한 풀 리퀘스트), 진짜 터미널이 있습니다.
모델과 키
OpenCode의 강점은 한 모델 업체에 묶이지 않는다는 것입니다. Maude에서는 휴대폰에서 다음 방법 중 하나로 로그인할 수 있습니다.
- ChatGPT Plus/Pro: OpenCode의 헤드리스 기기 코드 로그인을 통해.
- GitHub Copilot: GitHub의 기기 흐름을 통해.
- Anthropic 또는 OpenRouter API 키: 앱에 붙여넣으면 OpenCode가 서버에 저장합니다.
서버에서 opencode auth login으로 이미 설정한 제공자도 감지되어 사용됩니다. OpenCode 자체 게이트웨이도 선택지입니다. OpenCode Zen은 OpenCode 팀이 검증한 모델을 종량제로 쓰는 서비스이며, 기간 한정 무료 모델도 있습니다. OpenCode Go는 인기 있는 오픈 코딩 모델을 쓰는 월 $10 구독이고, 한도가 더 높은 Go Plus는 $40입니다. 모델은 입력창 위의 칩에서 세션마다 고릅니다. Maude에는 모델 사용량이 포함되지 않습니다.
가격과 동작 면에서 OpenCode가 업체 에이전트와 어떻게 다른지는 Claude Code vs Codex vs OpenCode를 참고하세요. 세션은 유휴 상태일 때 다른 에이전트에게 넘길 수도 있습니다. 새 에이전트는 계획, 수정한 파일, git 상태, 최근 대화를 담은 요약을 받고, 다시 전환하면 OpenCode 자신의 세션이 이어집니다.
집의 한 네트워크에서 OpenCode를 쓴다면: 비밀번호를 설정한 opencode web이 무료이고 충분합니다. 편한 네이티브 클라이언트를 원하고 Tailscale 운영이 괜찮다면: 커뮤니티 앱을 써 보세요. 원격 서버에서 24시간 실행되고, 보호할 포트가 없고, 다른 에이전트와 같은 받은함에서 쓰는 OpenCode라면: 그것이 Maude의 역할입니다.
자주 묻는 질문
공식 OpenCode 모바일 앱이 있나요?
휴대폰에서 opencode web을 안전하게 쓸 수 있나요?
OPENCODE_SERVER_PASSWORD를 설정해 기본 인증을 켜고, 공인 IP에는 노출하지 마세요. 비밀번호가 없으면 OpenCode는 서버가 보호되지 않는다고 경고하며, 서버에 닿을 수 있는 누구든 에이전트에게 명령을 실행시킬 수 있습니다.OpenCode는 어떤 모델을 쓸 수 있나요?
OpenCode에 구독이 필요한가요?
변경 사항
- — 페이지 게시. OpenCode 라이선스, 서버 기본값, 비밀번호 안내, Go/Zen 가격을 이 날짜에 opencode.ai 문서로 확인했습니다.
