Aprendizagem pessoal com IA
e orientação prática
TRAE

Como lidar com o Claude Code: um guia prático para aumentar a produtividade da programação de IA

Como lidar com o Claude Code: dicas práticas sobre codificação baseada em agentes da linha de frente

Claude Code O Agentic Coding é uma ferramenta de linha de comando para codificação agêntica. A codificação agêntica refere-se à ideia de dar à IA alguma autonomia para entender tarefas, planejar etapas e executar ações (por exemplo, ler/gravar arquivos, executar comandos) para fazer trabalhos relacionados à codificação, em vez de apenas completar o código ou fazer perguntas e respostas. Este guia reúne as práticas recomendadas para codificação em diferentes bases de código, linguagens e ambientes usando o Claude Code Dicas e truques práticos que comprovadamente funcionam.

Anthropic Lançado recentemente Claude CodeComo a ferramenta foi originalmente desenvolvida como um projeto de pesquisa para permitir que engenheiros e pesquisadores internos integrassem de forma mais natural o Claude são integrados ao processo diário de codificação.


Claude Code A filosofia de design é deliberadamente de baixo nível e sem opiniões, fornecendo acesso próximo ao modelo original sem forçar o usuário a seguir um fluxo de trabalho específico. Esse design o torna uma ferramenta poderosa, flexível, personalizável, com scripts e relativamente segura. No entanto, essa flexibilidade também significa que os engenheiros que são novos nas ferramentas de codificação baseadas em agentes precisam de algum tempo de aprendizado até descobrirem as práticas recomendadas por si mesmos.

Neste artigo, apresentaremos alguns dos produtos que foram Anthropic Modelos eficazes que foram amplamente validados por equipes internas e engenheiros externos. Essas sugestões não são regras de ouro ou universalmente aplicáveis; você pode considerá-las como um ponto de partida e, em seguida, experimentar com ousadia para descobrir o que funciona melhor para você.

1. personalize seu ambiente de trabalho

Claude Code Atua como um auxiliar de codificação baseado em agente que integra automaticamente as informações contextuais aos prompts. Embora a coleta de contexto consuma tempo e tokens, ela pode ser otimizada com o ajuste das configurações do ambiente. Compreender e fazer bom uso de CLAUDE.md A documentação é uma primeira etapa fundamental.

a. Criação CLAUDE.md papéis

CLAUDE.md é um arquivo especial.Claude Code carrega automaticamente seu conteúdo no contexto quando um diálogo é iniciado. Isso o torna um local ideal para registrar as seguintes informações:

  • Comandos comuns do bash
  • Descrição dos principais documentos do projeto e das funções da ferramenta
  • Especificação de estilo de código
  • Instruções de execução de teste
  • Especificações de colaboração do repositório de código (por exemplo, convenções de nomenclatura de ramificação, mesclagem e seleção de base de variantes, etc.)
  • Configurações do ambiente de desenvolvimento (por exemplopyenv uso, versão do compilador aplicável)
  • Quaisquer comportamentos especiais no projeto ou avisos que precisem de atenção
  • Outras esperanças Claude Informações "lembradas" em longo prazo

CLAUDE.md Não há requisitos obrigatórios de formatação para o documento, e recomenda-se que ele seja conciso e legível. Exemplo:

# Bash 命令
- npm run build: 构建项目
- npm run typecheck: 运行类型检查器
# 代码风格
- 使用 ES 模块 (import/export) 语法,而非 CommonJS (require)
- 尽可能使用解构导入 (例如 import { foo } from 'bar')
# 工作流程
- 完成一系列代码更改后,务必运行类型检查
- 为提高性能,优先运行单个测试,而不是整个测试套件

Você pode definir o CLAUDE.md Os arquivos são colocados em vários locais:

  • Diretório raiz do depósitoou você executa claude do comando (o uso mais comum). Dê um nome a ele CLAUDE.md e enviá-lo para git nele para ser compartilhado entre sessões e membros da equipe (recomendado). Se quiser que a configuração local não seja compartilhada, você pode nomear o arquivo CLAUDE.local.md incorporar .gitignore.
  • estar em movimento claude Qualquer diretório pai do diretório de comandoIsso é particularmente útil em monorepresentações. Isso é especialmente útil em monorepo. Por exemplo, se você adicionar o root/foo e execute claudeIsso pode ser feito no root responder cantando root/foo são colocados no diretório CLAUDE.md ambos são carregados automaticamente.
  • estar em movimento claude Qualquer subdiretório do diretório de comando. Ao contrário do caso anterior, quando você trabalha com arquivos em subdiretórios, a funçãoClaude Os subdiretórios são carregados sob demanda. CLAUDE.md Documentação.
  • Seu diretório pessoal de usuário (~/.claude/CLAUDE.md). A configuração aqui será aplicada a todas as suas claude Sessões.

