claude -p no Claude Code: ensine a IA a aprender sozinha

Esse post nasceu de um vídeo rápido que eu publiquei no Instagram e resolvi aprofundar aqui pra explicar cada detalhe. O assunto é uma ferramenta pouco comentada do Claude Code, mas que muda bastante a forma como você trabalha com IA: o claude -p.

O claude -p é o modo headless do Claude Code: ele permite chamar uma sessão do Claude via linha de comando, sem abrir a interface interativa. Na prática, você dispara uma requisição via Bash — por exemplo, dentro de um script Python ou de dentro do próprio Claude Code — e recebe a resposta de volta. É isso que abre uma possibilidade que parece estranha à primeira vista, mas que é poderosa: você usa o Claude Code pra conversar com o Claude Code. A IA fala com ela mesma.

Mas o que eu realmente quero que você leve desse conteúdo não é o comando em si. É um método — esse jeito de conversar com a IA e deixar ela descobrir junto é o coração do Método Prompthen, a forma de trabalhar com agentes de IA que eu venho organizando ao longo dos anos. A maioria das pessoas — e até o próprio agente — não sabe que o claude -p existe, porque isso não está no prompt dele. Então, em vez de eu te entregar um prompt pronto pra você copiar e colar, eu prefiro te ensinar a conversar com o teu agente e deixar que ele faça o trabalho de descobrir junto contigo.

Quem me acompanha sabe: eu sou contra ficar colecionando prompt pronto. Prompt pronto só funciona pra uma situação; o que funciona pra qualquer situação é você aprender a conversar com a IA. Copiar os "15 melhores prompts" de alguém é como colar na prova da escola — você até passa, mas não aprendeu nada. Pra se multiplicar de verdade, você precisa aprender a dialogar.

E aqui entra um conceito que eu uso o tempo todo: a auto-descoberta. Em vez de eu explicar pra IA tudo que ela tem que fazer, eu peço pra ela testar, descobrir sozinha e me devolver o que encontrou. Foi exatamente isso que eu fiz no vídeo: pedi pro Claude se chamar via claude -p, conversar com ele mesmo em múltiplos turnos, comprovar que funcionava e depois me explicar o que ele tinha descoberto. Eu não expliquei nada técnico — nem session id, nem formato JSON, nem cache. Ele descobriu tudo sozinho.

Uma coisa que eu faço questão de repetir, e que é um princípio central do Método Prompthen: você não precisa ser programador pra usar IA. Trate a IA como um Einstein sentado do seu lado. Você não precisa entender tudo que o Einstein entende — você só precisa aprender a conversar com ele. É como a geladeira ou o carro: você usa, tira o máximo proveito, e não faz a menor ideia do que acontece por trás. Com IA é igual.

Abaixo eu deixei a transcrição completa do vídeo, limpa e organizada, com a demonstração passo a passo do claude -p, a explicação de multi-turno, a dica do cache hit acima de 90%, a diferença entre agente coordenador e subagentes executores, e a ideia de transformar tudo isso numa skill. Se você está começando, esse conteúdo é um bom ponto de partida pra despertar pra esse tipo de uso.

Transcrição da aula

A dica de hoje: o claude -p

Nesse conteúdo eu vou dar uma dica rápida, uma versão expandida do que eu coloquei recente lá no Instagram. A Anthropic falou que não vai mais limitar o uso do claude -p a partir da assinatura, e isso me deu o gancho pra explicar melhor o que é essa ferramenta.

O claude -p é quando você faz uma solicitação via Bash — uma requisição via comando — pra chamar uma sessão dentro do Claude Code. Então, por exemplo, você pode ter um script Python e esse script faz uma chamada via terminal usando claude -p. Com isso, você tem uma chamada dentro do Claude Code. E o detalhe interessante: você pode fazer isso de dentro do próprio Claude Code. Ou seja, você usa o Claude Code pra conversar com o Claude Code.

