diff --git a/.github/workflows/pr-triage.yml b/.github/workflows/pr-triage.yml index 25b5ca35..ce787c29 100644 --- a/.github/workflows/pr-triage.yml +++ b/.github/workflows/pr-triage.yml @@ -59,7 +59,7 @@ jobs: 'src/tools/', 'src/utils/', ] - const docsExact = new Set(['README.md', 'README.en.md', 'package.json', 'package-lock.json', '.github/workflows/deploy-docs.yml']) + const docsExact = new Set(['README.md', 'README.zh-CN.md', 'package.json', 'package-lock.json', '.github/workflows/deploy-docs.yml']) const releaseExact = new Set([ '.github/workflows/pr-quality.yml', '.github/workflows/pr-triage.yml', diff --git a/README.en.md b/README.en.md deleted file mode 100644 index 2e91db83..00000000 --- a/README.en.md +++ /dev/null @@ -1,223 +0,0 @@ -# Claude Code Haha - -

- - - Claude Code Haha - -

- -
- -[![GitHub Stars](https://img.shields.io/github/stars/NanmiCoder/cc-haha?style=social)](https://github.com/NanmiCoder/cc-haha/stargazers) -[![GitHub Forks](https://img.shields.io/github/forks/NanmiCoder/cc-haha?style=social)](https://github.com/NanmiCoder/cc-haha/network/members) -[![GitHub Issues](https://img.shields.io/github/issues/NanmiCoder/cc-haha)](https://github.com/NanmiCoder/cc-haha/issues) -[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/NanmiCoder/cc-haha)](https://github.com/NanmiCoder/cc-haha/pulls) -[![License](https://img.shields.io/github/license/NanmiCoder/cc-haha)](https://github.com/NanmiCoder/cc-haha/blob/main/LICENSE) -[![中文](https://img.shields.io/badge/🇨🇳_中文-Available-green)](README.md) -[![English](https://img.shields.io/badge/🇺🇸_English-当前-blue)](README.en.md) -[![Docs](https://img.shields.io/badge/📖_Documentation-Visit-FF7A00)](https://cchaha.ai) - -
- -A Claude Code build repaired from the source leaked from Anthropic's npm registry on 2026-03-31. Claude Code Haha is now primarily a **desktop Claude Code workspace** for macOS, Windows, and Linux: sessions, projects, branch / Worktree launch, workspace changes and diff review, permission approval, model setup, Computer Use, H5 remote access, IM integration, and scheduled tasks in one app. - -

- Desktop Preview · Install · Highlights · More Docs · Sponsorship · User Group -

- ---- - -## Desktop Preview - -The Claude Code Haha desktop app brings sessions, multi-project navigation, branch / Worktree controls, file changes, diff review, permission approval, model setup, and remote access into one graphical workspace for daily development beyond the terminal. - -v0.5.0 shipped a full UI redesign — six colour themes that can follow your system's light/dark setting. All six shots below are from a real v0.5.0 build. - -

- Download Desktop -   - Install Guide -

- - - - - - - - - - - - -
Desktop session view
Say it once, watch it finish
Tool calls and every edit stay in the thread		Workspace diff review
See exactly what changed
Syntax-highlighted diffs; you decide what lands		Built-in browser previewing the page that was just changed
Verify on the spot
Open your dev server inside the app
Session view in the dark theme
Six themes, follows the system
Light and dark, six palettes in all		Skill marketplace
Missing a trick? Install it
Source and safety status shown up front		Desktop pet settings with the floating pet
Company while it works
Dada, Huhu, Bubu and Huihui follow the task
- ---- - -## Install the Desktop App - -1. Download the macOS / Windows / Linux desktop installer from [Releases](https://github.com/NanmiCoder/cc-haha/releases). -2. On first launch, configure your model provider, API key, and default model in Settings. -3. Public macOS releases require signing and notarization. Draft or unsigned temporary builds may still need one-time manual approval. Unsigned Windows installers may show SmartScreen; click "More info" -> "Run anyway". See the [desktop installation guide](docs/en/start/install.md). - -## Run the CLI from Source - -For users who want to debug the underlying CLI, server, or local development flow: - -```bash -bun install -cp .env.example .env -./bin/claude-haha -``` - -See [environment variables](docs/en/cli/env.md) and [CLI setup](docs/en/cli/index.md) for more configuration options. - ---- - -## Desktop Highlights - -- **Multi-session workspace**: tabs, project switching, terminal entry, and session history in one place, with a resizable sidebar. -- **Branch / Worktree launch**: choose a repository branch and decide whether to use the current working tree or an isolated Worktree. -- **Review edits file by file**: the workspace lists this turn's changes; open any file for a syntax-highlighted diff, or undo the whole turn. -- **Five permission modes**: from "ask every time" to "skip permissions" — risky commands, tool calls, and follow-up questions are all approved in the GUI. -- **Bring your own model**: sign in to Claude, ChatGPT, or Grok; use presets for DeepSeek, Kimi, Zhipu GLM and others; or point it at LM Studio and Ollama running locally. -- **Six colour themes**: white, paper, warm classic, celadon, ink night, and ink blue — optionally following your system's light/dark setting. -- **Skill marketplace**: discover, preview, and install third-party skills from ClawHub / SkillHub, with source and safety status shown up front. -- **Session activity panel**: track task progress, background tasks, SubAgents, and sources in one side panel. -- **Computer Use**: let the agent take screenshots, click, type, and control desktop apps after authorization. -- **Desktop pets**: Dada, Huhu, Bubu, and Huihui change what they do with the task at hand — or raise one of your own (off by default). -- **H5 remote access**: scan a QR code to continue the session in your phone browser; locking the screen won't kill a running task. -- **IM integration**: chat, switch projects, and approve actions through Telegram / Feishu / WeChat / DingTalk / WhatsApp. -- **Scheduled tasks and usage stats**: run planned tasks in their own sessions and track local token usage trends. - ---- - -## More Documentation - -Full documentation site: - -| Section | Documents | -|------|------| -| **Getting started** | [What this is](docs/en/start/index.md) · [Download and install](docs/en/start/install.md) · [Connect a model provider](docs/en/start/models.md) · [Your first session](docs/en/start/first-session.md) · [Troubleshooting](docs/en/start/troubleshooting.md) | -| **Desktop features** | [Feature overview](docs/en/desktop/index.md) · [Computer Use](docs/en/desktop/computer-use.md) · [Desktop pets](docs/en/desktop/pets.md) · [Phone H5 and IM relay](docs/en/desktop/remote.md) | -| **IM integrations** | [Overview and pairing](docs/en/im/index.md) · [Feishu](docs/en/im/feishu.md) · [Telegram](docs/en/im/telegram.md) · [WeChat](docs/en/im/wechat.md) · [DingTalk](docs/en/im/dingtalk.md) · [WhatsApp](docs/en/im/whatsapp.md) | -| **CLI** | [Install and run](docs/en/cli/index.md) · [Command reference](docs/en/cli/reference.md) · [Environment variables](docs/en/cli/env.md) | -| **Internals** | [Multi-agent system](docs/en/internals/agent.md) · [Skills system](docs/en/internals/skills.md) · [Memory system](docs/en/internals/memory.md) · [Computer Use architecture](docs/en/internals/computer-use.md) · [Local server and API](docs/en/internals/server.md) · [Channel system](docs/en/internals/channel.md) · [Project structure](docs/en/internals/structure.md) · [Contributing and quality gates](docs/en/internals/contributing.md) | - ---- - -## Sponsorship & Partnership - -This project is maintained in the author's spare time. Corporate or individual sponsorships are welcome to support ongoing development. Custom features, integrations, and business partnerships are also open for discussion. - - - - - - - - - - - - - - - - - - -
SponsorDescription
- - ShengSuanYun - - - Thanks to ShengSuanYun for sponsoring this project. ShengSuanYun is an industrial-grade AI task parallel execution platform for AI Native Teams, aggregating Claude, ChatGPT, Gemini, and other LLM, image, and video model capacity through direct, non-reverse-engineered access. Its platform SLA reaches 99.7%, with service status available online. It also supports dedicated enterprise gateways, cost and permission controls, smart routing, security protection, BYOK, usage-based billing, upcoming tokens plans, and invoicing. New users registering through this link can receive 10 yuan in model credits plus a 10% first top-up bonus. -
- - TeamoRouter - - - Thanks to TeamoRouter for sponsoring this project. TeamoRouter is an enterprise-grade Agentic LLM gateway for developers, AI teams, and businesses. Without any subscription, it lets you use Claude Code, Codex, Gemini CLI, and other popular AI agents through a single unified API, with API pricing at discounts of up to 90%. It aggregates hundreds of official model providers and trusted infrastructure partners — including OpenAI, Anthropic, Vertex, Azure, and AWS Bedrock — each verified for 100% Agent protocol compatibility, cache performance, and request traceability, delivering near-official TTFT, a 99.6% SLA, throughput up to 5,000 QPM, and industry-leading cache hit rates rather than reverse-engineered endpoints. It also offers centralized billing, team management, BYOK, smart routing, usage analytics, and dedicated support, and Teamo Desktop lets you use these AI agents with one-click setup. New users who register through this link receive 10% off their first top-up. -
- -📧 **Contact**: relakkes@gmail.com - ---- - -## User Group - -Scan the QR code below to join the cc-haha user group on Feishu (Lark) — the conversation there is mostly in Chinese. For questions and bug reports in English, [Issues](https://github.com/NanmiCoder/cc-haha/issues) is the better place. - -

- cc-haha Feishu user group QR code -

- ---- - -## ☕ Buy Me a Coffee - -If this project helps you, consider buying me a coffee — every bit of support keeps this project going ❤️ - - - - - - - -
-WeChat Pay
-WeChat Pay -		 -Alipay
-Alipay -		 - -Buy Me a Coffee -
-Buy Me a Coffee -
- ---- - -## Tech Stack - -| Category | Technology | -|------|------| -| Language | TypeScript | -| Desktop app | Electron | -| Desktop UI | React + Vite | -| Local runtime | [Bun](https://bun.sh) | -| Terminal UI | React + [Ink](https://github.com/vadimdemedes/ink) | -| CLI parsing | Commander.js | -| API | Anthropic SDK | -| Protocols | MCP, LSP | - -## Thanks - -Thanks to the following open-source projects and community practices for reference and inspiration: - -- [React](https://github.com/facebook/react): frontend engineering and component-based UI ecosystem. -- [Electron](https://github.com/electron/electron): cross-platform desktop app capabilities and engineering practices. -- [cc-switch](https://github.com/farion1231/cc-switch): reference for model provider configuration. - ---- - -## ⭐ Star History - -If this project helps you, please support it with a ⭐ Star so more people can discover Claude Code Haha. - - - - - - Star History Chart - - - ---- - -## 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. diff --git a/README.md b/README.md index beb38f29..eaecaa12 100644 --- a/README.md +++ b/README.md @@ -13,57 +13,59 @@ [![GitHub Forks](https://img.shields.io/github/forks/NanmiCoder/cc-haha?style=social)](https://github.com/NanmiCoder/cc-haha/network/members) [![GitHub Issues](https://img.shields.io/github/issues/NanmiCoder/cc-haha)](https://github.com/NanmiCoder/cc-haha/issues) [![GitHub Pull Requests](https://img.shields.io/github/issues-pr/NanmiCoder/cc-haha)](https://github.com/NanmiCoder/cc-haha/pulls) -[![License](https://img.shields.io/github/license/NanmiCoder/cc-haha)](https://github.com/NanmiCoder/cc-haha/blob/main/LICENSE) -[![中文](https://img.shields.io/badge/🇨🇳_中文-当前-blue)](README.md) -[![English](https://img.shields.io/badge/🇺🇸_English-Available-green)](README.en.md) -[![Docs](https://img.shields.io/badge/📖_文档站点-Visit-FF7A00)](https://cchaha.ai) +[![License](https://img.shields.io/badge/License-MIT-blue)](https://github.com/NanmiCoder/cc-haha/blob/main/LICENSE) +[![English](https://img.shields.io/badge/🇺🇸_English-Current-blue)](README.md) +[![中文](https://img.shields.io/badge/🇨🇳_简体中文-Available-green)](README.zh-CN.md) +[![Docs](https://img.shields.io/badge/📖_Documentation-Visit-FF7A00)](https://cchaha.ai) + +**English** · [简体中文](README.zh-CN.md) -Claude Code Haha 基于 2026-03-31 从 Anthropic npm registry 泄露的 Claude Code 源码修复而来，现在主要是一个**桌面端 Claude Code 工作台**：把会话、多项目、分支 / Worktree、工作区改动与 Diff 审阅、权限审批、模型配置、Computer Use、H5 远程访问、IM 接入和定时任务集中到一个 macOS / Windows / Linux APP 里。 +Claude Code Haha is a **desktop Claude Code workspace** for macOS, Windows, and Linux: sessions, projects, branch / Worktree launch, workspace changes and diff review, permission approval, model setup, Computer Use, H5 remote access, IM integration, and scheduled tasks in one app.

- 桌面端预览 · 安装桌面端 · 桌面端亮点 · 更多文档 · 赞助与合作 · 用户交流群 + Desktop Preview · Install · Highlights · More Docs · Sponsorship · User Group

--- -## 桌面端预览 +## Desktop Preview -Claude Code Haha 的桌面端把会话、多项目、分支 / Worktree、代码改动、Diff 评审、权限确认、模型配置和远程入口收进一个图形化工作台，适合不想长期停留在终端里的日常开发。 +The Claude Code Haha desktop app brings sessions, multi-project navigation, branch / Worktree controls, file changes, diff review, permission approval, model setup, and remote access into one graphical workspace for daily development beyond the terminal. -v0.5.0 做了一次全量 UI 重设计（「纸·墨·印」），六套配色可跟随系统深浅色切换。下面六张都拍自 v0.5.0 真机。 +v0.5.0 shipped a full UI redesign — six colour themes that can follow your system's light/dark setting. All six shots below are from a real v0.5.0 build.

- 下载桌面端 + Download Desktop   - 安装指南 + Install Guide

- - - + + + - - - + + +
桌面端会话主界面
说一句话，看它做完
工具调用和每处改动都留在对话里		工作区 Diff 评审
改了什么，逐个文件看
带语法高亮的 Diff，你点头才落地		内置浏览器预览刚改完的页面
改完当场验证
内置浏览器打开本地服务看效果		Desktop session view
Say it once, watch it finish
Tool calls and every edit stay in the thread		Workspace diff review
See exactly what changed
Syntax-highlighted diffs; you decide what lands		Built-in browser previewing the page that was just changed
Verify on the spot
Open your dev server inside the app
墨夜主题下的会话界面
六套配色可跟随系统
纯白 · 纸墨 · 经典暖色 · 青瓷 · 墨夜 · 墨夜蓝		技能市场
缺什么手艺装什么
来源和安全状态摆在明处		桌面宠物设置与悬浮宠物
桌面上有个伴
搭搭、弧弧、补补、回回随任务换动作		Session view in the dark theme
Six themes, follows the system
Light and dark, six palettes in all		Skill marketplace
Missing a trick? Install it
Source and safety status shown up front		Desktop pet settings with the floating pet
Company while it works
Dada, Huhu, Bubu and Huihui follow the task
--- -## 安装桌面端 +## Install the Desktop App -1. 前往 [Releases](https://github.com/NanmiCoder/cc-haha/releases) 下载 macOS / Windows / Linux 桌面端安装包。 -2. 首次启动后，在桌面端设置里配置模型提供商、API Key 和默认模型。 -3. 正式 macOS Release 需要经过签名和公证；如果安装的是 draft/unsigned 临时包，首次打开可能仍需手动放行。Windows 未签名安装包可能出现 SmartScreen 提示，点「更多信息」→「仍要运行」即可。详见 [桌面端安装指南](docs/start/install.md)。 +1. Download the macOS / Windows / Linux desktop installer from [Releases](https://github.com/NanmiCoder/cc-haha/releases). +2. On first launch, configure your model provider, API key, and default model in Settings. +3. Public macOS releases require signing and notarization. Draft or unsigned temporary builds may still need one-time manual approval. Unsigned Windows installers may show SmartScreen; click "More info" -> "Run anyway". See the [desktop installation guide](docs/en/start/install.md). -## 从源码启动 CLI +## Run the CLI from Source -适合想调试底层 CLI、服务端或自行开发的用户： +For users who want to debug the underlying CLI, server, or local development flow: ```bash bun install @@ -71,62 +73,62 @@ cp .env.example .env ./bin/claude-haha ``` -更多配置见 [环境变量](docs/cli/env.md) 和 [命令行安装与启动](docs/cli/index.md)。 +See [environment variables](docs/en/cli/env.md) and [CLI setup](docs/en/cli/index.md) for more configuration options. --- -## 桌面端亮点 +## Desktop Highlights -- **多会话工作台**：标签页、项目切换、终端入口和会话历史集中管理，侧边栏宽度可拖拽。 -- **分支 / Worktree 启动**：新会话可以选择仓库分支，并决定用当前工作树还是隔离 Worktree。 -- **改动逐个文件审阅**：右侧工作区列出本轮改动，点开就是带语法高亮的 Diff，整轮可撤销。 -- **五档权限模式**：从「询问权限」到「跳过权限」，危险命令、工具调用和 AI 反问都在桌面端审批。 -- **模型自选**：Claude / ChatGPT / Grok 官方账号可直接登录；DeepSeek、Kimi、智谱 GLM 等第三方 API 有现成预设；LM Studio、Ollama 的本地模型也接得上。 -- **六套配色主题**：纯白、纸墨、经典暖色、青瓷、墨夜、墨夜蓝，可跟随系统深浅色自动切换。 -- **技能市场**：发现、预览、安装 ClawHub / SkillHub 的第三方技能，来源和安全状态摆在明处。 -- **会话活动面板**：集中查看任务进度、后台任务、SubAgent 与来源。 -- **Computer Use**：让 Agent 在授权后截图、点击、输入并控制桌面应用。 -- **桌面宠物**：搭搭、弧弧、补补、回回随任务状态换动作，也能自己做一只（默认关闭）。 -- **H5 远程访问**：扫码用手机浏览器接入当前会话，锁屏切后台都不打断正在跑的任务。 -- **IM 接入**：通过 Telegram / 飞书 / 微信 / 钉钉 / WhatsApp 远程对话、切换项目和审批权限。 -- **定时任务与用量统计**：创建计划任务在独立会话执行，并查看本机 Token 使用趋势。 +- **Multi-session workspace**: tabs, project switching, terminal entry, and session history in one place, with a resizable sidebar. +- **Branch / Worktree launch**: choose a repository branch and decide whether to use the current working tree or an isolated Worktree. +- **Review edits file by file**: the workspace lists this turn's changes; open any file for a syntax-highlighted diff, or undo the whole turn. +- **Five permission modes**: from "ask every time" to "skip permissions" — risky commands, tool calls, and follow-up questions are all approved in the GUI. +- **Bring your own model**: sign in to Claude, ChatGPT, or Grok; use presets for DeepSeek, Kimi, Zhipu GLM and others; or point it at LM Studio and Ollama running locally. +- **Six colour themes**: white, paper, warm classic, celadon, ink night, and ink blue — optionally following your system's light/dark setting. +- **Skill marketplace**: discover, preview, and install third-party skills from ClawHub / SkillHub, with source and safety status shown up front. +- **Session activity panel**: track task progress, background tasks, SubAgents, and sources in one side panel. +- **Computer Use**: let the agent take screenshots, click, type, and control desktop apps after authorization. +- **Desktop pets**: Dada, Huhu, Bubu, and Huihui change what they do with the task at hand — or raise one of your own (off by default). +- **H5 remote access**: scan a QR code to continue the session in your phone browser; locking the screen won't kill a running task. +- **IM integration**: chat, switch projects, and approve actions through Telegram / Feishu / WeChat / DingTalk / WhatsApp. +- **Scheduled tasks and usage stats**: run planned tasks in their own sessions and track local token usage trends. --- -## 更多文档 +## More Documentation -完整文档站： +Full documentation site: -| 分区 | 文档 | +| Section | Documents | |------|------| -| **开始使用** | [这是什么](docs/start/index.md) · [下载与安装](docs/start/install.md) · [连接模型服务](docs/start/models.md) · [跑通第一条会话](docs/start/first-session.md) · [故障排查](docs/start/troubleshooting.md) | -| **桌面端功能** | [功能总览](docs/desktop/index.md) · [Computer Use](docs/desktop/computer-use.md) · [桌面宠物](docs/desktop/pets.md) · [手机 H5 与 IM 接力](docs/desktop/remote.md) | -| **IM 接入** | [总览与配对流程](docs/im/index.md) · [飞书](docs/im/feishu.md) · [Telegram](docs/im/telegram.md) · [微信](docs/im/wechat.md) · [钉钉](docs/im/dingtalk.md) · [WhatsApp](docs/im/whatsapp.md) | -| **命令行** | [安装与启动](docs/cli/index.md) · [命令参考](docs/cli/reference.md) · [环境变量](docs/cli/env.md) | -| **深入原理** | [桌面端架构](docs/internals/desktop.md) · [多 Agent 系统](docs/internals/agent.md) · [Skills 系统](docs/internals/skills.md) · [记忆系统](docs/internals/memory.md) · [Computer Use 架构](docs/internals/computer-use.md) · [本地 Server 与 API](docs/internals/server.md) · [Channel 系统](docs/internals/channel.md) · [项目结构](docs/internals/structure.md) · [参与贡献与质量门禁](docs/internals/contributing.md) | +| **Getting started** | [What this is](docs/en/start/index.md) · [Download and install](docs/en/start/install.md) · [Connect a model provider](docs/en/start/models.md) · [Your first session](docs/en/start/first-session.md) · [Troubleshooting](docs/en/start/troubleshooting.md) | +| **Desktop features** | [Feature overview](docs/en/desktop/index.md) · [Computer Use](docs/en/desktop/computer-use.md) · [Desktop pets](docs/en/desktop/pets.md) · [Phone H5 and IM relay](docs/en/desktop/remote.md) | +| **IM integrations** | [Overview and pairing](docs/en/im/index.md) · [Feishu](docs/en/im/feishu.md) · [Telegram](docs/en/im/telegram.md) · [WeChat](docs/en/im/wechat.md) · [DingTalk](docs/en/im/dingtalk.md) · [WhatsApp](docs/en/im/whatsapp.md) | +| **CLI** | [Install and run](docs/en/cli/index.md) · [Command reference](docs/en/cli/reference.md) · [Environment variables](docs/en/cli/env.md) | +| **Internals** | [Desktop architecture](docs/en/internals/desktop.md) · [Multi-agent system](docs/en/internals/agent.md) · [Skills system](docs/en/internals/skills.md) · [Memory system](docs/en/internals/memory.md) · [Computer Use architecture](docs/en/internals/computer-use.md) · [Local server and API](docs/en/internals/server.md) · [Channel system](docs/en/internals/channel.md) · [Project structure](docs/en/internals/structure.md) · [Contributing and quality gates](docs/en/internals/contributing.md) | --- -## 赞助与合作 +## Sponsorship & Partnership -本项目由个人利用业余时间维护，欢迎企业或个人赞助支持持续开发，也可洽谈定制、集成或商务合作。 +This project is maintained in the author's spare time. Corporate or individual sponsorships are welcome to support ongoing development. Custom features, integrations, and business partnerships are also open for discussion. - - + + @@ -136,39 +138,39 @@ cp .env.example .env
赞助商介绍SponsorDescription
- 胜算云 + ShengSuanYun - 感谢 胜算云 赞助本项目！胜算云是面向 AI Native Teams 的工业级 AI 任务并行执行平台，聚合 Claude、ChatGPT、Gemini 等海内外 LLM 及图片、视频多媒体模型算力；官方直连、非逆向，平台 SLA 可用性达 99.7%，可查看 服务状态。平台支持企业专属网关、成本与权限管控、智能路由、安全防护和 BYOK，按量与 tokens plan（即将上线）计费并可开票；使用 专属链接 注册可获 10 元模力及首充 10% 赠送。 + Thanks to ShengSuanYun for sponsoring this project. ShengSuanYun is an industrial-grade AI task parallel execution platform for AI Native Teams, aggregating Claude, ChatGPT, Gemini, and other LLM, image, and video model capacity through direct, non-reverse-engineered access. Its platform SLA reaches 99.7%, with service status available online. It also supports dedicated enterprise gateways, cost and permission controls, smart routing, security protection, BYOK, usage-based billing, upcoming tokens plans, and invoicing. New users registering through this link can receive 10 yuan in model credits plus a 10% first top-up bonus.
- 感谢 TeamoRouter 赞助本项目！TeamoRouter 是面向开发者、AI 团队与企业的企业级 Agentic LLM 网关，无需任何订阅即可通过统一 API 使用 Claude Code、Codex、Gemini CLI 等热门 AI Agent，API 价格最高可享 90% 折扣。平台聚合 OpenAI、Anthropic、Vertex、Azure、AWS Bedrock 等数百家官方模型提供商与可信基础设施，全部经过 100% Agent 协议兼容、缓存性能与请求可追踪性验证，官方直连、非逆向，提供接近官方的 TTFT、99.6% SLA、最高 5,000 QPM 吞吐与行业领先的缓存命中率；同时支持集中账单、团队管理、BYOK、智能路由、用量分析与专属支持，并可通过 Teamo Desktop 一键使用各类 AI Agent。新用户通过 专属链接 注册，首次充值可享 10% 折扣。 + Thanks to TeamoRouter for sponsoring this project. TeamoRouter is an enterprise-grade Agentic LLM gateway for developers, AI teams, and businesses. Without any subscription, it lets you use Claude Code, Codex, Gemini CLI, and other popular AI agents through a single unified API, with API pricing at discounts of up to 90%. It aggregates hundreds of official model providers and trusted infrastructure partners — including OpenAI, Anthropic, Vertex, Azure, and AWS Bedrock — each verified for 100% Agent protocol compatibility, cache performance, and request traceability, delivering near-official TTFT, a 99.6% SLA, throughput up to 5,000 QPM, and industry-leading cache hit rates rather than reverse-engineered endpoints. It also offers centralized billing, team management, BYOK, smart routing, usage analytics, and dedicated support, and Teamo Desktop lets you use these AI agents with one-click setup. New users who register through this link receive 10% off their first top-up.
-📧 **联系邮箱**：relakkes@gmail.com +📧 **Contact**: relakkes@gmail.com --- -## 用户交流群 +## User Group -使用过程中有问题、想反馈 Bug，或者想看看别人怎么用，欢迎扫码加入 cc-haha 飞书用户群。也可以直接来 [Issues](https://github.com/NanmiCoder/cc-haha/issues) 提问。 +Scan the QR code below to join the cc-haha user group on Feishu (Lark) — the conversation there is mostly in Chinese. For questions and bug reports in English, [Issues](https://github.com/NanmiCoder/cc-haha/issues) is the better place.

- cc-haha 飞书用户群二维码 + cc-haha Feishu user group QR code

--- -## ☕ 请作者喝杯咖啡 +## ☕ Buy Me a Coffee -如果这个项目对您有帮助，欢迎打赏支持，您的每一份支持都是我持续更新的动力 ❤️ +If this project helps you, consider buying me a coffee — every bit of support keeps this project going ❤️
-微信赞赏
-微信赞赏 +WeChat Pay
+WeChat Pay 		-支付宝
-支付宝 +Alipay
+Alipay 		@@ -181,32 +183,37 @@ cp .env.example .env --- -## 技术栈 +## Tech Stack -| 类别 | 技术 | +| Category | Technology | |------|------| -| 语言 | TypeScript | -| 桌面 APP | Electron | -| 桌面 UI | React + Vite | -| 本地运行时 | [Bun](https://bun.sh) | -| 终端 UI | React + [Ink](https://github.com/vadimdemedes/ink) | -| CLI 解析 | Commander.js | +| Language | TypeScript | +| Desktop app | Electron | +| Desktop UI | React + Vite | +| Local runtime | [Bun](https://bun.sh) | +| Terminal UI | React + [Ink](https://github.com/vadimdemedes/ink) | +| CLI parsing | Commander.js | | API | Anthropic SDK | -| 协议 | MCP, LSP | - -## 感谢 - -感谢以下开源项目和社区实践为本项目提供参考与启发： - -- [React](https://github.com/facebook/react)：前端工程与组件化 UI 生态。 -- [Electron](https://github.com/electron/electron)：跨端桌面应用能力与工程实践。 -- [cc-switch](https://github.com/farion1231/cc-switch)：模型供应商配置能力参考。 +| Protocols | MCP, LSP | +## Thanks +Thanks to the following open-source projects and community practices for reference and inspiration: +- [React](https://github.com/facebook/react): frontend engineering and component-based UI ecosystem. +- [Electron](https://github.com/electron/electron): cross-platform desktop app capabilities and engineering practices. +- [cc-switch](https://github.com/farion1231/cc-switch): reference for model provider configuration. --- -## Disclaimer +## ⭐ Star History -本仓库基于 2026-03-31 从 Anthropic npm registry 泄露的 Claude Code 源码。所有原始源码版权归 [Anthropic](https://www.anthropic.com) 所有。仅供学习和研究用途。 +If this project helps you, please support it with a ⭐ Star so more people can discover Claude Code Haha. + + + + + + Star History Chart + + diff --git a/README.zh-CN.md b/README.zh-CN.md new file mode 100644 index 00000000..f7dd561f --- /dev/null +++ b/README.zh-CN.md @@ -0,0 +1,219 @@ +# Claude Code Haha + +

+ + + Claude Code Haha + +

+ +
+ +[![GitHub Stars](https://img.shields.io/github/stars/NanmiCoder/cc-haha?style=social)](https://github.com/NanmiCoder/cc-haha/stargazers) +[![GitHub Forks](https://img.shields.io/github/forks/NanmiCoder/cc-haha?style=social)](https://github.com/NanmiCoder/cc-haha/network/members) +[![GitHub Issues](https://img.shields.io/github/issues/NanmiCoder/cc-haha)](https://github.com/NanmiCoder/cc-haha/issues) +[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/NanmiCoder/cc-haha)](https://github.com/NanmiCoder/cc-haha/pulls) +[![License](https://img.shields.io/badge/License-MIT-blue)](https://github.com/NanmiCoder/cc-haha/blob/main/LICENSE) +[![中文](https://img.shields.io/badge/🇨🇳_简体中文-当前-blue)](README.zh-CN.md) +[![English](https://img.shields.io/badge/🇺🇸_English-Available-green)](README.md) +[![Docs](https://img.shields.io/badge/📖_文档站点-Visit-FF7A00)](https://cchaha.ai) + +[English](README.md) · **简体中文** + +
+ +Claude Code Haha 是一个**桌面端 Claude Code 工作台**：把会话、多项目、分支 / Worktree、工作区改动与 Diff 审阅、权限审批、模型配置、Computer Use、H5 远程访问、IM 接入和定时任务集中到一个 macOS / Windows / Linux APP 里。 + +

+ 桌面端预览 · 安装桌面端 · 桌面端亮点 · 更多文档 · 赞助与合作 · 用户交流群 +

+ +--- + +## 桌面端预览 + +Claude Code Haha 的桌面端把会话、多项目、分支 / Worktree、代码改动、Diff 评审、权限确认、模型配置和远程入口收进一个图形化工作台，适合不想长期停留在终端里的日常开发。 + +v0.5.0 做了一次全量 UI 重设计（「纸·墨·印」），六套配色可跟随系统深浅色切换。下面六张都拍自 v0.5.0 真机。 + +

+ 下载桌面端 +   + 安装指南 +

+ + + + + + + + + + + + +
桌面端会话主界面
说一句话，看它做完
工具调用和每处改动都留在对话里		工作区 Diff 评审
改了什么，逐个文件看
带语法高亮的 Diff，你点头才落地		内置浏览器预览刚改完的页面
改完当场验证
内置浏览器打开本地服务看效果
墨夜主题下的会话界面
六套配色可跟随系统
纯白 · 纸墨 · 经典暖色 · 青瓷 · 墨夜 · 墨夜蓝		技能市场
缺什么手艺装什么
来源和安全状态摆在明处		桌面宠物设置与悬浮宠物
桌面上有个伴
搭搭、弧弧、补补、回回随任务换动作
+ +--- + +## 安装桌面端 + +1. 前往 [Releases](https://github.com/NanmiCoder/cc-haha/releases) 下载 macOS / Windows / Linux 桌面端安装包。 +2. 首次启动后，在桌面端设置里配置模型提供商、API Key 和默认模型。 +3. 正式 macOS Release 需要经过签名和公证；如果安装的是 draft/unsigned 临时包，首次打开可能仍需手动放行。Windows 未签名安装包可能出现 SmartScreen 提示，点「更多信息」→「仍要运行」即可。详见 [桌面端安装指南](docs/start/install.md)。 + +## 从源码启动 CLI + +适合想调试底层 CLI、服务端或自行开发的用户： + +```bash +bun install +cp .env.example .env +./bin/claude-haha +``` + +更多配置见 [环境变量](docs/cli/env.md) 和 [命令行安装与启动](docs/cli/index.md)。 + +--- + +## 桌面端亮点 + +- **多会话工作台**：标签页、项目切换、终端入口和会话历史集中管理，侧边栏宽度可拖拽。 +- **分支 / Worktree 启动**：新会话可以选择仓库分支，并决定用当前工作树还是隔离 Worktree。 +- **改动逐个文件审阅**：右侧工作区列出本轮改动，点开就是带语法高亮的 Diff，整轮可撤销。 +- **五档权限模式**：从「询问权限」到「跳过权限」，危险命令、工具调用和 AI 反问都在桌面端审批。 +- **模型自选**：Claude / ChatGPT / Grok 官方账号可直接登录；DeepSeek、Kimi、智谱 GLM 等第三方 API 有现成预设；LM Studio、Ollama 的本地模型也接得上。 +- **六套配色主题**：纯白、纸墨、经典暖色、青瓷、墨夜、墨夜蓝，可跟随系统深浅色自动切换。 +- **技能市场**：发现、预览、安装 ClawHub / SkillHub 的第三方技能，来源和安全状态摆在明处。 +- **会话活动面板**：集中查看任务进度、后台任务、SubAgent 与来源。 +- **Computer Use**：让 Agent 在授权后截图、点击、输入并控制桌面应用。 +- **桌面宠物**：搭搭、弧弧、补补、回回随任务状态换动作，也能自己做一只（默认关闭）。 +- **H5 远程访问**：扫码用手机浏览器接入当前会话，锁屏切后台都不打断正在跑的任务。 +- **IM 接入**：通过 Telegram / 飞书 / 微信 / 钉钉 / WhatsApp 远程对话、切换项目和审批权限。 +- **定时任务与用量统计**：创建计划任务在独立会话执行，并查看本机 Token 使用趋势。 + +--- + +## 更多文档 + +完整文档站： + +| 分区 | 文档 | +|------|------| +| **开始使用** | [这是什么](docs/start/index.md) · [下载与安装](docs/start/install.md) · [连接模型服务](docs/start/models.md) · [跑通第一条会话](docs/start/first-session.md) · [故障排查](docs/start/troubleshooting.md) | +| **桌面端功能** | [功能总览](docs/desktop/index.md) · [Computer Use](docs/desktop/computer-use.md) · [桌面宠物](docs/desktop/pets.md) · [手机 H5 与 IM 接力](docs/desktop/remote.md) | +| **IM 接入** | [总览与配对流程](docs/im/index.md) · [飞书](docs/im/feishu.md) · [Telegram](docs/im/telegram.md) · [微信](docs/im/wechat.md) · [钉钉](docs/im/dingtalk.md) · [WhatsApp](docs/im/whatsapp.md) | +| **命令行** | [安装与启动](docs/cli/index.md) · [命令参考](docs/cli/reference.md) · [环境变量](docs/cli/env.md) | +| **深入原理** | [桌面端架构](docs/internals/desktop.md) · [多 Agent 系统](docs/internals/agent.md) · [Skills 系统](docs/internals/skills.md) · [记忆系统](docs/internals/memory.md) · [Computer Use 架构](docs/internals/computer-use.md) · [本地 Server 与 API](docs/internals/server.md) · [Channel 系统](docs/internals/channel.md) · [项目结构](docs/internals/structure.md) · [参与贡献与质量门禁](docs/internals/contributing.md) | + +--- + +## 赞助与合作 + +本项目由个人利用业余时间维护，欢迎企业或个人赞助支持持续开发，也可洽谈定制、集成或商务合作。 + + + + + + + + + + + + + + + + + + +
赞助商介绍
+ + 胜算云 + + + 感谢 胜算云 赞助本项目！胜算云是面向 AI Native Teams 的工业级 AI 任务并行执行平台，聚合 Claude、ChatGPT、Gemini 等海内外 LLM 及图片、视频多媒体模型算力；官方直连、非逆向，平台 SLA 可用性达 99.7%，可查看 服务状态。平台支持企业专属网关、成本与权限管控、智能路由、安全防护和 BYOK，按量与 tokens plan（即将上线）计费并可开票；使用 专属链接 注册可获 10 元模力及首充 10% 赠送。 +
+ + TeamoRouter + + + 感谢 TeamoRouter 赞助本项目！TeamoRouter 是面向开发者、AI 团队与企业的企业级 Agentic LLM 网关，无需任何订阅即可通过统一 API 使用 Claude Code、Codex、Gemini CLI 等热门 AI Agent，API 价格最高可享 90% 折扣。平台聚合 OpenAI、Anthropic、Vertex、Azure、AWS Bedrock 等数百家官方模型提供商与可信基础设施，全部经过 100% Agent 协议兼容、缓存性能与请求可追踪性验证，官方直连、非逆向，提供接近官方的 TTFT、99.6% SLA、最高 5,000 QPM 吞吐与行业领先的缓存命中率；同时支持集中账单、团队管理、BYOK、智能路由、用量分析与专属支持，并可通过 Teamo Desktop 一键使用各类 AI Agent。新用户通过 专属链接 注册，首次充值可享 10% 折扣。 +
+ +📧 **联系邮箱**：relakkes@gmail.com + +--- + +## 用户交流群 + +使用过程中有问题、想反馈 Bug，或者想看看别人怎么用，欢迎扫码加入 cc-haha 飞书用户群。也可以直接来 [Issues](https://github.com/NanmiCoder/cc-haha/issues) 提问。 + +

+ cc-haha 飞书用户群二维码 +

+ +--- + +## ☕ 请作者喝杯咖啡 + +如果这个项目对您有帮助，欢迎打赏支持，您的每一份支持都是我持续更新的动力 ❤️ + + + + + + + +
+微信赞赏
+微信赞赏 +		 +支付宝
+支付宝 +		 + +Buy Me a Coffee +
+Buy Me a Coffee +
+ +--- + +## 技术栈 + +| 类别 | 技术 | +|------|------| +| 语言 | TypeScript | +| 桌面 APP | Electron | +| 桌面 UI | React + Vite | +| 本地运行时 | [Bun](https://bun.sh) | +| 终端 UI | React + [Ink](https://github.com/vadimdemedes/ink) | +| CLI 解析 | Commander.js | +| API | Anthropic SDK | +| 协议 | MCP, LSP | + +## 感谢 + +感谢以下开源项目和社区实践为本项目提供参考与启发： + +- [React](https://github.com/facebook/react)：前端工程与组件化 UI 生态。 +- [Electron](https://github.com/electron/electron)：跨端桌面应用能力与工程实践。 +- [cc-switch](https://github.com/farion1231/cc-switch)：模型供应商配置能力参考。 + +--- + +## ⭐ Star History + +如果这个项目对你有帮助，欢迎点一个 ⭐ Star，让更多人发现 Claude Code Haha。 + + + + + + Star History Chart + + diff --git a/scripts/pr/change-policy.test.ts b/scripts/pr/change-policy.test.ts index f2952930..9ff980f2 100644 --- a/scripts/pr/change-policy.test.ts +++ b/scripts/pr/change-policy.test.ts @@ -35,6 +35,7 @@ describe('evaluateChangePolicy', () => { 'docs/index.md', 'site/src/App.tsx', 'README.md', + 'README.zh-CN.md', ]) expect(result.blocked).toBe(false) diff --git a/scripts/pr/change-policy.ts b/scripts/pr/change-policy.ts index 2c8a9f12..cd669432 100644 --- a/scripts/pr/change-policy.ts +++ b/scripts/pr/change-policy.ts @@ -144,7 +144,7 @@ const policyExactPaths = new Set([ const docsExactPaths = new Set([ 'README.md', - 'README.en.md', + 'README.zh-CN.md', 'package.json', 'package-lock.json', '.github/workflows/deploy-docs.yml',