Tutoriais do Claude Code

Este guia fornece tutoriais passo a passo para fluxos de trabalho comuns com o Claude Code. Cada tutorial inclui instruções claras, comandos de exemplo e melhores práticas para ajudá-lo a obter o máximo do Claude Code.

​

Índice

• Entender novas bases de código
• Corrigir bugs eficientemente
• Refatorar código
• Trabalhar com testes
• Criar pull requests
• Lidar com documentação
• Usar fluxos de trabalho git avançados
• Trabalhar com imagens
• Configurar memória do projeto
• Usar o Claude como utilitário unix
• Configurar o Model Context Protocol (MCP)

​

Entender novas bases de código

​

Obter uma visão geral rápida da base de código

Quando usar: Você acabou de entrar em um novo projeto e precisa entender sua estrutura rapidamente.

$ cd /path/to/project

$ claude

> me dê uma visão geral desta base de código

> explique os principais padrões de arquitetura usados aqui
> quais são os principais modelos de dados?
> como a autenticação é tratada?

Dicas:

• Comece com perguntas amplas, depois restrinja a áreas específicas
• Pergunte sobre convenções de codificação e padrões usados no projeto
• Solicite um glossário de termos específicos do projeto

​

Encontrar código relevante

Quando usar: Você precisa localizar código relacionado a uma funcionalidade ou recurso específico.

> encontre os arquivos que lidam com autenticação de usuário

> como esses arquivos de autenticação trabalham juntos?

> trace o processo de login do front-end ao banco de dados

Dicas:

• Seja específico sobre o que você está procurando
• Use a linguagem do domínio do projeto

​

Corrigir bugs eficientemente

​

Diagnosticar mensagens de erro

Quando usar: Você encontrou uma mensagem de erro e precisa encontrar e corrigir sua origem.

> Estou vendo um erro quando executo npm test

> sugira algumas maneiras de corrigir o @ts-ignore em user.ts

> atualize user.ts para adicionar a verificação de nulo que você sugeriu

Dicas:

• Diga ao Claude o comando para reproduzir o problema e obter um rastreamento de pilha
• Mencione quaisquer etapas para reproduzir o erro
• Informe ao Claude se o erro é intermitente ou consistente

​

Refatorar código

​

Modernizar código legado

Quando usar: Você precisa atualizar código antigo para usar padrões e práticas modernas.

> encontre uso de API obsoleta em nossa base de código

> sugira como refatorar utils.js para usar recursos modernos do JavaScript

> refatore utils.js para usar recursos do ES2024 mantendo o mesmo comportamento

> execute testes para o código refatorado

Dicas:

• Peça ao Claude para explicar os benefícios da abordagem moderna
• Solicite que as mudanças mantenham compatibilidade retroativa quando necessário
• Faça a refatoração em pequenos incrementos testáveis

​

Trabalhar com testes

​

Adicionar cobertura de testes

Quando usar: Você precisa adicionar testes para código não coberto.

> encontre funções em NotificationsService.swift que não são cobertas por testes

> adicione testes para o serviço de notificação

> adicione casos de teste para condições de borda no serviço de notificação

> execute os novos testes e corrija quaisquer falhas

Dicas:

• Peça testes que cubram casos de borda e condições de erro
• Solicite tanto testes unitários quanto de integração quando apropriado
• Peça ao Claude para explicar a estratégia de teste

​

Criar pull requests

​

Gerar PRs abrangentes

Quando usar: Você precisa criar um pull request bem documentado para suas alterações.

> resuma as alterações que fiz no módulo de autenticação

> criar um pr

> melhore a descrição do PR com mais contexto sobre as melhorias de segurança

> adicione informações sobre como essas alterações foram testadas

Dicas:

• Peça diretamente ao Claude para fazer um PR para você
• Revise o PR gerado pelo Claude antes de enviar
• Peça ao Claude para destacar riscos ou considerações potenciais

​

Lidar com documentação

​

Gerar documentação de código

Quando usar: Você precisa adicionar ou atualizar documentação para seu código.

> encontre funções sem comentários JSDoc adequados no módulo de autenticação

> adicione comentários JSDoc às funções não documentadas em auth.js

> melhore a documentação gerada com mais contexto e exemplos

> verifique se a documentação segue nossos padrões de projeto

Dicas:

• Especifique o estilo de documentação que você deseja (JSDoc, docstrings, etc.)
• Peça exemplos na documentação
• Solicite documentação para APIs públicas, interfaces e lógica complexa

​

Trabalhar com imagens

