Claude Code 定制工具 tweakcc
通过系统提示词、工具集与终端界面定制，让 Claude Code 更贴合你的开发流程。
- Star 数
- ★ 2.6k
- 最近更新
- 今天
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 63/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 Claude Code 的个人开发者想编辑主系统提示词、工具说明或子代理提示词，并将提示词文件纳入 Git 管理。
- 不适合
- 不使用 Claude Code 的开发者
- 源码审查
- 63/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
tweakcc 是一个命令行工具，也可作为 npm 依赖使用，用于修改 Claude Code 的安装内容并保存定制配置。它提供交互式终端界面、--apply 命令、unpack、repack 和 adhoc-patch 子命令，以及可供项目调用的 API。功能包括编辑系统提示词、创建工具集和主题、调整输入高亮、思考动词与动画，并应用多种内置补丁。它支持 Windows、macOS 和 Linux 上的 npm 与原生二进制安装；原生安装通过 node-lief 提取和重打包 Bun 二进制中的 JavaScript。应用后的修改写入 Claude Code 安装，配置保存在本地；更新 Claude Code 后通常需要重新应用定制。
启动 npx tweakcc 可进入交互式终端界面配置功能；配置保存在 ~/.tweakcc/config.json，系统提示词文件保存在配置目录下的 system-prompts/。运行 tweakcc --apply 时，工具读取配置并从备份恢复安装，再应用启用的补丁；也可用 --patches 指定补丁 ID。对于 npm 安装，它直接修改 cli.js；对于原生安装，它提取二进制中的 JavaScript，修改后重打包。unpack 和 repack 用于原生安装的 JavaScript 检查与回写；adhoc-patch 可通过字符串替换、正则或 Node.js 脚本执行一次性修改。作为 npm 依赖时，API 可查找 Claude Code 安装、读写其内容并创建或恢复备份。
- 使用 Claude Code 的个人开发者想编辑主系统提示词、工具说明或子代理提示词，并将提示词文件纳入 Git 管理。
- 需要按研究、规划或其他工作模式启用不同内置工具的开发者，可创建工具集并通过
/toolset切换。 - 希望调整 Claude Code 终端外观的用户，可创建主题、设置思考动词与动画、改变用户消息样式或输入框边框。
- 需要在输入时突出显示文件路径、环境变量或自定义正则模式的用户，可配置输入模式高亮器。
- 在项目中集成 Claude Code 安装检测、内容读写或备份恢复流程的开发者，可使用 tweakcc 的 npm API。
- 需要检查或修改原生 Claude Code 二进制中 JavaScript 内容的开发者，可使用
unpack、repack或adhoc-patch。
如何安装或部署这个 Agent？
无需全局安装即可用 npx 启动交互界面。也可将 tweakcc 安装为项目依赖，以便使用其 API。README 没有要求 Claude API 密钥；工具目标是本机安装的 Claude Code。
如何使用这个 Agent？
先启动界面配置定制，再应用配置到 Claude Code：
npx tweakcc
npx tweakcc --apply也可以将 tweakcc 安装为依赖：
npm i tweakcc编辑系统提示词时，可修改 ~/.tweakcc/system-prompts 下的 Markdown 文件，然后应用配置。使用基于脚本的 adhoc-patch 需要 Node.js 20+：
这个 Agent 有哪些优点和局限？
- 提供系统提示词的逐部分 Markdown 文件，便于针对工具说明、子代理和其他提示词片段分别定制。
- 同时支持 npm 与原生二进制安装，并在 Windows、macOS 和 Linux 上提供安装发现与修改流程。
- 工具集可以控制发送给模型的内置工具，并支持按 Claude Code 模式绑定或通过
/toolset切换。 - 除内置功能外，还提供可编写自定义补丁的 API 和
adhoc-patch。
- 它只面向 Claude Code；其他编码代理或模型提供商没有文档所述的支持路径。
- 它会修改 Claude Code 的可执行内容；升级会覆盖定制，通常需要重新运行
--apply。 - README 验证的 Claude Code 版本为 2.1.162；其他版本的非系统提示词补丁可能无法工作。
- 从 HTTP URL 获取配置或补丁脚本需要网络；
adhoc-patch --script还要求 Node.js 20+。
这个 Agent 与同类方案有什么区别？
README 将 tweakcc 的工具集与 Claude Code 内置权限系统作了区分：未启用的内置工具不会发送给模型；README 也把原生与 npm 安装作为两种受支持的 Claude Code 安装方式。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Claude Code 定制工具 tweakcc 当前 | 63 · 存在缺口 | 命令行工具免费 | ★ 2.6k | 今天 | TypeScript | Claude Code |
| OpenGAP | 51 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 3k | 3 个月前 | TypeScript | Codex · Claude Code · OpenAI API |
| System Prompts Leaks 系统提示词泄露档案库 | 25 · 缺口较多 | 网页应用免费 | ★ 70k | 2 天前 | Python | — |
| Reasonix | 66 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 36k | 今天 | Go | OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README说明应用前展示摘要并要求确认，也能用 --restore 从备份恢复；但 --yes 可跳过确认，部分自动重应用会在会话启动时运行。工具直接修改 Claude Code 可执行文件，远程配置和脚本会影响本地安装；虽说明脚本沙箱限制及恶意补丁风险，敏感数据处理、权限边界和依赖安全证据仍有限。
文档详述备份恢复、版本适配限制、补丁失败处理及更新行为，测试文件也覆盖配置和补丁计划；但 Claude Code 版本变化会令非提示词补丁失效，依赖可用性与兼容范围没有全面证据。
功能覆盖提示词、主题、工具集、界面、补丁和自动化，明确支持多操作系统与原生/npm 等安装路径。文档指出版本及补丁边界，但许多功能尚缺文档，部分补丁是否适用须按目标版本判断；触发和适配规则说明不完整。
README有目录、安装命令、CLI/API说明、示例、FAQ、故障排除和已知限制；MIT 许可明确。版本号与更新说明可见，但提供的材料没有完整发布历史，维护责任和支持承诺也只部分说明。
该工具可集中定制 Claude Code 并保留设置，涵盖面广且示例能说明主要操作，具备明显增值。应用可改写可执行文件、更新后还需重应用，操作成本和潜在维护负担较高；输出适用性取决于目标版本。
多项主张由具体 CLI 行为、配置选项、测试代码和工作流文件支撑，且文档区分已验证版本与推测兼容范围。材料间有一定互证，但缺少实际运行证据，且不少功能说明尚未完成，因此无法全面核实所有产品主张。
- 该工具会修改 Claude Code 可执行文件；应用前应检查差异，并留意 README 所述的版本兼容限制及更新后需要重新应用。
- 远程配置和 adhoc 脚本会影响本地安装。文档描述了脚本沙箱，但也提醒脚本仍可能将恶意代码补丁写入 Claude Code。
常见问题
使用 tweakcc 需要付费服务或 API 密钥吗？
修改会在 Claude Code 更新后保留吗？
tweakcc --apply 重新应用保存在本地配置中的定制。哪些 Claude Code 版本能使用这些补丁？
自定义脚本能直接访问文件或网络吗？
adhoc-patch --script 在隔离的 Node.js 子进程中运行，并使用 Node.js 20+ 的实验性权限选项限制文件系统和网络 API。脚本仍然能修改 Claude Code 可执行内容，README 建议检查应用前显示的差异。