OpenClaude 아키텍처 설계기: 웹에서 Claude Code CLI를 제어하는 방법
Claude Code CLI를 웹에서 원격 제어하기 위한 OpenClaude 프로젝트의 아키텍처 설계 과정을 다룹니다. 초기 PRD의 한계를 실제 검증으로 발견하고, tmux + --print + --resume + 파일 기반 통신이라는 하이브리드 방식으로 프로세스 영속성, 실시간 스트리밍, 대화 연속성을 동시에 달성한 과정을 공유합니다.
Claude Code CLI를 웹에서 원격 제어하기 위한 OpenClaude 프로젝트의 아키텍처 설계 과정을 다룹니다. 초기 PRD의 한계를 실제 검증으로 발견하고, tmux + --print + --resume + 파일 기반 통신이라는 하이브리드 방식으로 프로세스 영속성, 실시간 스트리밍, 대화 연속성을 동시에 달성한 과정을 공유합니다.
방화벽이 비활성화되어 모든 포트가 외부에 노출된 홈서버에 Tailscale VPN과 UFW 방화벽을 조합하여 보안을 강화한 과정입니다. SSH 접속 전환, Docker 포트 바인딩 우회 문제 해결, 8단계에 걸친 보안 전환 작업과 기존 Nginx/PM2 서비스에 영향 없이 마이그레이션한 경험을 다룹니다.
Claude Code CLI 래핑 라이브러리에 모델 지정 옵션이 없어서 모든 호출이 Opus(최비싼 모델)로 실행되고 있었다. 작업별 최적 모델 배분으로 비용을 최적화한 과정.
OpenClaw 열풍에 합류해 Mac Studio M4 Max를 사고 6개 오픈소스 LLM을 테스트했다. 단순 작업은 되지만 Tool Calling과 추론은 어림도 없어서, 결국 GPT-5 mini(월 $10)와 Gemini 2.5 Flash(API 과금)로 돌아왔다.
여러 프로젝트에서 중복되던 Claude Code CLI 호출 로직을 Node.js 공용 라이브러리(claude-lib)로 추출하고, Python 래퍼까지 만들었다. 팀 에이전트 방식으로 병렬 개발 후 통합 검증에서 스트리밍 출력 파싱 버그를 발견하고 수정한 과정을 다룬다.
Claude Code로 개발하면서 쌓이는 시행착오를 자동으로 블로그화하자는 아이디어에서 출발하여, 대화 로그·Git 커밋·메모리 파일 수집 → Claude CLI 기반 포스트 생성 → 관리자 검토 후 발행까지의 전체 파이프라인을 Next.js + Prisma로 구현한 과정을 돌아본다.
보안 모니터 스크립트가 해시 갱신 없이 알림만 반복 발송하는 구조적 결함을 발견하고, 오탐 판별 및 해결 과정을 정리했습니다.