Claude Code, Cursor CLI, Codex 및 Gemini-CLI를 위한 데스크톱 및 모바일 UI입니다.

로컬 또는 원격으로 사용하여 어디에서나 활성화된 프로젝트와 세션을 확인할 수 있습니다.

CloudCLI Cloud · 문서 (Documentation) · Discord · 버그 보고 (Bug Reports) · 기여하기 (Contributing)

프로젝트 개요와 채팅을 보여주는 메인 인터페이스
|
터치 내비게이션이 가능한 반응형 모바일 디자인
|
Claude Code, Gemini, Cursor CLI 및 Codex 중 선택
|

반응형 디자인 (Responsive Design)

• 데스크톱, 태블릿, 모바일에서 원활하게 작동하여 모바일에서도 에이전트 (Agents)를 사용할 수 있습니다.
  대화형 채팅 인터페이스 (Interactive Chat Interface)
• 에이전트 (Agents)와 원활한 통신을 위한 내장 채팅 인터페이스를 제공합니다.
  통합 셸 터미널 (Integrated Shell Terminal)
• 내장된 셸 (shell) 기능을 통해 에이전트 (Agents) CLI에 직접 액세스할 수 있습니다.
  파일 탐색기 (File Explorer)
• 구문 강조 (syntax highlighting) 및 실시간 편집 기능이 포함된 대화형 파일 트리
  Git 탐색기 (Git Explorer)
• 변경 사항을 확인, 스테이징 (stage) 및 커밋 (commit)할 수 있습니다. 브랜치 (branch) 전환도 가능합니다.
  세션 관리 (Session Management)
• 대화를 재개하고, 여러 세션을 관리하며, 히스토리를 추적합니다.
  플러그인 시스템 (Plugin System)
• 커스텀 플러그인으로 CloudCLI를 확장하세요 — 새로운 탭, 백엔드 서비스 및 통합 기능을 추가할 수 있습니다. 직접 만들어보세요 →
  TaskMaster AI 통합 (TaskMaster AI Integration)(선택 사항)
• AI 기반 작업 계획, PRD 파싱 및 워크플로 자동화를 통한 고급 프로젝트 관리
  모델 호환성 (Model Compatibility)
• Claude, GPT 및 Gemini 모델 제품군과 함께 작동합니다 (shared/modelConstants.js를 참조하여 지원되는 전체 모델 목록을 확인하세요).

가장 빠르게 시작하는 방법 — 로컬 설정이 필요하지 않습니다. 웹, 모바일 앱, API 또는 즐겨 사용하는 IDE에서 액세스할 수 있는 완전 관리형 컨테이너화된 개발 환경을 이용하세요.

npx를 사용하여 CloudCLI UI를 즉시 사용해 보세요 (Node.js v22+ 필요):

npx @cloudcli-ai/cloudcli

또는 정기적인 사용을 위해 **전역 (globally)**으로 설치하세요:

npm install -g @cloudcli-ai/cloudcli
cloudcli

http://localhost:3001을 여세요

— 기존의 모든 세션이 자동으로 검색됩니다.

전체 구성 옵션, PM2, 원격 서버 설정 등에 대한 자세한 내용은 **문서 (documentation) →**를 방문하세요.

하이퍼바이저(hypervisor) 수준의 격리를 통해 격리된 샌드박스(sandbox)에서 에이전트(agent)를 실행합니다. 기본적으로 Claude Code를 시작합니다. sbx CLI가 필요합니다.

npx @cloudcli-ai/cloudcli@latest sandbox ~/my-project

Claude Code, Codex 및 Gemini CLI를 지원합니다. 설정 및 고급 옵션에 대해서는 샌드박스 문서(sandbox docs)를 참조하세요.

CloudCLI UI는 CloudCLI Cloud를 구동하는 오픈 소스(open source) UI 레이어입니다. 자신의 기기에 셀프 호스팅(self-host)하거나, 격리를 위해 Docker 샌드박스에서 실행하거나, 완전히 관리되는 환경인 CloudCLI Cloud를 사용할 수 있습니다.