Como ele se comporta igual a qualquer comando de terminal, dá pra jogar coisas pra dentro dele. Por exemplo, eu pego um arquivo de erro e mando ele explicar:

cat erro.txt | claude -p "me explica esse erro"

Você não precisa entender o que é o cat nem o | aqui — é só pra você ver que ele aceita receber um texto de fora e responder em cima dele. Esse é o tipo de coisa que o teu agente descobre sozinho quando você pede.

A informação que a Anthropic deu é que eles iam separar o SDK e o subprocesso do claude -p da assinatura. Hoje, quando você usa claude -p ou SDK e tem uma assinatura, ele consome os tokens da sua assinatura. Eles iam separar isso porque tem muita gente usando claude -p e SDK pra fazer aplicações externas — o cara desenvolve um app pra vender pra alguém e fica fazendo chamada via SDK ou claude -p, e isso fere o uso dos planos.

Mas vamos esquecer essa parte de contornar o uso. O legal mesmo é você usar isso dentro do seu próprio desenvolvimento, que é como eu uso.

Como eu uso o claude -p

Eu uso o claude -p no meu sistema de memória. Quando eu chamo o claude -p, eu jogo aquela solicitação pra background — ou seja, ela não fica na tela pra mim. Eu faço uma cópia de toda a minha sessão, de todas as informações da sessão do Claude Code, e mando isso pra ele trabalhar com a memória. Tudo via subprocesso do claude -p.

Não vou entrar no método da memória aqui, senão fica uma coisa muito complexa. A ideia desse vídeo é só você entender como pode usar o claude -p — e perceber que, geralmente, o próprio agente do Claude Code não sabe que isso existe.

Isso é muito comum. Muita coisa que você vai desenvolvendo, o agente não conhece, porque não está no prompt dele. Por isso é legal: quando você for fazer alguma coisa com o teu agente de IA, converse com ele. Fale pra ele o que você vai fazer, desenvolva a ideia junto, peça pra ele fazer alguns testes. Faça um processo de auto-descoberta.

Sobre os prompts: eu não dou prompt pronto

Eu coloquei três prompts no vídeo — e quem me conhece sabe que eu sou contra fornecer prompt pronto. Coloquei só pra facilitar a explicação, porque foram os três que eu usei naquele vídeo rápido do Instagram e do TikTok.

A ideia não é você copiar literalmente esses prompts. A ideia é você entender como conversa com o teu agente, e a partir dessa conversa fazer uma auto-descoberta. E a partir dessa auto-descoberta você cria várias coisas — uma skill, ou qualquer outra situação que faça sentido pro teu trabalho.

A mensagem é basicamente essa: a gente vai conversar com o Claude Code, pedir pra ele fazer um teste usando comandos no terminal — no caso, o claude -p. Fazendo isso, ele vai conversar com ele mesmo, vai se chamar e vai usar multi-turno.

Multi-turno é quando a IA mantém o contexto entre uma mensagem e outra: ela joga uma informação na primeira mensagem e consegue lembrar dela na segunda.

A comprovação é simples: na primeira mensagem ele inventa alguma coisa — um objeto, uma cor, um número. Na segunda mensagem, ele pergunta sobre aquilo. Se ele lembra, o multi-turno está funcionando.

E olha que detalhe: tecnicamente falando, você não precisa ser programador nem entender o que acontece por trás. Veja como essa explicação aqui está extremamente natural — esse é o ideal pra você conversar com o teu agente de IA.

Esqueça que você precisa ser programador

Esquece aquela ideia de "ah, eu preciso ter conhecimento avançado, preciso ser programador, preciso estudar programação". Claro que quem entende de lógica de programação consegue executar as coisas com IA de uma forma mais eficiente. Mas esses vídeos que eu faço seguem o mesmo método que eu sempre usei pra ensinar qualquer coisa.

