Claude Code — Setup e Uso

Pré-requisitos

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

Configuração do MCP (Linear)

O arquivo .claude/settings.json na raiz do repo configura a conexão 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 repositório contém todas as convenções do projeto. O Claude Code lê esse arquivo automaticamente ao iniciar. Ele inclui:

Stack e arquitetura do monorepo
Convenções de código e componentes (shadcn/ui, TanStack Query, Zustand)
Regras de workflow com Linear (branches, commits, PRs)
Padrões de data fetching e state management
Lista de "Do NOT" (guardrails)
Checklist de implementação

Sempre que o Claude Code fizer algo errado ou fora do padrão, adicione a regra no CLAUDE.md. Ele aplica as novas regras imediatamente na próxima interação.

Comandos Comuns

Você diz	Claude Code faz
"Pega a issue CRM-12 e implementa"	Lê issue via MCP, cria branch, codifica, abre PR
"Lista as issues In Progress do CRM"	Consulta via MCP e lista
"Antes de implementar, me propõe a arquitetura da CRM-13"	Lê a issue e propõe estrutura técnica sem codar
"Atualiza a CRM-12 com comentário de progresso"	Adiciona comentário na issue via MCP
"Abre PR pra main com Ref CRM-12"	Cria PR no GitHub com `Ref CRM-12` no corpo

Issues Grandes (Módulos Inteiros)

Para issues que envolvem módulos inteiros, siga esta abordagem:

Proposta de arquitetura

Peça primeiro a proposta técnica ao Claude Code:

Antes de implementar, me propõe 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 aprovação)
Hooks de data fetching
Componentes e páginas
Navegação e integração

PR único

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

Claude Code — Setup e Uso

On this page