首页 / 开源热榜 / cc-haha / 使用教程

cc-haha 中文教程：安装、模型配置与权限

更新于 2026-09-22 · NGJOO AI 实验室 · 约 8 分钟

cc-haha 的正式名称是 Claude Code Haha。它把本地编码 Agent 放进桌面工作台：左边是项目和会话，中间是对话，文件改动以 diff 展示，终端、Skills、MCP 和多 Agent 也在同一个界面里。安装时最容易弄错的地方是把它当成 Claude Code 的前端插件。官方文档说明，CLI 引擎已经随安装包提供。

版本核对：官方 release 页面当前标记 v0.6.6 为 Latest（2026-09-22）。版本和安装包会变化，下载前请确认系统架构和 release 资产。

1. 下载和首次启动

打开官方 Releases，按 macOS、Windows 或 Linux 以及 CPU 架构选择安装包。普通桌面安装不要求预先安装 Claude Code、Node.js 或 npm。第一次打开后先选择一个测试项目目录，别直接指向含密钥的工作目录。

2. 连接模型

进入 Settings → Providers。官方文档列出三类路径：Claude、ChatGPT、Grok 等官方账号；DeepSeek、Kimi、智谱等第三方 API；以及本地运行的 LM Studio 或 Ollama。cc-haha 是工作台，本身不附带模型，必须先配置一个 provider 才能运行任务。

3. 运行第一个任务

打开一个只包含 README 和测试文件的项目目录；输入“只阅读项目结构，告诉我测试命令，不要修改文件”；确认文件列表和命令；再让它修改一个临时文件，检查 diff 和撤销入口。

官方默认是询问权限。先保持默认设置，确认它什么时候请求写文件、运行命令或使用外部工具，再按项目需要调整。

4. Computer Use 和多 Agent

Computer Use 可以截图、点击、滚动、输入文字，并操作没有 API 的桌面软件。它会接触真实屏幕，所以系统权限必须逐项确认；当前官方文档标注 macOS 和 Windows 支持，Linux 没有 executor。多 Agent、Skills、MCP 和 Git worktree 适合复杂任务，但建议先用单 Agent 跑通项目流程。

5. 和终端 Claude Code 的区别

终端更适合脚本、远程服务器和 CI。cc-haha 更适合本地桌面使用：你可以直接看文件 diff、历史会话、权限提示和多个项目。它仍然依赖你选择的模型账号或 API，桌面壳不会替你承担模型费用。

验证边界：本轮核对了官方 README、文档和 v0.6.6 release，没有在当前工作区安装桌面包。发布前应在目标系统验证安装包签名、模型登录和 Computer Use 权限。

这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。

原教程未展开的系统信息

核心功能

多 provider
官方文档列出官方账号、第三方 API，以及 LM Studio/Ollama 本地模型路径。

常见问题

cc-haha 是 Claude 官方产品吗？

官方仓库是 NanmiCoder/cc-haha，页面没有把它描述为 Anthropic 官方桌面客户端；使用时按第三方开源项目处理。

需要单独安装 Claude Code 吗？

不需要。官方文档说 CLI 引擎随安装器提供，普通桌面安装不需要 Node.js 或 npm。

本地模型可以用吗？

可以，Settings → Providers 支持 LM Studio 和 Ollama 路径。

权限怎么验证？

先在只读目录执行读取任务，再用临时文件测试写入、终端命令和撤销；不要用含密钥的项目做第一次测试。