Quem olhar cursos antigos meus, de servidores, de SEO, vai ver que a forma como eu gosto de explicar é sempre a mais simples possível, sem você ter que ter um conhecimento avançado na área. E com agentes de IA é onde isso funciona melhor, porque você fala com o teu agente em linguagem natural, super simples, e ele entende. Ele descasca a laranja, ele faz a limonada. Você só começa a conversar, dá uma ideia inicial, e a partir dali surgem outras coisas.

Foi por isso que, quando me perguntaram "mas o que é o claude -p? Pra que serve? Onde eu posso usar?", em vez de fazer um vídeo tecnicamente complexo, eu achei melhor te dar uma introdução de como conversar com o teu agente, pra ele fazer os testes e te retornar o que descobriu. E daí cada um, dentro da sua forma de trabalho, aplica isso pra X ou pra Y situação.

É justamente por isso que eu sou contra prompt pronto: se eu te dou um prompt pronto, ele só vai funcionar pra uma situação. O ideal é você não ter prompt pronto. O ideal é você ter a ideia — "faça mais ou menos assim" — e conversar com ele. Eu te dou uns 10, 15, 20% da ideia de como começar, e a partir dali você vai conversando com o teu agente, crescendo, evoluindo e se multiplicando.

A IA moderna veio pra você se multiplicar

A IA está aí — principalmente a IA do meio de 2024 pra cá. Essa IA moderna veio pra possibilitar que você se multiplique. Você consegue fazer hoje, em horas, o que levaria dias. O que levaria semanas, você faz em dias. E em semanas eu desenvolvo coisas que eu não faria em anos.

Aqui na empresa, tanto em projetos meus quanto de cliente, a gente tem um gasto médio de cerca de 1,5 bilhão de tokens por dia. É muita coisa. No início desse ano eu fiz uma pergunta pra um dos agentes e ele me disse que, nos últimos três meses, a gente tinha gasto 30 bilhões de tokens. Em 2026 a gente está gastando bem mais, porque é muita coisa rodando ao mesmo tempo.

Não é chute — são dados reais que eu atinjo no dia a dia. E isso prova a escala de uso, não competência. É só pra você ter dimensão do volume de coisa que dá pra rodar quando você aprende a coordenar a IA.

A demonstração: o Claude conversando com ele mesmo

Vamos pra prática. Aquele quadro que aparece na tela enquanto eu explico é o Prompthen Whiteboard v3 — uma ferramenta de arquivo único, um HTML autocontido que eu fiz no próprio Claude Code, com quadro branco e leitura de papel. Eu uso ele pra deixar as coisas visuais quando gravo um tutorial, explico algo pra um cliente ou faço uma consultoria. (Nesse dia ele estava bugando legal, mas faz parte — é assim, ao vivo, sem encenação.)

Na data de hoje, 16 de junho de 2026, o meu Claude Code está bem desatualizado de propósito. Eu não atualizo sempre que sai uma versão. Quem acompanhou a versão 0.117 na época deve lembrar que teve um problema grave de cache — estava quebrando muito o cache no Claude Code.

O cache hit é quando o Claude Code reaproveita blocos de mensagem que se repetem — como o prompt de sistema ou o histórico da conversa. Esse bloco repetido custa cerca de 10% do valor normal.

Quando você manda uma mensagem no Claude Code e aquele bloco se repete, ele identifica e usa o cache, que gasta só 10% do custo. O Claude Code gerencia isso automaticamente, só que algumas versões quebraram esse comportamento. Por isso eu acabei travando na 117, que foi a que melhor corrigiu a situação. Eu inclusive desenvolvi uma ferramenta — não vou aprofundar aqui pra não fugir do assunto — que mede quanto de cache está sendo lido, o cache hit, dentro do Claude Code, controlando todas as mensagens que vão pra Anthropic.

Então, pegando o meu histórico anterior, a primeira mensagem foi mais ou menos assim:

Faz um teste pra mim usando um comando no terminal, que é o claude -p,
e faz uma chamada de subprocesso. Com isso você vai conseguir ver que eu
converso com a IA exatamente como se estivesse conversando com uma pessoa
sentada aqui do meu lado.

