← 모든 글

구성

token으로 값을 뽑아내는 Claude Code 스킬과 훅

설치하는 모든 스킬은 매 세션, 작동하든 안 하든 컨텍스트로 지불하는 작은 구독이다. 훅은 전혀 다른 구매이고, 그 차이에 돈의 대부분이 걸려 있다.

이 글은 여기서 설명하는 도구를 만드는 회사 HarnessUp의 프로덕트 매니저 Ted Mavera가 작성했습니다. 이 블로그의 글은 인공지능의 도움을 받아 작성되며, 게시 전에 팀이 검토합니다.

크림색 도자기 기계에 다섯 개의 스킬 카트리지가 꽂혀 있고, 각 카트리지가 주황색 코인 원반을 제 유리관으로 내보낸다. 옆에는 놋쇠 모래시계, 앞에는 분리된 카트리지 하나.

이 글을 쓰는 이유

이제 Claude Code 스킬 목록은 어디에나 있다. 상위 10개, 프런트엔드에 가장 좋은 것, 당신의 워크플로를 바꿔 줄 것들. 그중 어느 것도 알려주지 않는 사실은, 그 목록의 모든 항목이 구매이고, 작업 자체와 같은 화폐로 지불하며, 그날 쓰든 쓰지 않든 청구된다는 점이다. 목록은 유용성을 줄 세운다. 비용을 줄 세우는 사람은 없다.

이 글은 후자를 다룬다. 스킬이 나쁜 거래라서가 아니라, 어떤 스킬은 하네스 전체에서 가장 좋은 거래이기 때문이고, 본전을 뽑는 스킬과 조용히 매 세션에 세금을 매기는 스킬의 차이가 측정 가능한 차이인데도 거의 아무도 측정하지 않기 때문이다.

스킬을 추가할 때 지출하는 두 가지 방식

스킬에는 정의가 있고, 그 정의의 일부는 세션이 시작되는 순간부터 모델의 컨텍스트에 있다. 에이전트가 그 스킬이 존재하는지, 언제 꺼내 쓸지 알기 위해서다. 그 부분이 고정 비용이다. 모든 세션에서, 모든 대화에서, 스킬이 실제로 실행되는지와 무관하게 지불된다. 스킬이 실행되면 본문이 로드되고 그 지시가 이후 턴을 형성한다. 그것이 변동 비용이다.

무시되는 쪽은 고정된 절반이고, 가장 재미없는 방식으로 복리처럼 늘어난다. 세션 하단에서 각각 작아 보이는 스킬 열 개가 모여, 모든 대화의 모든 턴에서 다시 읽히는 블록이 된다. 다른 컨텍스트와 같은 산수다. 대화 맨 앞에 있는 것은 한 번이 아니라 계속해서 청구된다.

훅은 다르게 작동하고, 목록이 가장 자주 틀리는 부분이 여기다. 훅은 하네스가 이벤트에 실행하는 명령이다. 도구 호출 전, 편집 후, 세션이 멈출 때. 대부분의 훅은 token을 전혀 더하지 않는다. 지연을 더하고, 다음에 일어날 일을 바꾼다. 쓸모없는 쓰기를 막거나, 반복 읽기를 거부하거나, 편집 후 프로젝트를 컴파일하는 훅은 당신에게 밀리초를 청구하고 턴 하나를 통째로 돌려줄 수 있다. token 기준으로 좋은 훅은 거의 무료이고, 나쁜 훅이 비싼 이유는 컨텍스트를 읽어서가 아니라 실패하고, 재시도하고, 모든 것에 반응하기 때문이다.

스킬을 남겨 두기 전에 값을 매기는 법

네 가지 질문을 이 순서로. 시작 컨텍스트에 무엇을 더하는가? 실행될 때 턴을 몇 개 더하고 몇 개 없애는가? 출력을 얼마나 만드는가? 그리고 평범한 한 주에 실제로 몇 번 작동하는가?

대부분의 경우를 결정하는 것은 네 번째 질문이다. 한 달에 두 번 작동하지만 매 세션 컨텍스트에 함께 실려 가는 스킬은 거의 쓰지 않는 무언가에 대한 구독이다. 같은 스킬이라도 잘 쓰였다면, 작동하는 그 두 번에 아끼는 것의 일부만큼만 비용이 든다. 다만 그 두 번이 실제일 때만 그렇다.

우리 패널에는 정확히 이 지점을 겨냥한 화면이 있다. Optimize Harness는 각 스킬, 서브에이전트, 플러그인, 서버의 측정된 비용을 끄는 스위치와 함께 보여 주며, 의도적으로 추측을 거부한다. 측정되지 않은 것에는 숫자를 주지 않는다. 옆에 있는 Rules Auditor는 CLAUDE.md의 규칙에 대해 같은 일을 한다. 매 왕복마다 다시 로드되는 각 블록의 고정 비용을 보여 주고, 스스로 편집하지 않은 채 더 가벼운 파일을 제안한다. 둘 다 Pro이며, 이것들이 가능하게 하는 측정 습관은 카탈로그의 어떤 단일 도구보다 값지다.

작업대 위에 펼쳐진 작은 장부. 연필로 제목이 적힌 두 개의 열이 있고, 왼쪽 페이지에는 돋보기가 놓여 있으며, 근처에 놋쇠 나사 몇 개가 흩어져 있다.
한 페이지에는 고정 비용, 다른 페이지에는 변동 비용. 대부분의 목록은 오른쪽 페이지만 읽는다.

