cc-haha/docs/start/index.md
程序员阿江(Relakkes) c2cd615824 docs: rebuild the documentation site around two readers
The site had drifted from the product. Every screenshot predated the
v0.5.0 UI redesign, the reading experience shipped no search and no
syntax highlighting, and a third of the pages were internal process
artefacts — migration task lists addressed to agentic workers, a
release runbook, a proposal marked "historical".

Reorganise around the only two people who read this: someone getting
the desktop app running for the first time, and someone reading the
source. Five sections replace nine — start / desktop / im / cli /
internals — and the pages that served neither reader are gone.

Site rewrite:

- Palette lifted from the desktop app's 「纸·墨·印」 themes, so the
  site and the product read as one thing. Light mirrors 纯白, dark
  mirrors 墨夜, and dark mode exists at all now.
- Fonts are self-hosted. The old @import from Google Fonts is
  unreachable from mainland China, which left every heading in a
  fallback serif; it also only requested weight 600 while the CSS
  asked for 900, so Latin and CJK in the same heading disagreed.
- Docs were shipped as one 968KB manifest downloaded on every page
  view. Split into a 32KB index plus one lazily imported chunk per
  page; the entry bundle is now 101KB gzipped.
- Add search, syntax highlighting, per-route meta with canonical and
  hreflang, a sitemap, and an error boundary. Replace the 44vh
  mobile sidebar with a drawer.
- Image dimensions are read at build time and written into the tag,
  so lazy images reserve their space instead of collapsing.

Screenshots are recaptured from a real v0.5.0 build against a clean
demo project, with tokens, QR codes and paired accounts redacted.
The previous set is deleted rather than kept alongside.

Routes follow file paths, so the restructure would have broken every
inbound link; 37 old paths redirect, in both languages. The PR policy
gate and CODEOWNERS also hardcoded docs/guide/contributing.md.

Verified: check:docs 78 pages / 323 links / 0 problems, check:policy
127 pass. Walked every route at 1440 and 390 in both themes for
overflow, contrast, keyboard reachability and focus management.
2026-07-27 17:32:41 +08:00

3.6 KiB
Raw Blame History

title nav_title description order
Claude Code Haha 是什么 这是什么 跑在你自己电脑上的 AI 编程工作台:模型自己接,改动你审阅。 0

Claude Code Haha 是什么

它是一个装在你电脑上的应用。你把一个项目文件夹交给它,用大白话说出你想要什么,它去读代码、改文件、跑命令——每一处改动都摆在你眼前,等你点头才算数。

一条完整会话:提问、工具调用、编辑文件、内联 diff

上图是一条真实会话左边是项目和历史中间是对话Claude 读完文件后直接改,改了什么就在下面逐行标出来。

和 Claude Code CLI 是什么关系

Claude Code 是 Anthropic 出的命令行编程 Agent跑在终端里。Claude Code Haha 的内核就是从 Claude Code 源码修复而来的一份 CLI仓库里叫 claude-haha),桌面端是包在它外面的图形界面。

对你来说,这意味着两件事:

  • 不用先装 Claude Code。 CLI 内核已经打进安装包,装完应用就能用,不需要 Node.js、npm 或任何全局命令。
  • 终端里能干的,这里都能干。 权限审批、子 Agent、Skills、MCP、记忆都是同一套东西只是从滚动的终端输出变成了看得懂的界面。

想直接用终端的人也没被落下,源码里的 CLI 一直在,见 命令行

它能帮你做什么

写代码。 描述一个目标——加个功能、修个 bug、换套配色——它自己找文件、读上下文、动手改改完告诉你动了哪几个文件。

审改动。 每次编辑都带一份内联 diff右侧工作区还会把这一轮改过的文件列成清单能逐个点开左右对照。不满意就打回去重改。

派 Agent。 大任务可以拆给子 Agent 并行跑,你在活动面板里看它们各自的进度。也可以在设置里给不同 Agent 配不同的模型、工具和系统提示词。

定时跑。 每天早上整理一次日志、每周跑一遍依赖检查——把任务设成定时的,到点它自己开工,跑完留一份记录。

手机上继续。 开一次 H5 访问扫码就能在手机上接着刚才那条会话也可以把飞书、Telegram、微信这些聊天软件接上在对话框里指挥它干活。

三条底线

本地优先。 会话、设置、记忆、技能都存在你自己的机器上(默认在 ~/.claude 下)。没有账号体系,没有云端同步,不上传你的代码。唯一的对外流量是你自己配的模型服务。

模型自选。 不绑定任何一家。Claude、ChatGPT、Grok 的官方账号可以直接登录DeepSeek、Kimi、智谱 GLM 这些第三方 API 有现成预设LM Studio、Ollama 跑的本地模型也接得上,一分钱不花。

改动你说了算。 默认是「询问权限」模式:写文件、跑命令之前都会停下来问你一句。你可以放宽到自动接受编辑,也可以收紧到只让它做规划不许碰文件——五档权限,随时切换。

从这里开始

按顺序走,大约二十分钟能跑通第一条会话:

  1. 下载与安装 — 三个平台的安装包,以及系统拦下来时怎么办。
  2. 连接模型服务 — 官方账号、第三方 API、本地模型三种接法挑一种。
  3. 跑通第一条会话 — 选目录、选权限、说目标、看它干活、审改动。
  4. 桌面端功能地图 — 跑通之后,看看还有哪些能力可以用上。

中途卡住了,去 装不上 / 打不开 / 连不上 按症状找。