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 및 동작 사용자 지정 옵션을 제공합니다.