从Header到Prompt:brainless的Claude Code终端组件族9件套完全使用指南
从Header到Prompt:brainless的Claude Code终端组件族9件套完全使用指南
brainless 是一个开源的 shadcn 组件库,把 Claude Code、Codex 和 Grok 三套 AI 编程终端的界面,逐一复刻成可访问(accessible)的 React 组件。它的 Claude 家族一共包含 9 个组件,从欢迎页 Header 到输入框 Prompt 一应俱全,让你无需终端截图或 iframe,就能在文档站、演示页和产品 UI 里"放"一个高保真的 Claude Code 终端会话。
为什么选 brainless 做终端 UI?
在介绍 9 件套之前,先说清楚它的四个卖点:
- 像素级保真:所有组件的配色、字形、间距都来自真实终端的逐帧抓取(存放在 references/captures/ 目录,由 tools/capture/ 的 tmux 抓取工具产出);
- 可访问性优先:不是用
<pre>糊出来的"假终端",而是真实的fieldset/legend、radiogroup、details、aria-live语义元素,键盘和读屏都能正常操作; - 即拷即用:一条 shadcn 命令把源码装进你自己的项目,改文案换数据都是几行 props 的事;
- 纯组件、无图片:终端画面是活的——Thinking 行真的会动、权限框真的能点。
9 件套一览:Claude 家族全家福
| # | 组件 | 安装名 | 还原的终端元素 |
|---|---|---|---|
| 1 | ClaudeHeader | claude-header |
欢迎框:logo、Tips、模型/目录信息 |
| 2 | ClaudeMessage | claude-message |
一轮对话:用户 ❯ 提示行 / 助手纯文本 |
| 3 | ClaudeThinking | claude-thinking |
"正在工作"行:闪烁符号 + 实时秒数 |
| 4 | ClaudeToolCall | claude-tool-call |
⏺ 工具名 (参数) / ⎿ 结果 折叠行 |
| 5 | ClaudeTodoList | claude-todo-list |
任务清单:✔ 完成 / ◼ 进行中 / ◻ 待办 |
| 6 | ClaudeDiff | claude-diff |
内联 diff:⏺ Update (文件) + 增删行 |
| 7 | ClaudePermission | claude-permission |
"Do you want to proceed?" 审批框 |
| 8 | ClaudeSlashMenu | claude-slash-menu |
/ 斜杠命令面板 |
| 9 | ClaudePrompt | claude-prompt |
底部输入器:模式行 + effort 徽章 |
完整清单还可以查看 registry.json 和组件目录 lib/catalog.ts。
逐个认识 9 件套
1️⃣ ClaudeHeader:欢迎框
还原 Claude Code 启动时的经典欢迎框:像素风 logo(用 1-bit 位图解码成 SVG 绘制,放大不糊)、Welcome back Ben!、模型名与组织信息,右侧是 Tips 与 What's new 两栏。标题用真实的 fieldset + legend 实现,天然继承背景色。常用 props:version、user、model、org、cwd、tips、whatsNew。
2️⃣ ClaudeMessage:对话回合
一对 role 属性区分两种回合:role="user" 渲染为 Claude Code 的全宽深色 ❯ 提示行;默认 assistant 则是普通文本。把任意文案、JSX 塞进 children 即可。
3️⃣ ClaudeThinking:正在工作行
最"活"的组件:闪烁的星形符号按真实抓取的 10 帧序列轮播,动词每 5.2 秒换一个(Thinking → Levitating → Schlepping → Percolating…),秒数与 token 估算实时递增,并提示 esc to interrupt。整行是 aria-live 状态区,且尊重系统的"减弱动态效果"设置。传 running={false} 即可冻结。
4️⃣ ClaudeToolCall:工具调用行
还原 ⏺ Read (next.config.ts) / ⎿ Read 5 lines 的视觉语法。终端里靠 ctrl+o 展开,这里直接做成真实可键盘操作的 <details> 折叠:传入 children 就能展开输出内容,status 支持 success / error / pending 三种状态色。
5️⃣ ClaudeTodoList:任务清单
对应 Claude Code 的 Update Todos 块:✔ 完成(绿色+删除线)、◼ 进行中(陶土色加粗)、◻ 待办,图标列严格对齐。每条任务还带屏幕阅读器专用的状态文本(completed / in progress / pending)。
6️⃣ ClaudeDiff:代码差异块
⏺ Update (文件) + ⎿ 变更摘要,下面是有行号、增删着色的 diff 体。传入 lines 数组(type: "add" | "del" | "ctx")即可,加/删行还带有离屏 "added/removed" 标签,不依赖颜色也能读懂。
7️⃣ ClaudePermission:权限审批框
那个熟悉的 "Do you want to proceed?" 弹框。终端里是方向键驱动的编号列表,这里实现为真正的 radiogroup:方向键移动选中项、Enter/Space 或点击确认,onChoose(index) 回调拿到用户选择——可以直接接到你自己的真实审批逻辑上。
8️⃣ ClaudeSlashMenu:斜杠命令面板
内置 /agents、/clear、/compact 等命令列表,在底部输入框键入 / 之后的内容即可前缀过滤,方向键上下移动高亮行。它基于 ClaudePrompt 构建,命令列固定宽度,选中不跳动。
9️⃣ ClaudePrompt:输入器
家族里最复杂的一个:中间是真实文本输入框(❯ 前缀、方块光标),上方是 effort 徽章(low ○ → medium ◐ → high ● → xhigh ◉ → max ◈ → ultracode ✦,ultracode 还会把边框染成彩虹渐变),下方是模式行——auto / manual / accept-edits / plan 四种,配色与符号全部对照 shift+tab 实机抓取。受控与非受控两种用法都支持。
一步到位:用 claude-session 块组装完整会话
如果不想逐个拼装,官方提供了 claude-session.tsx 这个"整屏块":欢迎框 → 用户提问 → 助手回答 → 任务清单 → 工具调用 → diff → 权限审批 → Thinking 工作行 → 输入器,一个完整的 Claude Code 会话画面,一次导入直接用。
一键安装步骤
以 bun 为例,先注册命名空间(一次性),再按需添加组件:
bunx shadcn@latest registry add @brainless=https://brainless.swerdlow.dev/r/{name}.json
bunx shadcn@latest add @brainless/claude-header
bunx shadcn@latest add @brainless/claude-session
也支持 npm / pnpm / yarn(npx shadcn@latest add …)。安装后组件落在 components/brainless/claude/,按 lib/catalog.ts 中列出的路径导入即可,例如 @/components/brainless/claude/claude-header。
💡 不想注册命名空间时,可直接用 URL 方式安装单个组件,命令生成逻辑见 lib/install.ts。
上手之后还能玩什么
- 看官方演示:站点文档页 app/components/page.tsx 把 9 件套全部做了 live 示例,是学习 props 的最佳参考;
- 横向扩展:同一套思路还有 Codex 家族(header / message / exec / working / diff / permissions / prompt / slash menu)和 Grok 家族(status / event / thought / tool / write / plan / shortcuts 等 17 件),组件目录截图如下;
- 典型场景:AI 编程工具官网的 Hero 区、产品文档的"工作原理"演示、博客里的交互式 onboarding(官方的 Pied Piper Onboarding 块就是范例,见 registry/brainless/blocks/)。
小结
brainless 的 Claude 家族用 9 个组件精确还原了 Claude Code 终端的每一个关键状态:Header 欢迎、Message 对话、Thinking 工作行、ToolCall 工具调用、TodoList 任务、Diff 差异、Permission 审批、SlashMenu 命令面板、Prompt 输入器。它们既是独立的 shadcn 可安装组件,又能由 claude-session 块一键组合成完整会话——用纯代码替代截图,让终端 UI 真正"活"在你的 React 项目里。项目源码结构说明可参考 README.md。