É assim que funciona melhor. Essas dicas que eu vou dando são muito sobre isso: palavrinhas-chave, aquele ajuste do parafuso certo que faz a coisa funcionar bem. Determinadas palavras, determinadas formas de conversar com a IA que eu venho percebendo que funcionam melhor — e que eu vou compartilhando nesses vídeos.

A minha ideia profunda é séria: eu quero que todo mundo consiga usar o básico. Não precisa fazer um uso extremo, não precisa nem ser no Claude Code. Esse vídeo é de Claude Code porque o claude -p é dele, mas a minha vontade é que todo mundo use IA no dia a dia, no mínimo de forma básica.

E quando eu falo "básico", não é "acha um lugar pra mim" ou "faz uma foto engraçada". O básico que eu considero é você se multiplicar. Se você tem uma atividade que demora horas e passa a fazer em minutos usando IA, é esse o uso ideal. Se levava dias ou semanas e você faz em um dia, é isso.

O que aconteceu na demonstração (sem eu explicar nada)

Eu criei uma pasta nova, em branco, sem nada dentro — justamente pra ele não ter conhecimento de outras coisas minhas e fazer uma descoberta de verdade. E aí, passo a passo, ele:

• Verificou que tem acesso ao comando claude, confirmando que ele funciona em qualquer lugar do terminal.
• Conferiu a versão.
• Fez a primeira chamada, com uma pergunta tipo "olá, você é uma sessão do Claude Code", e pegou a resposta — tudo via Bash.

E aqui entra uma coisa que eu repito muito pra quem está aprendendo: não se preocupe em entender tudo que está acontecendo por trás. Se alguém te falar que você tem que aprender tudo, pensa numa coisa simples — a sua geladeira. Eu uso ela da melhor forma possível, e não sei o que acontece por dentro. O meu carro, igual. Use a IA da melhor forma, entenda como coordenar ela, como chefiar ela.

Pense no agente principal do Claude Code como um coordenador. Ele chama vários outros subagentes — você cria um time. É assim que você se multiplica. Você não precisa entender tecnicamente o que acontece por trás.

Continuando: ele pegou um session id sozinho.

O session id existe porque cada sessão que você abre no Claude Code grava o histórico da conversa — igual ao ChatGPT ou ao Claude no navegador. Ele cria um id pra poder retornar àquela conversa depois.

E é aqui que muita gente se engana: o claude -p não é uma conversa que morre e acabou. Ela não é descartável. Como cada sessão guarda esse session id, você consegue voltar pra ela depois e continuar de onde parou. No Claude Code isso aparece como --resume (passando o id daquela sessão) ou --continue (pra retomar a última). Na prática: a conversa continua, o contexto não se perde. É por isso que o multi-turno funciona — não é mágica, é o agente reabrindo a mesma sessão pra lembrar do que rolou antes.

Repara: tudo isso ele fez sozinho. Eu não expliquei. Não falei "Claude, identifica o session id, faz isso, faz aquilo". Eu só falei: faça, amigo, e descubra o que vai acontecer.

Aí ele fez o primeiro turno. Depois fez o segundo turno pra testar a descoberta da memória — porque, sendo multi-turno, ele joga uma informação na primeira vez e questiona aquela informação na segunda, pra ver se existe continuidade. Funcionou. E ele verificou que houve leitura de cache.

É com base nisso que eu fiz o meu sistema de análise de cache hit. E aproveitando, uma dica importante:

O seu cache hit tem que ficar acima de 90%. Se cair abaixo disso, você está deteriorando os teus tokens — a assinatura não vai durar nada, ou, se você usa via API, você degrada todo o teu dinheiro.

Ele fez um terceiro turno com dados registrados, um quarto turno, e concluiu a demonstração. Ele acertou tudo. E veja: ele usou --output-format json e o session id sem eu ter explicado nada disso. Essa é a grande vantagem da IA, e é o que eu gosto de deixar claro: você só precisa coordenar.

