![Imagem de capa de [Claude Code #1] Começando com /init e a geração automática do CLAUDE.md](/assets/images/posts/29f64ad2-15d8-41ec-84be-686abdce13e9/claude-code-init-1.jpg)
Ao adicionar uma ferramenta de programação com IA a um projeto novo, você acaba repetindo as mesmas explicações: qual é o comando de build, como executar os testes e quais regras o código deve seguir.
O Claude Code guarda essas explicações em um arquivo chamado CLAUDE.md e o lê automaticamente em todas as sessões. O problema é que escrever esse arquivo do zero pode ser surpreendentemente difícil.
/init é o comando que ajuda a superar esse primeiro obstáculo. Ele analisa o código-base e cria um rascunho do CLAUDE.md para você.
Este é o primeiro artigo de uma série que examina os comandos do Claude Code um por um. Vamos começar pelo comando que você provavelmente executará primeiro.
O que o /init faz
Digite /init no campo de entrada da sessão, e o Claude começará a explorar o projeto.
Documentação oficial sobre memória descreve o processo assim: analisa o código-base, encontra comandos de build, métodos de teste e convenções do projeto e gera o CLAUDE.md com essas informações.
O resultado fica mais ou menos assim.
# CLAUDE.md
## Build e testes
- Servidor de desenvolvimento: pnpm dev
- Testes: pnpm test (Obrigatórios antes do commit)
## Estrutura
- API Coloque os handlers em src/api/handlers/
- Agrupe os tipos compartilhados em src/lib/types.tsAs informações que podem ser lidas no package.json ou no Makefile formam a estrutura básica. Um rascunho que levaria 30 minutos para ser escrito manualmente fica pronto em poucos minutos.
Se você quer saber o que é o CLAUDE.md e por que ele é necessário, leia primeiro Artigo sobre regras e memória do Claude Code.
Se já existe um CLAUDE.md
Executar /init novamente não sobrescreve o arquivo existente.
Segundo a documentação oficial, quando o arquivo já existe, o Claude sugere melhorias em vez de sobrescrevê-lo. Por isso, é seguro executá-lo mesmo depois de o projeto avançar bastante.
Vale executá-lo periodicamente ao revisar um CLAUDE.md antigo. Ele pode sugerir melhorias que incorporem os procedimentos de build e teste alterados nesse intervalo.
Ao migrar de outras ferramentas de IA
/init também lê arquivos de regras de outros agentes de programação.
Os alvos são .cursor/rules/ e .cursorrules do Cursor e .github/copilot-instructions.md do GitHub Copilot. O conteúdo relevante é selecionado e incorporado ao novo CLAUDE.md.
Se o repositório já usa AGENTS.md, há outro método. Adicione a linha @AGENTS.md ao CLAUDE.md para carregar o arquivo inteiro.
@AGENTS.md
## Claude Code Instruções específicas
- src/billing/ Use primeiro o modo de planejamento ao alterar o conteúdo abaixoComo as duas ferramentas lerão as mesmas regras, não é necessário duplicar o conteúdo.
Para repositórios que usavam Codex CLI ou Gemini CLI, existe um comando separado, /import. Ele migra de uma vez tudo, dos arquivos de instruções aos servidores MCP, comandos e skills (v2.1.213 ou posterior).
Ativando o /init interativo
Com uma única variável de ambiente, você pode transformar /init em um modo interativo mais detalhado.
CLAUDE_CODE_NEW_INIT=1 claudeNesse modo, /init pergunta primeiro o que você quer criar. Você escolhe entre criar apenas o CLAUDE.md ou configurar também skills e hooks (scripts executados automaticamente em momentos específicos).
Depois, ele explora o código-base com subagentes e faz perguntas para preencher as informações que faltam. Como mostra uma proposta antes de escrever os arquivos, você pode revisá-la antes de aplicar as mudanças.
Esse modo também amplia o conjunto de arquivos de regras que lê. Configurações de outras ferramentas, como AGENTS.md, .windsurf/rules/ e .clinerules, também entram na consulta.
Verifique depois de criar
Quando a geração terminar, tente executar /context.
Se o CLAUDE.md aparecer em Memory files, ele foi carregado corretamente. Se não aparecer, o Claude não está lendo o arquivo.
Para abrir e editar o arquivo, use o comando /memory. Ele o abre diretamente em um editor dentro da sessão.
Rascunho é só rascunho: critérios para ajustar
Há um motivo para não deixar intacto o arquivo criado por /init: faltam conhecimentos que a análise automática não consegue encontrar.
A documentação oficial também recomenda adicionar, depois de criar o arquivo, “instruções que o Claude não consegue descobrir sozinho”. Isso inclui o contexto de por que uma estrutura foi escolhida e quais armadilhas evitar.
Ao ajustar o arquivo, lembre-se de apenas dois critérios.
Primeiro, tente manter cada arquivo em no máximo 200 linhas. Quanto mais longo, mais contexto consome e menor fica a adesão às instruções.
Segundo, escreva frases verificáveis. “Mantenha o código limpo” é seguido com muito menos consistência do que “use indentação de 2 espaços”.
Você pode remover informações óbvias ao olhar o código, como listas de diretórios. A verificação /doctor também pode encontrar esse tipo de excesso e sugerir sua remoção (v2.1.206 ou posterior).
Se quiser entender melhor por que ele deve ser mantido curto, Por que o CLAUDE.md deve ser curto explica em detalhes.
Resumo
/init é a primeira etapa ao começar a usar o Claude Code em um projeto novo.
Ele analisa o código-base para criar um rascunho do CLAUDE.md e sugere melhorias quando já existe um arquivo. Também migra regras do Cursor e do Copilot, sendo útil ao trocar de ferramenta.
Mas o rascunho é apenas o ponto de partida. Adicionar o contexto da equipe que a análise automática não encontra e ajustá-lo para 200 linhas ou menos continua sendo trabalho humano.
No próximo artigo planejado, Claude Code — parte 2, vamos abordar o /plan modo de planejamento, que busca alinhar o design antes de alterar o código.
Fontes e critérios de verificação
- Documentação oficial do Claude Code — How Claude remembers your project (Anthropic, verificado em 2026-08-12)