项目地址：https://github.com/NanmiCoder/cc-haha
许可证：仅供学习和研究用途，原始源码版权归 Anthropic 所有
技术栈：TypeScript · Bun · React + Ink · Tauri 2 · Anthropic SDK

---

一、项目定位

Claude Code Haha（cc-haha）是基于 2026 年 3 月 31 日从 Anthropic npm registry 泄露的 Claude Code 源码，经系统性修复和功能增强后的本地可运行版本。项目在保留官方完整 TUI 交互界面的基础上，新增了跨平台桌面端、Computer Use 桌面控制、IM 远程接入、多 Agent 编排和跨会话记忆系统等核心能力，将单一 CLI 编码助手扩展为多渠道、多代理协作的综合性 AI 开发平台。

与简单镜像泄露源码不同，cc-haha 围绕实际开发场景构建了完整的增强功能矩阵，解决了官方版本在提供商灵活性、图形化交互、远程控制和代理协作等方面的缺失。

二、核心功能

2.1 完整 TUI 与无头模式

保留与官方 Claude Code 一致的 Ink TUI 交互界面，同时支持 --print 无头模式用于脚本自动化和 CI/CD 场景。双模式设计兼顾交互式开发的灵活性与自动化流程的可编程性。

2.2 多提供商 API 支持

突破官方对 Anthropic API 的单一依赖，支持接入任意 Anthropic 兼容 API（MiniMax、OpenRouter、DeepSeek、OpenAI、Ollama 等），用户通过配置自定义端点和模型即可切换后端，有效降低供应商锁定风险和运营成本。

2.3 桌面端与 Computer Use

基于 Tauri 2 + React 构建图形化桌面客户端，集成会话管理、多项目切换、代码 Diff、权限确认、提供商配置、定时任务和 IM 适配器。Computer Use 功能支持 macOS/Windows 平台的截屏、鼠标和键盘控制，使 AI 代理可操控图形界面完成复杂任务。

2.4 IM 远程接入

支持通过 Telegram、飞书、微信、钉钉四大平台远程驱动，用户可在移动端完成对话、项目切换和权限审批，实现随时随地的远程操控。

2.5 多 Agent 系统与 Skills

多代理编排支持并行任务执行和 Teams 协作模式；Skills 系统提供可扩展的能力插件机制，支持自定义工作流和条件激活。两者结合使工具从编码助手进化为团队级协作平台。

2.6 记忆系统

跨会话持久化记忆解决了 AI 助手的"健忘"问题，用户偏好、项目上下文和历史决策在会话间保持一致，不同代理可共享上下文知识库，确保协作中的信息对齐。

三、技术架构

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

系统采用分层架构：API 层与模型提供商通信，服务层处理业务逻辑与状态管理，UI 层（TUI / 桌面端 / IM）提供多渠道交互入口。MCP 和 LSP 协议的引入使工具扩展和语言智能服务标准化接入。权限与安全模块贯穿全架构，降级 Recovery CLI 模式提供故障场景下的应急操作路径。

四、部署与使用

环境要求：Bun 运行时，Node.js 环境；Windows 需安装 Git for Windows。

# 安装依赖并配置
bun install
cp .env.example .env   # 填入 API Key

# 启动 TUI
./bin/claude-haha

# 无头模式
./bin/claude-haha -p "your prompt here"

# 全局使用（可选）
export PATH="$HOME/path/to/claude-code-haha/bin:$PATH"

桌面端联调需额外启动 API 服务端（端口 3456）和前端开发服务器（端口 2024），两步即可完成环境搭建。

五、项目评估

优势

维度	评估
功能完整性	新增桌面端、Computer Use、IM 接入、多 Agent 等关键能力，远超原始版本
提供商灵活性	支持任意兼容 API，降低供应商锁定和成本
部署便捷性	本地一键启动，5 分钟内完成环境搭建
扩展性	MCP/LSP + Skills 插件 + 多 Agent 编排，三层扩展覆盖多样需求

风险提示

项目基于 Anthropic 泄露源码构建，存在知识产权合规风险，声明仅供学习研究用途。企业采用前应充分评估法律风险，避免在商业生产环境部署。社区驱动的维护模式在长期可持续性和安全响应速度上存在不确定性，建议使用前进行独立安全审计。

六、结论

cc-haha 是对 Claude Code 泄露源码的系统性增强，通过桌面端、Computer Use、IM 远程接入、多 Agent 编排和记忆系统等创新功能，构建了功能远超原始版本的 AI 开发平台。项目在技术架构和功能完整性上表现出色，适合开发者在学习研究场景中探索 AI 辅助开发的边界。但基于泄露源码的法律属性不容忽视，建议在商业场景中谨慎评估合规风险，优先考虑官方授权方案。

---

本文基于 NanmiCoder/cc-haha 项目开源文档撰写，信息获取时间：2026 年 5 月 7 日。