​

Analisar imagens e capturas de tela

Quando usar: Você precisa trabalhar com imagens em sua base de código ou obter ajuda do Claude para analisar conteúdo de imagem.

# 1. Arraste e solte uma imagem na janela do Claude Code

# 2. Copie uma imagem e cole-a no CLI com ctrl+v

# 3. Forneça um caminho de imagem
$ claude
> Analise esta imagem: /path/to/your/image.png

> O que esta imagem mostra?
> Descreva os elementos da UI nesta captura de tela
> Há elementos problemáticos neste diagrama?

> Aqui está uma captura de tela do erro. O que está causando isso?
> Este é nosso esquema de banco de dados atual. Como devemos modificá-lo para o novo recurso?

> Gere CSS para corresponder a este mockup de design
> Qual estrutura HTML recriaria este componente?

Dicas:

• Use imagens quando descrições textuais seriam pouco claras ou trabalhosas
• Inclua capturas de tela de erros, designs de UI ou diagramas para melhor contexto
• Você pode trabalhar com múltiplas imagens em uma conversa
• A análise de imagem funciona com diagramas, capturas de tela, mockups e mais

​

Configurar memória do projeto

​

Criar um arquivo CLAUDE.md efetivo

Quando usar: Você quer configurar um arquivo CLAUDE.md para armazenar informações importantes do projeto, convenções e comandos frequentemente usados.

> /init

Dicas:

• Inclua comandos frequentemente usados (build, test, lint) para evitar buscas repetidas
• Documente preferências de estilo de código e convenções de nomenclatura
• Adicione padrões arquiteturais importantes específicos do seu projeto
• Você pode adicionar arquivos CLAUDE.md à pasta onde executa o Claude, diretórios pai (Claude lê estes automaticamente), ou diretórios filhos (Claude os puxa sob demanda)

​

Usar o Claude como utilitário unix

​

Adicionar o Claude ao seu processo de verificação

Quando usar: Você quer usar o Claude Code como um linter ou revisor de código.

Passos:

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'você é um linter. por favor, olhe as mudanças vs. main e reporte quaisquer problemas relacionados a erros de digitação. reporte o nome do arquivo e número da linha em uma linha, e uma descrição do problema na segunda linha. não retorne nenhum outro texto.'"
    }
}

​

Pipe in, pipe out

Quando usar: Você quer canalizar dados para o Claude e receber dados de volta em um formato estruturado.

$ cat build-error.txt | claude -p 'explique concisamente a causa raiz deste erro de build' > output.txt

​

Configurar Model Context Protocol (MCP)

Model Context Protocol (MCP) é um protocolo aberto que permite que LLMs acessem ferramentas externas e fontes de dados. Para mais detalhes, veja a documentação do MCP.

​

Configurar servidores MCP

Quando usar: Você quer aprimorar as capacidades do Claude conectando-o a ferramentas especializadas e servidores externos usando o Model Context Protocol.

# Sintaxe básica
$ claude mcp add <nome> <comando> [args...]

# Exemplo: Adicionando um servidor local
$ claude mcp add meu-servidor -e API_KEY=123 -- /path/to/server arg1 arg2

# Listar todos os servidores configurados
$ claude mcp list

# Obter detalhes para um servidor específico
$ claude mcp get meu-servidor

# Remover um servidor
$ claude mcp remove meu-servidor

Dicas:

• Use a flag -s ou --scope com project (padrão) ou global para especificar onde a configuração é armazenada
• Defina variáveis de ambiente com flags -e ou --env (ex: -e CHAVE=valor)
• MCP segue uma arquitetura cliente-servidor onde o Claude Code (o cliente) pode se conectar a múltiplos servidores especializados

​

Conectar a um servidor MCP Postgres

Quando usar: Você quer dar ao Claude acesso somente leitura a um banco de dados PostgreSQL para consultas e inspeção de esquema.

$ claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"

# Em sua sessão do Claude, você pode perguntar sobre seu banco de dados
$ claude
> descreva o esquema da nossa tabela de usuários
> quais são os pedidos mais recentes no sistema?
> mostre-me o relacionamento entre clientes e faturas

Dicas:

• O servidor MCP Postgres fornece acesso somente leitura por segurança
• Claude pode ajudar você a explorar a estrutura do banco de dados e executar consultas analíticas
• Você pode usar isso para entender rapidamente esquemas de banco de dados em projetos não familiares
• Certifique-se de que sua string de conexão use credenciais apropriadas com permissões mínimas necessárias

​

Próximos passos