estar em movimento /init comando, oClaude gerará automaticamente uma base para você CLAUDE.md Documentação.

b. Ajuste de seu CLAUDE.md papéis

CLAUDE.md O arquivo se tornará Claude parte do prompt, portanto, ele deve ser polido da mesma forma que você faria com um prompt comum. Um equívoco comum é adicionar muito conteúdo sem verificar sua eficácia. Reserve um tempo para experimentar e ver quais instruções o modelo segue melhor.

Você pode editar manualmente CLAUDE.mdClaude Code Imprensa # dando um comando queClaude Ele será automaticamente integrado à CLAUDE.md arquivo. Muitos engenheiros codificam com o uso frequente de # para documentar comandos, documentação e guias de estilo, e para CLAUDE.md As alterações são incluídas no commit para que os membros da equipe também possam se beneficiar.

existir Anthropic Internamente, às vezes o melhorador imediato para otimizar CLAUDE.md documentar e ajustar o texto das instruções (por exemplo, usar "IMPORTANTE" ou "VOCÊ DEVE" para dar ênfase) para melhorar a conformidade do modelo.

Dominando o código Claude: um guia prático para melhorar a eficiência da programação de IA-1

c. Gerenciamento Claude A lista de ferramentas licenciadas pelo

Por padrão, oClaude Code A permissão é solicitada para qualquer operação que possa modificar seu sistema: gravação em arquivos, execução de muitos comandos bash, uso do comando MCP ferramentas, etc. Esse design conservador prioriza a segurança. É possível personalizar a lista de permissões para permitir ferramentas que você confia serem seguras ou para permitir ações potencialmente inseguras que podem ser facilmente desfeitas (por exemplo, edição de arquivos),git commit).

Há quatro maneiras de gerenciar a ferramenta de licenciamento:

  • Selecione quando solicitado em uma sessão "Sempre permitir".
  • ativar (um plano) Claude Code após o uso /allowed-tools comando Adicionar ou remover ferramentas da lista de licenças. Por exemplo, para adicionar Edit Permitir que o arquivo seja editado em todos os momentos, adicionar Bash(git commit:*) executável git commitou adicionar mcp__puppeteer__puppeteer_navigate uso permitido Puppeteer Servidor MCP para navegação.
  • edição manual sob o item .claude/settings.json (que é recomendável incluir no controle de versão para ser compartilhado com a equipe) ou no diretório inicial do usuário sob o nome ~/.claude.json.
  • fazer uso de --allowedTools sinalizador de linha de comando (computação) Definir permissões para uma sessão específica.

d. Se estiver usando GitHubInstalação gh ferramenta de linha de comando

Claude Saber como usar gh Ferramentas de linha de comando versus ferramentas de linha de comando. GitHub interações para criar problemas, iniciar solicitações pull, ler comentários, etc. Se você não tiver ghAssim que você instalar o GitHub API ou o servidor MCP correspondente.Claude ainda podem interagir dessa forma.

2. para Claude Fornecimento de ferramentas adicionais

Claude tem acesso ao seu ambiente de shell, e você pode criar scripts para ele da mesma forma que faria para si mesmo, com um conjunto prático de scripts e funções. Ele também pode tirar proveito de ferramentas mais sofisticadas por meio das APIs MCP e REST.

a. Deixe Claude Usando o utilitário bash

Claude Code herda seu ambiente bash e, portanto, tem acesso a todas as suas ferramentas. Embora Claude entender algo como unix ferramentas e gh Ele não pode saber automaticamente sobre suas ferramentas bash personalizadas, você precisa informá-lo:

  1. informe Claude Nome da ferramenta e exemplos de seu uso.
  2. mandar alguém fazer algo Claude estar em movimento --help Veja a documentação da ferramenta.
  3. Registre as ferramentas de personalização comumente usadas no CLAUDE.md Médio.

b. Deixe Claude Usando a MCP

