O que é o Prompt Optimizer e para quem ele serve
Se você escreve prompts longos e educados para o Claude Code ou o Codex, cada palavra deles faz parte do que é lido de novo a cada turno. Por isso este artigo existe. Tudo o que está no começo de uma conversa é lido de novo a cada turno que vem depois, então um cumprimento que você digitou uma vez é relido em todos os turnos seguintes. A cortesia é bonita; ela só continua pegando carona.
O Prompt Optimizer é a nossa resposta a isso. A documentação o descreve em uma linha: "Reescreve o prompt mais curto e mais direto, cortando cortesia, desvio e frases repetidas." Ele faz parte do plano Basic, que é FREE, e roda no painel local da sua máquina, sem login.
Ele funciona em duas etapas. Regras locais fazem o primeiro corte. Depois, o claude oficial na sua conta tenta uma versão ainda menor. Se nenhuma versão sair menor, o seu original volta intacto. Tudo o que estiver entre crases também não é tocado, então nomes de arquivo e chamadas de função sobrevivem. E como somos nós que descrevemos a nossa própria ferramenta, aqui vai a parte que repetimos em todo lugar: o HarnessUp roda o claude e o codex oficiais com a sua conta, e nunca lê nem guarda o seu token ou a sua chave.
Você pode testar na demo do Prompt Optimizer na página Utilities, e ler a entrada oficial na documentação do Prompt Optimizer. Se quiser primeiro o quadro geral, nosso texto anterior, Apresentando o HarnessUp: mais trabalho com os mesmos tokens, explica a camada em que esta ferramenta vive.
Seu primeiro uso, passo a passo
O caminho no painel é Panel › Utilities › Prompt Optimizer. Você o liga no painel. Uma ferramenta que está fora do seu plano roda em modo sombra, o que quer dizer que ela mede, não aplica nada e não apaga nada. Esta é Basic FREE, então está dentro do plano.
Você não precisa instalar nada para vê-lo funcionar. Na página Utilities há uma demo. Cole o seu prompt, aperte Trim (atalho E) e veja o tamanho cair. Back to original (atalho R) devolve o seu texto exatamente como estava.
Uma nota franca sobre a demo: ela é simplificada. Só as regras locais atuam nela. O produto ainda tenta, depois, a versão do claude oficial, e a demo não faz isso. A documentação que temos não entra em mais etapas do que estas, por exemplo como o prompt otimizado chega ao agente, então não vamos chutar isso aqui.
Situações em que ele se paga
A. Um prompt educado com um relato de bug
Objetivo: manter o pedido e as referências aos arquivos, tirar as gentilezas.
Passos: colamos isto na demo, literalmente:
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!
Então apertamos Trim.
Resultado: rodar o JavaScript da demo nos deu esta saída, medida:
Fix the login bug. The login bug needs to be fixed. The error shows up in `auth.ts` in the `validate()` function.
São 299 caracteres que caíram para 113, e 75 tokens para 29, um corte de 62%. Os números de tokens são a estimativa da demo: caracteres divididos por 4. auth.ts e validate() saem idênticos, porque estavam entre crases.
Ao lado, a Token Calculator da demo transforma o corte em dinheiro. Com o controle em 40 rodadas e um preço de exemplo de US$ 3 por milhão de tokens de entrada, ela mostra Original na sessão US$ 0,009, Enxuto na sessão US$ 0,003 e Guardado no seu bolso US$ 0,006. Tenha em mente que o preço, as rodadas e os caracteres ÷ 4 são todos ilustrativos, e a demo não aplica nenhum desconto de cache.
A captura abaixo não é a demo da página de Utilitários: é o Prompt Optimizer dentro do painel da HarnessUp, com o mesmo prompt. A versão do painel vai além: também corta a frase repetida e reescreve onde está o erro, indo de 299 para 74 caracteres, e a estimativa dela mostra 159 tokens antes e 39 depois (−75%). O código entre crases continua idêntico ali também.
B. A repetição que sobrou
Objetivo: tirar uma frase que você disse duas vezes.
Passos: olhe a saída acima de novo. A frase repetida "The login bug needs to be fixed." sobreviveu. As regras locais da demo só cortam uma frase repetida quando a sobreposição passa de um limiar de 0,75, e aqui ela não passou.
Resultado: esse é o tipo de resto que a segunda etapa do produto, o claude oficial na sua conta, é a etapa que tenta uma versão menor. A documentação não publica um exemplo da saída dela, então não vamos inventar um para você.
C. Um prompt que já está enxuto
Objetivo: descobrir se há algo para cortar.
Passos: cole um prompt que já esteja curto e direto, e aperte Trim.
Resultado: a demo responde "No gain this time: the original comes back unchanged." e "Nothing to cut. The Prompt Optimizer returns your text as it was." Essas são as mensagens da própria demo.
Combinando com outras ferramentas
A Token Calculator é a vizinha natural. Na demo ela fica ao lado do otimizador e converte o corte em dinheiro. A real, nas palavras da documentação, "transforma um texto ou uma contagem de tokens em custo, em cada faixa de cobrança do modelo", e mostra ao lado o gasto medido nas suas próprias sessões. Ela também é Basic FREE, e tem entrada própria na documentação da Token Calculator.
A outra que vale conhecer é o MetaPrompt · Prompt Creator, também Basic FREE. Ele tem 34 tipos em 7 grupos, guarda o histórico das suas últimas 30 criações, e a saída vem com um título, o prompt, os parâmetros e as variações. Você o encontra em Panel › Utilities › MetaPrompt, descrito na documentação do MetaPrompt.
A documentação não descreve essas ferramentas encadeadas. Se você quiser uma ordem, aqui está a nossa, e é uma sugestão da casa, não um fluxo documentado: crie o prompt com o MetaPrompt, enxugue-o com o Prompt Optimizer e meça-o com a Token Calculator. Para dar escala, o inventário de utilitários tem 23 ferramentas: 13 Basic FREE, 8 Pro e 2 Ultra.
Limites e o que ele não faz
O Prompt Optimizer enxuga o que você escreve. Ele não enxuga o que o modelo devolve para você ler. Esta ferramenta trabalha sobre o que você escreve, não sobre o que o modelo devolve.
As regras da demo são 12 padrões em inglês, como cumprimentos, "please", "basically", "as I said" e "thanks so much in advance". A documentação não informa um limite de tamanho para o prompt, quais idiomas o produto suporta, nem quanto custa a tentativa do claude oficial. Preferimos dizer isso a preencher a lacuna com um número.
O corte da demo também não garante que a sua frase repetida desapareça, como a situação B mostrou. E o número que ela mostra é uma estimativa, não a conta que chega no fim do mês.
Quando o prompt é a parte pequena
O prompt de exemplo pesa 75 tokens. Um prompt é uma entrada entre várias em uma sessão, e outras ferramentas do HarnessUp trabalham sobre as outras. O Prompt Optimizer é uma das ferramentas gratuitas do HarnessUp, e o HarnessUp reúne mais de 132 ferramentas que rodam na sua máquina para economizar tokens no Claude Code e no Codex.
Se quiser testá-las, Instale o HarnessUp grátis, ou veja o que o Pro acrescenta. O Pro custa US$ 6 por mês no plano anual ou US$ 9 mensal, com 7 dias grátis, sem cartão e sem cadastro.