구분	셀프 호스팅 (npm)	셀프 호스팅 (Docker 샌드박스) (실험적)	CloudCLI Cloud
가장 적합한 대상	자신의 기기에서 로컬 에이전트 세션 실행	웹/모바일 IDE를 사용하는 격리된 에이전트	클라우드에서 에이전트를 사용하려는 팀
접근 방식	브라우저 ([yourip]:port를 통해)	브라우저 (localhost:port를 통해)	브라우저, 모든 IDE, REST API, n8n
설정	npx @cloudcli-ai/cloudcli	npx @cloudcli-ai/cloudcli@latest sandbox ~/project	설정 불필요
격리 수준	호스트(host)에서 실행	하이퍼바이저 수준의 샌드박스 (microVM)	완전한 클라우드 격리
기기 전원 유지 필요	예	예	아니요
모바일 접근	네트워크 내 모든 브라우저	네트워크 내 모든 브라우저	모든 기기, 네이티브 앱 출시 예정
지원 에이전트	Claude Code, Cursor CLI, Codex, Gemini CLI	Claude Code, Codex, Gemini CLI	Claude Code, Cursor CLI, Codex, Gemini CLI
파일 탐색기 및 Git	예	예	예
MCP 설정	~/.claude와 동기화됨	UI를 통해 관리	UI를 통해 관리
REST API	예	예	예
팀 공유	아니요	아니요	예
플랫폼 비용	무료, 오픈 소스	무료, 오픈 소스	월 $7부터 시작

모든 옵션은 귀하의 자체 AI 구독(Claude, Cursor 등)을 사용합니다. CloudCLI는 환경을 제공할 뿐, AI를 제공하는 것이 아닙니다.

🔒 중요 공지: 모든 Claude Code 도구는 **기본적으로 비활성화(disabled)**되어 있습니다. 이는 잠재적으로 해로운 작업이 자동으로 실행되는 것을 방지하기 위함입니다.

Claude Code의 모든 기능을 사용하려면 도구를 수동으로 활성화해야 합니다:

Open Tools Settings (도구 설정 열기)

• 사이드바의 기어 아이콘을 클릭하세요.
  Enable Selectively (선택적 활성화)
• 필요한 도구만 켜세요.
  Apply Settings (설정 적용)
• 설정 사항이 로컬에 저장됩니다.

권장 방식: 기본적인 도구만 활성화한 상태로 시작하여, 필요에 따라 추가하세요. 이 설정은 언제든지 나중에 조정할 수 있습니다.

CloudCLI는 자체적인 프론트엔드 UI(Frontend UI)와 선택적인 Node.js 백엔드(Backend)를 가진 커스텀 탭을 추가할 수 있는 플러그인 시스템을 제공합니다. Settings > Plugins (설정 > 플러그인) 메뉴에서 git 저장소로부터 직접 플러그인을 설치하거나, 직접 제작할 수 있습니다.

플러그인	설명
Project Stats (프로젝트 통계)	현재 프로젝트의 파일 개수, 코드 라인 수, 파일 유형별 분류, 가장 큰 파일, 최근 수정된 파일을 보여줍니다
Web Terminal (웹 터미널)	멀티 탭을 지원하는 완전한 xterm.js 터미널
CloudCLI Scheduler (CloudCLI 스케줄러)	워크스페이스 범위 내의 예약된 프롬프트(Scheduled prompts)를 생성하고, Codex, Claude Code 또는 Gemini CLI와 같은 로컬 CLI를 통해 실행합니다

Plugin Starter Template (플러그인 스타터 템플릿) → — 이 저장소를 포크(Fork)하여 자신만의 플러그인을 만드세요. 프론트엔드 렌더링, 실시간 컨텍스트 업데이트, 백엔드 서버와의 RPC 통신이 포함된 작동 예제가 들어 있습니다.

Plugin Documentation (플러그인 문서) → — 플러그인 API, 매니페스트(Manifest) 형식, 보안 모델 등에 대한 전체 가이드입니다.

Claude Code Remote Control과는 무엇이 다른가요?

Claude Code Remote Control은 로컬 터미널에서 이미 실행 중인 세션에 메시지를 보낼 수 있게 해줍니다. 이 경우 기기가 켜져 있어야 하고, 터미널이 열려 있어야 하며, 네트워크 연결이 약 10분 동안 끊기면 세션이 만료됩니다.

CloudCLI UI와 CloudCLI Cloud는 Claude Code와 나란히 존재하는 것이 아니라 Claude Code를 확장합니다. 여러분의 MCP 서버, 권한, 설정 및 세션은 Claude Code가 기본적으로 사용하는 것과 정확히 동일합니다. 어떤 것도 중복되거나 별도로 관리되지 않습니다.

