Claude Code para Leigos: O Meu Feedback

Depois de meses em caixas, o JB finalmente pôde voltar a instalar-se em frente do seu ecrã grande e voltar a programar. Ele estava tão entusiasmado com o Claude Code que lhe pedi para fazer uma demonstração (criar e publicar um site em menos de 3 minutos) e eu também experimentei.

Não sou developer, mas sei programar um pouco. Sei o que é um algoritmo, já escrevi vários scripts automáticos e uso APIs (= “portas de entrada” que permitem a um programa comunicar com outro programa) como as do Google ou Bing.

O meu projeto principal: traduzir livros antigos

Há anos que traduzo voluntariamente livros antigos. Para isso, usava a API do Claude (= pagava ao Claude por consumo para traduzir). É caro, por isso os meus scripts não eram muito exigentes e eu não avançava muito depressa. Já traduzi 1 800 páginas, que revia e corrigia todas eu mesma. Quando percebi o que o Claude Code podia realmente fazer Claude Code, voltei ao trabalho.

Claude Code vs ChatGPT: qual é a diferença?

Quando usa o ChatGPT ou o Claude.ai no seu navegador, está numa interface de chat : faz uma pergunta, a IA responde, e pronto. Ela não vê nada do que está no seu computador. Não pode abrir os seus ficheiros, executar um programa, alterar um documento. Ela responde numa caixa de texto e você tem de fazer tudo sozinho depois. Ela também tem memória e contexto limitados sobre o que já fez anteriormente.

Claude Code, é completamente diferente. Ele corre diretamente no seu computador, no terminal (= a janela preta com texto que os devs usam). E aí, ele põe as mãos na massa: pode ler e modificar os seus ficheiros (numa pasta autorizada), executar código, lançar comandos, criar pastas, chamar APIs, fazer testes, … Ele age mesmo na sua máquina, não só numa caixa de diálogo.

É a diferença entre alguém que o aconselha do sofá pelo telefone e alguém que está mesmo ali, sentado ao seu lado, que pode abrir as suas gavetas, ler os seus documentos e fazer as coisas por si.

É por isso que se chama um agente : ele não se limita a responder, age.

Os conselhos que me ajudaram

Um amigo, Kevin (recomendo vivamente que leia a apresentação dele), disse-me que era preciso

1. desafiar a IA
2. e mandar-lhe verificar o trabalho dela em cada etapa.

O JB disse-me para lembrar regularmente à IA de documentar o processo num ficheiro chamado CLAUDE.md, perguntar se a IA tem dúvidas, e pedir à IA para me dar sempre o plano detalhado antes de executar seja o que for (no Claude, isso chama-se “modo plano“).

O que é o CLAUDE.md?
Sabe o que é um novo colega que chega a uma empresa? No primeiro dia, ele não sabe nada: como a equipa trabalha, os hábitos, as regras não escritas, os projetos em curso. É preciso explicar-lhe tudo do zero.
O Claude Code é igual. Por defeito, em cada nova sessão, não se lembra de nada. Tudo o que fizeram juntos, todas as decisões tomadas, todas as preferências que lhe explicou… desapareceu.
O CLAUDE.md é o ficheiro que resolve este problema. É um simples ficheiro de texto que vive no seu projeto e que o Claude relê automaticamente sempre que arranca. É a memória permanente dele. O seu manual de acolhimento. O seu caderno de bordo.

No entanto, em ~/.claude/settings.json, é preciso desativar a memória, porque a memória contém tudo e mais alguma coisa e sobrecarrega o contexto desnecessariamente.

"autoMemoryEnabled":false

Porque é que o Claude Code mudou tudo nas minhas traduções

Antes, usava apenas a API, com ferramentas limitadas. Agora, com o Claude Code, posso dar-lhe acesso a muitos ficheiros ao mesmo tempo: um glossário, exemplos de traduções, livros .epub sobre o mesmo assunto. É muito mais prático do que antes e a tradução é muito mais qualitativa. Li passagens traduzidas ao acaso e, com o Claude Code, não encontrei erros.

O problema: os tokens

Os tokens são a unidade que mede o que a IA lê e escreve. É como se estivéssemos a alugar tempo de cérebro. Quanto mais texto lhe damos, mais consumimos e, portanto, mais caro fica. E eu esgoto-os muito rapidamente.

