文档大纲

Claude Code/desktop在国内水土不服,选择cc-haha

如果你在国内想用 Claude Code,这条路的坑你应该都踩过:注册 Anthropic 账号要特定网络环境、订阅付费需要海外信用卡、原生客户端对国内 IP 极其敏感、模型选择被锁死在 Claude 一家、想换 DeepSeek / GLM / Qwen 又得另搭一套工具链……

我之前也用过一段时间的 CCSwitch(Claude Code Switch),通过切换环境变量来换模型供应商。思路是好的,但它本质是「为 CLI 套一层切换壳」,碰到多工作区切换、IDE 联动、Computer Use 这类需要常驻 UI 的场景就显得力不从心;再加上配置散落在不同 shell 环境里,遇到过一次「worktree 上下文串了」之后,我开始认真找替代品。

最终停在了 https://github.com/NanmiCoder/cc-haha 这个项目上。

cc-haha 是什么

一句话:它把「泄露出来的 Claude Code 源码」修好、补上桌面端、加上了多模型和工作流能力,打包成了一个 macOS / Windows / Linux 通吃的桌面工作台。

技术栈是 TypeScript + Electron + React + Bun,本地运行时跑在 Bun 上(启动几乎是秒级)。CLI 部分仍然兼容原版 Claude Code 的所有配置和命令,所以从官方 CLI 迁移过来几乎零成本。

它解决了我的哪些痛点

1. 桌面端 GUI,不用一直盯着终端

我日常会同时跑 2–3 个项目,每个项目又有不同的会话和分支。纯 CLI 下要靠 iTerm2 / tmux 自己拼,标签多了就乱。

cc-haha 直接给你一个图形化工作台:

  • 左侧项目树 + 多会话标签
  • 右侧实时显示代码改动、Diff、行级增删
  • 工作区状态(worktree、当前分支、变更文件)一眼可见

对于习惯了 IDE 操作、不想一直 cat 终端的我来说,这是最直接的体验升级。

2. 分支 / Worktree 一键隔离

原版 Claude Code 启动会话时是直接落在当前 git 目录下。如果你在 main 上跑实验性 prompt,AI 一通操作下来工作区就乱了。

cc-haha 启动新会话时可以直接选:基于哪个分支、用不用隔离 Worktree。Worktree 模式下 AI 改文件、改依赖,都只影响隔离副本,主分支干净。这点在我做「想用 AI 试一下重构但又怕搞炸当前工程」时极其受用。

3. 多模型自由切换,告别单一供应商

这是我最看重的功能。cc-haha 在设置面板里支持配置多个模型提供商:

  • Anthropic 兼容 API
  • 第三方转接(DeepSeek / GLM / Qwen / Ollama 本地模型都能接)
  • WebSearch fallback

不用再像 CCSwitch 那样去改 shell 环境变量切来切去。在一个面板里就能配好所有 provider,对话过程中也能即时切换模型(轻量任务换 Haiku 级小模型省钱,重活再切 Opus)。这一点对国内用户尤其友好——平时用国产模型跑日常任务,关键时刻再切 Claude。

4. Computer Use:让 Agent 直接操作桌面

这是 cc-haha 相对其他替代方案最特别的功能之一。授权后 Agent 可以截屏、移动鼠标、点击、键盘输入,相当于把「GUI 操作」也纳入了 Agent 的工具集。

典型场景:让 AI 直接打开某个桌面软件执行操作(比如点开 Electron 应用跑测试)。它不是银弹,但需要的时候是真能省事。

5. H5 远程访问 + IM 接入

这是我「个人使用」场景下的杀手级功能:

  • H5 远程:通过一次性令牌,手机或任何设备浏览器就能接入当前桌面会话。出门在外也能继续让 AI 干活
  • IM 接入:Telegram / 飞书 / 微信 / 钉钉 都可以挂上来,远程发消息触发对话、切换项目、审批权限

这种「人在外面、公司电脑 / 个人电脑还在跑 AI 任务」的体验,是 CLI 工具链几乎不可能给你的。

6. 定时任务 + Token 用量统计

