프롬프트 옵티마이저는 무엇이고, 누구를 위한 것인가
Claude Code나 Codex에 길고 공손한 프롬프트를 쓴다면, 그 안의 모든 단어는 매 턴마다 다시 읽히는 내용의 일부입니다. 이 글이 존재하는 이유가 그것입니다. 대화 시작 부분의 모든 내용은 그 뒤의 매 턴마다 다시 읽히므로, 한 번 쓴 인사말도 이후 모든 턴에서 다시 읽힙니다. 공손함은 좋지만, 그것이 계속 따라다니며 비용을 늘리는 셈입니다.
프롬프트 옵티마이저는 이 문제에 대한 답입니다. 문서는 한 줄로 이렇게 설명합니다. "프롬프트를 더 짧고 직접적으로 다시 씀. 예의 표현, 돌아가는 설명, 반복되는 문장을 잘라냄." 기본 요금제인 Basic FREE에 포함되며, 로그인 없이 내 컴퓨터의 로컬 패널에서 실행됩니다.
두 단계로 작동합니다. 먼저 로컬 규칙이 첫 번째로 잘라냅니다. 그다음 내 계정으로 실행되는 공식 claude가 더 짧은 버전을 시도합니다. 어떤 버전도 더 짧아지지 않으면 원문이 손대지 않은 채 돌아옵니다. 백틱 사이의 내용도 건드리지 않으므로 파일 이름과 함수 호출은 그대로 남습니다. 그리고 우리 도구는 우리가 직접 설명하는 것이니, 어디서나 반복하는 한 가지를 말씀드립니다. HarnessUp은 내 계정으로 공식 claude와 codex를 실행하며, 내 토큰이나 키를 읽거나 저장하지 않습니다.
유틸리티 페이지의 Prompt Optimizer 데모에서 직접 써 볼 수 있고, Prompt Optimizer 문서에서 공식 설명을 읽을 수 있습니다. 더 넓은 그림을 먼저 보고 싶다면, 이전 글 HarnessUp 소개: 같은 토큰으로 더 많은 일을에서 이 도구가 속한 계층을 설명합니다.
첫 사용, 단계별로
패널의 경로는 Panel › Utilities › Prompt Optimizer입니다. 패널에서 켜면 됩니다. 요금제 밖의 도구는 그림자 모드로 실행되며, 이는 측정만 하고 아무것도 적용하거나 삭제하지 않는다는 뜻입니다. 이 도구는 Basic FREE이므로 요금제 안에 포함됩니다.
직접 보기 위해 아무것도 설치할 필요는 없습니다. 유틸리티 페이지에 데모가 있습니다. 프롬프트를 붙여 넣고 Trim(단축키 E)을 누르면 크기가 줄어드는 것을 볼 수 있습니다. Back to original(단축키 R)을 누르면 텍스트가 처음 그대로 돌아갑니다.
데모에 대해 솔직히 말씀드리면, 데모는 단순화되어 있습니다. 데모에서는 로컬 규칙만 작동합니다. 실제 제품은 그 뒤에 공식 claude의 버전도 시도하지만, 데모는 그렇지 않습니다. 우리가 가진 문서에는 이 단계들 외에 더 자세한 내용이 없습니다. 예를 들어 최적화된 프롬프트가 에이전트에 어떻게 전달되는지는 문서에 없으므로, 여기서 추측하지 않겠습니다.
이 도구가 값을 하는 상황들
A. 공손한 말투의 버그 보고
목표: 요청과 파일 참조는 남기고, 인사치레는 버립니다.
과정: 이것을 데모에 그대로 붙여 넣었습니다:
Hi there! Hope you're well. Please, if possible, I would really appreciate it if you could help me with one thing. Basically, I need you to fix the login bug. As I said, the login bug needs to be fixed. The error shows up in `auth.ts` in the `validate()` function. Thanks so much in advance, really!
그다음 Trim을 눌렀습니다.
결과: 데모의 JavaScript를 실행한 결과, 측정된 출력은 다음과 같았습니다:
Fix the login bug. The login bug needs to be fixed. The error shows up in `auth.ts` in the `validate()` function.
299자에서 113자로, 75 토큰에서 29 토큰으로 줄었고, 62% 감소입니다. 토큰 수치는 데모의 추정치로, 글자 수를 4로 나눈 값입니다. auth.ts와 validate()는 백틱 안에 있었기 때문에 그대로 똑같이 남았습니다.
옆에 있는 데모의 Token Calculator는 이 감소를 돈으로 환산해 보여 줍니다. 제어값을 40 라운드로 두고, 예시 가격으로 100만 입력 토큰당 US$ 3을 설정하면, 세션의 Original은 US$ 0.009, Trimmed는 US$ 0.003, Kept in your pocket은 US$ 0.006으로 표시됩니다. 가격, 라운드 수, 글자 수 ÷ 4는 모두 예시이며, 데모는 캐시 할인을 적용하지 않는다는 점을 기억하십시오.
아래 스크린샷은 유틸리티 페이지의 데모가 아니라, 같은 프롬프트를 넣은 HarnessUp 패널의 Prompt Optimizer입니다. 패널 버전은 한 걸음 더 나아가 반복된 문장도 지우고 오류 위치를 다시 써서 299자를 74자로 줄이며, 자체 추정치로는 159토큰이 39토큰이 됩니다(−75%). 백틱 안의 코드는 여기서도 그대로입니다.
B. 남아 있는 반복
목표: 두 번 말한 문장을 없앱니다.
과정: 위의 출력을 다시 보십시오. 반복된 문장 "The login bug needs to be fixed."는 남았습니다. 데모의 로컬 규칙은 겹침 정도가 0.75 기준을 넘을 때만 반복 문장을 자르는데, 여기서는 넘지 않았습니다.
결과: 이런 잔여 반복은 제품의 두 번째 단계, 즉 내 계정의 공식 claude가 더 짧은 버전을 시도하는 단계에서 다뤄지는 종류입니다. 문서는 그 출력의 예시를 공개하지 않으므로, 예시를 지어내지 않겠습니다.
C. 이미 간결한 프롬프트
목표: 잘라낼 것이 있는지 알아봅니다.
과정: 이미 짧고 직접적인 프롬프트를 붙여 넣고 Trim을 누릅니다.
결과: 데모는 "No gain this time: the original comes back unchanged."와 "Nothing to cut. The Prompt Optimizer returns your text as it was."라고 답합니다. 이것은 데모 자체의 메시지입니다.
다른 도구와 함께 쓰기
Token Calculator가 자연스러운 이웃입니다. 데모에서는 옵티마이저 옆에 있으면서 감소분을 돈으로 바꿔 줍니다. 실제 도구는 문서의 표현대로 "텍스트나 토큰 수를 모델의 각 요금 구간별 비용으로 바꾸고", 그 옆에 내 세션에서 측정된 지출을 보여 줍니다. 이것도 Basic FREE이며, Token Calculator 문서에 항목이 있습니다.
알아 둘 가치가 있는 다른 도구는 MetaPrompt · Prompt Creator로, 역시 Basic FREE입니다. 34가지 유형이 7개 그룹으로 나뉘어 있고, 최근 30번의 생성 기록을 보관하며, 출력에는 제목, 프롬프트, 매개변수, 변형이 함께 나옵니다. Panel › Utilities › MetaPrompt에서 찾을 수 있으며, MetaPrompt 문서에 설명되어 있습니다.
문서는 이 도구들이 연결되어 쓰인다고 설명하지 않습니다. 순서가 필요하다면 우리가 제안하는 순서가 있습니다. 이것은 문서화된 파이프라인이 아니라 우리 집의 권장 방식입니다. MetaPrompt로 프롬프트를 만들고, Prompt Optimizer로 다듬고, Token Calculator로 측정합니다. 규모를 말씀드리면, 유틸리티 목록에는 도구가 23개 있습니다. Basic FREE 13개, Pro 8개, Ultra 2개입니다.
한계와 하지 않는 일
Prompt Optimizer는 내가 쓴 것을 다듬습니다. 모델이 나에게 다시 읽어 주는 것은 다듬지 않습니다. 이 도구는 내가 쓴 내용을 다루며, 모델이 되돌려 주는 내용은 다루지 않습니다.
데모의 규칙은 영어 패턴 12개입니다. 인사말, "please", "basically", "as I said", "thanks so much in advance" 같은 것들입니다. 문서는 프롬프트의 크기 제한, 제품이 지원하는 언어, 공식 claude 시도의 비용을 명시하지 않습니다. 그 빈칸을 숫자로 채우기보다는 그렇게 말씀드리는 편이 낫습니다.
데모의 감소가 반복 문장이 사라진다는 것을 보장하지도 않습니다. 상황 B에서 보았듯이 그렇습니다. 그리고 데모가 보여 주는 숫자는 추정치이며, 월말에 도착하는 청구서가 아닙니다.
프롬프트가 작은 부분일 때
예시 프롬프트는 75 토큰입니다. 프롬프트는 세션 안의 여러 입력 중 하나이며, 다른 HarnessUp 도구들은 나머지 입력에서 작동합니다. Prompt Optimizer는 HarnessUp의 무료 도구 중 하나이고, HarnessUp은 Claude Code와 Codex에서 토큰을 아끼기 위해 내 컴퓨터에서 돌아가는 132개 이상의 도구를 모아 둡니다.
직접 써 보고 싶다면 HarnessUp 무료 설치를 하거나, Pro가 무엇을 더하는지 보십시오. Pro는 연간 요금제 기준 월 US$ 6, 월간 결제 시 US$ 9이며, 카드나 가입 없이 7일 무료 체험이 있습니다.