Para tarefas menos complexas, o Kevin e o JB aconselharam-me a usar o Deepseek (um modelo chinês) com Claude Code (a interface que fala com o modelo, chama-se a isso uma harness, ver explicação abaixo). O modelo Deepseek é ligeiramente pior do que os da Claude, mas é infinitamente mais barato (cerca de 25 vezes menos). A relação qualidade/preço é excecional. Eu e o JB partilhamos uma conta de 25/30$ por mês, o que nos permite consumir milhares de milhões de tokens, o que seria inacessível com os modelos da Claude.

E precisamente, não nos faltarem tokens torna-nos perfeitamente irresponsáveis ! No Deepseek, nunca fazemos limpeza nas conversas (/clear, /compact), não otimizamos nada. No Claude, por outro lado, como só temos uma subscrição de 20$/mês cada um e isso gasta-se depressa, temos muito cuidado: otimizamos regularmente, auditamos os nossos processos para poupar tokens. Pessoas como nós estão a poluir o planeta, não está nada bem!!!

Claude Code é o que se chama uma “harness” (= uma interface, uma concha). Imagine um robô com braços. Os braços, as pinças, o facto de ele agarrar objetos, movê-los, abrir gavetas, carregar em botões… isso é a harness. É ele que faz as coisas concretas no mundo real. Mas a cabeça, a que pensa e decide o que fazer com esses braços, podemos mudá-la. Pomos uma cabeça muito inteligente para tarefas complexas, uma cabeça mais básica para tarefas simples. O corpo do robô continua exatamente o mesmo, só mudamos o que está sobre os ombros.

O Claude Code é igual. A harness são os braços: lê os vossos ficheiros, lança comandos, modifica documentos, gere os passos um após o outro. Isso é fixo, não muda. Mas a cabeça lá dentro, a que pensa e escreve, podemos mudá-la! Com um pouco de configuração técnica, podemos pôr o Claude Opus, Sonnet ou Haiku claro, mas também o Deepseek, GPT Sol ou Gemini. Os braços continuam os mesmos, só mudamos a cabeça. É muito prático: pomos uma cabeça potente para tarefas complexas (Claude Fable 5), uma cabeça mais barata para tarefas simples (Deepseek).

Ler a documentação técnica muda tudo

O JB diz sempre que quem lê a documentação técnica tem mais vantagens do que os outros. E como adoro ler documentações técnicas, leio-as por nós os dois! Foi assim que descobri funcionalidades que o Claude não oferece por defeito (/skill, sub agents, agent teams) : é preciso pedir-lhe para fazer uma auditoria ao processo, e aí ele otimiza tudo.

O que são as skills e os sub-agents?

Por defeito, quando trabalham com o Claude Code, ele faz tudo sozinho, passo a passo. É bom, mas não é o ideal.
As skills (= competências)são como fichas de trabalho que preparam com antecedência. Por exemplo: “quando traduzes, é exatamente assim que te deves comportar, este é o glossário a respeitar, este é o estilo esperado”. Em vez de lhe explicar tudo de novo a cada vez, ele vai buscar a ficha e parte diretamente de boas bases. Evita repetir as mesmas instruções e melhora a qualidade do resultado.

Os sub-agentes (= sub-agentes), isso é ainda mais poderoso. Em vez de ter um único Claude que faz tudo, você tem vários trabalhando em paralelo, cada um em uma tarefa específica. Um pouco como uma equipe. No meu caso, para traduções, é enorme: em vez de um único agente traduzir, verificar e corrigir, tenho um agente “tradutor” que traduz e outro “editor” que relê e questiona o trabalho do primeiro. O resultado é muito melhor e é mais rápido.

Os diferentes modelos

Para traduções, sempre gostei da qualidade do Claude Sonnet 4.6.

Para verificações mais pesadas, descobri o Claude Fable 5 recentemente e estou super satisfeita. Ele é rápido, tem uma precisão cirúrgica e enxerga além do que é pedido. Ele consome muitos tokens por sessão (cada sessão me custaria o equivalente a 25$ se fosse pela API), mas no fim resolve tarefas complexas em menos sessões do que outros modelos (mandei um livro inteiro para ele, e ele percebeu inconsistências na tradução e é capaz de citar 3 trechos diferentes do livro para justificar a escolha de uma palavra no 4º trecho). Estou feliz por tê-lo na minha assinatura Claude Pro até 22 de junho.

Deepseek V4 Pro pensa rápido demais e escreve scripts de qualidade duvidosa. É preciso obrigá-lo a pensar e propor soluções antes de codar, senão ele sai com a cabeça baixa, quebra tudo, e o debug vira um pesadelo. Eu o uso para tarefas básicas (criação de sites simples, scripts para fazer epubs).

