Piebald-AI/tweakcc

Customize Claude Code's system prompts, create custom toolsets, input pattern highlighters, themes/thinking verbs/spinners, customize input box & user message styling, support AGENTS.md, unlock private/unreleased features, and much more. Supports both native/npm installs on all platforms.

tweakcc 的功能

tweakcc 是一个命令行工具，让您可以个性化 Claude Code 桌面应用（Anthropic 的 AI 助手 UI）。它的工作原理是修补应用的 JavaScript 包（或 Claude Code 随附的原生 Bun 二进制文件），然后重新打包，因此更改会在您下次启动 Claude Code 时生效。

核心功能

领域	您可以更改的内容
系统提示词	替换 Claude 在启动时收到的默认提示词，或从社区维护的提示词库中挑选。
主题与颜色	使用 HSL/RGB 取色器选择颜色、更改整个 UI 调色板、隐藏 ASCII 边框、设置用户消息样式，甚至可以自定义 Claude 思考时显示的加载动画。
工具集与命令	定义自定义的工具集，这些工具集可通过 Claude Code 中的新 `/toolset` 命令使用。
会话处理	为聊天命名（`/title`、`/rename`）、启用“会话记忆”功能（`/remember`），并控制子代理（Plan、Explore 等）如何选择模型。
模型别名与限制	添加别名，例如 `opusplan[1m]`（Opus 用于规划 + Sonnet-1M 上下文），并通过 `CLAUDE_CODE_CONTEXT_LIMIT` 调整上下文限制。
显示调整	选择表格样式（Unicode、ASCII、Markdown）、显示 token 计数、调整状态栏更新频率，并隐藏各种 UI 提示。
性能	通过非阻塞 MCP 连接和可配置的并行批次大小，将启动速度提升约 50%。
安全性与权限	选项可跳过 `sudo` 中的权限检查、抑制原生安装程序警告，并禁用 Ctrl-Z 暂停功能。

底层工作原理

发现 – tweakcc 会定位 Claude Code 安装（npm/yarn/pnpm/bun、原生二进制文件、Homebrew、Nix 等）。
提取 – 对于原生 Bun 二进制文件，它使用 node-lief（LIEF 库的 Node 绑定）从可执行文件中取出捆绑的 JavaScript（cli.js）。
应用补丁 – 自定义设置会从 ~/.tweakcc/config.json（或远程 URL）读取，并以文本替换、正则表达式或完整脚本补丁的方式应用。
重新打包 – 修改后的 JavaScript 会写回二进制文件（或直接覆盖 npm 安装的 cli.js）。会保留原始二进制文件的备份，以便 tweakcc --restore 可以还原更改。
CLI 与 API – 您可以使用 npx tweakcc 运行交互式 UI、使用子命令（unpack、repack、adhoc-patch）进行高级工作流程，或导入库（npm i tweakcc）并从您自己的 Node 项目调用其 API。

典型工作流程

# 运行交互式 UI，创建主题和自定义提示词
npx tweakcc

# 将保存的配置应用到 Claude Code（非交互式，适用于脚本）
npx tweakcc --apply --yes

# 快速测试一次性更改，无需编辑配置
npx tweakcc adhoc-patch --string "old text" "new text"

谁可能使用它？

Claude Code 的高级用户，想要深色模式友好的配色方案、自定义思考动词或不同的加载动画。
团队，在成员之间共享一组标准的系统提示词或工具集。
开发人员，为 Claude Code 构建扩展，并需要可重现的方式来注入补丁。
研究人员，想要实验替代的模型选择逻辑（例如 opusplan[1m] 别名），而无需修改 Claude 的源代码。

限制与注意事项

此工具与特定 Claude Code 版本相关；它已针对 2.1.162 验证，可能需要更新以支持较新的版本。
当 Claude Code 更新时，您的补丁会被移除；您必须重新运行 tweakcc --apply 来还原它们。
原生二进制文件修补需要 Node 20+（用于沙盒脚本模式），并且在 Apple Silicon 上可能需要临时的代码签名。

TL;DR： tweakcc 是一个基于 Node 的命令行工具，可让您通过修补 Claude Code AI 助手桌面应用的 JavaScript 包来设置主题、扩展和调整它。它支持 npm 安装和原生 Bun 二进制文件，提供 API 供编程使用，并为高级用户和团队提供丰富的 UI 和行为自定义选项。