|
|
@@ -0,0 +1,213 @@
|
|
|
+# Claude Code Haha
|
|
|
+
|
|
|
+<p align="right"><a href="./README.md">中文</a> | <strong>English</strong></p>
|
|
|
+
|
|
|
+A **locally runnable version** repaired from the leaked Claude Code source, with support for any Anthropic-compatible API endpoint such as MiniMax and OpenRouter.
|
|
|
+
|
|
|
+> The original leaked source does not run as-is. This repository fixes multiple blocking issues in the startup path so the full Ink TUI can work locally.
|
|
|
+
|
|
|
+<p align="center">
|
|
|
+ <img src="docs/00runtime.png" alt="Runtime screenshot" width="800">
|
|
|
+</p>
|
|
|
+
|
|
|
+## Features
|
|
|
+
|
|
|
+- Full Ink TUI experience (matching the official Claude Code interface)
|
|
|
+- `--print` headless mode for scripts and CI
|
|
|
+- MCP server, plugin, and Skills support
|
|
|
+- Custom API endpoint and model support
|
|
|
+- Fallback Recovery CLI mode
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## Architecture Overview
|
|
|
+
|
|
|
+<table>
|
|
|
+ <tr>
|
|
|
+ <td align="center" width="25%"><img src="docs/01-overall-architecture.png" alt="Overall architecture"><br><b>Overall architecture</b></td>
|
|
|
+ <td align="center" width="25%"><img src="docs/02-request-lifecycle.png" alt="Request lifecycle"><br><b>Request lifecycle</b></td>
|
|
|
+ <td align="center" width="25%"><img src="docs/03-tool-system.png" alt="Tool system"><br><b>Tool system</b></td>
|
|
|
+ <td align="center" width="25%"><img src="docs/04-multi-agent.png" alt="Multi-agent architecture"><br><b>Multi-agent architecture</b></td>
|
|
|
+ </tr>
|
|
|
+ <tr>
|
|
|
+ <td align="center" width="25%"><img src="docs/05-terminal-ui.png" alt="Terminal UI"><br><b>Terminal UI</b></td>
|
|
|
+ <td align="center" width="25%"><img src="docs/06-permission-security.png" alt="Permissions and security"><br><b>Permissions and security</b></td>
|
|
|
+ <td align="center" width="25%"><img src="docs/07-services-layer.png" alt="Services layer"><br><b>Services layer</b></td>
|
|
|
+ <td align="center" width="25%"><img src="docs/08-state-data-flow.png" alt="State and data flow"><br><b>State and data flow</b></td>
|
|
|
+ </tr>
|
|
|
+</table>
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## Quick Start
|
|
|
+
|
|
|
+### 1. Install Bun
|
|
|
+
|
|
|
+This project requires [Bun](https://bun.sh). If Bun is not installed on the target machine yet, use one of the following methods first:
|
|
|
+
|
|
|
+```bash
|
|
|
+# macOS / Linux (official install script)
|
|
|
+curl -fsSL https://bun.sh/install | bash
|
|
|
+```
|
|
|
+
|
|
|
+If a minimal Linux image reports `unzip is required to install bun`, install `unzip` first:
|
|
|
+
|
|
|
+```bash
|
|
|
+# Ubuntu / Debian
|
|
|
+apt update && apt install -y unzip
|
|
|
+```
|
|
|
+
|
|
|
+```bash
|
|
|
+# macOS (Homebrew)
|
|
|
+brew install bun
|
|
|
+```
|
|
|
+
|
|
|
+```powershell
|
|
|
+# Windows (PowerShell)
|
|
|
+powershell -c "irm bun.sh/install.ps1 | iex"
|
|
|
+```
|
|
|
+
|
|
|
+After installation, reopen the terminal and verify:
|
|
|
+
|
|
|
+```bash
|
|
|
+bun --version
|
|
|
+```
|
|
|
+
|
|
|
+### 2. Install project dependencies
|
|
|
+
|
|
|
+```bash
|
|
|
+bun install
|
|
|
+```
|
|
|
+
|
|
|
+### 3. Configure environment variables
|
|
|
+
|
|
|
+Copy the example file and fill in your API key:
|
|
|
+
|
|
|
+```bash
|
|
|
+cp .env.example .env
|
|
|
+```
|
|
|
+
|
|
|
+Edit `.env`:
|
|
|
+
|
|
|
+```env
|
|
|
+# API authentication (choose one)
|
|
|
+ANTHROPIC_API_KEY=sk-xxx # Standard API key via x-api-key header
|
|
|
+ANTHROPIC_AUTH_TOKEN=sk-xxx # Bearer token via Authorization header
|
|
|
+
|
|
|
+# API endpoint (optional, defaults to Anthropic)
|
|
|
+ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic
|
|
|
+
|
|
|
+# Model configuration
|
|
|
+ANTHROPIC_MODEL=MiniMax-M2.7-highspeed
|
|
|
+ANTHROPIC_DEFAULT_SONNET_MODEL=MiniMax-M2.7-highspeed
|
|
|
+ANTHROPIC_DEFAULT_HAIKU_MODEL=MiniMax-M2.7-highspeed
|
|
|
+ANTHROPIC_DEFAULT_OPUS_MODEL=MiniMax-M2.7-highspeed
|
|
|
+
|
|
|
+# Timeout in milliseconds
|
|
|
+API_TIMEOUT_MS=3000000
|
|
|
+
|
|
|
+# Disable telemetry and non-essential network traffic
|
|
|
+DISABLE_TELEMETRY=1
|
|
|
+CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
|
|
|
+```
|
|
|
+
|
|
|
+### 4. Start
|
|
|
+
|
|
|
+```bash
|
|
|
+# Interactive TUI mode (full interface)
|
|
|
+./bin/claude-haha
|
|
|
+
|
|
|
+# Headless mode (single prompt)
|
|
|
+./bin/claude-haha -p "your prompt here"
|
|
|
+
|
|
|
+# Pipe input
|
|
|
+echo "explain this code" | ./bin/claude-haha -p
|
|
|
+
|
|
|
+# Show all options
|
|
|
+./bin/claude-haha --help
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## Environment Variables
|
|
|
+
|
|
|
+| Variable | Required | Description |
|
|
|
+|------|------|------|
|
|
|
+| `ANTHROPIC_API_KEY` | One of two | API key sent via the `x-api-key` header |
|
|
|
+| `ANTHROPIC_AUTH_TOKEN` | One of two | Auth token sent via the `Authorization: Bearer` header |
|
|
|
+| `ANTHROPIC_BASE_URL` | No | Custom API endpoint, defaults to Anthropic |
|
|
|
+| `ANTHROPIC_MODEL` | No | Default model |
|
|
|
+| `ANTHROPIC_DEFAULT_SONNET_MODEL` | No | Sonnet-tier model mapping |
|
|
|
+| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | No | Haiku-tier model mapping |
|
|
|
+| `ANTHROPIC_DEFAULT_OPUS_MODEL` | No | Opus-tier model mapping |
|
|
|
+| `API_TIMEOUT_MS` | No | API request timeout, default `600000` (10min) |
|
|
|
+| `DISABLE_TELEMETRY` | No | Set to `1` to disable telemetry |
|
|
|
+| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | No | Set to `1` to disable non-essential network traffic |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## Fallback Mode
|
|
|
+
|
|
|
+If the full TUI has issues, use the simplified readline-based interaction mode:
|
|
|
+
|
|
|
+```bash
|
|
|
+CLAUDE_CODE_FORCE_RECOVERY_CLI=1 ./bin/claude-haha
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## Fixes Compared with the Original Leaked Source
|
|
|
+
|
|
|
+The leaked source could not run directly. This repository mainly fixes the following issues:
|
|
|
+
|
|
|
+| Issue | Root cause | Fix |
|
|
|
+|------|------|------|
|
|
|
+| TUI does not start | The entry script routed no-argument startup to the recovery CLI | Restored the full `cli.tsx` entry |
|
|
|
+| Startup hangs | The `verify` skill imports a missing `.md` file, causing Bun's text loader to hang indefinitely | Added stub `.md` files |
|
|
|
+| `--print` hangs | `filePersistence/types.ts` was missing | Added type stub files |
|
|
|
+| `--print` hangs | `ultraplan/prompt.txt` was missing | Added resource stub files |
|
|
|
+| **Enter key does nothing** | The `modifiers-napi` native package was missing, `isModifierPressed()` threw, `handleEnter` was interrupted, and `onSubmit` never ran | Added try/catch fault tolerance |
|
|
|
+| Setup was skipped | `preload.ts` automatically set `LOCAL_RECOVERY=1`, skipping all initialization | Removed the default setting |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## Project Structure
|
|
|
+
|
|
|
+```text
|
|
|
+bin/claude-haha # Entry script
|
|
|
+preload.ts # Bun preload (sets MACRO globals)
|
|
|
+.env.example # Environment variable template
|
|
|
+src/
|
|
|
+├── entrypoints/cli.tsx # Main CLI entry
|
|
|
+├── main.tsx # Main TUI logic (Commander.js + React/Ink)
|
|
|
+├── localRecoveryCli.ts # Fallback Recovery CLI
|
|
|
+├── setup.ts # Startup initialization
|
|
|
+├── screens/REPL.tsx # Interactive REPL screen
|
|
|
+├── ink/ # Ink terminal rendering engine
|
|
|
+├── components/ # UI components
|
|
|
+├── tools/ # Agent tools (Bash, Edit, Grep, etc.)
|
|
|
+├── commands/ # Slash commands (/commit, /review, etc.)
|
|
|
+├── skills/ # Skill system
|
|
|
+├── services/ # Service layer (API, MCP, OAuth, etc.)
|
|
|
+├── hooks/ # React hooks
|
|
|
+└── utils/ # Utility functions
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## Tech Stack
|
|
|
+
|
|
|
+| Category | Technology |
|
|
|
+|------|------|
|
|
|
+| Runtime | [Bun](https://bun.sh) |
|
|
|
+| Language | TypeScript |
|
|
|
+| Terminal UI | React + [Ink](https://github.com/vadimdemedes/ink) |
|
|
|
+| CLI parsing | Commander.js |
|
|
|
+| API | Anthropic SDK |
|
|
|
+| Protocols | MCP, LSP |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## Disclaimer
|
|
|
+
|
|
|
+This repository is based on the Claude Code source leaked from the Anthropic npm registry on 2026-03-31. All original source code copyrights belong to [Anthropic](https://www.anthropic.com). It is provided for learning and research purposes only.
|
程序员阿江-Relakkes