Inicializando um Novo Projeto com /init

/init é um comando de barra do Claude Code que escaneia um repositório novo (ou existente) e cria um CLAUDE.md inicial para você, para que você não precise escrever a memória do projeto a partir de uma página em branco.

Resumo

Todo novo projeto eventualmente precisa de um CLAUDE.md descrevendo suas convenções, estrutura e regras.

Escrever um do zero significa re-derivar coisas que o Claude Code já pode ver por si só, como a linguagem, o layout das pastas e a configuração de testes.

/init preenche essa lacuna fazendo com que o Claude Code olhe para o projeto primeiro e produza um rascunho, que você então lê e corrige.

É o caminho mais rápido de "sem memória de projeto" para "um CLAUDE.md funcional", mesmo que o resultado ainda precise de uma passagem humana.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

cd my-project
claude
# once inside the Claude Code session:
/init

Quando usar isso:

• Iniciando um projeto totalmente novo e querendo ter a memória do projeto em vigor desde o primeiro dia.
• Herdando um repositório existente que ainda não tem um CLAUDE.md.
• As convenções do projeto mudaram o suficiente para que valha a pena regenerar e revisar o CLAUDE.md existente.
• Você quer uma primeira passagem rápida para documentar a estrutura antes de refiná-la manualmente.

Exemplo de Trabalho

Aqui está uma sessão completa, de um CLAUDE.md vazio a um revisado, em um pequeno projeto de API Node.js.

# 1. Start Claude Code inside the project root
cd order-service
claude
 
# 2. Run /init inside the session
/init
 
# Claude Code scans package.json, the folder structure, existing
# README content, test setup, and any config files, then writes
# a first-pass CLAUDE.md to the project root.
 
# 3. Review what it produced
cat CLAUDE.md

Um rascunho inicial típico do /init se parece com isto:

# Project: order-service
 
## Overview
A Node.js REST API for managing customer orders.
 
## Tech Stack
- Node.js, Express
- PostgreSQL via `pg`
- Jest for testing
 
## Structure
- `src/routes/` - Express route handlers
- `src/services/` - business logic
- `src/db/` - database access
- `__tests__/` - Jest test files
 
## Commands
- `npm test` - run the test suite
- `npm run dev` - start the dev server

# 4. Edit the draft to add anything /init couldn't infer,
#    like team-specific rules and hard constraints.

## Hard Rules
- Never query the database directly from a route handler - go through `src/services/`.
- Always add a test in `__tests__/` for any new route.
- Do not commit directly to `main`.

# 5. Commit the finished file
git add CLAUDE.md
git commit -m "Add CLAUDE.md via /init"

O que isso demonstra:

• /init produz um rascunho estrutural inicial (pilha, pastas, comandos) a partir do que pode observar no repositório.
• Regras específicas da equipe e restrições rígidas raramente são inferíveis apenas pelo código - você ainda as adiciona manualmente.
• O arquivo gerado destina-se a ser revisado e commitado como qualquer outro arquivo de projeto, não aceito cegamente.
• Executar /init é rápido o suficiente para refazer sempre que a forma do projeto mudou significativamente.

Mergulho Profundo

Como Funciona

• /init lê os arquivos do projeto (manuais de pacotes, estrutura de pastas, documentação existente, configurações) para inferir a pilha tecnológica e o layout.
• Ele escreve o resultado em CLAUDE.md na raiz do projeto, em markdown simples.
• Se um CLAUDE.md já existir, executar /init novamente o atualiza com base no estado atual do projeto em vez de criar um arquivo duplicado.
• O comando não executa testes, não instala nada nem modifica código - ele apenas produz documentação.
• O que ele escreve ainda é carregado exatamente como um CLAUDE.md escrito manualmente no início de cada sessão futura.

O Que /init Captura Confiável vs O Que Não Captura

Reexecutando /init em um Projeto Existente

# CLAUDE.md already exists and is a bit stale
/init
 
# Claude Code re-scans the project and updates CLAUDE.md
# to reflect the current structure, rather than starting over

Armadilhas

• Aceitar o rascunho sem lê-lo. /init infere o que pode ver, mas não pode conhecer convenções da equipe não escritas. Correção: sempre leia o arquivo gerado de ponta a ponta antes de fazer o commit dele.
• Perder regras escritas manualmente em uma reexecução. Reexecutar /init atualiza o arquivo com base no estado atual do projeto, o que pode se misturar com edições manuais anteriores se você não estiver prestando atenção. Correção: compare o arquivo após reexecutar /init e confirme que suas regras rígidas ainda estão lá.
• Tratar o rascunho como exaustivo. /init documenta o que existe, não o que nunca deve acontecer. Correção: adicione uma seção explícita de "Regras Rígidas" manualmente para qualquer coisa não negociável.
• Executar /init no diretório errado. Se executado fora da raiz real do projeto, o escaneamento produz uma imagem imprecisa ou vazia do projeto. Correção: confirme que você está na raiz do projeto (pwd, verifique o arquivo de manifesto do projeto) antes de executá-lo.
• Deixar o rascunho ficar desatualizado. Um CLAUDE.md gerado uma vez no início do projeto pode divergir à medida que a base de código evolui. Correção: reexecute /init periodicamente, ou atualize o arquivo manualmente quando a estrutura mudar significativamente.

Alternativas

FAQs

Relacionados

• O Que CLAUDE.md Realmente Faz - o conceito que /init está inicializando.
• Noções Básicas de Gerenciamento de Contexto - onde /init se encaixa entre as ferramentas principais da seção.
• Escrevendo um Arquivo CLAUDE.md Que Realmente é Seguido - refinando o rascunho que /init produz.
• Arquivos CLAUDE.md Aninhados e Como Funciona a Herança de Escopo - adicionando regras com escopo além do que /init gera na raiz.

Versões da Pilha: Escrito contra a linha de modelos Claude atual em aproximadamente junho de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (o padrão) e Claude Haiku 4.5. Nomes de modelos, preços e recursos de produtos mudam rapidamente - verifique os detalhes atuais em platform.claude.com/docs antes de confiar neles.