Tutoriais

​

Índice

• Retomar conversas anteriores
• Entender novas bases de código
• Corrigir bugs eficientemente
• Refatorar código
• Trabalhar com testes
• Criar pull requests
• Lidar com documentação
• Trabalhar com imagens
• Usar pensamento estendido
• Configurar memória do projeto
• Configurar o Model Context Protocol (MCP)
• Usar o Claude como um utilitário estilo unix
• Criar comandos de barra personalizados
• Executar sessões paralelas do Claude Code com Git worktrees

​

Retomar conversas anteriores

​

Continue seu trabalho sem interrupções

• --continue para continuar automaticamente a conversa mais recente
• --resume para exibir um seletor de conversas

claude --continue

claude --continue --print "Continue com minha tarefa"

claude --resume

1. Armazenamento de Conversas: Todas as conversas são automaticamente salvas localmente com todo o histórico de mensagens
2. Desserialização de Mensagens: Ao retomar, todo o histórico de mensagens é restaurado para manter o contexto
3. Estado das Ferramentas: O uso de ferramentas e resultados da conversa anterior são preservados
4. Restauração de Contexto: A conversa é retomada com todo o contexto anterior intacto

• O histórico de conversas é armazenado localmente em sua máquina
• Use --continue para acesso rápido à sua conversa mais recente
• Use --resume quando precisar selecionar uma conversa específica do passado
• Ao retomar, você verá todo o histórico da conversa antes de continuar
• A conversa retomada começa com o mesmo modelo e configuração do original

# Continuar a conversa mais recente
claude --continue

# Continuar a conversa mais recente com um prompt específico
claude --continue --print "Mostre nosso progresso"

# Mostrar seletor de conversas
claude --resume

# Continuar a conversa mais recente no modo não interativo
claude --continue --print "Execute os testes novamente"

​

Entender novas bases de código

​

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

cd /caminho/para/projeto 

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?

• 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

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

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

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

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

​

Corrigir bugs eficientemente

​

Diagnosticar mensagens de erro

> 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 

• Informe 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

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

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

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

> execute testes para o código refatorado 

• 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

> encontre funções em NotificationsService.swift que não estã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 

• 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

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

> crie 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 

• 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 potenciais ou considerações

​

Lidar com documentação

​

Gerar documentação de 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 os padrões do nosso projeto 

• 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

> 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? 

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

​

Usar pensamento estendido

​

Aproveite o pensamento estendido do Claude para tarefas complexas

> Preciso implementar um novo sistema de autenticação usando OAuth2 para nossa API. Pense profundamente sobre a melhor abordagem para implementar isso em nossa base de código. 

> pense sobre possíveis vulnerabilidades de segurança nesta abordagem 
> pense mais profundamente sobre casos de borda que devemos tratar 

• Planejar mudanças arquitetônicas complexas
• Depurar problemas intrincados
• Criar planos de implementação para novos recursos
• Entender bases de código complexas
• Avaliar compensações entre diferentes abordagens

• “pense” aciona o pensamento estendido básico
• frases intensificadoras como “pense mais”, “pense muito”, “pense mais profundamente” ou “pense por mais tempo” acionam um pensamento mais profundo

​

Configurar memória do projeto

​

Criar um arquivo CLAUDE.md eficaz

> /init 

• 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 arquitetônicos importantes específicos do seu projeto
• As memórias do CLAUDE.md podem ser usadas tanto para instruções compartilhadas com sua equipe quanto para suas preferências individuais. Para mais detalhes, veja Gerenciando a memória do Claude.

​

Configurar o Model Context Protocol (MCP)

​

Configurar servidores MCP

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

# Exemplo: Adicionando um servidor local
claude mcp add meu-servidor -e API_KEY=123 -- /caminho/para/servidor arg1 arg2

# Sintaxe básica
claude mcp add --transport sse <nome> <url>

# Exemplo: Adicionando um servidor SSE
claude mcp add --transport sse servidor-sse https://exemplo.com/endpoint-sse

# 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

• Use a flag -s ou --scope para especificar onde a configuração é armazenada:
  • local (padrão): Disponível apenas para você no projeto atual (era chamado de project em versões mais antigas)
  • project: Compartilhado com todos no projeto via arquivo .mcp.json
  • user: Disponível para você em todos os projetos (era chamado de global em versões mais antigas)
