EnglishРусский Map

tweakcc

Toolbox toolboxclaude-codecustomizationclitypescriptwatchlistTypeScriptMIT ↳ show in map Markdown
title
tweakcc
type
toolbox
summary
CLI для патчинга установленного Claude Code: изменение системных промптов, тем, спиннеров и наборов инструментов
tags
claude-code, customization, cli, typescript, watchlist
repo
https://github.com/Piebald-AI/tweakcc
language
TypeScript
license
MIT
created
2026-05-06
updated
2026-05-06
lang
ru
translation_of
tweakcc
source_updated
2026-05-06
translated
2026-09-01
translator
lllm/antigravity/gemini-3.7-flash-medium

CLI, патчащий установленный Claude Code: позволяет менять системные промпты, темы, глаголы размышлений, спиннеры, подсветку ввода, наборы инструментов и массу настроек UI/производительности - без необходимости делать форк. Проект поддерживает Piebald LLC.

Это бинарный патчер, а не обёртка или загрузчик плагинов. Вы запускаете npx tweakcc, настраиваете параметры в TUI, и tweakcc перезаписывает cli.js в Claude Code (или, для нативных сборок, извлекает встроенный JS, патчит его и пересобирает бинарник). Настройки хранятся в ~/.tweakcc/config.json и повторно применяются после каждого обновления Claude Code командой tweakcc --apply.

Находится в watchlist - каждый релиз Claude Code может всё сломать, и полезность проекта целиком зависит от того, успевает ли Piebald за Anthropic.

Как это работает

Два пути в зависимости от способа установки:

  • Установка через npm - напрямую редактирует минифицированный cli.js на месте.
  • Нативные бинарники - использует node-lief (биндинги LIEF), чтобы извлечь встроенный JS-блоб из бинарника, применить те же патчи и упаковать обратно. Требуется для Homebrew, официальных нативных сборок CC от Anthropic и подобных вариантов.

Патчи привязаны к конкретным версиям. В README проверенной версией указан CC 2.1.62; патчи системных промптов работают вплоть до 2.0.14, поскольку tweakcc хранит в репозитории корпус оригинальных промптов для каждой версии. Остальные патчи (UI, производительность) на старых версиях работают по принципу best-effort.

Для разовых правок tweakcc adhoc-patch выполняет однократную замену по строке/регулярному выражению/скрипту в изолированном Node (--experimental-permission). TUI построен на Ink + React.

Что можно настроить

  • Системные промпты - правки лежат в виде markdown-файлов в ~/.tweakcc/system-prompts/ и охватывают все 17 встроенных инструментов и сценариев работы агентов. Есть проверка конфликтов при выходе новых промптов от Anthropic.
  • Темы - визуальный выбор цветов HSL/RGB; темы переключаются штатной командой /theme в Claude Code.
  • Глаголы размышлений и спиннеры - замена списка глаголов и строки форматирования ("Claude is {verb}ing..."); настройка фаз и скорости спиннера.
  • Подсветка шаблонов ввода - регулярное выражение -> цвет в поле ввода (здесь же находится старый радужный эффект ultrathink).
  • Наборы инструментов - выборочное отключение инструментов путём их удаления из промпта, отправляемого в модель. Не просто скрытие в интерфейсе.
  • Поддержка AGENTS.md - фоллбэк на другие имена файлов инструкций (GEMINI.md, CRUSH.md и т. д.) для переносимости между различными средами по соглашениям flue / library-skills / agent-skill-linter.
  • Автоподтверждение в режиме плана (2.1.22+), память сессии + навык /remember, неблокирующий запуск MCP с размером пакета 1-20, выбор стиля таблиц, округление токенов, троттлинг строки статуса, фильтрация escape-последовательностей прокрутки, опциональный --dangerously-skip-permissions под sudo.
  • Opus Plan 1M - Opus 4.5 для планирования с контекстным окном в 1M токенов от Sonnet 4.5 для выполнения.

Использование

# Configure interactively
npx tweakcc

# Apply saved config (run after every CC upgrade)
npx tweakcc --apply

# Revert to stock CC
npx tweakcc --restore

# One-off patch
npx tweakcc adhoc-patch

# Native-binary surgery
npx tweakcc unpack /path/to/cc
npx tweakcc repack /path/to/cc

Порядок поиска каталога конфигурации: TWEAKCC_CONFIG_DIR -> ~/.tweakcc/ -> ~/.claude/tweakcc/ -> $XDG_CONFIG_HOME/tweakcc.

Конфигурацию можно загружать по HTTP для совместной работы в команде: npx tweakcc --apply --config-url https://example.com/config.json. Удалённая конфигурация объединяется в remoteConfig.settings, не перезаписывая локальную.

Программный API

Пакет также опубликован как библиотека, что позволяет создавать собственные инструменты патчинга:

import * as tweakcc from 'tweakcc';

const installations = await tweakcc.findAllInstallations();
const content = await tweakcc.readContent(installation);
const modified = content.replace(/old/g, 'new');
await tweakcc.writeContent(installation, modified);

Категории: config, installation, I/O, backup, utilities.

Ограничения

  • Привязка к конкретным версиям Claude Code: патчи, не относящиеся к системным промптам, могут молча ломаться на релизах CC, которые tweakcc ещё не поддерживает.
  • Патчит закрытый сторонний бинарник; ничто не мешает Anthropic изменить внутренности настолько, что tweakcc придётся догонять.
  • Патчи бинарников в Nix/NixOS требуют sudo (read-only хранилище) и удаляются при сборке мусора через nix-collect-garbage.
  • adhoc-patch пропускает шаг резервного копирования: сначала запустите обычный --apply, если хотите, чтобы затем сработал --restore.

Репозиторий

github.com/Piebald-AI/tweakcc - TypeScript, MIT, ~2000 звёзд, 155+ форков. Последний релиз v4.0.11 (5 марта 2026 года).

Linked from