Criando uma Configuração de Projeto Consistente

Um projeto Claude Code bem configurado fornece ao Claude o contexto necessário para compreender seus objetivos, arquivos e a estrutura do projeto. Sem esse contexto, o Claude pode produzir resultados que não correspondem totalmente à sua intenção original.

Comece executando o comando /init no terminal do projeto. O Claude irá revisar a base de código, identificar como o projeto funciona e criar ou atualizar o arquivo CLAUDE.md. Esse arquivo contém instruções importantes e contexto que o Claude lê ao trabalhar no projeto.

Você também pode criar pastas no nível do projeto para:

• Agents, para assistentes de IA especializados;
• Skills, para instruções e fluxos de trabalho reutilizáveis;
• Rules, para requisitos específicos do projeto.

Manter esses recursos dentro do projeto torna a configuração portátil. Quando o repositório é compartilhado pelo GitHub ou aberto em outro dispositivo, as mesmas instruções e fluxos de trabalho permanecem disponíveis.

O arquivo .claude/settings.local.json armazena permissões locais, como quais ferramentas o Claude pode usar sem pedir autorização. Por incluir .local no nome, normalmente ele é mantido apenas no seu dispositivo e não é compartilhado com o repositório. Um arquivo compartilhado settings.json pode ser usado quando as mesmas permissões devem se aplicar a todos que trabalham no projeto.

O arquivo .mcp.json pode conter configurações do servidor MCP no nível do projeto. Isso é útil quando uma equipe precisa acessar as mesmas integrações, embora o Claude geralmente consiga configurar essas conexões automaticamente.