Claude.ai no dia a dia de quem programa: projetos, arquivos e quando usar

O Claude.ai é a forma mais simples de usar o Claude: um chat no navegador, no aplicativo de desktop ou no celular, sem instalar nada e sem integração com o seu código. Para quem programa, ele é útil e também é fácil de usar mal, porque tudo parece uma conversa e nem toda tarefa deveria ser uma.

Este é o primeiro artigo da trilha Usando o Claude. Ele mostra o que cada recurso do Claude.ai resolve, como o dono deste site divide o trabalho entre o chat e o agente de código, e qual é o sinal de que está na hora de sair da conversa. Os recursos e planos foram conferidos na central de ajuda oficial em 22 de outubro de 2026. Planos e limites mudam com frequência, então confira lá antes de decidir.

Os quatro recursos que importam

Conversa. Uma pergunta, um erro colado, um trecho de código para explicar. É o uso mais comum e o mais limitado: a conversa só sabe o que você colou nela.

Projeto. Um espaço com histórico próprio, arquivos de referência e instruções fixas. Os arquivos e as instruções valem para todas as conversas do projeto, então você não precisa colar a especificação de novo toda vez. Segundo a central de ajuda, projetos existem em todos os planos, inclusive no gratuito, que permite até cinco. Nos planos pagos, quando os arquivos do projeto se aproximam do limite de contexto, o Claude passa a buscar só os trechos relevantes, a mesma ideia explicada em RAG na prática.

Artefato. O que o Claude produz para você usar fora da conversa: um documento, um trecho de código, uma página simples, um diagrama, uma pequena ferramenta interativa. O artefato abre ao lado da conversa, pode ser editado e compartilhado, e começa privado.

Memória. O Claude guarda contexto sobre você entre conversas, e nos planos pagos também consegue buscar conversas antigas. É prático para preferências pessoais, mas não substitui o projeto: memória é sobre você, projeto é sobre um trabalho específico.

Como fizemos aqui: pouco chat, muito agente

O dono deste site usa o chat bem menos do que o agente. A maior parte do trabalho, como artigos, migrations, o assistente Porto e o deploy, acontece no Claude Code, direto no repositório, como mostra o artigo Claude Code na prática. Quando o chat entra, é em três situações:

• Um projeto com arquivos de referência. Documentos e regras que se repetem ficam num projeto, para não colar o mesmo contexto a cada conversa.
• Pensar antes de mandar fazer. A ideia ou a especificação é discutida no chat primeiro e só depois vai para o agente executar. Conversar sobre o que construir é mais barato do que desfazer código.
• Pesquisa e texto. Resumir um assunto, comparar opções, escrever um texto ou um e-mail de trabalho.

Essa divisão segue uma regra simples: o chat é bom para pensar e escrever, o agente é bom para mudar o repositório. Quando a resposta precisa virar código testado, o chat passa a atrapalhar.

O sinal de que a tarefa pede um agente

Três sintomas mostram que você está usando o chat para um trabalho de agente:

1. Você está colando arquivos um atrás do outro. Se o Claude precisa ver cinco arquivos para responder, ele deveria poder abri-los sozinho.
2. A resposta depende de rodar alguma coisa. Compilar, rodar os testes, ver a saída de um comando. No chat, você vira o intermediário que roda e cola o resultado.
3. A mudança atravessa vários arquivos. Copiar trechos da conversa para o editor, um por um, é onde os erros entram: a parte esquecida, a versão antiga colada por cima da nova.

Nesses casos, o caminho é o Claude Code, que lê o projeto, roda os comandos e mostra o diff para você revisar. E o contrário também vale: se a dúvida é conceitual, como entender um padrão, escolher entre duas bibliotecas ou revisar um texto, abrir o agente no repositório é exagero.

Pesquisa: o cuidado que mais importa

Pesquisa é o uso em que o modelo mais impressiona e mais engana. Ele resume bem, mas pode juntar fontes que discordam entre si como se concordassem, ou citar com confiança um número que mudou.

Um caso deste site mostra o problema. Ao pesquisar o programa de certificações do Claude, a busca trouxe várias páginas de terceiros que divergiam sobre preço e sobre quem pode fazer as provas, e nenhuma era a página oficial da Anthropic. A pesquisa foi feita pelo agente, não pelo chat, mas o cuidado é o mesmo. A decisão foi não publicar nada sobre certificação até conferir a fonte oficial. O artigo Fontes confiáveis para IA corporativa detalha esse cuidado.

Na prática: peça as fontes, abra as que importam e desconfie de números de preço, prazo e versão. Eles são justamente o tipo de dado que o modelo erra, como mostrou a avaliação do assistente deste site.

Como montar um projeto que ajuda

Um projeto bom tem pouca coisa, mas a certa:

• Instruções curtas: quem você é, a stack do sistema, o formato de resposta que você quer e o que nunca fazer. É o mesmo papel do CLAUDE.md para o agente.
• Arquivos de referência estáveis: a especificação, as regras de negócio, o glossário do domínio. Arquivo que muda toda semana fica desatualizado no projeto sem você perceber.
• Um projeto por assunto: misturar dois sistemas no mesmo projeto faz o Claude responder sobre um com as regras do outro.

O que não colar no chat

Chaves de API, senhas, tokens e dados de clientes não vão para a conversa, nem para os arquivos de um projeto. Neste site, a regra vale até para o agente: a chave da API do assistente Porto foi copiada entre arquivos direto no servidor, sem que o valor aparecesse na sessão. Antes de colar código ou documento da empresa, confira a política de uso de IA do seu time e o plano contratado.

Checklist

• Uso a conversa para dúvidas pontuais, explicação e texto.
• Contexto que se repete está num projeto, com instruções curtas e arquivos estáveis.
• Quando estou colando muitos arquivos ou rodando comandos para o chat, passo para o agente.
• Discuto a ideia antes de pedir código, e levo para o agente uma especificação com critério de aceite.
• Em pesquisa, peço as fontes e confiro preços, prazos e versões na fonte oficial.
• Nunca colo chave, senha ou dado de cliente na conversa.

Próximo passo da trilha: Prompt para desenvolvedores: do pedido solto à instrução com critério.