incipit

A frontend rework of the official Claude Code VS Code extension — surface redrawn, engine untouched.

incipit 把 Claude Code 在 VS Code 里的整套前端——正文排版、数学渲染、tool call 折叠、diff、本地历史的编辑、上下文与项目活动视图——按文学风格重新设计，工程信息也归并到统一的视觉语言。没有更改，侵入任何模型请求、鉴权、tool schema、CLI spawn 协议；装它前后，服务端那一侧看到的字节完全相同。

跑一次，重载 VS Code 即可，不需要额外依赖。每次 Claude Code 升级覆盖前端文件后，重跑一次。incipit 会按目标/版本保留一个轻量官方恢复点，随时可以把已打补丁的扩展恢复回官方 Claude Code。

它是补丁，不是独立扩展

incipit 修改的是 Claude Code 官方扩展在你磁盘上的文件，本身不是 VS Code 插件，也不替代官方扩展。Claude 订阅、API key、登录态、MCP 配置、tool schema、权限设置——一切官方逻辑——都跟没装它的时候一样。

撤掉它，扩展立刻回到出厂状态。

安装

需要 Node.js 16 或更新版本。

npm install -g incipit@latest

incipit 是终端 CLI，必须全局安装。npm install incipit（不带 -g）是 npm 装本地依赖的写法，会把包丢进当前目录的 node_modules/，既不会注册到系统 PATH，也跑不到正确版本。

装好后直接运行：

incipit

首次启动会 CLI 语言选择，之后进入交互菜单：

菜单操作：

• Apply / Restore：应用补丁，或把选中的 Claude Code 目标恢复为官方文件。每个目标/版本第一次干净 apply 时只记录一个官方恢复点，后续 apply 复用它；恢复时不会动你其他的 VS Code 配置。
• Configure：开关数学公式渲染、会话用量徽章；切换正文字号（12 / 13 / 14 / 15 / 16，默认 13）和暖黑 / 暖白主题。
• Manage Claude Code targets：自动探测 VS Code / Cursor / Insiders / VSCodium / Windsurf / Antigravity，也支持手动指定扩展目录。
• CLI language：随时切换中英文。

跳过菜单直接执行：

incipit apply     # 直接应用
incipit restore   # 把当前目标恢复为官方 Claude Code 文件

Claude Code 扩展每次更新后，本地补丁会被官方文件覆盖，重跑 incipit 并应用即可。更新 incipit 自身用同一条全局安装命令。

卸载 incipit CLI：

npm uninstall -g incipit

仅移除 incipit cli 本身，不会自动还原已应用到 Claude Code 扩展里的补丁，也不会删除 ~/.incipit/。如果要回滚补丁，请先运行 incipit restore。

界面

文学风格界面——暖黑底色，米色调衬线字体，色域窄到只剩同色相的明度阶差，陶土红只在链接、强调和底部状态行克制地点出。

数学渲染，表格呈现booktabs，代码块的语法色被压低，工具调用收成一行，展开层用暗红暗绿做 diff，字符级差异再以淡彩在行内细描。

工程信息归并为统一的文学风格——工具调用、diff、状态行的字体、色相、强调方式都与正文风格一致。

上下文与缓存

输入框上方的状态行常驻显示当前上下文体量和缓存命中率，数字随每一次发出和回复实时刷新。点开后展开一个浮层，列出最近几轮的 token 用量和缓存比例，以及整段会话的累计统计。

数据来自 Claude Code 本地的 JSONL 转录，不经由任何网络，不调用任何模型请求。

缓存详情还会按时间画出命中率曲线。你可以看见最近一段时间里 cache read / cache write / fresh input / output 的比例变化，也可以拖选一段时间范围，只看那段请求的累计读写量。

项目活动

incipit 会把本地 Claude Code 转录里的编辑活动汇总成项目视角。当前项目显示新增 / 删除行数；全局视图显示已记录项目、会话数量、工具编辑次数和活跃天数，并用热力图呈现一段时间内的编辑密度。

这些统计同样只读取本地转录文件，不上传项目内容，也不参与模型上下文。

diff

Edit / Write 的 diff 不保留宿主默认的双栏 Monaco：文件名 + +N −M 位于头部，删除行铺一层暗红底色，新增行铺一层暗绿，行号克制，字符级差异在行内再做一次同色相但更显的二次着色。短 diff 直接展开，长 diff 折成卡片，点 Click to expand 在浮层里看完整。

暖黑主题下是酒红 / 森林绿，暖白主题下是浅粉红 / 浅粉绿。不同主题所有元素经过独立且统一的设计。

数学渲染

完整的，支持各类复杂情况的公式渲染。

KaTeX 按需加载，当前回复里没有公式就不启动数学链路。字号 1.21em，与衬线正文和 CJK 混排时笔画粗细对得齐。 同时修复了KaTeX原生的括号被撑大的问题。

对话历史编辑

• 每条用户消息底部，都有图标：edit / rerun / fork / more。

• Edit (内联编辑)：在消息原位展开编辑器。AI消息同样支持编辑。所有输出块均可支持编辑。

