-
AI 코딩 에이전트가 명령줄에서 직접 클라우드 샌드박스 생성·제어를 수행할 수 있게 하는 도구로, VM과 GPU 인스턴스를 자동으로 실행함
- 로컬 디렉터리나 Git 저장소에서 원격 개발 환경을 만들고, VS Code·Jupyter·VNC·터미널 등 다양한 접근 방식을 지원
-
Chrome CDP 통합을 통해 브라우저 탐색, 입력, 클릭, 스크린샷, 데이터 스크래핑 등 자동화 기능을 CLI에서 수행 가능
-
파일 업로드·다운로드 및 자동 동기화, GPU 선택(
--gpu H100:2 등), 크기 조정(--size small 등) 등 세밀한 리소스 제어를 제공
- 오픈소스(MIT). macOS·Linux·Windows에서 사용 가능
개요
- cloudrouter는 Claude Code, Codex, Cursor 등 AI 코딩 에이전트가 클라우드 상에서 VM과 GPU 샌드박스를 생성·관리할 수 있도록 하는 CLI 기반 스킬
- 명령줄에서 샌드박스를 만들고 명령 실행, 파일 전송, 브라우저 자동화까지 수행 가능
-
npx skills add manaflow-ai/cloudrouter 명령으로 설치 가능
설치 및 인증
- AI 에이전트용 스킬로 추가하거나, 독립 실행형 CLI로 설치 가능
-
npm install -g @manaflow-ai/cloudrouter 후 cloudrouter login으로 인증
-
cloudrouter와 cr 명령어 모두 사용 가능
주요 기능
-
즉시 실행 가능한 클라우드 샌드박스: 로컬 디렉터리, Git 저장소, 템플릿에서 원격 VM 생성
-
AI 에이전트 통합: Claude Code, Cursor 등에서 직접 샌드박스 생성·코드 실행·브라우저 자동화 수행
-
브라우저 자동화: Chrome CDP 기반으로 탐색, 클릭, 입력, 스크린샷, 접근성 트리 분석 가능
-
다중 접근 방식: VS Code 브라우저, VNC 데스크톱, 터미널, 단일 명령 실행 등 다양한 접근 지원
-
파일 전송: 업로드·다운로드 및 변경 감지 자동 재업로드 기능 제공
-
오픈소스: MIT 라이선스, Go 언어로 작성, macOS·Linux·Windows용 npm 패키지 배포
GPU 및 인스턴스 옵션
- 표준 샌드박스는 즉시 사용 가능하며,
--gpu 옵션으로 GPU 인스턴스 추가 가능
- 예:
--gpu H100:2는 H100 GPU 2개 사용
- GPU 종류와 용도
-
T4 (16GB) : 소형 모델 추론·미세조정
-
L4 (24GB) : 이미지 생성
-
A10G (24GB) : 중형 모델 학습
-
L40S (48GB) : 비디오 생성
-
A100 (40GB) : 대형 모델 학습(7B–70B)
-
H100 (80GB) , H200 (141GB) , B200 (192GB) : 고성능 연구 및 프런티어 모델용
브라우저 자동화
- 각 샌드박스에는 Chrome CDP 통합 브라우저가 포함되어 있음
- URL 열기, 접근성 트리 스냅샷, 요소 상호작용, 스크린샷 촬영 가능
- 예:
-
cloudrouter browser open cr_abc123 "https://example.com";
-
cloudrouter browser fill cr_abc123 @e1 "user@example.com"
-
cloudrouter browser click cr_abc123 @e3
샌드박스 관리
- 실행 중인 샌드박스 목록, 상태 확인, 중지·삭제 등 관리 명령 제공
-
cloudrouter ls, cloudrouter stop , cloudrouter delete
- 일시 중지(
stop)와 재개(resume) 지원, 타임아웃 연장(extend) 가능
- 최대 10개의 동시 실행 샌드박스 제한 존재
파일 전송 및 동기화
- 로컬과 샌드박스 간 양방향 파일 전송 지원
- 업로드:
cloudrouter upload ./src
- 다운로드:
cloudrouter download ./dist
- 변경 감지 자동 업로드(
--watch) 및 제외 패턴(-e "*.log") 설정 가능
개발 환경 접근
- 다양한 원격 개발 인터페이스 제공
-
VS Code:
cloudrouter code
-
Jupyter Lab:
cloudrouter jupyter
-
VNC 데스크톱:
cloudrouter vnc
-
터미널 세션:
cloudrouter pty
보안 지침
-
E2B 포트 포워딩 URL은 인증 없이 공개되므로 절대 공유 금지
- 대신 VNC, VS Code, Jupyter URL만 안전하게 공유 가능
- 개발 서버 접근은
cloudrouter vnc 를 통해 수행
문제 해결 가이드
-
npm install 오류 시: sudo chown -R 1000:1000 /home/user/.npm 명령 필수
-
ssh 명령 실패 시: 명령어 전체를 따옴표로 감싸야 함
- 브라우저 명령 실패 시: 샌드박스 생성 직후 잠시 대기 필요
-
snapshot 플래그 순서 오류, extend 플래그 오용 등 주요 실수 사례 명시
오픈소스 및 지원