Claude Code — Setup e Uso

Pre-requisitos

Claude Code instalado (npm install -g @anthropic-ai/claude-code)
Acesso ao workspace Vendee no Linear

Configuracao do MCP (Linear)

O arquivo .claude/settings.json na raiz do repo configura a conexao com o Linear:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/sse"]
    }
  }
}

Na primeira vez, rode /mcp dentro do Claude Code para autenticar com o Linear.

CLAUDE.md

O arquivo CLAUDE.md na raiz do repositorio contem todas as convencoes do projeto. O Claude Code le esse arquivo automaticamente ao iniciar. Ele inclui:

Stack e arquitetura do monorepo
Convencoes de codigo e componentes (shadcn/ui, TanStack Query, Zustand)
Regras de workflow com Linear (branches, commits, PRs)
Padroes de data fetching e state management
Lista de "Do NOT" (guardrails)
Checklist de implementacao

Sempre que o Claude Code fizer algo errado ou fora do padrao, adicione a regra no CLAUDE.md. Ele aplica as novas regras imediatamente na proxima interacao.

Comandos Comuns

Voce diz	Claude Code faz
"Pega a issue CRM-12 e implementa"	Le issue via MCP, cria branch, codifica, abre PR
"Lista as issues In Progress do CRM"	Consulta via MCP e lista
"Antes de implementar, me propoe a arquitetura da CRM-13"	Le a issue e propoe estrutura tecnica sem codar
"Atualiza a CRM-12 com comentario de progresso"	Adiciona comentario na issue via MCP
"Abre PR pra main com Closes CRM-12"	Cria PR no GitHub

Issues Grandes (Modulos Inteiros)

Para issues que envolvem modulos inteiros, siga esta abordagem:

Proposta de arquitetura

Peca primeiro a proposta tecnica ao Claude Code:

Antes de implementar, me propoe a arquitetura da CRM-15

Validar

Revise a proposta — componentes, hooks, tabelas, rotas. Ajuste antes de codar.

Implementar em etapas

Implemente em passos incrementais dentro do mesmo branch:

Tabelas e migrations (com aprovacao)
Hooks de data fetching
Componentes e paginas
Navegacao e integracao

PR unico

Tudo no mesmo branch e PR, referenciando a issue com Closes ISSUE-ID.

Claude Code — Setup e Uso

On this page