MCP, o protocolo de contexto de modelo (Modelo de protocolo de contexto), uma especificação que permite que os modelos de linguagem interajam com ferramentas e serviços externos.Claude Code Ele pode ser usado como um servidor MCP ou como um cliente MCP. Como cliente, ele pode se conectar a qualquer número de servidores MCP para acessar suas ferramentas de três maneiras:

  • Em Configuração do projeto(Execute-o no diretório do projeto) Claude Code (quando disponível).
  • Na configuração global(disponível em todos os projetos).
  • depósito .mcp.json arquivo(disponível para todos que usam a base de código). Por exemplo, você pode definir o Puppeteer responder cantando Sentry O servidor é adicionado à lista .mcp.json Isso é para que todos os engenheiros da equipe possam usar essas ferramentas imediatamente.

Ao usar o MCP, o MCP pode ser definido pelo botão --mcp-debug Ativação da bandeira Claude Ajuda a diagnosticar problemas de configuração.

c. Uso de comandos de barra personalizados

Para fluxos de trabalho repetitivos, como loops de depuração, análise de registros, etc., os modelos de prompt podem ser armazenados no .claude/commands no arquivo Markdown. Quando você digita / Quando você faz isso, esses modelos aparecem no menu de comandos da barra. Você pode enviar esses comandos para o gitpara uso pelo restante da equipe.

Os comandos de barra personalizados podem conter palavras-chave especiais $ARGUMENTSque é usado para passar parâmetros anexados ao comando de chamada.

Por exemplo, aqui está um que pode ser puxado e corrigido automaticamente GitHub emitir comando de barra:

请分析并修复 GitHub issue: $ARGUMENTS。
请遵循以下步骤:
1. 使用 `gh issue view` 获取 issue 详细信息
2. 理解 issue 中描述的问题
3. 在代码库中搜索相关文件
4. 实现必要的代码更改以修复问题
5. 编写并运行测试以验证修复
6. 确保代码通过 linting 和类型检查
7. 创建描述性的 commit 消息
8. 推送代码并创建 PR
记住,所有与 GitHub 相关的任务都使用 GitHub CLI (`gh`)。

Salve as informações acima em .claude/commands/fix-github-issue.md Depois que o arquivo for Claude Code acertou em cheio /project:fix-github-issue para usá-lo agora. Por exemplo, executando /project:fix-github-issue 1234 teria permitido Claude para corrigir o problema número 1234. Da mesma forma, você pode adicionar comandos que você usa pessoalmente ao ~/.claude/commands para torná-la disponível para todas as sessões.

3. experimentação de fluxos de trabalho comuns

Claude Code Não impõe um fluxo de trabalho específico, dando-lhe a flexibilidade de usá-lo sob demanda. Com essa flexibilidade, vários modelos comprovados surgiram na comunidade de usuários:

a. Explorar, planejar, codificar, enviar

Esse é um processo genérico que se aplica a uma ampla gama de problemas:

  1. mandar alguém fazer algo Claude Ler documentos, imagens ou URLs relacionados. Ele pode receber instruções gerais ("read the file that handles logging") ou um nome de arquivo específico ("read logging.py"), mas é explicitamente instruído a não escrever nenhum código por enquanto.
    • Nessa etapa, especialmente para problemas complexos, considere a possibilidade de ter o Claude Use subagentes para validar detalhes ou investigar problemas específicos que ele possa encontrar. Fazer isso no início do diálogo ou da tarefa geralmente preserva a usabilidade do contexto sem sacrificar muito a eficiência.
  2. mandar alguém fazer algo Claude Desenvolvimento de planos para tratar de problemas específicos. Recomenda-se usar a palavra "think" (pensar) para acionar o modo de pensamento estendido, que fornecerá o Claude Tempo adicional de computação para avaliar alternativas de forma mais completa. O sistema tem um mapeamento integrado de orçamentos de raciocínio em diferentes níveis: "pensar" < "pensar muito" < "pensar mais" < "ultra-pensar". Cada nível aloca mais orçamento de raciocínio para Claude Use.
    • Se os resultados dessa etapa parecerem razoáveis, você pode deixar o Claude Escreva o plano em um documento ou crie GitHub para que, se a implementação subsequente (etapa 3) não atender às expectativas, você possa voltar a esse estado.
  3. mandar alguém fazer algo Claude Escrever código para implementar seus programas. Esse também é um bom momento para pedir que ele valide explicitamente a solidez das várias partes do programa à medida que ele for sendo realizado.
  4. mandar alguém fazer algo Claude Envie os resultados e crie uma solicitação pull.. Se for relevante, também é possível fazer Claude atualização README talvez changelogexplicando o que acabou de fazer.