• Defina variáveis de ambiente com flags -e ou --env (por exemplo, -e CHAVE=valor)
• Configure o tempo limite de inicialização do servidor MCP usando a variável de ambiente MCP_TIMEOUT (por exemplo, MCP_TIMEOUT=10000 claude define um tempo limite de 10 segundos)
• Verifique o status do servidor MCP a qualquer momento usando o comando /mcp dentro do Claude Code
• MCP segue uma arquitetura cliente-servidor onde o Claude Code (o cliente) pode se conectar a vários servidores especializados

​

Entendendo os escopos de servidor MCP

# Adicionar um servidor de escopo local (padrão)
claude mcp add meu-servidor-privado /caminho/para/servidor

# Especificar explicitamente o escopo local
claude mcp add meu-servidor-privado -s local /caminho/para/servidor

# Adicionar um servidor de escopo de projeto
claude mcp add servidor-compartilhado -s project /caminho/para/servidor

{
  "mcpServers": {
    "servidor-compartilhado": {
      "command": "/caminho/para/servidor",
      "args": [],
      "env": {}
    }
  }
}

# Adicionar um servidor de usuário
claude mcp add meu-servidor-usuario -s user /caminho/para/servidor

• Servidores de escopo local têm precedência sobre servidores de escopo de projeto e de usuário com o mesmo nome
• Servidores de escopo de projeto (em .mcp.json) têm precedência sobre servidores de escopo de usuário com o mesmo nome
• Antes de usar servidores de escopo de projeto de .mcp.json, o Claude Code solicitará que você os aprove por segurança
• O arquivo .mcp.json é destinado a ser incluído no controle de versão para compartilhar servidores MCP com sua equipe
• Servidores de escopo de projeto facilitam garantir que todos em sua equipe tenham acesso às mesmas ferramentas MCP
• Se você precisar redefinir suas escolhas para quais servidores de escopo de projeto estão habilitados ou desabilitados, use o comando claude mcp reset-project-choices

​

Conectar a um servidor MCP Postgres

claude mcp add servidor-postgres /caminho/para/postgres-mcp-server --connection-string "postgresql://usuario:senha@localhost:5432/meudb"

# Em sua sessão do Claude, você pode perguntar sobre seu banco de dados

> descreva o esquema da nossa tabela de usuários
> quais são os pedidos mais recentes no sistema?
> mostre-me a relação entre clientes e faturas

• O servidor MCP Postgres fornece acesso somente leitura para segurança
• Claude pode ajudá-lo 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 desconhecidos
• Certifique-se de que sua string de conexão use credenciais apropriadas com permissões mínimas necessárias

​

Adicionar servidores MCP a partir de configuração JSON

# Sintaxe básica
claude mcp add-json <nome> '<json>'

# Exemplo: Adicionando um servidor stdio com configuração JSON
claude mcp add-json api-clima '{"type":"stdio","command":"/caminho/para/cli-clima","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

claude mcp get api-clima

• Certifique-se de que o JSON esteja adequadamente escapado em seu shell
• O JSON deve estar em conformidade com o esquema de configuração do servidor MCP
• Você pode usar -s user para adicionar o servidor à sua configuração de usuário em vez da específica do projeto

​

Importar servidores MCP do Claude Desktop

# Sintaxe básica 
claude mcp add-from-claude-desktop 

claude mcp list 

• Este recurso funciona apenas no macOS e Windows Subsystem for Linux (WSL)
• Ele lê o arquivo de configuração do Claude Desktop de sua localização padrão nessas plataformas
• Use a flag -s user para adicionar servidores à sua configuração de usuário
• Servidores importados terão os mesmos nomes que no Claude Desktop
• Se servidores com os mesmos nomes já existirem, eles receberão um sufixo numérico (por exemplo, servidor_1)

​

Usar o Claude Code como um servidor MCP

# Sintaxe básica
claude mcp serve

{
  "command": "claude",
  "args": ["mcp", "serve"],
  "env": {}
}

• O servidor fornece acesso às ferramentas do Claude como View, Edit, LS, etc.
• No Claude Desktop, tente pedir ao Claude para ler arquivos em um diretório, fazer edições e mais.
• Observe que este servidor MCP está simplesmente expondo as ferramentas do Claude Code ao seu cliente MCP, então seu próprio cliente é responsável por implementar a confirmação do usuário para chamadas de ferramentas individuais.