실제 적용 시 의미하는 바는 다음과 같습니다:

단 하나의 세션이 아닌 모든 세션— CloudCLI UI는 ~/.claude에서 모든 세션을 자동으로 검색합니다.

폴더입니다. Remote Control은 Claude 모바일 앱에서 사용할 수 있도록 단 하나의 활성 세션만 노출합니다. 설정은 그대로 유지됩니다— CloudCLI UI에서 변경한 MCP 서버, 도구 권한(tool permissions), 프로젝트 설정은 Claude Code 설정에 직접 기록되어 즉시 반영되며, 그 반대의 경우도 마찬가지입니다. 더 많은 에이전트와 함께 작동합니다— Claude Code뿐만 아니라 Cursor CLI, Codex, Gemini CLI와도 함께 작동합니다. 단순한 채팅창이 아닌 전체 UI— 파일 탐색기(file explorer), Git 통합, MCP 관리, 그리고 셸 터미널(shell terminal)이 모두 내장되어 있습니다. CloudCLI Cloud는 클라우드에서 실행됩니다— 노트북을 닫아도 에이전트는 계속 실행됩니다. 지켜봐야 할 터미널도, 깨워두어야 할 컴퓨터도 없습니다.

AI 구독료를 별도로 지불해야 하나요?

네. CloudCLI는 환경을 제공할 뿐, AI를 제공하는 것이 아닙니다. 사용 중인 Claude, Cursor, Codex 또는 Gemini 구독을 직접 가져와야 합니다. CloudCLI Cloud는 해당 구독료 외에 호스팅된 환경에 대해 월 $7부터 시작합니다.

휴대폰에서 CloudCLI UI를 사용할 수 있나요?

네. 셀프 호스팅(self-hosted)의 경우, 사용자의 기기에서 서버를 실행하고 네트워크 내의 모든 브라우저에서 [사용자IP]:포트를 열면 됩니다. CloudCLI Cloud의 경우, VPN, 포트 포워딩(port forwarding), 별도의 설정 없이 어떤 기기에서든 접속할 수 있습니다. 네이티브 앱(native app)도 개발 중입니다.

UI에서 변경한 내용이 로컬 Claude Code 설정에 영향을 미치나요?

네, 셀프 호스팅의 경우 그렇습니다. CloudCLI UI는 Claude Code가 기본적으로 사용하는 것과 동일한 ~/.claude 설정 파일을 읽고 씁니다. UI를 통해 추가한 MCP 서버는 Claude Code에 즉시 나타나며, 그 반대의 경우도 마찬가지입니다.

Documentation (문서)— 설치, 구성, 기능 및 문제 해결
Discord— 도움을 받거나 다른 사용자와 연결하기
GitHub Issues— 버그 보고 및 기능 요청
Contributing Guide (기여 가이드)— 프로젝트에 기여하는 방법

GNU Affero General Public License v3.0 이상 (AGPL-3.0-or-later) — 섹션 7에 따른 추가 약관을 포함한 전체 텍스트는 LICENSE를 참조하십시오.

이 프로젝트는 오픈 소스이며 AGPL-3.0-or-later 라이선스에 따라 자유롭게 사용, 수정 및 배포할 수 있습니다. 만약 이 소프트웨어를 수정하여 네트워크 서비스로 실행하는 경우, 수정된 소스 코드를 해당 서비스의 사용자들에게 공개해야 합니다.

CloudCLI UI - (https://cloudcli.ai).

Claude Code- Anthropic의 공식 CLI
Cursor CLI- Cursor의 공식 CLI
Codex- OpenAI Codex
Gemini-CLI- Google Gemini CLI
React- 사용자 인터페이스 (User interface) 라이브러리
Vite- 빠른 빌드 도구 (Build tool) 및 개발 서버 (Dev server)
Tailwind CSS- 유틸리티 우선 (Utility-first) CSS 프레임워크
CodeMirror- 고급 코드 에디터 (Code editor)
TaskMaster AI*(선택 사항)*- AI 기반 프로젝트 관리 및 작업 계획

Claude Code, Cursor 및 Codex 커뮤니티를 위해 정성을 다해 제작되었습니다.