아이패드에서 코딩하기 — code-server + Tailscale로 어디서든 개발환경 접속

아이패드로 코딩한다고 하면 보통 두 가지 반응이 돌아옵니다. "그게 되나요?" 아니면 "그걸 왜 하나요?".

근데 됩니다. 그것도 꽤 쾌적하게.

저는 이미 맥 세 대를 Tailscale + SSH로 하나의 네트워크로 묶어놓은 상태였습니다. 해당 과정이 궁금하시다면 이전에 작성한 홈서버 구축기를 참고하시면 됩니다. 맥북에어에서 맥북프로로 SSH 붙어서 작업하는 건 됐는데, 아이패드에서도 같은 걸 하고 싶었습니다.

SSH 터미널만으로는 한계가 있거든요. 코드 읽기가 불편하고, 파일 네비게이션이 답답하고, 멀티 파일 수정은 더 귀찮습니다. 그래서 아이패드 브라우저에서 VS Code를 그대로 띄우는 방법을 찾았고, code-server로 해결했습니다.

이 글에서는 처음부터 셋팅하는 과정을 정리합니다.

code-server란

code-server는 VS Code를 웹 브라우저에서 돌릴 수 있게 해주는 오픈소스 프로젝트입니다. Microsoft의 VS Code 코드베이스를 기반으로 만들어졌고, 서버에서 실행하면 브라우저로 접속해서 사용할 수 있습니다.

구조는 이렇습니다.

맥북프로에서 code-server 실행
    → 웹 서버가 뜸 (localhost:8080)
    → 아이패드 브라우저에서 접속
    → VS Code UI가 그대로 나옴

맥북프로의 파일 시스템, 터미널, 확장 프로그램, 테마까지 전부 브라우저에서 그대로 씁니다. SSH 터미널이 아니라 진짜 VS Code 화면이 나옵니다.

필요한 것

• 개발환경이 세팅된 맥 (또는 리눅스)
• 아이패드 (+ 블루투스 키보드 추천)
• Tailscale (외부 네트워크에서도 접속하려면)

같은 와이파이에서만 쓸 거면 Tailscale 없이도 됩니다. 근데 카페, 이동 중에도 접속하려면 Tailscale이 필요합니다.

Step 1. code-server 설치

macOS 기준입니다. Homebrew로 한 줄이면 끝납니다.

brew install code-server

리눅스라면 공식 설치 스크립트를 쓰면 됩니다.

curl -fsSL https://code-server.dev/install.sh | sh

설치 확인:

code-server --version
# 4.x.x

Step 2. 설정 파일 수정

처음 실행하면 설정 파일이 자동으로 생성됩니다.

code-server
# 최초 실행 → ~/.config/code-server/config.yaml 생성
# Ctrl+C로 종료

설정 파일을 열어서 수정합니다.

bind-addr: 0.0.0.0:8080
auth: password
password: 원하는비밀번호
cert: false

각 항목을 설명하면:

bind-addr

0.0.0.0:8080으로 설정하면 같은 네트워크의 다른 기기에서 접속할 수 있습니다. 127.0.0.1이면 로컬에서만 접속 가능합니다.

auth

인증 방식입니다. password로 하면 접속 시 비밀번호를 입력해야 합니다. password 항목에 원하는 비밀번호를 직접 지정할 수 있습니다.

Tailscale 네트워크 안에서만 접속한다면 auth: none으로 해도 됩니다. Tailscale 자체가 인증 레이어 역할을 하니까요. 근데 보안 습관상 password를 권장합니다.

cert

HTTPS 인증서 설정입니다. false면 HTTP로 동작합니다. 로컬/Tailscale 환경에서는 HTTP로 충분합니다.

Step 3. code-server 실행

code-server

터미널에 이런 로그가 나옵니다.

[2026-03-27T10:00:00.000Z] info  code-server 4.x.x
[2026-03-27T10:00:00.000Z] info  HTTP server listening on http://0.0.0.0:8080

맥 브라우저에서 localhost:8080으로 접속해보면 VS Code가 나타납니다. 여기까지 되면 서버 쪽은 끝입니다.

Step 4. 아이패드에서 접속

같은 와이파이일 때

