中文 | English
基于 Claude Code 泄露源码修复的本地可运行版本,支持接入任意 Anthropic 兼容 API(如 MiniMax、OpenRouter 等)。
原始泄露源码无法直接运行。本仓库修复了启动链路中的多个阻塞问题,使完整的 Ink TUI 交互界面可以在本地工作。
- 完整的 Ink TUI 交互界面(与官方 Claude Code 一致)
--print无头模式(脚本/CI 场景)- 支持 MCP 服务器、插件、Skills
- 支持自定义 API 端点和模型
- 降级 Recovery CLI 模式
整体架构 |
请求生命周期 |
工具系统 |
多 Agent 架构 |
终端 UI |
权限与安全 |
服务层 |
状态与数据流 |
本项目运行依赖 Bun。如果你的电脑还没有安装 Bun,可以先执行下面任一方式:
# macOS / Linux(官方安装脚本)
curl -fsSL https://bun.sh/install | bash如果在精简版 Linux 环境里提示 unzip is required to install bun,先安装 unzip:
# Ubuntu / Debian
apt update && apt install -y unzip# macOS(Homebrew)
brew install bun# Windows(PowerShell)
powershell -c "irm bun.sh/install.ps1 | iex"安装完成后,重新打开终端并确认:
bun --versionbun install复制示例文件并填入你的 API Key:
cp .env.example .env编辑 .env(推荐直接使用 OpenRouter 的 qwen/qwen3.6-plus:free 作为主模型):
# Claude Haha 始终使用独立配置目录:~/.claude-haha
# 不要把 CLAUDE_CONFIG_DIR 指向官方全局 ~/.claude
# OpenRouter qwen/qwen3.6-plus:free(主推荐)
ANTHROPIC_API_KEY=
ANTHROPIC_AUTH_TOKEN=or-xxx
ANTHROPIC_BASE_URL=https://openrouter.ai/api
ANTHROPIC_MODEL=qwen/qwen3.6-plus:free
ANTHROPIC_SMALL_FAST_MODEL=qwen/qwen3.6-plus:free
ANTHROPIC_DEFAULT_SONNET_MODEL=qwen/qwen3.6-plus:free
ANTHROPIC_DEFAULT_HAIKU_MODEL=qwen/qwen3.6-plus:free
ANTHROPIC_DEFAULT_OPUS_MODEL=qwen/qwen3.6-plus:free
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
# 如果你的中间层仍然报 prompt cache_control 错误,可再加:
# DISABLE_PROMPT_CACHING=1
# 手动备选:Fireworks GLM-5
# ANTHROPIC_API_KEY=fw-xxx
# ANTHROPIC_AUTH_TOKEN=
# ANTHROPIC_BASE_URL=https://api.fireworks.ai/inference
# ANTHROPIC_MODEL=accounts/fireworks/models/glm-5
# ANTHROPIC_SMALL_FAST_MODEL=accounts/fireworks/models/glm-5
# ANTHROPIC_DEFAULT_SONNET_MODEL=accounts/fireworks/models/glm-5
# ANTHROPIC_DEFAULT_HAIKU_MODEL=accounts/fireworks/models/glm-5
# ANTHROPIC_DEFAULT_OPUS_MODEL=accounts/fireworks/models/glm-5
# 超时(毫秒)
API_TIMEOUT_MS=3000000
# 禁用遥测和非必要网络请求
DISABLE_TELEMETRY=1
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1# 交互 TUI 模式(完整界面)
./bin/claude-haha
# 无头模式(单次问答)
./bin/claude-haha -p "your prompt here"
# 管道输入
echo "explain this code" | ./bin/claude-haha -p
# 查看所有选项
./bin/claude-haha --help前置要求:必须安装 Git for Windows(提供 Git Bash,项目内部 Shell 执行依赖它)。
Windows 下启动脚本 bin/claude-haha 是 bash 脚本,无法在 cmd / PowerShell 中直接运行。请使用以下方式:
方式一:安装 PowerShell 启动器(推荐)
bun run launcher:install
claude-haha启动器会把 Claude Haha 的插件、MCP、sessions、settings 固定隔离在 ~/.claude-haha 下,不会读取或复用官方全局 ~/.claude。
本地 /ultraplan:
/ultraplan <需求描述>
它会在当前 claude-haha 会话里进入更强的本地规划流程,只做本地探索与计划编写,不会跳转到 Claude Code on the web,也不依赖官方远程 CCR 会话。
可用健康检查:
bun run launcher:doctor方式二:PowerShell / cmd 直接调用 Bun
# 交互 TUI 模式
bun --env-file=.env ./src/entrypoints/cli.tsx
# 无头模式
bun --env-file=.env ./src/entrypoints/cli.tsx -p "your prompt here"
# 降级 Recovery CLI
bun --env-file=.env ./src/localRecoveryCli.ts方式二:Git Bash 中运行
# 在 Git Bash 终端中,与 macOS/Linux 用法一致
./bin/claude-haha注意:部分功能(语音输入、Computer Use、Sandbox 隔离等)在 Windows 上不可用,不影响核心 TUI 交互。
| 变量 | 必填 | 说明 |
|---|---|---|
ANTHROPIC_API_KEY |
二选一 | API Key,通过 x-api-key 头发送。默认 OpenRouter 配置下请留空。 |
ANTHROPIC_AUTH_TOKEN |
二选一 | Auth Token,通过 Authorization: Bearer 头发送。OpenRouter 推荐使用该方式。 |
ANTHROPIC_BASE_URL |
否 | 自定义 API 端点,默认 Anthropic 官方 |
ANTHROPIC_MODEL |
否 | 默认模型 |
ANTHROPIC_SMALL_FAST_MODEL |
否 | 小模型/子 Agent 模型映射 |
ANTHROPIC_DEFAULT_SONNET_MODEL |
否 | Sonnet 级别模型映射 |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
否 | Haiku 级别模型映射 |
ANTHROPIC_DEFAULT_OPUS_MODEL |
否 | Opus 级别模型映射 |
CLAUDE_CONFIG_DIR |
否 | Claude Haha 独立配置目录,默认 ~/.claude-haha,禁止指向官方 ~/.claude |
API_TIMEOUT_MS |
否 | API 请求超时,默认 600000 (10min) |
DISABLE_TELEMETRY |
否 | 设为 1 禁用遥测 |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC |
否 | 设为 1 禁用非必要网络请求 |
如果完整 TUI 出现问题,可以使用简化版 readline 交互模式:
CLAUDE_CODE_FORCE_RECOVERY_CLI=1 ./bin/claude-haha泄露的源码无法直接运行,主要修复了以下问题:
| 问题 | 根因 | 修复 |
|---|---|---|
| TUI 不启动 | 入口脚本把无参数启动路由到了 recovery CLI | 恢复走 cli.tsx 完整入口 |
| 启动卡死 | verify skill 导入缺失的 .md 文件,Bun text loader 无限挂起 |
创建 stub .md 文件 |
--print 卡死 |
filePersistence/types.ts 缺失 |
创建类型桩文件 |
--print 卡死 |
ultraplan/prompt.txt 缺失 |
创建资源桩文件 |
| Enter 键无响应 | modifiers-napi native 包缺失,isModifierPressed() 抛异常导致 handleEnter 中断,onSubmit 永远不执行 |
加 try-catch 容错 |
| setup 被跳过 | preload.ts 自动设置 LOCAL_RECOVERY=1 跳过全部初始化 |
移除默认设置 |
bin/claude-haha # 入口脚本
preload.ts # Bun preload(设置 MACRO 全局变量)
.env.example # 环境变量模板
src/
├── entrypoints/cli.tsx # CLI 主入口
├── main.tsx # TUI 主逻辑(Commander.js + React/Ink)
├── localRecoveryCli.ts # 降级 Recovery CLI
├── setup.ts # 启动初始化
├── screens/REPL.tsx # 交互 REPL 界面
├── ink/ # Ink 终端渲染引擎
├── components/ # UI 组件
├── tools/ # Agent 工具(Bash, Edit, Grep 等)
├── commands/ # 斜杠命令(/commit, /review 等)
├── skills/ # Skill 系统
├── services/ # 服务层(API, MCP, OAuth 等)
├── hooks/ # React hooks
└── utils/ # 工具函数
| 类别 | 技术 |
|---|---|
| 运行时 | Bun |
| 语言 | TypeScript |
| 终端 UI | React + Ink |
| CLI 解析 | Commander.js |
| API | Anthropic SDK |
| 协议 | MCP, LSP |
本仓库基于 2026-03-31 从 Anthropic npm registry 泄露的 Claude Code 源码。所有原始源码版权归 Anthropic 所有。仅供学习和研究用途。