• 附件管理：消息展示历史附加的 IDE 文件引用、代码选区及图片。支持点击移除现有附件，也可直接拖拽或粘贴引入新图片。 本地保存机制：点击保存仅改写本地 JSONL 对话记录文件，不触发任何网络请求。 重发逻辑：编辑功能仅负责修改本地上下文状态。若需将修改后的内容提交给模型，需在保存后配合使用 Rerun 功能。

• Rerun (重试)：仅用户消息处可用，允许在任何用户消息处执行。移除后续对话全部上下文，通过 Claude Code 原生接口（session.send）在同一的sessionid下原样重发当前消息，完整保留图文及 IDE 引用结构。这意味着改用户消息及以前的上下文，缓存保留

• Fork (分支)：调用宿主APP forkConversation 接口，将当前及之前的上下文复制到新会话，原会话保留。

• More (更多菜单)： 包含 代码回滚 (Rewind) 及其组合操作（回滚并 Rerun、回滚并 Fork）。回滚通过调用 session.rewindCode 撤销后续所有磁盘文件更改。 包含 Copy as text / markdown 复制选项。

Incipit 的本地历史能力遵循原则：不伪造模型上下文，不自行构造 Claude Code 的消息树，也不绕开 Claude Code 的会话协议。涉及 rerun、edit、rewind、fork 等操作，Incipit 只在本地 JSONL 上执行可验证的最小变更：截断历史时保留合法前缀，删除用户消息及其后续派生内容，避免留下孤立的 assistant/tool_use/tool_result 片段；随后重新发送、代码回滚和会话分叉均交回 Claude Code 的原生接口处理，如 session.send、rewindCode、forkConversation 等。

为了避免不可逆写盘造成损坏状态，Incipit 在执行前会做严格的 preflight 校验：必须能确认当前 session id、目标 JSONL、宿主 SessionState 以及相关原生接口都可用，否则操作会被直接拦截。rerun 截断后如果后续发送失败，Incipit 还会在确认 transcript 尚未产生新追加内容的前提下恢复原始 JSONL。这样做的目标是确保本地历史变更不会产生违反 Claude Code / Anthropic messages 结构约束的异常上下文，例如悬空的 tool result、错误的角色顺序、错位的会话分支或不一致的文件状态。

合规性

这是一个纯前端改造项目，没有侵入任何模型工具调用层，网络请求层。

Claude供应商的用户协议约束的是你和他们服务之间的关系：不能滥用 API、不能绕开限速、不能伪造身份、不能干扰服务端协议。incipit 完全不在这个范围里——它只改你本地屏幕上的渲染方式，和Claude模型供应商的服务器之间没有任何连接。你发出的每一个字节，装它之前和之后是一样的。

还原

incipit restore

CLI 会先锁定当前 Claude Code 目标，确认后恢复同版本、同扩展目录的官方文件。复制进 webview/ 的 incipit 资源也会被清掉。你在 VS Code settings 里自己做的其他配置不受影响。

0.1.7 过渡期会额外保留 incipit clean-backups，用于删除旧版命名备份目录 ~/.incipit-backup/；它不会删除新的官方恢复点 ~/.incipit/。

平台

Windows 11 下经过充分测试，日用稳定。

Linux 和 macOS 理论上可以正常工作，但目前没有实机验证。如果遇到问题，提 issue 时附上你的 Claude Code 扩展版本号和报错信息。

Claude Code 扩展每次更新后，补丁会被一并覆盖。再跑一次 incipit 即可，通常十秒内完成。

为什么不做成 VS Code 插件

VS Code 的扩展之间有严格的沙箱隔离，一个插件没有办法向另一个插件的界面注入脚本或样式。要改变 Claude Code 聊天界面的渲染，唯一的途径是直接修改它在本地磁盘上的文件。这就是 incipit 走补丁路线的原因。

如果Claude Code官方将来提供官方的主题或样式注入接口，这个项目会第一时间迁移过去，届时补丁方案归档。

致谢

感谢 linuxdo 社区的交流、分享与反馈。

License

从下一个版本开始，incipit 按 GNU Affero General Public License v3.0 or later 发布。此前已经发布的版本仍保留其发布时的许可。见 LICENSE。

内置字体

incipit 内置以下 webview 字体，均依 SIL Open Font License 1.1 授权。每个字族的完整许可随附在 data/fonts/<字族>/OFL.txt：

| 字体 | 用途 | 版权 | 来源 | | --- | --- | --- | --- | | IBM Plex Serif | 拉丁正文 + 强调 | © 2017 IBM Corp.，保留字体名 "Plex" | IBM/plex | | Noto Sans SC 思源黑体 | CJK 正文（默认 plex-hei 预设） | © 2014–2021 Adobe（Source Han Sans / Noto CJK） | notofonts/noto-cjk | | LXGW WenKai 霞鹜文楷 | CJK 正文（可选 plex-serif 楷体预设） | © 2021–2026 LXGW；© 2020 The Klee Project Authors | lxgw/LxgwWenKai | | Recursive | 等宽（代码 / 工具输出） | © 2020 The Recursive Project Authors | arrowtype/recursive |

OFL 允许这样的内置与再分发；这些字体经过子集化（OFL 许可范围内的修改），且没有以使用保留字体名（Reserved Font Name）的方式重命名。