​

Usar o Claude como um utilitário estilo unix

​

Adicionar o Claude ao seu processo de verificação

// 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

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

​

Controlar formato de saída

cat dados.txt | claude -p 'resuma estes dados' --output-format text > resumo.txt

cat codigo.py | claude -p 'analise este código em busca de bugs' --output-format json > analise.json

cat log.txt | claude -p 'analise este arquivo de log em busca de erros' --output-format stream-json

• Use --output-format text para integrações simples onde você só precisa da resposta do Claude
• Use --output-format json quando precisar do log completo da conversa
• Use --output-format stream-json para saída em tempo real de cada turno da conversa

​

Criar comandos de barra personalizados

​

Criar comandos específicos do projeto

mkdir -p .claude/commands

echo "Analise o desempenho deste código e sugira três otimizações específicas:" > .claude/commands/otimizar.md 

claude > /project:otimizar 

• Os nomes dos comandos são derivados do nome do arquivo (por exemplo, otimizar.md se torna /project:otimizar)
• Você pode organizar comandos em subdiretórios (por exemplo, .claude/commands/frontend/componente.md se torna /project:frontend:componente)
• Comandos do projeto estão disponíveis para todos que clonam o repositório
• O conteúdo do arquivo Markdown se torna o prompt enviado ao Claude quando o comando é invocado

​

Adicionar argumentos de comando com $ARGUMENTS

echo "Encontre e corrija o problema #$ARGUMENTS. Siga estas etapas: 1.
Entenda o problema descrito no ticket 2. Localize o código relevante em
nossa base de código 3. Implemente uma solução que aborde a causa raiz 4. Adicione
testes apropriados 5. Prepare uma descrição concisa de PR" >
.claude/commands/corrigir-problema.md 

claude > /project:corrigir-problema 123 

• O espaço reservado $ARGUMENTS é substituído por qualquer texto que segue o comando
• Você pode posicionar $ARGUMENTS em qualquer lugar no seu modelo de comando
• Outras aplicações úteis: gerar casos de teste para funções específicas, criar documentação para componentes, revisar código em arquivos específicos ou traduzir conteúdo para idiomas especificados

​

Criar comandos de barra pessoais

mkdir -p ~/.claude/commands 

echo "Revise este código em busca de vulnerabilidades de segurança, focando em:" >
~/.claude/commands/revisao-seguranca.md 

claude > /user:revisao-seguranca 

• Comandos pessoais são prefixados com /user: em vez de /project:
• Comandos pessoais estão disponíveis apenas para você e não são compartilhados com sua equipe
• Comandos pessoais funcionam em todos os seus projetos
• Você pode usá-los para fluxos de trabalho consistentes em diferentes bases de código

​

Executar sessões paralelas do Claude Code com Git worktrees

​

Usar worktrees para ambientes de codificação isolados

# Criar um novo worktree com um novo branch 
git worktree add ../projeto-recurso-a -b recurso-a

# Ou criar um worktree com um branch existente
git worktree add ../projeto-bugfix bugfix-123

# Navegue até seu worktree 
cd ../projeto-recurso-a

# Execute o Claude Code neste ambiente isolado
claude

cd ../projeto-bugfix
claude

# Listar todos os worktrees
git worktree list

# Remover um worktree quando terminar
git worktree remove ../projeto-recurso-a

• Cada worktree tem seu próprio estado de arquivo independente, tornando-o perfeito para sessões paralelas do Claude Code
• Alterações feitas em um worktree não afetarão outros, evitando que instâncias do Claude interfiram umas com as outras
• Todos os worktrees compartilham o mesmo histórico Git e conexões remotas
• Para tarefas de longa duração, você pode ter o Claude trabalhando em um worktree enquanto continua o desenvolvimento em outro
• Use nomes de diretório descritivos para identificar facilmente para qual tarefa é cada worktree
• Lembre-se de inicializar seu ambiente de desenvolvimento em cada novo worktree de acordo com a configuração do seu projeto. Dependendo da sua stack, isso pode incluir:
  • Projetos JavaScript: Executar instalação de dependências (npm install, yarn)
  • Projetos Python: Configurar ambientes virtuais ou instalar com gerenciadores de pacotes
  • Outras linguagens: Seguir o processo de configuração padrão do seu projeto

​

Próximos passos