📁 Trabalhando com Projetos

Claude Code entende projetos atraves de arquivos de configuracao na pasta .claude/ e arquivos especiais como CLAUDE.md na raiz.

projeto/
├── CLAUDE.md              # Instrucoes de projeto (raiz)
├── .claude/
│   ├── settings.json      # Configuracoes locais
│   └── skills/            # Skills de projeto
│       └── my-skill/
│           └── SKILL.md
├── .claudeignore          # Arquivos a ignorar
└── src/
    └── ...

O arquivo CLAUDE.md na raiz do projeto e lido automaticamente e define convencoes e instrucoes para o agente.

# Projeto: E-commerce API

## Tech Stack
- Node.js 20 + TypeScript
- Express.js
- PostgreSQL + Prisma ORM
- Jest para testes

## Convencoes
- Use async/await, nunca callbacks
- Funcoes com mais de 20 linhas devem ser divididas
- Todos os endpoints precisam de testes
- Commits em ingles, mensagens no formato conventional

## Estrutura
- src/controllers/ - Handlers de rotas
- src/services/ - Logica de negocio
- src/models/ - Schemas Prisma
- src/utils/ - Funcoes auxiliares

O arquivo .claude/settings.json permite configurar permissoes especificas por projeto.

{
  "permissions": {
    "allowedTools": ["Read", "Write", "Edit", "Glob", "Grep"],
    "blockedCommands": ["rm -rf", "sudo"]
  },
  "autoApprove": ["Read", "Glob", "Grep"],
  "model": "claude-sonnet-4-20250514"
}

Claude Code integra nativamente com Git para commits, branches e pull requests.

# Claude pode executar:
"Faca commit das mudancas"         # git add + commit
"Crie uma branch para o fix"       # git checkout -b
"Mostre o diff das mudancas"       # git diff
"Crie um PR com estas mudancas"    # gh pr create

Use .claudeignore para excluir arquivos do contexto do agente - similar ao .gitignore.

# Dependencias
node_modules/
vendor/

# Build
dist/
build/
*.min.js

# Segredos
.env
.env.local
*.pem
credentials.json

# Outros
*.log
coverage/

O arquivo CLAUDE.local.md permite notas pessoais que NAO sao versionadas.

# Notas Pessoais

## TODO
- [ ] Revisar implementacao do cache
- [ ] Testar com dados de producao

## Anotacoes
- API externa esta lenta, usar mock local
- Credenciais de teste em 1Password