ONEDEV

tweakcc

piebald-ai파일 497개

★ 2,503주당 +15조회 4

무엇인가

tweakcc는 Claude Code 실행 파일 자체를 수정해 에이전트가 받는 지시문과 도구 구성, 화면 표시 규칙을 사용자 정의로 덮어쓰는 CLI 도구다. 규율하는 영역은 세 가지다. 첫째, 에이전트에게 주입되는 시스템 프롬프트 원문. 둘째, `/toolset` 명령으로 호출되는 도구 묶음 구성. 셋째, 입력 상자·사고 표시·테마·상태줄 같은 UI 렌더링 규칙이다.

어떻게 동작하나

동작 방식은 규칙 파일을 컨텍스트에 얹는 것이 아니라 설치본을 직접 패치하는 것이다. Claude Code의 minified/컴파일된 JavaScript 또는 이를 담은 네이티브 바이너리를 `tweakcc unpack`으로 풀고, 설정에 정의된 패치 목록을 적용한 뒤 `tweakcc repack`으로 다시 묶는다. 패치 목록은 로컬 설정 파일에 두거나 원격 URL에서 불러올 수 있고, `tweakcc adhoc-patch`로 샌드박스된 Node.js 스크립트를 즉석 적용할 수도 있다. 적용 결과는 `tweakcc --restore`로 되돌린다.

무엇과 다른가

CLAUDE.md·AGENTS.md 같은 규칙 파일과는 적용 지점이 다르다. 규칙 파일은 대화 컨텍스트에 텍스트를 추가해 모델이 읽고 따르기를 기대하는 방식이라 토큰을 소모하고 무시될 수 있다. tweakcc는 시스템 프롬프트 원문과 렌더링 코드를 실행 파일 수준에서 교체하므로 컨텍스트를 쓰지 않고, 사용자 메시지로 우회하기도 어렵다. 같은 효과를 내려면 저장소를 포크해 빌드해야 했던 작업을 설정과 스크립트로 대체한다.

어떻게 쓰나

설치 없이 `npx tweakcc` 또는 `pnpm dlx tweakcc`로 실행한다. 프로젝트에 API로 붙이려면 `npm i tweakcc`를 쓴다. 첫 사용은 실행 후 대화형 메뉴에서 패치를 고르고 적용하는 흐름이며, 이후 Claude Code를 실행해 `/config`에서 새 테마를 선택하거나 `/toolset`, `/title`, `/rename`, `/remember` 같은 추가 명령을 쓴다.

전제와 한계

대상은 Claude Code 전용이며 Codex·Cursor·Copilot에는 적용되지 않는다. Windows·macOS·Linux에서 네이티브 바이너리 설치와 npm·yarn·pnpm·bun·Homebrew/Linuxbrew·nvm·fnm·n·volta·nvs·nodenv·Nix 설치를 모두 지원하고, macOS Apple Silicon에서는 ad-hoc 서명을 수행한다. Claude Code가 업데이트되면 패치를 다시 적용해야 하고, 지원하지 않는 버전에서는 패치가 실패할 수 있다.

유사 스킬