서버에 별도의 설치 없이 SSH 포트 하나만으로 개발

이미 열려 있는 SSH 포트 하나만으로 서버 개발과 모니터링이 가능하다. AI 도구는 서버가 아닌 로컬 PC에서 실행되며, LiteDeck(라이트덱)이 어댑터 역할을 수행해 SSH 연결과 커맨드 로그를 통해 서버의 파일을 수정하거나 상태를 조회하는 방식이다.

서버 쪽에 에이전트나 데몬, 패키지를 설치할 필요가 없으며 vscode-server, Claude, Codex 같은 도구들을 전혀 깔지 않고 작동한다. 포트를 새로 개방하는 절차가 없으므로 클라우드 환경의 보안 그룹 설정을 수정하지 않고 그대로 유지할 수 있다.

AWS(아마존 웹 서비스) 같은 클라우드 인스턴스를 포함해 VPS(가상 사설 서버), Proxmox VM(가상 머신), 사내 서버, 홈서버 등 SSH 연결이 가능한 모든 환경에서 동일하게 작동한다. 클라이언트 앱은 macOS, Windows, Ubuntu 24.04.4 환경에서 구동을 확인했다. 검증 범위는 문서에 상세히 기록되어 있으며, 라이선스는 Apache-2.0(아파치 라이선스 2.0)으로 제공된다.

AI의 서버 조작 시 파일 변경 승인 절차와 변경 이력 표시

127.0.0.1 로컬 주소에만 MCP(Model Context Protocol, AI 모델과 외부 도구를 연결하는 표준 규격) 엔드포인트를 열어 외부 접근을 차단했다. AI가 임의로 명령을 실행하거나 파일을 삭제하는 기능은 아예 제공하지 않는다. 파일 변경 시에는 서버에 저장된 기존 내용과 수정안의 차이를 보여주는 diff 화면을 통해 사용자의 승인을 받아야 한다. 이는 AI가 가질 수 없는 정보 영역을 사람이 직접 확인하게 만드는 장치다. 변경된 파일은 다시 되돌릴 수 있으며, 커맨드 로그(Command Log)에서 AI가 수정한 줄을 명시해 변경 이력을 추적한다.

4.8~9.8MB의 다운로드 크기는 OS 내장 웹뷰를 활용해 경량화를 구현한 결과다. Electron(웹 기술로 데스크톱 앱을 만드는 프레임워크) 대신 윈도우의 WebView2, 리눅스의 WebKitGTK, 맥의 WKWebView를 사용한다. JVM(자바 가상 머신)이나 Node, 번들된 크로미움(Chromium)을 포함하지 않는 구조다. Go 언어와 Wails(Go 기반 데스크톱 앱 프레임워크), React 조합으로 제작해 OS별 정적 바이너리 형태로 제공한다. OS가 이미 가진 자원을 활용해 설치 비용과 메모리 점유를 낮췄다.

확인해야 할 핵심 지점

서버에 Node나 Python 같은 런타임이 설치되어 있지 않아도 AI가 설정을 수정할 수 있다. Claude Code(클로드 코드)나 Codex CLI(코덱스 CLI) 같은 AI 도구가 서버 내부가 아닌 사용자 PC에서 실행되기 때문이다. 이 도구들은 SSH 세션을 통해 서버를 제어하며 GUI와 동일한 어댑터, SSH 연결, 커맨드 로그를 공유한다. 전용 경로를 따로 구축하지 않고 기존 연결 체계를 그대로 활용하는 방식이다.

CPU와 메모리, 디스크 로드 등 자원 모니터링부터 systemd 유닛의 시작과 중지, 실시간 로그 확인까지 수행한다. 프로세스 트리 보기와 열린 포트 점검, sshd 설정 확인 기능도 포함된다. Docker(도커)와 Podman(포드맨)은 Compose 프로젝트 단위로 조작하며, Windows 서버의 경우 PowerShell(파워쉘) 어댑터를 통해 동일한 작업을 처리한다.

설치 권한이 없거나 오토스케일링으로 인해 에이전트 관리가 불가능한 인스턴스에서도 로컬 AI의 코딩 능력을 서버 설정에 즉시 적용하고 싶다면 LiteDeck(라이트덱) 도입을 고려해야 한다.