As etapas #1 e #2 são essenciais - sem elas, oClaude Muitas vezes, você vai direto para a etapa de codificação. Embora às vezes isso seja exatamente o que você quer, para problemas que exigem um pensamento mais aprofundado, é importante primeiro deixar que o Claude A realização de pesquisa e planejamento pode melhorar significativamente o resultado final.

b. Escrever testes, enviar; codificar, iterar, enviar

isto é Anthropic Um fluxo de trabalho altamente respeitado internamente, especialmente para alterações que podem ser facilmente verificadas por meio de testes unitários, de integração ou de ponta a ponta. O desenvolvimento orientado por testes (TDD) se torna ainda mais poderoso com a codificação baseada em agentes:

  1. mandar alguém fazer algo Claude Escreva testes com base nos pares de entrada/saída esperados. Comunique explicitamente que o desenvolvimento orientado por testes está ocorrendo, de modo a evitar a criação de implementações simuladas, mesmo que a funcionalidade ainda não exista.
  2. informe Claude Execute os testes e confirme se eles falharam. Geralmente, é útil instruí-lo explicitamente a não escrever nenhum código de implementação nesse estágio.
  3. Quando você estiver satisfeito com o teste.mandar alguém fazer algo Claude Enviar código de teste.
  4. mandar alguém fazer algo Claude Escrever código que passe nos testese instrua-o a não modificar o teste em si. Diga Claude Continue tentando até que todos os testes sejam aprovados. Geralmente, são necessárias várias iterações (escrever código, executar testes, ajustar o código, executar testes novamente).
    • Nesse estágio, pode ser necessário usar um subagente independente para verificar se a implementação não está se ajustando demais aos casos de teste.
  5. Quando você estiver satisfeito com as alterações no códigomandar alguém fazer algo Claude Enviar código.

(col.) reprovar (um aluno) Claude Seu desempenho é melhor quando há um objetivo claro que pode ser repetido, como um modelo visual, um caso de teste ou alguma outra forma de resultado esperado. Ao fornecer um resultado esperado, como um testeClaude Podem ser feitas alterações, os resultados podem ser avaliados e melhorias incrementais podem ser feitas até que sejam bem-sucedidas.

c. Escrever código, comparar capturas de tela, iterar

Da mesma forma que os fluxos de trabalho de teste, você também pode criar um fluxo de trabalho de teste para o Claude Forneça alvos visuais:

  1. para o benefício de Claude Uma maneira de capturar as telas do navegador(Por exemplo, usando Servidor Puppeteer MCPeSimulador de iOS Servidor MCPou copie e cole manualmente a captura de tela em Claude).
  2. para o benefício de Claude Um rascunho de design visualVocê pode fazer isso copiando e colando, arrastando e soltando a imagem ou fornecendo o caminho para o arquivo de imagem.
  3. mandar alguém fazer algo Claude Implementação do design no códigointerceptar o gráfico resultante e iterar até que o resultado corresponda ao projeto.
  4. Quando você estiver satisfeito.mandar alguém fazer algo Claude Enviar código.

Como os humanos.Claude geralmente melhora significativamente após as iterações. A primeira versão pode ser boa, mas depois de duas ou três iterações, geralmente fica muito melhor. Para Claude Fornecer ferramentas para visualizar seus resultados proporciona os melhores resultados.

Dominando o código Claude: um guia prático para melhorar a eficiência da programação de IA-1

d. Modo YOLO de segurança

Se você não quiser supervisionar todo o processo ClaudeVocê pode usar o claude --dangerously-skip-permissions para ignorar todas as verificações de permissão e permitir que o parâmetro Claude Trabalhar ininterruptamente até a conclusão. Esse modo é adequado para a execução de fluxos de trabalho, como a correção de erros de lint ou a geração de código de amostra.

avisos: Let Claude A execução de comandos arbitrários sem validação é arriscada e pode levar à perda de dados, à corrupção do sistema ou até mesmo ao vazamento de dados (por exemplo, por meio de um ataque de injeção de prompt). Para minimizar esses riscos, é altamente recomendável que os contêineres sem acesso à Internet usem o --dangerously-skip-permissions. Você pode consultar Claude Code fornecido no repositório com base no Docker Contêineres de desenvolvimento implementação de referência.