O --output-format json é quando você pede pro claude -p devolver a resposta organizada em JSON, em vez de só o texto solto. Aí vem tudo certinho: a resposta, o session id daquela sessão e até o custo. Isso é útil quando não é uma pessoa que vai ler — é outro programa, um script, que precisa pegar esses dados de forma organizada. Repara que ele escolheu fazer assim sozinho, porque era o que fazia sentido pro teste.

É como contratar um grande expert na sua empresa. Um gênio. Você tem um Einstein do seu lado — e não precisa entender tudo que o Einstein entende. Você só precisa aprender a conversar com ele. Daí ele te dá grandes resultados e ainda se multiplica em mini-Einsteins.

Segunda mensagem: o processo de auto-descoberta

A segunda mensagem foi pra ele revisar a sessão e me devolver as descobertas. Isso é um processo de auto-descoberta, que você pode usar pra qualquer coisa.

Aqui foi só uma mensagem, mas imagina que você está há horas conversando com a IA, fazendo testes e descobertas. Quando você fica horas conversando, tem que pedir pra ela retornar isso pra você. A mensagem foi mais ou menos assim:

Agora, por favor, identifique tudo o que fizemos nessa sessão e retorne
de forma organizada o que você descobriu e as decisões. Em uma simples
mensagem, em tópicos.

Eu fiz questão de pedir as decisões. Por quê? Porque numa conversa real você toma decisões: eu mandei ele fazer uma coisa, não gostei, e falei "certifique-se que sempre tenha tal coisa". É legal pedir pra ele retornar essas decisões.

E por que "em uma simples mensagem"? Porque no meu prompt de sistema — eu modifico todo o prompt de sistema do meu Claude Code — eu tenho muita instrução mandando ele sempre salvar as coisas, pra não depender da memória. Se eu não pedir explicitamente pra ele responder numa simples mensagem, às vezes ele salva tudo num arquivo. Então esse retorno é sempre bom pedir em uma simples mensagem, em tópicos.

Aí ele identificou tudo que fez. E você vai ver que ele fala um monte de coisa que a gente não sabia, que a gente não disse pra ele fazer daquele jeito — mas ele mesmo descobriu, porque rodou os comandos. O Claude Code é fantástico justamente por isso: você dá acesso a uma máquina inteira pra ele. Ele sabe quais são os comandos, o que vai acontecer e o que não vai. Infinitamente melhor do que usar via navegador.

E já que ele tem acesso à máquina, fica a tranquilidade: por padrão, antes de fazer qualquer coisa que mexe no teu computador — apagar um arquivo, rodar um comando mais pesado — ele para e pede permissão. Não sai fazendo na surdina. Agora, quando você monta uma automação que precisa rodar sozinha, sem você ali pra clicar "sim", você pode dizer de antemão quais ferramentas ele tem liberdade pra usar. No claude -p isso é o --allowedTools: você lista o que está liberado e o resto continua pedindo confirmação. Pensa nisso como dar a chave de algumas portas, não da casa inteira.

O navegador é mais prático pra coisas pequenas e rápidas. Mas pra coisas mais densas não tem comparação — ou Codex ou Claude Code.

Um parêntese sobre o Gemini

O do Gemini eu já usei muito, principalmente por causa da janela de contexto. Antes do Opus ter janela de um milhão de tokens, e antes desses modelos novos terem um milhão, eu usava muito o Gemini e muita coisa do Google por causa do contexto. Inclusive eu usava o subprocesso do Claude Code chamando a CLI do Gemini.

Mas o Gemini, pelo menos atualmente (estamos em 16 de junho de 2026), na minha opinião é o pior — ele mente muito, delira muito. Mesmo assim eu uso demais ele. Semanalmente eu tenho atividades que geram entre 20 mil, 60 mil e até 100 mil requisições, dependendo da demanda. Pra esse volume eu uso o Gemini Flash 3, que funciona muito bem. Eu faço via Bash, que dá um desconto de 50%, mais o desconto do cache — fica muito barato.

