KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #ai-agent #cli #claude-code #open-source #deepseek-harness #dsh-plugin #python #mcp

cc-haha

★ 14,136 Open GitHub ↗

Claude Code / 에이전트를 위한 로컬 우선 크로스 플랫폼 데스크톱 워크스페이스: 멀티 에이전트, Git worktrees, 코드 diff, 스킬 마켓플레이스, 멀티 모델, Computer Use, 태스크 인식 데스크톱 펫을 지원하며 WeChat, Feishu, DingTalk, Telegram, WhatsApp 및 H5 접속이 가능합니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Claude Code Haha

[![GitHub Stars](https://img.shields.io/github/stars/NanmiCoder/cc-haha?style=social)](https://github.com/NanmiCoder/cc-haha/stargazers)
[![GitHub Forks](https://img.shields.io/github/forks/NanmiCoder/cc-haha?style=social)](https://github.com/NanmiCoder/cc-haha/network/members)
[![GitHub Issues](https://img.shields.io/github/issues/NanmiCoder/cc-haha)](https://github.com/NanmiCoder/cc-haha/issues)
[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/NanmiCoder/cc-haha)](https://github.com/NanmiCoder/cc-haha/pulls)
[![License](https://img.shields.io/badge/License-MIT-blue)](https://github.com/NanmiCoder/cc-haha/blob/main/LICENSE)
[![English](https://img.shields.io/badge/🇺🇸_English-Current-blue)](https://raw.githubusercontent.com/NanmiCoder/cc-haha/main/README.md)
[![中文](https://img.shields.io/badge/🇨🇳_简体中文-Available-green)](https://raw.githubusercontent.com/NanmiCoder/cc-haha/main/README.zh-CN.md)
[![Docs](https://img.shields.io/badge/📖_Documentation-Visit-FF7A00)](https://cchaha.ai)

**English** · [简体中文](README.zh-CN.md)

</div>

Claude Code Haha는 macOS, Windows, Linux를 위한 **데스크톱 Claude Code 워크스페이스**입니다. 멀티 세션 워크스페이스, 글로벌 검색, 브랜치 / Worktree 실행, diff 리뷰, 내장 브라우저 미리보기, GUI 권한 승인, Claude, ChatGPT, Grok, 프리셋 또는 로컬 엔드포인트를 포함한 모든 모델 지원, 이미지 생성, 비주얼 MCP & SubAgent 매니저, 모델 트레이스, Computer Use, 스킬 마켓플레이스, 컬러 테마, 데스크톱 펫, H5 원격 접속, IM 통합 및 예약 작업까지 모든 기능을 하나의 앱에서 제공합니다.

---

## Desktop Preview

<table>
  <tr>
    <td align="center" width="33.33%"><img src="docs/images/app/en/session-new.webp" alt="Empty desktop session before the first task"><br><b>깨끗하고 비어 있는 세션으로 시작</b><br><sub>프로젝트와 권한 설정이 상시 표시됩니다</sub></td>
    <td align="center" width="33.33%"><img src="docs/images/app/en/session-main.webp" alt="Real task running with the Activity panel open"><br><b>작업 실행 과정을 실시간으로 확인</b><br><sub>툴 호출 및 단계별 진행 상황을 한눈에 볼 수 있습니다</sub></td>
    <td align="center" width="33.33%"><img src="docs/images/app/en/workspace-diff.webp" alt="Workspace diff review"><br><b>정확히 무엇이 변경되었는지 확인</b><br><sub>구문 강조가 적용된 전체 너비의 포커스된 diff 뷰를 제공합니다</sub></td>
  </tr>
  <tr>
    <td align="center" width="33.33%"><img src="docs/images/app/en/workspace-preview.webp" alt="Built-in browser previewing the page that was just changed"><br><b>현장에서 즉시 검증</b><br><sub>내장 브라우저를 통해 실제로 수정된 페이지를 확인합니다</sub></td>
    <td align="center" width="33.33%"><img src="docs/images/app/en/model-picker.webp" alt="Model picker showing providers, presets, and local endpoints"><br><b>정확한 모델 선택</b><br><sub>제공업체, 프리셋, 로컬 엔드포인트를 하나의 리스트에서 관리합니다</sub></td>
    <td align="center" width="33.33%"><img src="docs/images/app/en/skill-market.webp" alt="Skill marketplace"><br><b>필요한 기능이 없으신가요? 설치하세요</b><br><sub>소스 및 보안 상태를 즉시 확인할 수 있습니다</sub></td>
  </tr>
</table>

---

## Sponsorship & Partnership

이 프로젝트는 제작자의 개인 시간에 유지 관리되고 있습니다. 지속적인 개발을 지원하기 위한 기업 또는 개인 후원을 환영합니다. 맞춤형 기능, 통합 서비스 및 비즈니스 파트너십에 대한 논의도 언제든 가능합니다.

<table>
  <thead>
    <tr>
      <th width="220">Sponsor</th>
      <th align="left">Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td align="center" valign="middle">
        <a href="https://teamorouter.com/?utm_source=cc_haha&utm_medium=referral&utm_campaign=ai_directory">
          <img src="docs/images/sponsors/teamorouter-logo.svg" width="180" alt="TeamoRouter">
        </a>
      </td>
      <td valign="middle">
        이 프로젝트를 후원해주신 <a href="https://teamorouter.com/?utm_source=cc_haha&utm_medium=referral&utm_campaign=ai_directory">TeamoRouter</a>에 감사드립니다. TeamoRouter는 엔터프라이즈급 Agentic LLM 게이트웨이로, 구독 없이 공식 가격 대비 최대 90% 저렴한 비용으로 Claude Code, Codex, Gemini CLI 및 기타 인기 AI 에이전트를 하나의 통합 API로 실행할 수 있게 해줍니다. Agent 프로토콜 호환성이 검증된 수백 개의 공식 모델 제공업체(OpenAI, Anthropic, Vertex, Azure, AWS Bedrock)를 통합하며, 공식 수준의 TTFT, 99.6%의 SLA 및 업계 최고 수준의 캐시 히트율을 제공합니다. 또한 중앙 집중식 빌링, 팀 관리, BYOK, 사용량 분석 및 원클릭 Teamo Desktop 기능을 추가합니다. <a href="https://teamorouter.com/?utm_source=cc_haha&utm_medium=referral&utm_campaign=ai_directory">이 링크</a>를 통해 가입하는 신규 사용자는 첫 충전 시 10% 할인을 받을 수 있습니다.
      </td>
    </tr>
    <tr>
      <td align="center" valign="middle">
        <a href="https://www.xuanshuapi.com/register?aff=CC-HAHA&promo=CC-HAHA">
          <img src="docs/images/sponsors/xuanshuapi-logo.svg" width="120" alt="XuanShu API">
        </a>
      </td>
      <td valign="middle">
        이 프로젝트를 후원해주신 <a href="https://www.xuanshuapi.com/register?aff=CC-HAHA&promo=CC-HAHA">XuanShu API</a>에 감사드립니다. XuanShu API는 단일 통합 API를 통해 글로벌 선도 모델에 접속할 수 있는 엔터프라이즈급 AI 게이트웨이이며, Claude Code, Codex, Gemini CLI와 같은 인기 AI 코딩 툴과 즉시 호환됩니다. 안정성을 최우선으로 하여, 멀티 계정 풀 스케줄링과 자동 페일오버를 통해 업스트림 계정의 변동성을 최소화합니다. 모델 호출 비용은 공식 요금의 25% 수준으로 낮으며, 잔액 충전 시 만료일 없는 약 20%의 보너스를 제공합니다. <a href="https://www.xuanshuapi.com/register?aff=CC-HAHA&promo=CC-HAHA">이 링크</a>를 통해 가입하는 신규 사용자에게는 $5 크레딧이 제공됩니다.
      </td>
    </tr>
    <tr>
      <td align="center" valign="middle">
        <a href="https://api.fenno.ai/s/WD8c">
          <img src="docs/images/sponsors/fennoai-logo.svg" width="180" alt="FennoAI">
        </a>
      </td>
      <td valign="middle">
        이 프로젝트를 후원해주신 <a href="https://api.fenno.ai/s/WD8c">FennoAI</a>에 감사드립니다. FennoAI는 엔터프라이즈 엔지니어링 팀과 개인 개발자를 위한 고안정성, 고성능 API 릴레이 서비스입니다. OpenAI와 Anthropic 프로토콜을 모두 지원하여 Codex, Claude Code, OpenCode 및 기타 주류 AI 코딩 툴에 바로 적용할 수 있습니다. 일일 수천억 개의 토큰을 처리하는 엔터프라이즈급 안정성을 위해 구축되었으며, 국내외 법인을 위한 기업 결제 및 인보이스 발행을 지원합니다. cc-haha 사용자 혜택으로 <a href="https://api.fenno.ai/s/WD8c">이 링크</a>를 통해 구독을 구매하면 $1.99에 $50의 Coding Plan 크레딧을 받을 수 있습니다. 추천 시 최대 20%의 커미션을 받을 수 있습니다.
      </td>
    </tr>
    <tr>
      <td align="center" valign="middle">
        <a href="https://s.qiniu.com/IZbyya">
          <img src="docs/images/sponsors/qiniuai-logo.svg" width="180" alt="Qiniu Cloud AI">
        </a>
      </td>
      <td valign="middle">
        이 프로젝트를 후원해주신 <a href="https://s.qiniu.com/IZbyya">Qiniu Cloud AI</a>에 감사드립니다. Qiniu Cloud AI는 Qiniu Cloud (02567.HK)의 엔터프라이즈급 LLM MaaS 플랫폼입니다. 전 세계 150개 이상의 선도 모델을 하나의 진입점으로 제공하며, 주요 벤더의 프로토콜과 호환됩니다. 텍스트, 이미지, 오디오, 비디오 및 파일 처리를 포함한 모든 모달리티를 지원하며 169만 개 이상의 기업과 개발자에게 서비스를 제공하고 있습니다. cc-haha 사용자 혜택으로 <a href="https://s.qiniu.com/IZbyya">이 링크</a>를 통해 가입하면 기업 사용자는 12M, 개발자는 3M의 무료 토큰을 받을 수 있습니다.
      </td>
    </tr>
  </tbody>
</table>

📧 **Contact**: relakkes@gmail.com

---

## Install the Desktop App

1. [Releases](https://github.com/NanmiCoder/cc-haha/releases)에서 macOS / Windows / Linux 데스크톱 설치 프로그램을 다운로드하세요.
2. 처음 실행할 때, Settings에서 모델 제공업체, API 키 및 기본 모델을 설정하세요.
3. 공개 macOS 릴리스는 서명 및 공증이 필요합니다. 드래프트 또는 서명되지 않은 임시 빌드는 일회성 수동 승인이 필요할 수 있습니다. 서명되지 않은 Windows 설치 프로그램은 SmartScreen이 표시될 수 있습니다. "추가 정보" -> "실행"을 클릭하세요. 자세한 내용은 [데스크톱 설치 가이드](docs/en/start/install.md)를 참조하세요.

릴리스 신뢰 및 개인정보 보호: [코드 서명 정책](docs/en/start/code-signing.md) · [개인정보 및 네트워크 접속](docs/en/start/privacy.md)

## Run the CLI from Source

기저의 CLI, 서버 또는 로컬 개발 흐름을 디버깅하려는 사용자를 위한 안내입니다:

```bash
bun install
cp .env.example .env
./bin/claude-haha
```

더 많은 설정 옵션은 [환경 변수](docs/en/cli/env.md) 및 [CLI 설정](docs/en/cli/index.md)을 참조하세요.

---

## Desktop Highlights

- **멀티 세션 워크스페이스**: 탭, 프로젝트 전환, 터미널 진입, 세션 기록을 한곳에서 관리하며, 크기 조정 가능한 사이드바를 제공합니다.
- **글로벌 검색**: Cmd+K를 눌러 모든 세션을 검색하고 일치하는 항목으로 즉시 이동합니다.
- **브랜치 / Worktree 실행**: 리포지토리 브랜치를 선택하고 현재 작업 트리(working tree)를 사용할지 또는 격리된 Worktree를 사용할지 결정합니다.
- **파일별 수정 사항 검토**: 워크스페이스에서 이번 턴의 변경 사항을 나열합니다. 파일을 열어 구문 강조가 적용된 diff를 확인하거나 턴 전체를 실행 취소할 수 있습니다.
- **내장 브라우저 미리보기**: 에이전트가 방금 수정한 페이지가 앱 내부에서 렌더링되며, 쿠키와 로그인 상태가 유지됩니다.
- **5가지 권한 모드**: "매번 확인"부터 "권한 건너뛰기"까지 설정 가능합니다. 위험한 명령, 툴 호출, 후속 질문 등을 GUI에서 모두 승인할 수 있습니다.
- **사용자 정의 모델 사용**: Claude, ChatGPT 또는 Grok에 로그인하여 사용하거나 DeepSeek, Kimi, Zhipu GLM 등의 프리셋을 사용하세요. 또한 로컬에서 실행 중인 LM Studio 및 Ollama에 연결할 수 있습니다.
- **이미지 생성**: 채팅창에서 바로 이미지를 생성하고 편집하세요. ChatGPT 또는 Grok으로 로그인하여 즉시 사용하거나, OpenAI 호환 Images API를 연결할 수 있습니다.
- **비주얼 MCP 매니저**: GUI에서 MCP 서버를 추가하고 편집하세요. STDIO / Streamable HTTP / SSE를 지원하며 프로젝트, 공유 또는 글로벌 범위로 설정할 수 있습니다.
- **6가지 컬러 테마**: 화이트, 페이퍼, 웜 클래식, 셀라돈, 잉크 나이트, 잉크 블루 테마를 제공하며, 시스템의 라이트/다크 모드 설정을 따를 수 있습니다.
- **스킬 마켓플레이스**: ClawHub / SkillHub에서 서드파티 스킬을 발견, 미리보기 및 설치하세요. 소스 및 보안 상태가 명확히 표시됩니다.
- **세션 활동 패널**: 작업 진행 상황, 백그라운드 작업, SubAgents 및 소스를 하나의 사이드 패널에서 추적합니다.
- **비주얼 SubAgent 매니저**: GUI에서 SubAgents를 생성하고 튜닝하세요. 모델, 툴 및 권한 모드를 설정할 수 있습니다.
- **모델 트레이스**: 모든 모델 요청이 상태 및 타이밍과 함께 로컬에 로그로 기록됩니다. 검색 및 필터링을 통해 멈추거나 실패한 호출을 진단하세요.
- **Computer Use**: 권한 부여 후 에이전트가 스크린샷을 찍고, 클릭하고, 입력하며 데스크톱 앱을 제어하도록 할 수 있습니다.
- **데스크톱 펫**: Dada, Huhu, Bubu, Huihui가 현재 작업에 따라 행동을 바꿉니다. 또는 자신만의 펫을 키워보세요 (기본적으로 꺼져 있음).
- **H5 원격 접속**: QR 코드를 스캔하여 휴대폰 브라우저에서 세션을 이어가세요. 화면을 잠가도 실행 중인 작업은 중단되지 않습니다.
- **IM 통합**: Telegram / Feishu / WeChat / DingTalk / WhatsApp을 통해 채팅하고, 프로젝트를 전환하며, 작업을 승인하세요.
- **예약 작업 및 사용량 통계**: 계획된 작업을 별도의 세션에서 실행하고 로컬 토큰 사용량 추이를 추적하세요.

---

## More Documentation

전체 문서 사이트: <https://cchaha.ai>

| 섹션 | 문서 |
|------|------|
| **시작하기** | [소개](docs/en/start/index.md) · [다운로드 및 설치](docs/en/start/install.md) · [모델 제공업체 연결](docs/en/start/models.md) · [첫 세션 시작](docs/en/start/first-session.md) · [트러블슈팅](docs/en/start/troubleshooting.md) |
| **데스크톱 기능** | [기능 개요](docs/en/desktop/index.md) · [Computer Use](docs/en/desktop/computer-use.md) · [데스크톱 펫](docs/en/desktop/pets.md) · [휴대폰 H5 및 IM 릴레이](docs/en/desktop/remote.md) |
| **IM 통합** | [개요 및 페어링](docs/en/im/index.md) · [Feishu](docs/en/im/feishu.md) · [Telegram](docs/en/im/telegram.md) · [WeChat](docs/en/im/wechat.md) · [DingTalk](docs/en/im/dingtalk.md) · [WhatsApp](docs/en/im/whatsapp.md) |
| **CLI** | [설치 및 실행](docs/en/cli/index.md) · [명령어 레퍼런스](docs/en/cli/reference.md) · [환경 변수](docs/en/cli/env.md) |
| **내부 구조** | [데스크톱 아키텍처](docs/en/internals/desktop.md) · [멀티 에이전트 시스템](docs/en/internals/agent.md) · [스킬 시스템](docs/en/internals/skills.md) · [메모리 시스템](docs/en/internals/memory.md) · [Computer Use 아키텍처](docs/en/internals/computer-use.md) · [로컬 서버 및 API](docs/en/internals/server.md) · [채널 시스템](docs/en/internals/channel.md) · [프로젝트 구조](docs/en/internals/structure.md) · [기여 및 품질 게이트](docs/en/internals/contributing.md) |

---

## ☕ Buy Me a Coffee

이 프로젝트가 도움이 되었다면, 커피 한 잔을 선물해 주세요. 여러분의 작은 지원이 프로젝트를 계속 이어가는 힘이 됩니다 ❤️

<table>
<tr>
<td align="center" width="33%">
<img src="docs/images/donate/wechat_pay.jpeg" width="250" alt="WeChat Pay"><br>
<b>WeChat Pay</b>
</td>
<td align="center" width="33%">
<img src="docs/images/donate/zfb_pay.png" width="250" alt="Alipay"><br>
<b>Alipay</b>
</td>
<td align="center" width="33%">
<a href="https://buymeacoffee.com/relakkes" target="_blank">
<img src="docs/images/donate/bmc_button.png" width="250" alt="Buy Me a Coffee">
</a><br>
<b>Buy Me a Coffee</b>
</td>
</tr>
</table>

---

## User Group

아래 QR 코드를 스캔하여 Feishu (Lark)의 cc-haha 사용자 그룹에 가입하세요. 그룹 내 대화는 주로 중국어로 진행됩니다. 영어 질문이나 버그 제보는 [Issues](https://github.com/NanmiCoder/cc-haha/issues)를 이용해 주세요.

---

## Tech Stack

| 카테고리 | 기술 |
|------|------|
| 언어 | TypeScript |
| 데스크톱 앱 | Electron |
| 데스크톱 UI | React + Vite |
| 로컬 런타임 | [Bun](https://bun.sh) |
| 터미널 UI | React + [Ink](https://github.com/vadimdemedes/ink) |
| CLI 파싱 | Commander.js |
| API | Anthropic SDK |
| 프로토콜 | MCP, LSP |

## Acknowledgements

참조와 영감을 준 다음의 오픈 소스 프로젝트와 커뮤니티 관행에 감사드립니다:

- [React](https://github.com/facebook/react): 프론트엔드 엔지니어링 및 컴포넌트 기반 UI 생태계.
- [Electron](https://github.com/electron/electron): 크로스 플랫폼 데스크톱 앱 기능 및 엔지니어링 관행.
- [cc-switch](https://github.com/farion1231/cc-switch): 모델 제공업체 설정 참조.
- [LINUX DO](https://linux.do/): 새로운 이상적인 개발자 커뮤니티.

---

## ⭐ Star History

이 프로젝트가 도움이 되었다면, 더 많은 분들이 Claude Code Haha를 발견할 수 있도록 ⭐ Star로 지원해 주세요.

cc-haha

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README