e. Perguntas e respostas sobre a base de código (Q&A)

Ao abordar uma nova base de código, você pode usar o Claude Code Para aprender e explorar. Você pode aprender com outros engenheiros do projeto, como fez ao programar em pares com Claude Pergunta.Claude Capacidade de pesquisar agenticamente a base de código para responder a perguntas gerais, por exemplo:

  • Como funciona o sistema de registro?
  • Como faço para criar um novo endpoint de API?
  • foo.rs O texto a seguir é o da linha 134 do documento async move { ... } O que ele faz?
  • CustomerOnboardingFlowImpl Quais situações de fronteira foram abordadas?
  • Por que a chamada para foo() em vez de bar()?
  • baz.py O código na linha 334 do arquivo está na seção Java Qual é a contrapartida em

existir AnthropicO uso do Claude Code O processo de integração, que se tornou essencial, reduz significativamente o tempo de familiarização dos novos membros da equipe e alivia a carga dos outros engenheiros. Não são necessários avisos especiais! Basta fazer a pergunta.Claude exploraria o código para encontrar a resposta.

Dominando o código Claude: um guia prático para melhorar a eficiência da programação de IA-1

f. Deixe Claude junto com git um ao outro

Claude Pode lidar efetivamente com muitos git Operação. Muitas Anthropic Os engenheiros irão 90% acima git entregar para Claude Processamento:

  • procurar algo git histórias para responder a perguntas como "Quais alterações estão incluídas na v1.2.3?" , "Quem é responsável por qual recurso?" ou "Por que a API foi projetada dessa forma?" ou "Por que essa API foi projetada dessa forma?". Dicas claras Claude consulte git Os registros históricos ajudam a responder a essas perguntas.
  • Escrevendo uma mensagem de confirmação.Claude examinará automaticamente suas alterações de código e o histórico recente, sintetizando todo o contexto relevante para compor a mensagem.
  • processamento de complexos git equipamentoPor exemplo, desfazer alterações em arquivos, resolver conflitos de rebase, comparar e aplicar patches (patch grafting).

g. Deixe Claude junto com GitHub um ao outro

Claude Code É possível gerenciar muitos GitHub Interação:

  • Criação de um pull request::Claude Compreende a abreviação "pr" e gera mensagens de confirmação apropriadas com base nas diferenças de código (diffs) e no contexto circundante.
  • Solução completa para comentários simples de revisão de códigoSe o comentário no PR for corrigido (o que pode ser acompanhado de instruções mais específicas), basta dizer a ele para corrigir o comentário no PR e enviá-lo de volta para a ramificação do PR quando terminar.
  • Correção de compilações com falha ou aviso de linter.
  • Classificação e triagem Problemas não processados: Let Claude Iterar por todos os estados abertos GitHub questão.

É para que você não precise se lembrar gh A sintaxe complexa do comando automatiza muitas tarefas de rotina.

h. Deixe Claude lidar com Jupyter notebook

Anthropic de pesquisadores e cientistas de dados que usam Claude Code para ler e escrever Jupyter Notebook.Claude A capacidade de entender a saída, incluindo imagens, fornece um atalho para explorar e interagir com os dados. Não há prompts específicos ou requisitos de fluxo de trabalho, mas uma maneira recomendada de trabalhar com o VS Code Abrir lado a lado em Claude Code responder cantando .ipynb Documentação.

Você também pode fazer Claude Limpe ou enfeite sua casa antes de mostrá-la aos colegas Jupyter Dizer explicitamente a ele para tornar o notebook ou suas visualizações de dados "esteticamente agradáveis" geralmente ajuda a lembrá-lo de que ele está sendo otimizado para uma experiência de leitura humana.

4. otimize seu fluxo de trabalho

As recomendações a seguir se aplicam a todos os fluxos de trabalho:

a. Seja específico em suas instruções

Claude Code A taxa de sucesso aumenta significativamente quando as instruções são mais específicas, especialmente na primeira tentativa. Fornecer instruções claras desde o início reduz o custo das correções subsequentes.

Exemplo:

