cc-haha README

The project's README from github.com/NanmiCoder/cc-haha. As one markdown file: README.md.

Claude Code Haha

cc-haha — Claude Code 开源桌面端

GitHub Stars GitHub Forks GitHub Issues GitHub Pull Requests License 中文 English Docs

简体中文 · English

Claude Code Haha 是一个桌面端 Claude Code 工作台:多会话与全局搜索、分支 / Worktree 启动、Diff 审阅、内置浏览器预览、图形化权限审批、模型自选(Claude / ChatGPT / Grok / 预设 / 本地端点)、图片生成、MCP 与 SubAgent 可视化管理、Agent Teams 协作工作台、动态 Workflow 编排、模型请求追踪、Computer Use、技能市场、多主题、桌面宠物、H5 远程访问、IM 接入和定时任务,集中在一个 macOS / Windows / Linux APP 里。

桌面端预览 · 安装桌面端 · 桌面端亮点 · 更多文档 · 赞助与合作 · 用户交流群


桌面端预览

下载桌面端

第一次任务前的空会话
从清爽的空会话开始
项目和权限都在首屏
打开活动面板的真实执行中任务
跟着任务一步步往前
工具调用与阶段进度都留在眼前
工作区 Diff 评审
改了什么,逐行看清楚
放大的高亮 Diff,文字和代码更清楚
内置浏览器预览刚改完的页面
改完当场验证
内置浏览器打开真实本地页面
显示服务商、预设和本地端点的模型选择器
每条会话自选模型
自己的服务商、预设和本地端点都在一个列表里
技能市场
缺什么手艺装什么
来源和安全状态摆在明处

赞助与合作

本项目由个人利用业余时间维护,欢迎企业或个人赞助支持持续开发,也可洽谈定制、集成或商务合作。

赞助商 介绍
Atlas Cloud Atlas Cloud 感谢 Atlas Cloud 赞助本项目!Atlas Cloud 是一个全模态 AI 推理平台,让开发者通过统一的 AI API 访问视频生成、图像生成和 LLM API,无需分别维护多个厂商集成,即可调用 300+ 精选模型。cc-haha 已内置 Atlas Cloud 供应商预设,在设置里选择后填入 API Key 即可直接使用。Atlas Cloud 最新推出 coding plan 优惠,为开发者提供更具性价比的 API 访问预算。
ApiSmart 感谢 ApiSmart 赞助本项目!ApiSmart 通过单一 API 提供对主流 AI 模型的统一访问。只需一个 API Key,即可通过兼容 OpenAI 的接口连接大语言模型、图像模型和视频模型。轻松切换模型、简化账单管理,并通过智能路由和自动故障转移提升可靠性。

📧 联系邮箱:[email protected]


安装桌面端

  1. 前往 Releases 下载 macOS / Windows / Linux 桌面端安装包。
  2. 首次启动后,在桌面端设置里配置模型提供商、API Key 和默认模型。
  3. 正式 macOS Release 需要经过签名和公证;如果安装的是 draft/unsigned 临时包,首次打开可能仍需手动放行。Windows 未签名安装包可能出现 SmartScreen 提示,点「更多信息」→「仍要运行」即可。详见 桌面端安装指南。

发布可信度与隐私:Code signing policy · 隐私与联网说明

从源码启动 CLI

适合想调试底层 CLI、服务端或自行开发的用户:

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

更多配置见 环境变量 和 命令行安装与启动。


桌面端亮点


更多文档

完整文档站:https://cchaha.ai

分区 文档
开始使用 这是什么 · 下载与安装 · 连接模型服务 · 跑通第一条会话 · 故障排查
桌面端功能 功能总览 · Computer Use · 桌面宠物 · 手机 H5 与 IM 接力
IM 接入 总览与配对流程 · 飞书 · Telegram · 微信 · 钉钉 · WhatsApp
命令行 安装与启动 · 命令参考 · 环境变量
深入原理 桌面端架构 · 多 Agent 系统 · Skills 系统 · 记忆系统 · Computer Use 架构 · 本地 Server 与 API · Channel 系统 · 项目结构 · 参与贡献与质量门禁

☕ 请作者喝杯咖啡

如果这个项目对您有帮助,欢迎打赏支持,您的每一份支持都是我持续更新的动力 ❤️

微信赞赏
微信赞赏
支付宝
支付宝
Buy Me a Coffee
Buy Me a Coffee

用户交流群

使用过程中有问题、想反馈 Bug,或者想看看别人怎么用,欢迎扫码加入 cc-haha 企业微信用户群。也可以直接来 Issues 提问。企业定制 / 私有化部署 / Agent 定制需求,请联系作者 NanmiCoder。

cc-haha 企业微信用户群二维码


技术栈

类别 技术
语言 TypeScript
桌面 APP Electron
桌面 UI React + Vite
本地运行时 Bun
终端 UI React + Ink
CLI 解析 Commander.js
API Anthropic SDK
协议 MCP, LSP

致谢

感谢以下开源项目和社区实践为本项目提供参考与启发:


⭐ Star History

如果这个项目对你有帮助,欢迎点一个 ⭐ Star,让更多人发现 Claude Code Haha。

Star History Chart

cc-haha (NanmiCoder/cc-haha)

wechat
Searching Database…

15.1K ·GitHub
What is this?Claude Code Haha is a local-first desktop workbench for Claude Code and other coding agents, bundling multi-session chat, git worktree launches, diff review, an in-app browser, model switching, MCP management, Computer Use, a skill marketplace, and remote access via chat apps into one macOS/Windows/Linux app.
Is this a desktop app, or can I run it from the CLI too?It is primarily an Electron desktop app for macOS/Windows/Linux, but it also has a separate CLI/server you can run from source if you want to debug the underlying engine yourself.
Which model providers do I need an account or API key for?You can log in directly with Claude, ChatGPT or Grok accounts, use preset third-party API keys (DeepSeek, Kimi, Zhipu GLM, etc.), or point it at a local endpoint like LM Studio or Ollama — no single provider is mandatory.
Any install pitfalls on macOS or Windows?Signed/notarized macOS releases install normally, but draft/unsigned builds may still need manual approval on first open; unsigned Windows installers can trigger a SmartScreen warning that you click through via 'More info' then 'Run anyway'.
Which operating systems does it run on?It ships as a single app for macOS, Windows and Linux.
What is the skill marketplace?It lets you discover, preview and install third-party agent skills from ClawHub/SkillHub, with each skill's source and security status shown clearly before install.
What can Computer Use do?Once authorized, the agent can take screenshots, click, type and otherwise control desktop applications directly, not just the terminal.
What are the desktop pets?They are optional on-screen mascots (named characters like 搭搭 and 弧弧) that change animation based on the current task's status; the feature is off by default.
Can I control sessions from my phone or chat apps?Yes — you can connect via Telegram, Feishu, WeChat, DingTalk or WhatsApp to chat remotely, switch projects and approve permissions, or scan a QR code for H5 mobile browser access that keeps running in the background.
Creator
NanmiCoder
Size
190 MB
Stars
15.1K
Age
6mo
Commits · 90 Days