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）を選択し、トークン数を表示し、ステータスラインの更新頻度を調整し、さまざまな 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 の拡張機能を構築し、パッチを注入する再現可能な方法を必要とする開発者。
研究者。Claude のソースを変更せずに、代替のモデル選択ロジック（例：opusplan[1m] エイリアス）を実験したい研究者。

制限と注意点

このツールは特定の Claude Code バージョンに依存しています。2.1.162 で検証されており、新しいリリースでは更新が必要になる場合があります。
Claude Code が更新されると、パッチは削除されます。復元するには tweakcc --apply を再実行する必要があります。
ネイティブバイナリのパッチ適用には Node 20+（サンドボックススクリプトモード用）が必要で、Apple Silicon ではアドホックなコード署名が必要になる場合があります。

TL;DR: tweakcc は、Claude Code AI アシスタントデスクトップアプリの JavaScript バンドルにパッチを適用して、テーマ設定、拡張、調整を行うための Node ベースの CLI です。npm インストールとネイティブ Bun バイナリの両方をサポートし、プログラムによる使用のための API を提供し、パワーユーザーとチーム向けの豊富な UI および動作のカスタマイズオプションを備えています。