siteboon/claudecodeui

CloudCLI UI (Claude Code UI)

개요 – Anthropic의 Claude Code, Cursor의 CLI, 그리고 OpenAI의 Codex 위에 구축된 오픈 소스 Web 기반 UI입니다. 이러한 코드 생성 에이전트를 로컬 또는 호스팅된 CloudCLI Cloud 서비스에서 실행하고, 기능이 풍부한 데스크톱 및 모바일 인터페이스를 통해 상호 작용할 수 있습니다.

주요 기능

• 반응형 UI – 데스크톱 브라우저, 태블릿 및 휴대폰에서 작동하며, macOS/Windows용 네이티브 컴패니언 앱이 포함되어 있습니다.
• 채팅 및 터미널 – 내장된 채팅 창과 선택한 에이전트에 직접 명령을 보낼 수 있는 내장 셸(xterm)을 제공합니다.
• 파일 및 Git 탐색기 – 파일 탐색, 편집(CodeMirror를 통한 구문 강조 포함), 스테이징 및 커밋, 브랜치 전환이 가능합니다.
• 브라우저 탭 – 리서치용 또는 브라우저를 제어해야 하는 에이전트를 위한 웹 뷰를 엽니다.
• 세션 관리 – 여러 에이전트 세션을 나열, 재개 및 종료할 수 있으며, 히스토리가 유지됩니다.
• 플러그인 시스템 – 제공된 스타터 템플릿을 통해 사용자 정의 탭 또는 백엔드 서비스(예: 프로젝트 통계, 토큰 비용 계산기, 예약된 프롬프트)를 추가할 수 있습니다.
• TaskMaster AI 통합 (선택 사항) – PRD 파싱 및 워크플로 자동화와 같은 AI 기반 프로젝트 관리 기능.
• 모델 불가지론(Model-agnostic) – Claude, Claude-Code, Cursor 및 Codex 모델을 지원합니다. 정확한 목록은 실행 시 조회됩니다.

시작하기

옵션	실행 방법	선택 시점
CloudCLI Cloud (호스팅형)	https://cloudcli.ai에서 가입하고 Web UI를 엽니다.	자신의 컴퓨터를 켜두지 않고도 24시간 실행되는 관리형 환경이 필요한 경우.
셀프 호스팅 (npm)	npx @cloudcli-ai/cloudcli (Node 22+) 또는 npm i -g @cloudcli-ai/cloudcli && cloudcli를 실행한 후 http://localhost:3001을 엽니다.	빠른 로컬 사용이 필요한 경우. 이미 Claude/Cursor/Codex 구독을 가지고 있는 경우.
셀프 호스팅 (Docker sandbox – 실험적 기능)	npx @cloudcli-ai/cloudcli@latest sandbox ~/my-project를 실행합니다. sbx CLI가 필요합니다.	로컬에서 실행하면서 에이전트에 대해 하이퍼바이저 수준의 격리(micro-VM)가 필요한 경우.
데스크톱 컴패니언 앱	릴리스 페이지(macOS/Windows)에서 다운로드하여 로컬 또는 클라우드 서버를 지정합니다.	메뉴 바/트레이 바로가기 및 네이티브 창 처리가 필요한 경우.

보안 참고 사항 – 모든 Claude Code 도구는 기본적으로 비활성화되어 있습니다. UI의 Tools Settings 패널을 통해 필요한 도구만 활성화할 수 있습니다.

커뮤니티 및 확장성

• 플러그인은 Settings → Plugins에서 Git 리포지토리로부터 설치하거나 cloudcli-plugin-starter 템플릿에서 빌드할 수 있습니다.
• 지원을 위한 활발한 Discord 커뮤니티, 문서 사이트 및 이슈 트래커가 있습니다.

라이선스 – AGPL-3.0 이상. 코드를 수정하여 네트워크 서비스로 노출하는 경우 변경 사항을 공유해야 합니다.

---

위의 모든 세부 사항은 저장소의 README에서 직접 가져온 것입니다.