Instruções insuficientemente específicas Instruções mais específicas
Adição de testes ao foo.py por causa de foo.py Escreva um novo caso de teste que cubra o caso limite quando o usuário não estiver conectado. Evite usar mock.
Por qual motivo? ExecutionFactory A API é tão estranha assim? consulte ExecutionFactory (usado em uma expressão nominal) git para resumir como sua API evoluiu até o momento.
Adicionar um widget de calendário Confira as implementações dos widgets existentes na página inicial para entender os padrões, especialmente como o código e a interface são separados.HotDogWidget.php é um bom ponto de partida. Em seguida, siga esse padrão para implementar um novo widget de calendário que permita ao usuário selecionar o mês e avançar/retroceder na página para selecionar o ano. Crie do zero e não introduza novas bibliotecas além daquelas já usadas na base de código.

Claude Pode inferir a intenção, mas não lê mentes. A especificidade leva a um melhor alinhamento dos resultados.

Dominando o código Claude: um guia prático para melhorar a eficiência da programação de IA-1

b. Para Claude Fornecimento de fotos

Claude Excelente em trabalhar com imagens e gráficos, há várias maneiras de fornecer informações visuais:

  • Colar captura de tela(No macOS.Cmd+Ctrl+Shift+4 Você pode fazer uma captura de tela na área de transferência e adicioná-la à pasta Claude Code uso final Ctrl+V Colar. Observe que aqui está o Ctrl+V Em vez do habitual Cmd+V(e não oferece suporte à colagem remota).
  • arrastar e soltar (computação) arquivo de imagem na caixa de entrada de prompt.
  • Forneça o caminho do arquivo local da imagem.

Isso é particularmente útil quando se trabalha com rascunhos de design para o desenvolvimento da interface do usuário, realizando análises e diagramas visuais para depuração. Mesmo que você não forneça entrada visual para o Claude Também seria útil declarar explicitamente que a apresentação visual do resultado final é importante.

Dominando o código Claude: um guia prático para melhorar a eficiência da programação de IA-1

c. Mencione que você deseja Claude Documentos visualizados ou processados

Use o recurso de preenchimento automático da tecla Tab para fazer referência rápida a um arquivo ou pasta em qualquer lugar do seu repositório, ajudando-o a Claude Localize ou atualize o recurso correto.

Dominando o código Claude: um guia prático para melhorar a eficiência da programação de IA-1

d. Para Claude Fornecer URL

Cole o URL específico ao lado de seu prompt.Claude pode rastrear e ler seu conteúdo. Para evitar o risco de rastrear o mesmo domínio (por exemplo docs.foo.com) para exibir solicitações de permissão repetidamente, você pode usar o /allowed-tools adiciona o domínio à sua lista de licenças.

e. Correções de curso antecipadas e frequentes

Embora o modo de aceitação automática (pressione Shift+Tab (interruptor) permite que o Claude trabalham de forma autônoma, mas geralmente como colaboradores ativos e orientando os Claude O método de análise de dados dá melhores resultados. No início do Claude Explicar minuciosamente a tarefa proporciona os melhores resultados, mas você sempre pode consertá-la! Claude Como chegar.

As quatro ferramentas a seguir podem ajudar nas correções de orientação:

  • Antes da codificaçãosolicitação Claude desenvolver um plano. Diga a ele explicitamente para não começar a codificar até que você tenha confirmado que o plano funciona.
  • existir Claude qualquer estágio do processo (pensamento, invocação de ferramentas, edição de documentos)manter a mão sobre Escape interrupção de chaveque preservará o contexto atual e permitirá que você redirecione ou estenda os comandos.
  • clique duas vezes Escape A chave permite que você volte ao passadoEdite uma das dicas anteriores e explore diferentes direções. Você pode editar as dicas várias vezes até obter um resultado satisfatório.
  • solicitação Claude Desfazer alteraçõesA seguir, um exemplo de uma abordagem diferente, geralmente usada em conjunto com a opção #2.

mesmo que Claude Code Às vezes, é possível resolver o problema perfeitamente na primeira tentativa, mas o bom uso dessas ferramentas de correção geralmente produz uma solução melhor e mais rápida.

f. Use /clear Manutenção do foco contextual

Durante a longa sessão, oClaude A janela de contexto pode ser preenchida com diálogos, conteúdos de arquivos e comandos irrelevantes. Isso pode prejudicar o desempenho e, às vezes, distrair Claude de atenção. Uso frequente entre tarefas /clear redefine a janela de contexto.

g. Uso de listas de verificação e quadros de registros temporários para fluxos de trabalho complexos

Para tarefas grandes que contêm várias etapas ou exigem uma solução exaustiva, como migração de código, correção de um grande número de bugs de lint ou execução de scripts de compilação complexos, você pode facilitar as coisas com a opção Claude Usando arquivos Markdown (ou mesmo GitHub como listas de verificação e blocos de notas para melhorar o desempenho:

Por exemplo, para corrigir um grande número de problemas de fiapos, você pode fazer o seguinte:

  1. informe Claude Execute o comando linte grava todos os erros resultantes (incluindo nomes de arquivos e números de linhas) em um arquivo de manifesto Markdown.
  2. diretrizes Claude Abordagem de cada questão caso a casoDepois de corrigir e verificar, marque a lista como completa e passe para a próxima.

h. Para Claude transmitir dados

Há várias maneiras de enviar uma mensagem para Claude Fornecer dados:

  • Copiar e colar diretamenteem seu prompt (o método mais comum).
  • aprovar (um projeto de lei ou inspeção etc.)Entrada de tubo para Claude Code(por exemplo cat foo.txt | claude), que é especialmente útil para trabalhar com registros, arquivos CSV e grandes quantidades de dados.
  • informe Claude Extração de dados por meio de comandos bash, ferramentas MCP ou comandos slash personalizados.
  • solicitação Claude Ler arquivoou pegue o URL (também se aplica a imagens).

A maioria das sessões usará uma combinação desses métodos. Por exemplo, você pode passar um arquivo de registro por meio de um pipe e, em seguida, informar ao Claude Use uma das ferramentas para obter contexto adicional para depurar esses registros.

5. automatize sua infraestrutura com o modo sem cabeça

Claude Code incorpora modo sem cabeçaEle é adequado para ambientes não interativos, como CI (Integração Contínua), ganchos de pré-compromisso, scripts de compilação e tarefas automatizadas. Use o -p com um prompt para ativar o modo sem cabeça, use o sinalizador --output-format stream-json Você pode obter uma saída JSON de fluxo contínuo.

Observe que o modo sem cabeça não persiste entre as sessões e precisa ser acionado todas as vezes.

a. Use Claude Triagem de problemas

O modo sem cabeça pode ser acionado pelo GitHub Automação acionada por eventos, como quando um novo problema é criado em seu repositório. Por exemplo, a função pública Armazém de códigos de Claude fazer uso de Claude para verificar se há problemas emergentes e atribuir-lhes rótulos apropriados.

b. Use Claude Como um Linter de revisão de código

Claude Code disponível Revisão subjetiva do códigoEle vai além do escopo das ferramentas tradicionais de linting, identificando problemas como erros de ortografia, comentários desatualizados, nomes enganosos de funções ou variáveis e assim por diante.

6) Adoção de múltiplos Claude Fluxo de trabalho para eficiência

Além de usar o ClaudeAlguns dos cenários de aplicativos mais avançados envolvem a execução de vários Claude Exemplo:

a. Seja a Claude Escreva o código, o outro Claude para verificar

Uma maneira simples, mas eficaz, de fazer isso é ter um Claude Uma instância é responsável por escrever o código, enquanto outra instância é responsável por revisá-lo ou testá-lo. Isso é semelhante à colaboração com vários engenheiros e, às vezes, contextos separados são benéficos:

  1. fazer uso de Claude Escreva o código.
  2. estar em movimento /clear Ou inicie uma segunda em outro terminal Claude Exemplo.
  3. fazer a segunda Claude Revisão do primeiro Claude O trabalho.
  4. Iniciar outro Claude(ou novamente) /clear) para ler o código e revisar o feedback.
  5. Que isso Claude Editar o código com base no feedback.

Você pode lidar com testes de maneira semelhante: deixe um Claude Escreva o teste e, em seguida, faça outro Claude Escreva o código para passar nesses testes. Você pode até mesmo fazer isso atribuindo a eles diferentes quadros de rascunho de trabalho e instruindo-os sobre qual deles usar para escrever e qual usar para ler, o Claude Comunicação entre instâncias.

Essa segregação de funções geralmente é mais eficaz do que ter um único Claude O manuseio de tudo produz melhores resultados.

b. Uso de várias cópias de check-out do repositório de código

Anthropic Muitos engenheiros usam essa abordagem para evitar a espera por Claude Conclua cada etapa:

  1. Em pastas diferentesCriar 3-4 git checkout.
  2. Em diferentes guias de terminalAbra cada pasta.
  3. Em cada pastaativar (um plano) ClaudeO governo dos Estados Unidos da América foi incumbido de diferentes tarefas.
  4. Alternar por turnoVerificar o progresso e aprovar/negar solicitações de permissão.

c. Use git worktrees

Essa abordagem é particularmente eficaz para lidar com várias tarefas independentes e é uma alternativa mais leve do que criar várias cópias da base de código completa.Git worktrees Permite que você faça check-out de diferentes ramificações do mesmo repositório em diferentes diretórios. Cada worktree tem seu próprio diretório de trabalho e arquivos separados, mas compartilha o mesmo Git histórico e reflog, o que economiza espaço em disco em relação à replicação completa do repositório.

fazer uso de git worktreesVocê pode executar mais de um deles ao mesmo tempo. Claude sessões que lidam com diferentes partes do projeto separadamente, sendo que cada sessão se concentra em uma tarefa distinta. Por exemplo, você pode ter uma Claude refatoração do sistema de autenticação, enquanto outro Claude Criar um componente de visualização de dados completamente não relacionado. Como as tarefas não se sobrepõem, cada Claude Ambos podem trabalhar em velocidade máxima sem ter que esperar que o outro faça alterações ou lidar com conflitos de mesclagem:

  1. Criação de uma árvore de trabalho::git worktree add ../project-feature-a feature-a
  2. Começa em cada árvore de trabalho Claude::cd ../project-feature-a && claude
  3. conforme necessárioCriar mais árvores de trabalho(Repita as etapas 1 e 2 em uma nova guia do terminal).

Algumas dicas sobre como usá-lo:

  • Use convenções de nomenclatura consistentes.
  • Mantenha uma guia de terminal para cada worktree.
  • Se estiver usando o iTerm2 em um Mac, você pode Configuração de notificações para Claude Receba alertas quando precisar prestar atenção.
  • Use janelas do IDE separadas para diferentes árvores de trabalho.
  • Limpe tudo quando terminar:git worktree remove ../project-feature-a

d. Uso do modo headless em conjunto com scripts personalizados

claude -p(Modo sem cabeça) permite que você defina o Claude Code Integre-se de forma programática a fluxos de trabalho maiores e aproveite as ferramentas incorporadas e os avisos do sistema. Há dois modos principais de usar o modo Headless:

  1. ExpansãoGerenciamento de migrações ou análises em grande escala (por exemplo, análise do sentimento de centenas de registros ou análise de milhares de arquivos CSV):
    1. mandar alguém fazer algo Claude Escreva um script para gerar uma lista de tarefas. Por exemplo, gere uma lista de 2.000 arquivos que precisam ser migrados da Estrutura A para a Estrutura B.
    2. Itere pela lista de tarefas e, para cada tarefa, chame programaticamente a função ClaudeSe o usuário tiver uma tarefa, dê a ele uma tarefa e um conjunto de ferramentas que ele possa usar. Por exemplo:claude -p “将 foo.py 从 React 迁移到 Vue。完成后,如果成功,你必须返回字符串 OK,如果任务失败,则返回 FAIL。” --allowedTools Edit Bash(git commit:*)
    3. Execute o script várias vezes e otimize suas dicas para obter os resultados desejados.
  2. Pipelining: Will Claude Integração aos pipelines de dados/processamento existentes:
    1. invocações claude -p “<你的提示>” --json | your_commandque your_command é sua próxima etapa para lidar com o pipeline.
    2. A saída JSON (opcional) ajuda a fornecer dados estruturados para processamento automatizado subsequente.

Para ambos os casos de uso, use o --verbose Os sinalizadores ajudam na depuração Claude Geralmente, recomenda-se desativar o modo detalhado em ambientes de produção para obter uma saída mais concisa. Geralmente, recomenda-se desativar o modo detalhado em ambientes de produção para obter uma saída mais limpa.

Esperamos que essas dicas o ajudem a ser mais eficiente com suas Claude Code. Continue explorando e experimentando para encontrar a melhor maneira de codificar para você.

Não pode ser reproduzido sem permissão:Chefe do Círculo de Compartilhamento de IA " Como lidar com o Claude Code: um guia prático para aumentar a produtividade da programação de IA
pt_BRPortuguês do Brasil