Claude Code Remote

· 애플리케이션

Claude Code는 오늘날 사용 가능한 가장 강력한 AI 기반 코딩 어시스턴트 중 하나지만, 로컬 콘솔 창에서 사용하는 것은 실제로 한계가 있어요. 설치된 컴퓨터에 묶여 있고, 휴대폰에서 접근할 수 없으며, 동료와 세션을 공유하는 쉬운 방법도 없어요.

sgcClaudeCodeRemote solves all of this. It's a lightweight Windows server that wraps Claude Code inside a web-based terminal, letting you connect from any browser — on your desktop, laptop, tablet, or phone. Under the hood, it uses the Windows ConPTY pseudo-console API for a real terminal session, and sgcWebSockets to stream the terminal I/O to the browser in real time.

이 글에서는 기능, 설정 옵션, 그리고 콘솔에서 직접 Claude Code를 실행하는 것 대비 장점을 다뤄요.

Claude Code를 원격으로 사용하는 이유

sgcClaudeCodeRemote는 개발자가 콘솔에서 Claude Code를 사용할 때 직면하는 가장 일반적인 불편함을 해결해요.

모든 기기에서 접근
휴대폰, 태블릿, 노트북에서 브라우저를 열고 개발 머신에서 실행 중인 Claude Code에 연결하세요. Node.js도, CLI 설치도 필요 없어요. URL만 있으면 돼요. 		협업 세션
여러 개발자가 동일한 이름의 세션에 참여하여 Claude의 출력을 실시간으로 볼 수 있어요. 화면 공유 도구 없이 페어 프로그래밍이 내장돼 있어요. 		기본적으로 안전
무차별 대입 공격 방지 기능이 있는 비밀번호 인증, 설정 가능한 타임아웃, IP 차단, 인터넷 연결 배포를 위한 선택적 TLS 1.3 암호화를 제공해요.

모바일 친화적 터미널

웹 인터페이스는 모바일 기기에서 작동하도록 설계되었어요. 화면 하단의 터치 최적화 키 툴바는 Claude Code에 필요하지만 모바일 키보드에 없는 특수 키를 제공해요:

버튼 기능
Esc 현재 작업을 취소하거나 뒤로 가요
Tab 제안을 수락하고 자동 완성해요
Intro 입력을 확인해요 (Enter 키)
Ctrl 고정 수식 키 — 한 번 탭한 후 Ctrl+C(인터럽트) 같은 콤보를 위해 문자를 탭해요
↑ ↓ ← → 명령 기록과 메뉴를 탐색해요

툴바는 터치 스크린에서 즉각적인 반응을 위해 pointerdown 이벤트를 사용하고, 터미널이 활성 상태를 유지하도록 포커스 탈취를 방지해요. 뷰포트는 동적 뷰포트 단위(dvh)를 사용하여 모바일 브라우저 chrome에 적응하므로 스크롤 없이 툴바가 항상 보여요.

이름 있는 세션

각 연결은 세션 이름(예: "backend-refactor", "devops", "testing")을 지정할 수 있어요. 세션은 서버가 실행되는 동안 유지되므로, 나중에 연결을 끊었다가 같은 Claude Code 인스턴스에 다시 연결할 수 있어요.

인증 및 보안

sgcClaudeCodeRemote는 기본적으로 여러 겹의 보호 기능을 포함해요:

비밀번호 인증
단일 공유 비밀번호로 접근을 보호해요. 사용자 이름은 필요 없고 비밀번호만 있으면 돼요. 로그인 폼은 우발적 저장을 방지하기 위해 브라우저 자격 증명 자동 완성을 비활성화해요. 		무차별 대입 공격 방지
같은 IP에서 5번 실패하면 해당 주소가 5분간 차단돼요. 차단된 IP는 추가 처리 전에 연결 수준에서 거부돼요.
인증 타임아웃
클라이언트는 설정 가능한 시간(기본 15초) 내에 인증해야 해요. 인증 정보를 보내지 않는 유휴 연결은 자동으로 끊겨요. 		TLS 1.3 암호화
인터넷 연결 배포의 경우 인증서와 키 파일로 TLS를 활성화하세요. 브라우저와 서버 간의 모든 트래픽이 종단 간 암호화돼요.