桌面端里可以创建计划任务(比如让 AI 每晚自动跑一次代码巡检),并查看本机 Token 消耗趋势。对控制成本很关键——尤其是切到 Opus 跑大任务时,能看到每条会话烧了多少 token,比事后看账单直观得多。

7. 技能市场 + 内存记忆 + 多 Agent

  • 技能市场:在桌面端里直接浏览、安装 ClawHub / SkillHub 上的第三方 skill,相当于一个 Agent 的「应用商店」
  • 记忆系统:跨会话持久化的项目记忆,AI 下次开会话还能记得你的偏好和项目约定
  • 多 Agent:支持 SubAgent、Teams 协作,能跑并行任务
  • 权限审批:危险命令 / 工具调用集中审批,不用每个 prompt 都在终端弹 y/n

与 CCSwitch 的对比

我从 CCSwitch 切过来的体感差异:

维度CCSwitchcc-haha
形态CLI 上的模型切换壳完整桌面工作台
模型切换改 shell 环境变量面板里可视化配置 + 即时切换
多会话管理全靠 tmux 自己拼内置标签 + 项目树
Worktree 隔离不支持启动会话时可一键开
Computer Use无原生支持
远程接入无H5 + IM 双重
定时任务无内置
兼容性仅 CLI兼容原版 CC 配置 + 额外能力
风险第三方脚本切换环境变量闭源分发 + 未签名安装包

CCSwitch 的优势是「轻」、没有图形界面,但如果你已经过了「在终端里就能搞定一切」的阶段,cc-haha 的体验维度会宽很多。

安装建议(亲测)

桌面端安装:

  1. 前往 [Releases](https://github.com/NanmiCoder/cc-haha/releases) 下载对应平台的安装包
  2. macOS:正式 Release 是经过签名和公证的,draft / unsigned 包首次打开需要在「系统设置 → 隐私与安全性」手动放行
  3. Windows:未签名安装包会触发 SmartScreen,「更多信息 → 仍要运行」即可
  4. 首次启动后在「设置」里配置模型提供商、API Key、默认模型

从源码启动 CLI(适合想折腾或者不放心下载二进制的人):

bun install
cp .env.example .env
./bin/claude-haha

我个人更推荐桌面端包——既然它解决的就是「不想一直盯终端」的问题,那直接装 GUI 才是完整体验。

一些必须说在前面的话

推荐归推荐,有几个坑 / 风险你应该知道:

  1. 版权与合规:
    cc-haha 基于 2026-03-31 从 Anthropic npm registry 泄露的源码二次开发。LICENSE 里明确写了「禁止商用、禁止再分发、禁止与 Anthropic 商业产品竞争」。个人学习研究可以,公司业务场景请先咨询法务。
  2. 个人维护项目:
    维护者是个人开发者(relakkes),issue 区有零星「升级后配置丢失」「Windows 启动失败」等报告。建议升级前手动备份 ~/.claude/ 和 ~/.config/claude-code-haha/。
  3. 安装包签名:
    macOS / Windows 安装包不一定每版都签名,下载前确认 release notes,必要时校验 SHA256。
  4. Computer Use / IM / H5 这三个能力不要在主工作环境里开。如果一定要试,请在专门的虚拟机或测试机上玩。这三个功能相当于把 Agent 的权限边界从「当前工程目录」扩展到了「你的整台电脑 + 你的 IM 账号」,一定要在沙箱里跑。
  5. Anthropic 官方不背书:
    用了第三方 fork 之后,Anthropic 账号层面的任何风控 / 封号风险都得自己承担。

写在最后

cc-haha 不是完美的项目——版本号还在 v0.4.x,安装包偶发未签名,单人维护有 bus factor 风险。但在国内「想用一个不被墙、能切多模型、有桌面 GUI、还能远程接入的 Claude Code」这个具体需求下,它目前是最接近「开箱即用」的选择。

如果你也受够了 CCSwitch 的零碎、想从纯 CLI 升级到有图形化工作台、又需要把国产模型和 Claude 混着用——可以先从桌面端装一版,配置好你的模型 API Key 跑几天,再决定要不要把它放进主力工具链。

阅读量: 247