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 Code
Como 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 exemplo
pyenv
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 eleCLAUDE.md
e enviá-lo paragit
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 arquivoCLAUDE.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 oroot/foo
e executeclaude
Isso pode ser feito noroot
responder cantandoroot/foo
são colocados no diretórioCLAUDE.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 suasclaude
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.md
O Claude 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.
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 adicionarEdit
Permitir que o arquivo seja editado em todos os momentos, adicionarBash(git commit:*)
executávelgit commit
ou adicionarmcp__puppeteer__puppeteer_navigate
uso permitidoPuppeteer
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 GitHub
Instalaçã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 gh
Assim 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:
- informe
Claude
Nome da ferramenta e exemplos de seu uso. - mandar alguém fazer algo
Claude
estar em movimento--help
Veja a documentação da ferramenta. - 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 oPuppeteer
responder cantandoSentry
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 git
para uso pelo restante da equipe.
Os comandos de barra personalizados podem conter palavras-chave especiais $ARGUMENTS
que é 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:
- 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.
- Nessa etapa, especialmente para problemas complexos, considere a possibilidade de ter o
- 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á oClaude
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 paraClaude
Use.- Se os resultados dessa etapa parecerem razoáveis, você pode deixar o
Claude
Escreva o plano em um documento ou crieGitHub
para que, se a implementação subsequente (etapa 3) não atender às expectativas, você possa voltar a esse estado.
- Se os resultados dessa etapa parecerem razoáveis, você pode deixar o
- 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. - mandar alguém fazer algo
Claude
Envie os resultados e crie uma solicitação pull.. Se for relevante, também é possível fazerClaude
atualizaçãoREADME
talvezchangelog
explicando 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:
- 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. - 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. - Quando você estiver satisfeito com o teste.mandar alguém fazer algo
Claude
Enviar código de teste. - mandar alguém fazer algo
Claude
Escrever código que passe nos testese instrua-o a não modificar o teste em si. DigaClaude
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.
- 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:
- 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 emClaude
). - 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. - 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. - 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.
d. Modo YOLO de segurança
Se você não quiser supervisionar todo o processo Claude
Você 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 documentoasync move { ... }
O que ele faz?CustomerOnboardingFlowImpl
Quais situações de fronteira foram abordadas?- Por que a chamada para
foo()
em vez debar()
? baz.py
O código na linha 334 do arquivo está na seçãoJava
Qual é a contrapartida em
existir Anthropic
O 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.
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 clarasClaude
consultegit
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 abertosGitHub
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.
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 à pastaClaude Code
uso finalCtrl+V
Colar. Observe que aqui está oCtrl+V
Em vez do habitualCmd+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.
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.
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 sobreEscape
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:
- 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. - 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 exemplocat 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 Claude
Alguns 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:
- fazer uso de
Claude
Escreva o código. - estar em movimento
/clear
Ou inicie uma segunda em outro terminalClaude
Exemplo. - fazer a segunda
Claude
Revisão do primeiroClaude
O trabalho. - Iniciar outro
Claude
(ou novamente)/clear
) para ler o código e revisar o feedback. - 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:
- Em pastas diferentesCriar 3-4
git
checkout. - Em diferentes guias de terminalAbra cada pasta.
- Em cada pastaativar (um plano)
Claude
O governo dos Estados Unidos da América foi incumbido de diferentes tarefas. - 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 worktrees
Você 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:
- Criação de uma árvore de trabalho::
git worktree add ../project-feature-a feature-a
- Começa em cada árvore de trabalho
Claude
::cd ../project-feature-a && claude
- 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:
- 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):
- 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. - Itere pela lista de tarefas e, para cada tarefa, chame programaticamente a função
Claude
Se 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:*)
- Execute o script várias vezes e otimize suas dicas para obter os resultados desejados.
- mandar alguém fazer algo
- Pipelining: Will
Claude
Integração aos pipelines de dados/processamento existentes:- invocações
claude -p “<你的提示>” --json | your_command
queyour_command
é sua próxima etapa para lidar com o pipeline. - A saída JSON (opcional) ajuda a fornecer dados estruturados para processamento automatizado subsequente.
- invocações
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ê.