跳到主要内容
项目档案命令行工具

NanmiCoder/cc-haha CLI 工具:安装、命令与使用场景

本仓库提供 Claude Code 泄露源码的修复版本,可在本地运行完整的 Ink TUI 界面。支持 MiniMax、OpenRouter 等 Anthropic 兼容 API,具备记忆系统、多 Agent 编排、Skills 插件等高级功能,适用于 AI 编程助手、自动化脚本等场景。包含详细安装、使用文档和架构解析。

14,655TypeScriptStar 于 2026年4月2日2026年9月20日 更新

AI 总结

基于 Claude Code 泄露源码修复的本地可运行版本,提供完整的 Ink TUI 交互界面,支持多种 Anthropic 兼容 API,适用于本地 AI 编程助手与自动化任务。

中文项目介绍

Claude Code Haha 是一个从泄露源码修复并使其可在本地完整运行的 CLI 工具。它解决了原始版本无法启动的问题,重建了与官方一致的 Ink 终端交互界面。 该项目支持接入任意 Anthropic 兼容 API(如 MiniMax、OpenRouter 等),无需依赖官方服务。它适用于本地 AI 编程助手、CI/CD 自动化脚本执行、多 Agent 协作任务编排等场景。 技术层面,项目基于 Bun 运行时,使用 TypeScript 开发,采用 React + Ink 构建 TUI,通过 Commander.js 解析命令行参数,并集成 Anthropic SDK、MCP 协议等。核心功能包括记忆系统、多 Agent 系统、Skills 插件系统、Channel 远程控制、Computer Use 桌面控制等,具备完整的服务层、权限安全机制与状态数据流管理。

详细信息与使用说明

1. 项目定位与用途

Claude Code Haha 是基于泄露的 Claude Code 源码修复的本地可运行版本,定位为本地 AI 编程助手与自动化任务执行工具。它提供与官方一致的完整 Ink TUI 交互界面,支持通过配置接入多种 Anthropic 兼容 API(如 MiniMax、OpenRouter 等),无需依赖 Anthropic 官方服务。主要用途包括交互式代码生成、文件操作、终端命令执行,以及通过无头模式支持脚本与 CI 场景。

2. 解决的问题

原始泄露源码存在启动链路中的多个阻塞问题,无法直接运行。本仓库通过修复这些问题,使完整的 Ink TUI 交互界面能够在本地正常工作。同时,项目解决了官方版本对 API 提供商的限制,通过统一 Anthropic 兼容接口,允许用户灵活选择第三方服务商,并提供了记忆持久化、多 Agent 编排等增强功能。

3. 适用场景

主要适用场景包括:1) 本地交互式 AI 编程助手,在终端内直接进行代码生成与编辑;2) CI/CD 自动化脚本执行,通过 --print 无头模式运行;3) 多 Agent 协作任务编排,处理复杂并行工作流;4) 通过 Telegram/飞书/Discord 等 IM 工具远程控制 Agent;5) 桌面自动化操作,利用 Computer Use 功能控制鼠标键盘。

4. 安装方式

安装过程已在仓库中明确给出:1) 安装 Bun 运行时,支持 macOS/Linux(curl 或 brew)与 Windows(PowerShell);2) 在项目根目录运行 `bun install` 安装依赖;3) 复制 `.env.example` 为 `.env` 并编辑填入 API Key 等环境变量,详细配置参考 `docs/guide/env-vars.md`。Windows 用户需前置安装 Git for Windows。

5. 使用方式

使用方式在 README 中有明确说明:交互 TUI 模式运行 `./bin/claude-haha`;无头模式使用 `./bin/claude-haha -p "your prompt here"`;通过 `--help` 查看所有选项。支持全局使用,将 `bin/` 目录加入 PATH 后可在任意目录启动。降级恢复模式通过设置环境变量 `CLAUDE_CODE_FORCE_RECOVERY_CLI=1` 后运行实现。

6. 补充说明与实现特点

项目采用模块化命令系统,功能以独立命令形式存在(如 agents、bridge、buddy 等),支持延迟加载。基于 Bun 运行时特性检测控制功能开关。TypeScript 配置启用严格模式与路径别名。文档体系完善,包含中文与英文双语文档,涵盖架构图、实现原理与使用指南。部分命令(如 ant-trace、autofix-pr、bughunter)当前为存根状态,未启用。

思维导图

Claude Code Haha
核心功能
Ink TUI 交互界面
无头模式 (--print)
记忆系统
多 Agent 系统
Skills 插件系统
Channel 远程控制
Computer Use 桌面控制
技术架构
Bun 运行时
React + Ink TUI
Commander.js CLI
Anthropic SDK
MCP 协议支持
OpenTelemetry 可观测性
命令系统
agents (Agent 管理)
bridge (远程控制)
buddy (陪伴者)
branch (对话分支)
chrome (Chrome 集成)
add-dir (工作目录)
API 集成
MiniMax 直连
OpenAI via LiteLLM
DeepSeek via LiteLLM
OpenRouter 等兼容接口
文档体系
中文文档 (docs/)
英文文档 (docs/en/)
架构解析图集
环境变量指南
FAQ 与故障排除

常见问题

为什么需要修复 Claude Code 泄露源码?

原始泄露版本存在启动链路阻塞问题,无法直接运行。本仓库修复了这些问题,使完整的 Ink TUI 交互界面能够在本地正常工作,并增强了记忆、多 Agent 等能力。

支持哪些 API 提供商?

支持任意 Anthropic 兼容 API,包括 MiniMax(直连)、OpenRouter,以及通过 LiteLLM 代理接入 OpenAI、DeepSeek 等。通过配置 .env 文件中的 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 即可切换。

如何安装和启动项目?

首先安装 Bun 运行时,然后运行 `bun install` 安装依赖,复制 `.env.example` 为 `.env` 并配置 API Key。启动方式:交互模式运行 `./bin/claude-haha`,无头模式使用 `./bin/claude-haha -p "prompt"`。Windows 用户需前置安装 Git for Windows。