토큰 아끼는 AI 코딩 스킬 5개 설치법
캐러셀에 나온 5개는 모두 GitHub에 공개된 오픈소스예요. AI가 덜 읽고 덜 쓰게 해서 같은 일을 더 적은 토큰으로 끝내요.
| 도구 | 하는 일 | 공식 소개 수치 |
|---|---|---|
| 포니테일 (Ponytail) | 새 코드를 잔뜩 짜기 전에 이미 있는 코드·기본 기능으로 끝낼 수 있는지 먼저 봐요 | 토큰 45%↓, 코드 53%↓ |
| 케이브맨 (Caveman) | 답에서 인사·반복 설명만 빼고 코드·명령·숫자는 그대로 둬요 | 토큰 65%↓ (같은 답 63 → 20토큰) |
| RTK | AI가 실행한 git·테스트 같은 명령 결과를 핵심만 남겨 넘겨요 | 자주 쓰는 명령에서 60~90%↓ |
| 헤드룸 (Headroom) | 로그·JSON 같은 큰 자료를 AI에 보내기 전에 내 컴퓨터에서 압축해요 | JSON 60~95%↓ |
| 코드그래프 (CodeGraph) | 코드의 함수·호출 관계를 지도로 만들어 두고, 파일을 하나씩 열지 않고 지도에서 찾아요 | 토큰 62%↓, 도구 호출 88%↓ |
숫자는 각 프로젝트 공식 GitHub 소개(2026-10-19 확인) 그대로예요. 작업에 따라 줄어드는 폭은 달라요.
1. 시작 전에 알아둘 것
- 붙일 곳은 클로드 코드의 로컬 작업창이에요. 터미널에서
claude를 실행한 창이나 데스크톱 앱의 Code 탭처럼 내 PC 파일을 다룰 수 있는 곳이어야 해요. 일반 클로드 웹 채팅창에서는 설치할 수 없어요. - 코드 작업하는 프로젝트 폴더에서 클로드 코드를 열고 붙여 넣으세요. 코드그래프가 그 폴더의 코드 지도를 바로 만들어요.
- 클로드 코드가 아직 없으면 먼저 설치하고 로그인해 두세요. 나머지는 아래 요청문으로 AI가 설치해요.
- 헤드룸은 압축 모델까지 같이 받아서 설치 용량이 2GB 정도예요. 요청문이 디스크 여유를 먼저 확인해요.
- 챗GPT 계정으로 코덱스(Codex)를 쓰면 6번 요청문을 쓰세요.
2. 맥 설치 요청문
붙일 곳: Mac에서 실행 중인 클로드 코드.
텍스트
내 Mac의 클로드 코드에 토큰 아끼는 도구 5개(포니테일·케이브맨·RTK·헤드룸·코드그래프)를 설치해 줘. 지금 열린 폴더가 내가 코드 작업하는 프로젝트 폴더야.
공식 원본:
- 포니테일 https://github.com/DietrichGebert/ponytail
- 케이브맨 https://github.com/JuliusBrussee/caveman
- RTK https://github.com/rtk-ai/rtk (설치 문서 https://www.rtk-ai.app/guide/getting-started/installation)
- 헤드룸 https://github.com/headroomlabs-ai/headroom (설치 문서 https://docs.headroomlabs.ai/docs/installation)
- 코드그래프 https://github.com/colbymchenry/codegraph
0. claude --version, claude plugin list, rtk --version, headroom --version, codegraph version으로 이미 설치된 게 있는지 먼저 확인해. 이미 있는 건 지우거나 다시 깔지 말고 건너뛰어. ~/.claude/settings.json과 ~/.claude.json은 고치기 전에 백업해 둬.
1. 포니테일: claude plugin marketplace add DietrichGebert/ponytail 실행 후 claude plugin install ponytail@ponytail
2. 케이브맨: claude plugin marketplace add JuliusBrussee/caveman 실행 후 claude plugin install caveman@caveman
3. RTK: curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh 로 설치해. ~/.local/bin이 PATH에 없으면 내 셸 설정(~/.zshrc)에 추가해. rtk gain이 통계 화면을 보여 주는지 확인해(command not found면 이름만 같은 다른 rtk가 깔린 거니 알려 줘). 그다음 rtk init -g 로 클로드 코드에 연결해.
4. 코드그래프: curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh 로 설치해. 새 셸에서 codegraph install --target claude --location global --yes --init 를 실행해서 클로드 코드 연결과 이 폴더 색인까지 해. codegraph status로 색인된 파일 수를 확인해.
5. 헤드룸: 디스크 여유가 3GB 이상인지 확인해. uv가 없으면 curl -LsSf https://astral.sh/uv/install.sh | sh 로 설치하고, uv tool install --python 3.13 "headroom-ai[all]" 로 설치해. headroom --version 으로 확인해. headroom wrap은 실행하지 마(내가 직접 켤 거야).
끝나면 도구별로 설치된 버전, 성공/실패, 바뀐 설정 파일 경로를 표로 알려 줘. 결제·로그인·API 키 입력은 하지 마.
3. 윈도우 설치 요청문
붙일 곳: Windows에서 실행 중인 클로드 코드. 명령은 PowerShell 기준이에요.
텍스트
내 Windows PC의 클로드 코드에 토큰 아끼는 도구 5개(포니테일·케이브맨·RTK·헤드룸·코드그래프)를 설치해 줘. 지금 열린 폴더가 내가 코드 작업하는 프로젝트 폴더야. 설치 명령은 PowerShell에서 실행해.
공식 원본:
- 포니테일 https://github.com/DietrichGebert/ponytail
- 케이브맨 https://github.com/JuliusBrussee/caveman
- RTK https://github.com/rtk-ai/rtk (설치 문서 https://www.rtk-ai.app/guide/getting-started/installation)
- 헤드룸 https://github.com/headroomlabs-ai/headroom (설치 문서 https://docs.headroomlabs.ai/docs/installation)
- 코드그래프 https://github.com/colbymchenry/codegraph
0. 지금 작업창이 Windows 네이티브인지 WSL인지 확인해. 이 안내는 네이티브 Windows용이야. WSL이면 진행하지 말고 먼저 알려 줘. claude --version, claude plugin list, rtk --version, headroom --version, codegraph version으로 이미 설치된 게 있는지 확인하고, 있는 건 지우거나 다시 깔지 말고 건너뛰어. %USERPROFILE%\.claude\settings.json과 %USERPROFILE%\.claude.json은 고치기 전에 백업해 둬. 보안 설정을 전역으로 끄지 마.
1. 포니테일: claude plugin marketplace add DietrichGebert/ponytail 실행 후 claude plugin install ponytail@ponytail
2. 케이브맨: claude plugin marketplace add JuliusBrussee/caveman 실행 후 claude plugin install caveman@caveman
3. RTK: winget install rtk-ai.rtk 로 설치하고, 일부 기능이 쓰는 ripgrep도 winget install BurntSushi.ripgrep.MSVC 로 설치해. 새 PowerShell에서 rtk gain이 통계 화면을 보여 주는지 확인해(command not found면 이름만 같은 다른 rtk가 깔린 거니 알려 줘). 그다음 rtk init -g 로 클로드 코드에 연결해.
4. 코드그래프: irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex 로 설치해. 새 PowerShell에서 codegraph install --target claude --location global --yes --init 를 실행해서 클로드 코드 연결과 이 폴더 색인까지 해. codegraph status로 색인된 파일 수를 확인해.
5. 헤드룸: 디스크 여유가 3GB 이상인지 확인해. uv가 없으면 powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" 로 설치하고, 새 PowerShell에서 uv tool install --python 3.13 "headroom-ai[all]" 로 설치해. headroom --version 으로 확인해. 설치 중 Rust나 MSVC가 없다는 오류가 나면 더 진행하지 말고 오류 내용을 알려 줘. headroom wrap은 실행하지 마(내가 직접 켤 거야).
끝나면 도구별로 설치된 버전, 성공/실패, 바뀐 설정 파일 경로를 표로 알려 줘. 결제·로그인·API 키 입력은 하지 마.
설치 앱 승인 창(winget, 관리자 권한)이 뜨면 직접 눌러 주세요.
4. 직접 해야 하는 것
AI가 설치를 끝낸 뒤 사람이 할 일은 이것뿐이에요.
- 클로드 코드를 완전히 껐다가 새로 켜 주세요. 포니테일·케이브맨·RTK·코드그래프는 새로 연 창부터 켜져 있어요.
- 헤드룸은 켜는 방법만 바뀌어요. 터미널(윈도우는 PowerShell)에서
claude대신 아래처럼 켜면 헤드룸을 거쳐서 실행돼요.
텍스트
headroom wrap claude
원래대로 돌리려면 headroom unwrap claude예요. wrap은 코드 검색 도구 Serena도 같이 연결해요(공식 안내).
- 다른 프로젝트 폴더에서는 코드 지도를 한 번 만들어 주세요. 그 폴더에서 연 클로드 코드에 이렇게 말하면 돼요.
텍스트
이 폴더에서 codegraph init 을 실행해서 코드그래프 색인을 만들고, codegraph status 결과를 알려 줘.
5. 써 보는 법
- 케이브맨: 새 창부터 답이 짧아져요. 원래 말투로 돌리려면
stop caveman, 다시 켜려면/caveman. - RTK: 며칠 쓰고 나서 클로드 코드에 “rtk gain 결과 보여 줘”라고 하면 지금까지 줄인 양이 나와요.
- 헤드룸:
headroom wrap claude로 켠 상태에서headroom perf를 실행하면 줄인 양이 나와요. - 코드그래프: “이 프로젝트에서 로그인 처리하는 코드 어디 있어?“처럼 물어보면 파일을 하나씩 열지 않고 지도에서 찾아요.
- 포니테일: 따로 할 건 없어요. 기능을 만들어 달라고 하면 이미 있는 코드부터 찾아 써요.
6. 코덱스(챗GPT)에서 쓰기
챗GPT 계정으로 코덱스(Codex CLI)를 쓰면 5개 모두 코덱스에도 연결할 수 있어요(각 프로젝트 공식 안내). 2·3번으로 RTK·헤드룸·코드그래프 프로그램을 먼저 설치한 뒤, 코덱스 작업창에 붙여 넣으세요. 윈도우·맥 같은 요청문이에요.
텍스트
내 PC의 코덱스(Codex CLI)에 토큰 아끼는 도구 5개를 연결해 줘. 지금 운영체제가 Windows인지 Mac인지 먼저 확인하고, Windows면 PowerShell에서 실행하고 npx 대신 npx.cmd를 써.
0. ~/.codex/config.toml(Windows는 %USERPROFILE%\.codex\config.toml)은 고치기 전에 백업해 둬. 이미 연결된 건 건너뛰어.
1. 포니테일: codex plugin marketplace add DietrichGebert/ponytail 실행 후 codex plugin add ponytail@ponytail
2. 케이브맨: npx -y skills add JuliusBrussee/caveman -g (Node.js가 없으면 nodejs.org 공식 LTS 설치를 준비하고 설치 승인만 내가 하게 안내해)
3. RTK: rtk --version이 되면 rtk init -g --codex 실행. 안 되면 https://github.com/rtk-ai/rtk 설치 안내대로 먼저 설치해.
4. 코드그래프: codegraph version이 되면 codegraph install --target codex --location global --yes --init 실행. 안 되면 https://github.com/colbymchenry/codegraph 설치 안내대로 먼저 설치해.
5. 헤드룸: headroom --version만 확인해. wrap은 실행하지 마.
끝나면 도구별로 성공/실패와 바뀐 설정 파일 경로를 표로 알려 줘. 결제·로그인·API 키 입력은 하지 마.
끝나면 직접 할 일:
- 코덱스를 껐다 켠 뒤
/hooks를 열어 포니테일의 훅 2개를 허용하고 새 스레드를 열어요(포니테일 공식 안내). - 케이브맨은
$caveman으로 켜요. - 헤드룸은
codex대신headroom wrap codex로 켜요.
7. 직접 확인한 범위
2026-10-19에 각 공식 README·설치 문서를 보고 썼어요.
| 항목 | 확인한 것 |
|---|---|
| 맥 설치 명령 | 맥스 맥(Apple Silicon)의 빈 사용자 폴더에서 요청문의 명령을 그대로 실행해 5개 모두 설치·연결됨: 포니테일 5.3.2, 케이브맨 4.0.1, RTK 1.0.1, 코드그래프 1.6.2, 헤드룸 0.41.0 |
| 코덱스 연결 명령 | 같은 방식으로 포니테일 플러그인·케이브맨 스킬·RTK·코드그래프의 코덱스 연결까지 실행됨 |
| 윈도우 명령 | RTK·헤드룸 공식 설치 문서와 코드그래프 README의 Windows 명령 그대로예요. 윈도우 PC에서 직접 실행해 보지는 않았어요 |
| 로그인한 상태로 써 보기 | 설치까지 확인했어요. 설치 뒤 막히면 오류 화면을 그대로 클로드 코드에 보여 주고 “공식 README 보고 고쳐 줘”라고 하세요 |