보통 본전을 뽑는 범주

재읽기를 막는 것들. 에이전트 세션에서 가장 비싼 습관 하나는 같은 내용을 두 번 읽는 것이다. 본문보다 골격을 먼저 주거나, 에이전트가 이미 본 구간을 거부하거나, 전체 이력 대신 안정적인 요약을 유지하는 것은 그렇지 않으면 수십 번 다시 보내질 컨텍스트를 되사는 일이다. Read Router는 큰 컨텍스트 파일을 처음 읽을 때 색인을 돌려주고 전문은 요청이 있을 때만 준다. Delta Read는 에이전트가 이미 본 줄을 추적한다. Hot Context는 오래된 이력을 상주시키지 않고 검색 가능한 조각으로 잘라 둔다.

도구 출력에 상한을 두는 것들. 육백 개가 일치하는 grep, 구백 줄을 찍는 테스트 스위트, 내비게이션이 사만 자로 도착하는 가져온 페이지. 이 모두가 컨텍스트에 들어와 머문다. Head Limit은 호출마다 거대한 grep 결과를 잘라 내고 나머지를 어떻게 요청할지 에이전트에게 알려 준다. Smart Cut은 큰 파일의 첫 페이지를 전체 크기와 함께 전달한다. Output Diet와 Terminal Guide는 시작, 끝, 오류 줄을 남기고 전체 출력은 디스크에 둔다.

낭비되는 턴을 막는 것들. 턴은 시스템에서 가장 비싼 단위이고, 전형적인 낭비는 컴파일러가 이미 알고 있던 것을 알아내는 데 쓰는 턴이다. First Pass는 편집 후 빌드하고 오류를 다음 턴으로 밀어 넣는다. Conduction Write는 파일을 그대로 두게 될 쓰기를 막는다. Way Out은 도구가 실패했을 때 프로젝트에서 같은 문제를 해결한 예시를 가리킨다. 근거가 있을 때만 그렇게 한다.

답변을 짧게 만드는 것들. Response Diet는 서두 문구가 대화에 들어오기 전에 잘라 낸다. 자를 수 있는 가장 싼 지점이다. No Comment는 뻔한 것에 주석을 달지 말라고 요청하고, 이미 있는 주석은 건드리지 않은 채 새 코드가 얼마나 여전히 주석과 함께 도착하는지 측정한다.

보통 본전을 뽑지 못하는 범주

모델이 이미 가진 문서를 다시 진술하는 스킬. 형식이 필수 요건이 아니라면 페르소나와 포매팅 스킬. 겹치는 세 개의 MCP 서버, 각각 시작 시 프로젝트를 검사한다. 더 미묘한 경우도 있다. 정말 유용하지만 두 버전으로, 조금씩 다른 설명과 함께 두 번 설치된 스킬. 이제 에이전트는 둘 다에 값을 치르고 하나를 골라야 한다.

어느 것도 죄가 아니다. 모두 영수증을 보여 주지 않은 사람이 하나씩 내린 합리적인 구매다. 문제는 개별 스킬이 아니라, 합계의 값을 한 번도 매기지 않았다는 것이다.

20분 감사

설치한 것을 나열하라. Optimize Harness를 열어 항목별 측정 비용을 보고, 이번 주에 쓰지 않은 것은 모두 꺼라. Rules Auditor를 열어 컨텍스트 파일의 블록별 고정 비용을 읽어라. 대부분은 프로젝트가 버린 관례를 설명하는 블록을 최소 하나 발견한다. 평범한 세션을 세 번 실행하라. 첫 세션의 시작 컨텍스트와 네 번째를 비교하라.

힘들게 배운 경고 하나. 한 번에 하나씩 끄고, 무엇을 제거했는지 적어 두라. 비활성화한 스킬이 아낀 token보다 품질에서 더 많은 비용을 만들 수 있고, 아는 방법은 그것이 조용해진 주를 알아차리는 것뿐이다.

이 글이 약속하지 않는 것

가벼운 컨텍스트가 자동으로 좋은 컨텍스트는 아니다. 어떤 스킬은 하루에 세 번의 나쁜 턴을 막아 고정 비용을 벌어들인다. 그것을 잘라 내는 것은 최악의 절약이다. 측정은 가격을 알려 주지만 가치는 알려 주지 않는다. 그 판단은 당신에게 남는다. 여기 있는 모든 도구가 클릭 한 번으로 되돌릴 수 있고 측정 계층이 무료인 이유이기도 하다. 뛰기 전에 볼 수 있어야 하기 때문이다.

HarnessUp 자체는 스킬도, 훅도, 플러그인도, MCP 서버도, 프록시도 아니다. Claude Code와 Codex의 공식 훅을 통해 작동하고 당신의 token이나 키를 절대 읽지 않는 로컬 두 번째 계층이다. 이 글에서 그 구분이 중요하다. 위의 어떤 도구도 스킬처럼 시작 컨텍스트에 정의를 추가하지 않는다. 그것들은 프롬프트가 아니라 트래픽에 작용한다.

설치한 것의 값을 매기세요. HarnessUp을 무료로 설치하고 당신의 설정에 있는 모든 스킬, 서브에이전트, 서버의 측정된 비용을 확인하세요.

무료로 설치