권한 확인 건너뛰기. 로그인 화면의 체크박스(기본적으로 선택됨)는 --dangerously-skip-permissions 플래그로 Claude Code를 실행해요. 서버 콘솔에서 권한 대화상자와 상호작용할 수 없는 원격 세션에 꼭 필요해요.

sgcClaudeCodeRemote vs. 콘솔 Claude Code

Claude Code를 로컬에서 실행하는 것과 sgcClaudeCodeRemote를 통해 실행하는 것의 비교예요.

기능 콘솔 sgcClaudeCodeRemote
모든 기기에서 접근 No Yes
모바일 / 태블릿 지원 No 예 (터치 툴바)
같은 세션에서 다중 사용자 No Yes
이름 있는 지속 세션 No Yes
비밀번호 보호 No 예 (무차별 대입 차단)
TLS 암호화 N/A TLS 1.3
클라이언트 소프트웨어 필요 Node.js + CLI 브라우저만 있으면 돼요
페어 프로그래밍 외부 도구 내장
실시간 지연 시간 표시 No Yes
클라이언트 플랫폼 같은 머신만 Windows, macOS, Linux, Android, iOS

시작하기

sgcClaudeCodeRemote를 다운로드하고 비밀번호와 함께 명령줄에서 실행하세요:

sgcClaudeCodeRemote.exe --password MySecretPassword

그런 다음 브라우저를 열고 http://your-server-ip:8765/로 이동하세요. 비밀번호를 입력하고 세션 이름을 선택하면 바로 사용할 수 있어요.

예제

더 높은 연결 한도의 사용자 지정 포트:

sgcClaudeCodeRemote.exe --port 9000 --password MyPass --max-conn 20

인터넷을 통한 안전한 접근을 위한 TLS 암호화:

sgcClaudeCodeRemote.exe --tls --tls-cert cert.pem --tls-key key.pem --password MyPass

명령줄 옵션

옵션 설명 기본값
--port 서버 수신 포트 8765
--password 접근 비밀번호 (인증 활성화 시 필요) —
--command 터미널에서 실행할 명령 claude
--cols / --rows 초기 터미널 크기 120 × 40
--max-conn 최대 동시 연결 수 10
--timeout 인증 타임아웃(초) 15
--no-auth 인증을 완전히 비활성화해요 —
--tls TLS 1.3 암호화를 활성화해요 —
--tls-cert / --tls-key 인증서 및 개인 키 PEM 파일 —
--tls-password 개인 키 비밀번호 (암호화된 경우) —
--tls-port TLS 수신 포트 --port와 동일

활용 사례

작동 원리

sgcClaudeCodeRemote는 세 가지 핵심 기술로 만들어진 Delphi 콘솔 애플리케이션이에요:

Windows ConPTY
Windows 10 의사 콘솔 API는 완전한 VT100/ANSI 시퀀스 지원으로 실제 터미널 세션을 생성해요. Claude Code는 일반 터미널 창에서와 똑같이 이 콘솔 내에서 실행돼요. 		sgcWebSockets
sgcWebSockets 라이브러리가 모든 WebSocket 통신, HTTP 서비스 제공, 선택적 TLS 암호화를 처리해요. 바이너리 프레임은 터미널 출력을, JSON 텍스트 프레임은 인증 및 제어 메시지를 처리해요. 		xterm.js
브라우저는 fit 애드온(창 크기 자동 조정)과 web-links 애드온(클릭 가능한 URL)이 포함된 xterm.js로 터미널을 렌더링해요. 다크 테마가 Claude Code의 미적 감각과 일치해요.

시스템 요구 사항. 서버는 Windows 10 버전 1809 이상(ConPTY 지원)과 호스트 머신에 Claude Code가 설치되어 있어야 해요. 클라이언트는 최신 웹 브라우저만 있으면 돼요.

웹 인터페이스 기능

단일 페이지 웹 UI는 실행 파일에 직접 내장되어 있어요. 배포할 외부 파일이 없어요. 다음을 포함해요:

sgcClaudeCodeRemote 다운로드

sgcClaudeCodeRemote는 Delphi와 .NET을 위한 고성능 WebSocket 컴포넌트인 sgcWebSockets로 만들어졌어요.

www.esegece.com