cc-haha

简体中文 · English

cc-haha 是一个桌面端 Claude Code 工作台：多会话与全局搜索、分支 / Worktree 启动、Diff 审阅、内置浏览器预览、图形化权限审批、模型自选（Claude / ChatGPT / Grok / 预设 / 本地端点）、图片生成、MCP 与 SubAgent 可视化管理、Agent Teams 协作工作台、动态 Workflow 编排、模型请求追踪、Computer Use、技能市场、多主题、桌面宠物、H5 远程访问、IM 接入和定时任务，集中在一个 macOS / Windows / Linux APP 里。在 macOS 上，Computer Use 能操作其他应用，同时不占用你的真实鼠标和键盘。

---

桌面端预览

从 0 开始：下载安装 → 连接模型 → 跑通第一条会话 → 设置指南 → 实战案例。想体验不抢鼠标的跨应用操作，接着看 Computer Use 指南。

---

赞助与合作

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

📧 联系邮箱：[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

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

---

用户交流群

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

---

☕ 请作者喝杯咖啡

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

---

桌面端亮点

• 多会话工作台：标签页、项目切换、终端入口和会话历史集中管理，侧边栏宽度可拖拽。
• 全局搜索：按 Cmd+K 跨所有会话全文搜索，一键跳到命中位置。
• 分支 / Worktree 启动：新会话可以选择仓库分支，并决定用当前工作树还是隔离 Worktree。
• 改动逐个文件审阅：右侧工作区列出本轮改动，点开就是带语法高亮的 Diff，整轮可撤销。
• 内置浏览器预览：Agent 刚改完的页面直接在应用内渲染，登录态和 Cookie 真实可用。
• 五档权限模式：从「询问权限」到「跳过权限」，危险命令、工具调用和 AI 反问都在桌面端审批。
• 模型自选：Claude / ChatGPT / Grok 官方账号可直接登录；DeepSeek、Kimi、智谱 GLM 等第三方 API 有现成预设；LM Studio、Ollama 的本地模型也接得上。
• 图片生成：聊天中直接生成和编辑图片——ChatGPT / Grok 授权登录即可使用，也支持接入任意 OpenAI 兼容的 Images API。
• MCP 图形化管理：界面化增删改 MCP Server，支持 STDIO / Streamable HTTP / SSE 三种传输方式与项目私有、共享、全局三种作用域。
• 六套配色主题：纯白、纸墨、经典暖色、青瓷、墨夜、墨夜蓝，可跟随系统深浅色自动切换。
• 技能市场：发现、预览、安装 ClawHub / SkillHub 的第三方技能，来源和安全状态摆在明处。
• 会话活动面板：集中查看任务进度、后台任务、SubAgent 与来源。
• 可视化 SubAgent 管理：图形界面创建和调校子代理，选择模型、工具与权限模式。
• Agent Teams 协作工作台：桌面端可视化多 Agent 协作团队——成员、任务、通信流和依赖泳道一目了然。
• 动态 Workflow 编排：模型当场编写并运行编排脚本，并发或流水线调度多个子代理，支持阶段视图、中断与断点续跑。
• 模型请求追踪：本地记录每轮模型请求的状态与耗时，可搜索筛选，快速定位卡死或失败调用。
• Computer Use：让 Agent 在授权后截图、点击、输入并控制桌面应用；macOS 原生运行时不占用你的真实鼠标和键盘。
• 桌面宠物：搭搭、弧弧、补补、回回随任务状态换动作，也能自己做一只（默认关闭）。
• H5 远程访问：扫码用手机浏览器接入当前会话，锁屏切后台都不打断正在跑的任务。
• IM 接入：通过 Telegram / 飞书 / 微信 / 钉钉 / WhatsApp / 企业微信 / QQ / Slack 远程对话、切换项目和审批权限。
• 定时任务与用量统计：创建计划任务在独立会话执行，并查看本机 Token 使用趋势。

---

更多文档

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

分区	文档
开始使用	这是什么 · 下载与安装 · 连接模型服务 · 跑通第一条会话 · 故障排查
桌面端功能	功能总览 · Computer Use · 桌面宠物 · 手机 H5 与 IM 接力
IM 接入	总览与配对流程 · 飞书 · Telegram · 微信 · 钉钉 · WhatsApp · 企业微信 · ·

---

技术栈

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

致谢

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

• React：前端工程与组件化 UI 生态。
• Electron：跨端桌面应用能力与工程实践。
• cc-switch：模型供应商配置能力参考。
• LINUX DO：新的理想型开发者社区。
• AtomGit：为本项目提供国内代码托管。

---

⭐ Star History

如果这个项目对你有帮助，欢迎点一个 ⭐ Star，让更多人发现 cc-haha。

---

许可说明

当前采用 cc-haha Community Source License 1.0。允许个人非商业使用及企业内部自用；接单、对外商业盈利、收费修改或二次开发、商业分发及付费服务须事先取得书面商业授权；二次分发须显著保留来源署名。历史 MIT 授权与第三方许可继续有效。详见许可说明。当前许可属于源码可用许可，不是 OSI 认可的开源许可证。