Claude Code에 더 나은 리포지토리 인터페이스를 제공했더니 명령어가 55% 줄었습니다.
I gave Claude Code a better interface to my repo. It generated 55% fewer commands.
핵심 요약
반복적인 작업을 고수준의 결정론적 명령어로 추상화하여 Claude Code의 효율성을 높인 실험 결과입니다.
- 성능 최적화 — 반복 작업을 고수준 명령어로 통합하여 토큰 사용량과 명령어 수를 획기적으로 줄임
- 결정론적 접근 — 에이전트가 매번 수행 방식을 재구성하지 않게 하여 작업 효율을 개선함
- 실험적 검증 — 세션 로그 분석을 통해 명령어 55% 감소 및 도구 출력 90% 감소 확인
- 커뮤니티 공감 — 많은 사용자가 유사한 방식(래퍼 스크립트 등)으로 에이전트 성능을 개선하고 있음
Claude Code 가지고 간단한 실험 좀 해봤음.
같은 레포지토리에서 두 개의 세션으로 나눠서 똑같은 작업을 돌려봤는데, 둘 다 Opus 5에 medium effort 설정으로 맞췄다.
세션 1은 기본 설정: Claude가 직접 레포지토리 뒤져보고, 명령어 알아내서 실행하고, 결과값까지 다 처리하게 둠.
세션 2는 반복되는 레포지토리 작업들을 미리 상위 수준의 결정론적(deterministic) 명령어로 바꾸도록 유도하는 Skill을 추가함.
어차피 무엇을 할지는 에이전트가 결정하는 건 똑같음. 차이점은 어떻게 할지를 매번 다시 짜야 하느냐 아니냐였지.
첫 번째 실행 결과:
-
commands: 52 → 23
-
tool output: 21.5 KB → 8.4 KB
-
agent output tokens: 4,745 → 1,958
그다음에도 똑같은 작업을 몇 번 더 반복해 봤는데, Skill을 적용한 세션에서는 툴 출력값이 대략 90% 정도 줄어들더라.
아직은 아주 작은 실험 수준임. 레포지토리 하나에 세 번 돌려본 거라 이걸 무슨 벤치마크라고 하긴 좀 그렇지.
그냥 다른 사람들도 이런 거 느꼈는지 궁금해서 올려봄. Claude가 매번 똑같은 명령어 찾아내고, 순서 정하고, 어떤 결과값이 중요한지 파악하는 데 힘을 꽤나 쏟는 것 같더라고.
혹시 똑같이 해보고 싶은 사람 있을까 봐 Skill이랑 실험 노트 링크 남겨둠:
github.com/a-dithya-b/agent-native-cli
이게 별로 도움 안 되는 결과도 나오는지 진짜 궁금하네. 결과 좀 공유해주라.
