노트북은 5년 됐고, 빌드는 8분 걸리고, 기차 안에서 태블릿으로 버그를 고치고 싶습니다. code-server는 서버에서 Visual Studio Code를 실행해 브라우저 탭 하나에 편집기 전체를 띄워 줍니다. 확장도, 터미널도, 단축키도 그대로입니다. 무거운 일은 VPS가 하고, 내 기기는 화면만 그립니다.
VPS가 잘 맞는 이유
- 어디서나 같은 환경. 노트북이든 빌린 PC든 iPad든 같은 체크아웃, 도구, 설정.
- 빌드가 배터리를 잡아먹지 않음. 컴파일과 테스트는 서버의 CPU로 돌아갑니다.
- 긴 작업이 살아남음. 노트북 덮개를 닫아도 tmux 안의 작업은 계속 돕니다.
- 빠른 다운로드.
npm install과docker pull은 호텔 Wi-Fi가 아니라 서버의 빠른 회선을 탑니다.
필요한 사양
| 작업 | 추천 요금제 |
|---|---|
| 스크립트, 설정 편집, 작은 Python 프로젝트 | Micro — 1 vCPU, 2 GB, 월 $5 |
| TypeScript, PHP, Go 웹 앱 | Small — 2 vCPU, 4 GB, 월 $8 |
| 여러 프로젝트, Docker 빌드, 큰 모노레포 | Medium — 4 vCPU, 6 GB, 월 $12 |
숨은 비용은 언어 서버입니다. 파일이 몇천 개인 TypeScript 프로젝트는 그것만으로 1 GB를 쓸 수 있습니다.
설치
sudo 권한이 있는 일반 사용자로(root 말고요. sudo 사용자 가이드 참고):
curl -fsSL https://code-server.dev/install.sh | sh
sudo systemctl enable --now code-server@$USER
설치 스크립트가 배포판에 맞는 패키지를 고릅니다. 설정은 ~/.config/code-server/config.yaml에 있습니다.
bind-addr: 127.0.0.1:8080
auth: password
password: use-a-long-random-password
cert: false
편집 후에는 재시작하세요: sudo systemctl restart code-server@$USER. bind-addr은 127.0.0.1로 두세요. 앞단에 HTTPS 없이 공개 주소에서 대기하면 안 됩니다.
접속 방법 1: SSH 터널(모든 요금제에서 가능)
내 컴퓨터에서:
ssh -p 22 -N -L 8080:127.0.0.1:8080 you@203.0.113.10
그리고 http://localhost:8080을 엽니다. 인터넷에 노출되는 것은 없고, 암호화는 SSH가 맡습니다. NAT 요금제라면 22 대신 대시보드에 있는 개인 SSH 포트를 쓰세요. 혼자 개발한다면 이 구성을 권합니다.
접속 방법 2: 내 도메인에서 HTTPS
SSH를 쓸 수 없는 기기에서 접속하려면, 전용 IP 요금제에서 nginx를 앞단에 두세요. 서브도메인을 서버로 연결하고(방법은 여기), WebSocket을 지원하도록 프록시를 설정합니다.
server {
server_name code.example.com;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection upgrade;
proxy_set_header Accept-Encoding gzip;
}
}
인증서는 certbot --nginx -d code.example.com으로 받습니다. 자세한 내용은 리버스 프록시 가이드에 있습니다. 공개 URL이라면 config.yaml의 비밀번호가 인터넷과 서버 셸 사이의 유일한 벽이니 길게 만드세요.
옮기기 전에 알아 둘 것
- 확장은 Open VSX에서 옵니다. 인기 있는 것은 대부분 있지만 Microsoft 전용 몇 가지는 없습니다. 먼저 내 확장을 확인하세요.
- 가끔 브라우저 단축키가 이깁니다. Ctrl+W는 파일이 아니라 탭을 닫습니다. 브라우저 메뉴에서 code-server를 PWA로 설치하면 대부분 해결됩니다.
- GPU는 없습니다. CPU 서버라서 코드에는 좋지만 모델 학습에는 맞지 않습니다.
- 긴 작업은 tmux에서. 통합 터미널은 탭과 함께 사라집니다.
함께 쓰면 좋은 것
AI 코딩 에이전트를 쓴다면 같은 서버에서 편집기 옆에 돌릴 수 있습니다. VPS에서 코딩 에이전트 돌리기와 Claude Code 활용 사례를 보세요. 요금제 상세와 업그레이드 방법은 요금제 문서에 있습니다.
댓글
아직 댓글이 없습니다. 첫 번째가 되세요.