A opinião dele, com as palavras dele

No final, eu coloquei uma instrução pra ele falar com as palavras dele. Isso é importante: vocês precisam aprender a conversar com a IA e fazer ela retornar a opinião. A pergunta foi mais ou menos:

Diga pro pessoal do YouTube, na sua opinião, qual a melhor forma de
descobrir as diversas formas que cada um pode usar agentes de IA pra
potencializar os resultados — na base da conversa, fazendo descobertas
com o próprio agente, sem ficar dependendo de prompt pronto de copia e cola.

E olha o que ele respondeu: o segredo não está em colecionar prompt. Eu coloquei os três só pra facilitar a explicação — a ideia nunca foi você copiar nenhum deles. Então pare de buscar prompt pronto. Sério, parem. Aquelas coisas que o pessoal compartilha, "tive tal resultado, aqui estão meus 15 prompts" — pra se multiplicar de verdade, você tem que aprender a conversar com a IA. É igual colar na prova da escola: você passa, mas não aprendeu.

Não vou ficar lendo todos os tópicos que ele trouxe, porque se você fizer esse processo no seu próprio Claude Code, você vai ter as respostas do teu lado. Mas usar a própria ferramenta pra te ensinar é muito importante — é o que eu uso pra mim.

Por que esse método importa: a IA moderna é nova

Pela IA ser uma coisa nova, e a IA moderna ser muito recente, eu acho que o método de uso da IA ainda não está maduro. Quem é das antigas, uns 12 ou 14 anos atrás, provavelmente usava aquelas IAs primitivas e gratuitas que faziam rosto de pessoas aleatórias — às vezes vinha com um buraco, com um pedaço de coisa no rosto. Muita gente usa IA há tempo, mas essa IA moderna, com que a gente faz milhares de coisas, é recente.

Por isso eu gosto sempre de fazer uma coisa que funcione pra todo mundo. Pro grande expert, que já tem imersão em projetos de tecnologia. E pro cara que, sei lá, trabalha na recepção de um prédio e está tentando aprender IA pra desenvolver projetos que sempre teve na cabeça, mas nunca pôde contratar alguém pra fazer. Ou simplesmente pra aprender coisas novas.

Repara que esses tópicos ficaram incríveis e eu nem dei um script pra ele. Essa é a sacada: você faz a descoberta e registra em algum lugar.

Onde tudo isso vira uma skill

E esse "registrar em algum lugar" me leva à pergunta final. Dependendo do caso, você quer passar isso pra frente — e aí você pode fazer uma skill.

Uma boa regra: tudo que você executa duas ou mais vezes na semana pode virar uma skill, mesmo que simples.

Eu perguntei pra ele: se fosse fazer uma skill a partir do que a gente aprendeu aqui, como seria a aplicabilidade dela e quais as sugestões de uso pra diversas áreas? Eu sempre peço as sugestões e a opinião dele.

E ele me deu camadas: a camada técnica, a camada de método, e por aí vai. Não vou ler tudo, porque cada um de vocês pode rodar e aprofundar. Mas veja que legal: ele já te dá ideias que você pode expandir e, no mínimo, mandar ele transformar numa skill.

No mínimo, essa skill serviria pra você ensinar ao seu Claude principal — o coordenador — que ele pode e sabe usar o claude -p pra conversar com ele mesmo. Porque aí você tem um Claude principal conversando com outra instância do Claude Code, e não apenas com subagentes.

A diferença é importante: o principal uso do subagente é colocar tarefa em background — eles são executores atômicos. Já com o claude -p, o seu agente coordenador pode conversar com outra sessão completa do Claude Code e usar multi-turno.

Isso pode ser usado pra inúmeras coisas. E daí cada um de vocês descobre onde esse recurso é útil no seu dia a dia. Esse é o ponto de tudo: não decora o comando, aprende a conversar e deixa a descoberta acontecer.

Um abraço.