맥의 로컬 IP를 확인합니다.

ipconfig getifaddr en0
# 192.168.0.x

아이패드 Safari에서 http://192.168.0.x:8080으로 접속합니다.

다른 네트워크일 때 (Tailscale)

맥의 Tailscale IP를 확인합니다.

tailscale ip -4
# 100.112.xxx.xx

아이패드에서도 Tailscale 앱(App Store)을 설치하고 같은 계정으로 로그인합니다. VPN 프로필 허용 팝업이 뜨는데 승인하면 됩니다.

이후 아이패드 Safari에서 http://100.112.xxx.xx:8080으로 접속합니다.

비밀번호를 입력하면 VS Code가 브라우저에 뜹니다. 프로젝트 폴더, 터미널, 확장 프로그램, 설정까지 전부 맥에 있는 그대로 나옵니다.

Step 5. 자동 실행 설정

매번 터미널을 열어서 code-server를 수동으로 실행하기 귀찮으면, macOS가 켜질 때 자동으로 시작되게 합니다.

brew services start code-server

이러면 맥을 재부팅해도 code-server가 자동으로 뜹니다. 아이패드에서 주소만 입력하면 바로 접속됩니다.

자동 실행 상태 확인:

brew services list | grep code-server
# code-server  started  chahyunwoo ~/Library/LaunchAgents/...

중지하려면:

brew services stop code-server

실사용 팁

키보드 단축키

아이패드에 블루투스 키보드를 연결하면 VS Code 단축키가 거의 다 동작합니다.

잘 되는 것들:

• Cmd+P — 파일 찾기
• Cmd+Shift+P — 커맨드 팔레트
• Cmd+B — 사이드바 토글
• `Cmd+`` — 터미널 토글
• Cmd+S — 저장

안 되는 것들:

• Cmd+Tab — 아이패드 앱 전환으로 먹힘
• Cmd+W — Safari 탭 닫기로 먹힘 (주의)

이건 아이패드 OS 레벨 제약이라 어쩔 수 없습니다.

터미널

code-server 터미널은 맥의 실제 쉘을 띄웁니다. git, pnpm, node, docker 전부 그대로 실행됩니다. 빌드도 맥에서 도는 거라 아이패드 스펙과 무관합니다.

확장 프로그램

대부분 동작합니다. 근데 code-server는 Microsoft 마켓플레이스 대신 Open VSX 레지스트리를 사용합니다. 대부분의 인기 확장은 양쪽에 다 있는데, 일부는 Open VSX에 없을 수 있습니다.

확실히 잘 되는 것들:

• Biome, ESLint, Prettier
• GitLens
• Tailwind CSS IntelliSense
• 테마, 아이콘 팩

보안

Tailscale을 쓰고 있다면 보안 걱정은 크게 할 필요 없습니다. Tailscale 네트워크는 WireGuard 암호화를 사용하고, 외부에서는 접근 자체가 불가능합니다.

근데 한 가지 주의할 점이 있습니다. bind-addr: 0.0.0.0:8080 + auth: none 조합으로 공용 와이파이에서 쓰면 같은 네트워크의 누구나 내 VS Code에 접속할 수 있습니다. Tailscale 없이 쓸 때는 반드시 auth: password를 설정하세요.

정리

좋은 점

• 아이패드만 있으면 어디서든 메인 개발환경 접속
• 셋팅이 간단함 (brew install + config 수정 + Tailscale)
• 맥의 리소스를 그대로 쓰기 때문에 빌드/실행 속도 그대로
• 확장 프로그램, 터미널, 파일 시스템 전부 동작

고려할 점

• 네트워크 필수 (오프라인 코딩 불가)
• 일부 VS Code 확장이 Open VSX에 없을 수 있음
• 아이패드 OS 레벨 단축키 충돌 (Cmd+Tab, Cmd+W)
• 메인 작업보다는 이동 중 보조 용도에 적합

이미 Tailscale을 쓰고 있다면 셋팅은 5분이면 끝납니다. SSH 터미널만으로 원격 작업하던 분들이라면 확실히 한 단계 업그레이드된 경험이 될 겁니다.

참고 자료

• code-server GitHub
• code-server 공식 문서
• Tailscale 공식 사이트