Claude Code를 서버에서 24/7 돌리고 싶었다 — 그래서 VibeCheck을 만들었습니다

Claude Code를 서버에서 24/7 돌리고 싶었다 — 그래서 VibeCheck을 만들었습니다

노트북 닫으면 Claude Code 세션이 죽습니다. Anthropic Remote Control도 마찬가지입니다. 로컬 프로세스니까요.

"서버에 올려놓고, 폰으로 접속해서, 노트북 꺼도 계속 돌아가게 하고 싶다."

이 한 문장 때문에 만든 게 VibeCheck입니다. 오픈소스(MIT)로 공개돼 있습니다.

왜 만들었냐

Anthropic의 Remote Control을 써봤습니다. 폰에서 Claude 세션을 볼 수 있다는 건 좋은데, 노트북을 닫으면 세션이 끊깁니다. 와이파이가 10분 이상 끊겨도 타임아웃. 세션도 한 개뿐.

"리모트"라는 이름인데, 컴퓨터를 켜놔야 합니다.

Anthropic의 클라우드 옵션(claude --remote)도 있지만, 로컬 환경(MCP 서버, 환경변수, DB)을 못 씁니다. GitHub 레포를 클론해서 작업하는 방식이라 로컬 세팅에 의존하는 프로젝트에는 맞지 않습니다.

로컬 환경을 유지하면서 노트북을 끌 수 있는 옵션이 없어서 직접 만들었습니다.

구조

브라우저 (폰/노트북/태블릿)
       |
       v
VibeCheck 서버 (WebSocket 허브)
       |
       v
내 서버 (vibecheck-agent + Claude Code CLI)

에이전트가 서버에서 Claude Code를 headless로 실행하고, WebSocket으로 중계 서버에 연결합니다. 브라우저에서 중계 서버에 접속하면 실시간으로 대화할 수 있습니다.

세션 히스토리는 Claude Code CLI와 동일한 .jsonl 포맷으로 저장됩니다. CLI에서 시작한 세션을 웹에서 이어가거나, 웹에서 시작한 세션을 CLI에서 이어갈 수 있습니다.

설치

클라우드 (가장 간단)

vibecheck.sotaaz.com에서 가입하고 API 키를 받으면:

curl -sL https://vibecheck.sotaaz.com/install/YOUR_API_KEY | bash

한 줄이면 끝납니다. 브라우저에서 바로 접속해서 코딩 시작하면 됩니다.

셀프 호스팅 (무료)

git clone https://github.com/NestozAI/VibeCheck
cd VibeCheck/self-hosted
./setup.sh

http://localhost:8501로 접속합니다. Slack 연동도 셀프 호스팅 버전에서 지원됩니다.

npm으로 에이전트만

npm i -g vibecheck-agent
vibecheck-agent --key YOUR_API_KEY --dir /path/to/project

Node.js 18+, Claude Code CLI(claude가 PATH에 있으면)면 충분합니다.

주요 기능

스킬 프리셋

용도별로 미리 설정된 에이전트 모드가 7개 있습니다.

태스크 스케줄러

cron 기반으로 반복 작업을 예약할 수 있습니다. 매일 아침 git pull, 매주 의존성 감사, 정기 테스트 실행 같은 것들.

모델 선택

쿼리마다 Claude 모델을 바꿀 수 있습니다. 간단한 질문은 Haiku, 코딩은 Sonnet, 복잡한 추론은 Opus.

비용 추적

응답마다 사용한 토큰 수와 USD 비용이 표시됩니다.

보안

경로 기반 접근 제어가 기본입니다. 작업 디렉토리만 신뢰하고, 외부 경로 접근 시 승인 UI가 뜹니다. 일회성 승인이나 영구 승인을 선택할 수 있습니다.

실제로 쓰는 방식

저는 이렇게 나눠 씁니다.

로컬에서 빠르게 확인할 때는 Remote Control. 폰으로 "테스트 통과했어?" 정도 확인하는 용도.

장시간 돌리거나 노트북 끄고 싶을 때는 VibeCheck. 서버에서 돌아가니까 퇴근해도 작업이 계속됩니다.

데모

마무리

Claude Code는 좋은 도구입니다. 근데 "노트북 닫으면 죽는다"는 제약이 생각보다 큽니다.

서버에 올려놓고, 폰에서 접속하고, 노트북 꺼도 돌아가게 — 그게 VibeCheck을 만든 이유입니다.

• 클라우드: vibecheck.sotaaz.com
• 셀프 호스팅: github.com/NestozAI/VibeCheck
• 라이선스: MIT

참고: Anthropic Remote Control 문서 · Claude Code on the Web · VibeCheck GitHub