피드로 돌아가기
GeekNewsInfrastructure
원문 읽기
Show GN: 노트북 덮어도 안 죽는 Claude CLI 멀티세션 웹 터미널
PTY 기반 세션 영속화 및 WebSocket 통신을 통한 Claude CLI 웹 터미널 구현
AI 요약
Context
Claude CLI 사용 시 다수 세션 관리의 번거로움과 네트워크 단절에 따른 세션 유실 발생. 기존 터미널 환경의 의존성을 탈피하여 세션 유지와 접근성 개선을 위한 독립적 실행 환경 필요.
Technical Solution
- Server-side PTY 도입을 통한 프로세스 생명주기와 브라우저 세션의 분리 설계
- WebSocket 기반 실시간 스트리밍으로 XTerm.js 터미널 UI와 백엔드 PTY 간 데이터 동기화
- JSON 기반 세션 상태 저장 및 자동 --resume 옵션을 통한 서버 재시작 후 세션 복원 메커니즘 구현
- Linux /proc 파일 시스템 분석을 통한 외부 Claude 프로세스 감지 및 세션 바인딩 로직 적용
- Docker exec 커맨드 추상화를 통한 컨테이너 내부 작업 환경 UI 통합 제공
- aiohttp 비동기 프레임워크를 활용한 다중 WebSocket 연결의 효율적 처리
실천 포인트
- 세션 영속성이 필요한 CLI 도구 설계 시 PTY와 세션 저장소를 분리하여 상태 복구 전략 수립 - 로컬 전용 도구의 경우
1
2
7.
0.
0.1 바인딩 및 Reverse Proxy 적용을 통한 보안 리스크 최소화 - Linux 환경의 프로세스 관리 효율화를 위해 /proc 인터페이스 활용 방안 검토