hydroCoderClaud/cc-desktop

English | 中文 | DingTalk 가이드

Hydro Desktop — Claude Code CLI를 위한 Electron 기반 데스크톱 Agent 워크스페이스 및 터미널 에뮬레이터입니다. 세 가지 작업 모드를 갖춘 네이티브 데스크톱 앱을 통해 코딩 세션을 관리합니다: Developer 모드 (PTY 직접 연결), Agent 모드 (비전 지원 스트리밍 채팅), 그리고 Notebook 모드 (구조화된 생성을 위한 소스/성과 워크스페이스).

저장소 / 패키지 식별자: cc-desktop

.

Developer + Agent + Notebook— 멀티 세션 관리가 가능한 전체 CLI 터미널, 이미지 인식을 포함한 스트리밍 출력이 지원되는 Agent 채팅, 그리고 소스 큐레이션 및 성과 생성을 위한 Notebook 워크스페이스
MCP / Skills / Plugins / Agents / Hooks— 시각적 관리, 기능 설정 워크벤치, 그리고 내장 마켓플레이스를 갖춘 확장 가능한 기능 시스템
내장 플러그인 런타임 (Built-in Plugin Runtime)— 플러그인 마켓플레이스 추가/제거/새로고침 및 플러그인 설치/제거/업데이트가 이제 claude plugin ...을 셸로 호출하는 대신 데스크톱 메인 프로세스에서 실행됩니다.

멀티 프로바이더 API 관리 (Multi-Provider API Management)— 여러 API 프로바이더 (Anthropic 공식, 프록시, 호환 엔드포인트)를 프로바이더 수준의 기본 모델 매핑 및 프로필별 기본 모델 ID와 함께 구성할 수 있습니다.
DingTalk 봇 통합 (DingTalk Bot Integration)— 모바일을 통한 원격 AI 지원 개발을 위해 Claude Code를 DingTalk에 연결합니다.
크로스 플랫폼 (Cross-Platform)— Windows & macOS, 6가지 색상 테마, 라이트/다크 모드, 이중 언어 UI (영어 및 중국어)

다운로드 (Download)— Releases에서 버전을 가져온 후 설치 가이드를 따르세요.
실행 (Run)— Hydro Desktop을 실행하고, API 프로바이더를 구성한 후, 코딩을 시작하세요.

상세한 설치 단계 (Node.js, Git Bash, CLI 설정)는 전체 설치 가이드(Installation Guide)를 참조하세요.

프로바이더 구성 (Configure Provider)— 설정 (Settings) → 프로바이더 관리 (Provider Management) → 프로바이더 선택 또는 추가
API 키 추가 (Add API Key)— 설정 (Settings) → API 구성 (API Configuration) → 키 추가
연결 (Connect)— 프로젝트 폴더 선택 → 연결 (Connect) → Claude와 채팅 시작

Q: "Claude Code CLI를 찾을 수 없습니다"?
CLI를 설치하세요: irm https://claude.ai/install.ps1 | iex

(Windows) 또는 curl -fsSL https://claude.ai/install.sh | bash (macOS)

Q: Windows 터미널에서 글자가 깨지나요?
Git Bash가 설치되어 있고 PATH에 추가되었는지 확인하세요.

Q: 빌드 후 오른쪽 패널이 비어 있나요?
npm install을 실행하여 js-yaml이 설치되었는지 확인한 후, 다시 빌드하세요.

커스텀 라이선스 — 개인적 사용, 학습 및 개발은 허용되나, 상업적 판매 및 재배포는 금지됩니다. LICENSE를 참조하세요.

Hydro Desktop — Electron 기반의 데스크톱 에이전트(Agent) 워크스테이션 및 터미널 시뮬레이터로, Claude Code CLI에 그래픽 인터페이스(GUI)를 제공합니다. 세 가지 작업 모드: Developer 모드 (PTY를 통한 CLI 직접 연결), Agent 모드 (스트리밍 대화, 이미지 인식 지원), Notebook 모드 (자료원/결과물 워크스테이션).

저장소 / 패키지 명은 여전히 cc-desktop입니다.

Developer + Agent + Notebook 3가지 모드 — 완전한 CLI 터미널 + 다중 세션 관리, Agent 대화 인터페이스 (이미지 인식, 스트리밍 출력), 그리고 Notebook 자료 정리 및 결과물 생성 워크스테이션
MCP / Skills / Plugins / Agents / Hooks — 확장 가능한 능력 체계, 시각적 관리, 내장된 컴포넌트 마켓 및 능력 설정 워크스테이션
내장 플러그인 런타임 (Plugin Runtime) — 플러그인 마켓의 CRUD(생성, 조회, 수정, 삭제) 및 플러그인 설치, 삭제, 시작/정지, 업데이트가 데스크톱 메인 프로세스에서 직접 처리되어 더 이상 claude plugin ...에 의존하지 않습니다.
다중 서비스 제공자 API 관리 — 공식 API, 중계 서비스(Proxy), 호환 엔드포인트를 지원하며, 서비스 제공자별로 기본 모델 매핑을 유지하고 프로필(Profile)별로 기본 모델 ID를 지정할 수 있습니다.
딩딩(DingTalk) 로봇 통합 — Claude Code를 딩딩에 브릿지하여, 모바일을 통해 원격으로 AI 보조 개발을 수행할 수 있습니다.
크로스 플랫폼 — Windows & macOS, 6가지 색상 테마, 다크/라이트 모드, 중문/영문 인터페이스

다운ดาว로드 — Releases 페이지에서 버전을 가져와 가이드에 따라 설치하세요.
실행 — Hydro Desktop을 실행하고, API 서비스 제공자를 설정한 후 코딩을 시작하세요.

상세 설치 단계 (Node.js, Git Bash, CLI 설정)는 전체 설치 가이드를 참조하세요.

서비스 제공자 설정 — 설정 → 서비스 제공자 관리 → 서비스 제공자 선택 또는 추가
API Key 추가 — 설정 → API 구성 관리 → 키 추가
프로젝트 연결 — 프로젝트 폴더 선택 → 연결 → Claude와 대화 시작

Q: "Claude Code CLI를 찾을 수 없습니다"라고 표시되나요?
CLI를 설치하세요: irm https://claude.ai/install.ps1 | iex (Windows) 또는 curl -fsSL https://claude.ai/install.sh | bash (macOS)

Q: Windows 터미널에서 글자가 깨지나요?
Git Bash가 설치되어 있고 PATH에 추가되었는지 확인하세요.

Q: 빌드 후 오른쪽 패널에 내용이 없나요?
npm install을 실행하여 js-yaml이 설치되었는지 확인한 후, 다시 빌드하세요.

커스텀 라이선스 — 개인적 사용, 학습 및 개발은 허용되나, 상업적 판매 및 재배포는 금지됩니다. LICENSE를 참조하세요.