Meus aprendizados

Trabalhar com IA exige mudar para o modo gerente e não o modo executivo. Em vez de pensar “como vamos fazer”, tenho que mudar e pensar “qual resultado eu quero, não importa como ele chega lá”. Por exemplo, para uma tradução: não me importo se ele divide meu texto em 2 ou 4 partes, é problema dele. Meu problema é ter a melhor tradução possível, com um estilo homogêneo do início ao fim. Ele que se vire para conseguir isso. Nas raras vezes em que digo a ele o que fazer (“faça um script Python”, “envie isso em lote”), é microgerenciamento, e isso se traduz diretamente em ineficiência. Em vez de encontrar a melhor solução técnica, ele segue a MINHA solução técnica, que não é necessariamente a certa. É como contratar um especialista e ditar cada movimento em vez de explicar o que você quer alcançar. Ele vai ser necessariamente pior do que se você tivesse apenas dado o objetivo. Também podemos pensar no modo processo e equipes: quero um tradutor, um segundo que verifique a qualidade da tradução, um webdesigner, …

Ainda me pego me limitando e pensando “nossa, isso parece complexo, não vou pedir isso a ele”. Grande erro. Preciso me lembrar de que não há absolutamente nenhum limite. Um exemplo concreto: quero oferecer .epub (= livros digitais) acessíveis a todos. Mas para meu leitor reMarkable 2 (= um tablet especial para ler e tomar notas), preciso de epubs em um formato um pouco específico. Se fosse um humano fazendo esse trabalho, eu me sentiria culpada em pedir um esforço extra só para 0,5% dos leitores. Então eu me autocensuraria. Mas aqui é uma IA. Ela não se cansa, não bufa, não olha o relógio. Pedir a ela para gerar duas versões em vez de uma não custa nada. Meu imenso prazer em ler um ebook perfeitamente adaptado ao meu leitor não é nenhum capricho, é apenas um resultado extra que eu estaria errada em não pedir. A regra que devo aplicar: se eu hesitar em pedir algo porque “é pedir demais”, peço mesmo assim. Com a IA, podemos pedir a perfeição, ao contrário de um humano.

Atualização: percebi que me limito menos quando tenho um número quase ilimitado de tokens. Então, se você acha que pode ir mais longe, pegue o pacote ++ por 200$ por apenas um mês para não se limitar e aprender o máximo, depois volte para o pacote de 20$.

Descobri que é possível assumir o controle de softwares já instalados no meu computador via linha de comando. Assim, em vez de fazer o OCR (reconhecimento de caracteres) via IA (e queimar os tokens), pude lançar OCRs via linha de comando para controlar o software ABBYY. E atualizar os flashcards com meu software ANKI. Portanto, não é porque uma ferramenta não tem API/MCP que não podemos interagir com ela. Não hesite em pedir que ele escaneie os softwares que você já tem, para economizar tokens.

Última coisa, e eu recomendo fortemente a todos: arranje um buddy para conversar sobre Claude Code. A gente fica absolutamente louco com essa ferramenta, no bom sentido. Temos uma vontade irresistível de falar sobre isso com alguém. Se essa pessoa já tiver experiência, melhor ainda: você pode fazer perguntas sobre boas práticas, mostrar o que o Claude respondeu, perguntar se é normal. Estou convencida de que uma hora de conversa com alguém que tem um ano de Claude Code nas costas economiza facilmente 3 meses de teste & aprendizado solo. E também permite compartilhar a frustração da falta de tokens. Entre viciados, é muito importante andar com outros viciados! ahahah

Sério, também é muito útil para acompanhar as novidades. Há tanta coisa saindo todos os dias que é impossível testar tudo sozinho. Se cada um testar uma coisa e contar para os outros, vocês cobrem muito mais terreno juntos.

E por fim, tem o FOMO (= Fear Of Missing Out, o medo de perder algo, de ficar para trás). Esse FOMO é bem real. Quando vemos a velocidade com que a IA nos permite avançar, temos um único medo: que nosso concorrente avance mais rápido. E essa angústia só pode ser realmente compreendida por quem usa essas ferramentas no dia a dia. Então sim, encontre seu buddy.

Se você precisa de demonstrações e casos concretos e mais complexos, aqui está uma apresentação generosamente compartilhada por Kevin Richard (nosso amigo, que recomendo fortemente seguir no YouTube e X). Esta apresentação é importante porque vai acordar muita gente (pelo menos acordou a mim!).