O arquivo CLAUDE.md

[Music starts] [Music starts] One of the most useful parts of Claude Code is the claude.md file. Uma das partes mais uteis do Claude Code e o arquivo CLAUDE.md. It gives Claude Code persistent memory about your project. Ele da ao Claude Code uma memoria persistente sobre o seu projeto. When you open up Claude Code without a claude.md file, it's like it has to start fresh every single time. Quando voce abre o Claude Code sem um arquivo CLAUDE.md, e como se ele tivesse que comecar do zero. It has to re-explore your codebase, understand what dependencies are needed and the features that are already implemented. Ele precisa reexplorar sua base de codigo, entender quais dependencias sao necessarias, Sometimes it has to make assumptions which makes it harder for us to steer Claude in the right direction. As vezes ele precisa fazer suposicoes, o que torna mais dificil para nos orientar o Claude na direcao certa. But that's where claude.md comes in. Mas e ai que o CLAUDE.md entra em cena. It's a markdown file that you add to the root of your project and Claude Code reads it automatically every time you start a session. E um arquivo Markdown que voce adiciona a raiz do seu projeto e o Claude Code le toda vez. It's like an onboarding script for your codebase. E como um script de integracao para sua base de codigo. Simply put, the contents of claude.md file are appended to your own prompt. You can run the /init command which will make Claude generate one based off of your codebase. Em resumo, o conteudo do arquivo CLAUDE.md e adicionado ao seu proprio prompt. Pense nisso como—— So let's have a look at one. Vamos ver um exemplo. This is a Next.js 15 app using the app router, Tailwind, and Drizzle ORM. Este e um aplicativo Next.js 15 usando App Router, Tailwind e Drizzle ORM. Commands: dev server, run tests, lint. Comandos: servidor de desenvolvimento, executar testes, lint. Code style: use two space indentation, prefer named exports, all API routes go in app/api, use server actions instead of API routes where possible. Estilo de codigo: usar recuo de dois espacos, preferir exportacoes nomeadas, todas as rotas de API vao em—— And it's pretty straightforward. E e bem simples. Now, if I ask Claude Code to create a React component, it knows how to style it with Tailwind or any other CSS framework that I'm using. Agora, se eu pedir ao Claude Code para criar um componente React, ele sabe como estiliza-lo corretamente desde o inicio. We can see that Claude does a better job at doing its job right off the bat versus having to understand where everything is at first. Podemos ver que o Claude faz um trabalho melhor desde o inicio em comparacao com antes. And before you ask, the answer is yes. E antes de voce perguntar, a resposta e sim. You share this in your version control for your team to use. Voce compartilha isso no seu controle de versao para que sua equipe use. But there's actually a hierarchy of memory files depending on who it's for. Mas na verdade ha uma hierarquia de arquivos de memoria dependendo de para quem e. So first you have your project-level claude.md that lives in the root directory of your project. Primeiro voce tem seu CLAUDE.md em nivel de projeto que fica no diretorio raiz. You have a user-level claude.md that lives in your configuration folder. Voce tem um CLAUDE.md em nivel de usuario que fica na sua pasta de configuracao. This one is just for you and goes across all your projects. Este e apenas para voce e se aplica a todos os seus projetos. So put your personal preferences here, like how you write code comments. Coloque suas preferencias pessoais aqui, como como voce escreve comentarios de codigo. First, if you have to correct Claude to do something, like always use server actions instead of API routes, then explicitly ask Claude to save this to memory so that when you come back to this project, it will know every single time. Primeiro, se voce precisar corrigir o Claude para fazer algo, como sempre usar Server Actions—— Second, if you have docs in your project that you want Claude to reference, just use the @ symbol with the file path. Segundo, se voce tiver documentos no seu projeto que deseja que o Claude referencie, simplesmente—— And third is we recommend you start off a project without a claude.md file so you can see where you have to constantly course correct the model. Terceiro, recomendamos que voce comece um projeto sem um arquivo CLAUDE.md para que voce possa—— This keeps your claude.md file compact and contains only the necessary information that Claude can work with. Isso mantém seu arquivo CLAUDE.md compacto e contém apenas as informacoes necessarias. [Music transition] [Music transition] The difference between a frustrating Claude Code session and a productive one comes down to the context, and the claude.md file's how you provide that context. A diferenca entre uma sessao frustrante do Claude Code e uma produtiva muitas vezes depende do seu arquivo CLAUDE.md. Start with your stack, your preferences, and then commands, and just build from there as you go. Comece com sua stack, suas preferencias e depois os comandos, e construa a partir dai.