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)

Searching Database…

15.1K ·GitHub
Cc-haha
这是什么？Claude Code Haha 是一款本地优先的桌面工作台，面向 Claude Code 及其他编程智能体。它把多会话聊天、git worktree 启动、差异审查、应用内浏览器、模型切换、MCP 管理、Computer Use、技能市场，以及通过聊天应用进行远程访问等功能，整合进同一个 macOS/Windows/Linux 应用中。
这是桌面应用，还是我也能用命令行运行？它主要是一款面向 macOS/Windows/Linux 的 Electron 桌面应用，但也提供单独的 CLI/服务端。如果你想自己调试底层引擎，可以从源代码运行它。
我需要哪些模型服务商的账号或 API 密钥？你可以直接使用 Claude、ChatGPT 或 Grok 账号登录，也可以使用预设的第三方 API 密钥（如 DeepSeek、Kimi、智谱 GLM 等），或者指向 LM Studio、Ollama 等本地端点。没有哪一家服务商是必选的。
在 macOS 或 Windows 上安装时我需要注意什么？经过签名和公证的 macOS 版本可以正常安装，但草稿版或未签名的构建在首次打开时可能仍需手动允许。未签名的 Windows 安装包可能会触发 SmartScreen 警告，此时点击“更多信息”，再点击“仍要运行”即可继续。
它支持哪些操作系统？它是一个统一的应用，同时支持 macOS、Windows 和 Linux。
什么是技能市场？你可以在这里发现、预览并安装来自 ClawHub 或 SkillHub 的第三方智能体技能。安装前，每个技能的来源和安全状态都会清楚地显示出来。
Computer Use 能做什么？获得授权后，智能体可以直接截图、点击、输入，并以其他方式操控桌面应用，而不只是操作终端。
什么是桌面宠物？它们是可选的屏幕吉祥物（如搭搭、弧弧等有名字的角色），会根据当前任务的状态切换动画。该功能默认关闭。
我能用手机或聊天应用控制会话吗？可以。你可以通过 Telegram、飞书、微信、钉钉或 WhatsApp 连接，远程聊天、切换项目并批准权限；也可以扫描二维码，通过 H5 手机浏览器访问，它会在后台持续运行。
What are similar projects?claude-code, evenfire, qwen-code, LobsterAI, CodePilot, pstack-claude, open-pstack, oh-my-pi
Which topics is it in?computer-use, bun, wechat, telegram, workflow, chatgpt, agent-orchestration, electron, skill, anthropic, multi-agent, mcp-server
Creator
NanmiCoder
Size
193.6 MB
Stars
15.1K
Updated
CommitOct 18Releasev0.7.4Oct 16
Age
6mo
Commits · 90 Days