Introdução geral
Claude Código é o nome dado ao código pelo Antrópica O Claude Code é uma ferramenta de codificação inteligente projetada para ajudar os desenvolvedores a concluir rapidamente as tarefas de programação no terminal usando comandos de linguagem natural. Ele entende o contexto da base de código e suporta a busca de código, a edição de arquivos, a execução de testes e até mesmo o envio direto para o GitHub. Como um produto beta em pré-visualização de pesquisa, o Claude Code oferece aos desenvolvedores uma nova experiência de programação colaborativa, integrando-se profundamente ao modelo Claude da Anthropic. O Claude Code não apenas acelera as tarefas diárias de codificação, mas também otimiza sua funcionalidade por meio da interação com os desenvolvedores, e atualmente tem o código aberto no GitHub, atraindo muita atenção e feedback.
Lista de funções
- Pesquisa e compreensão de códigosLocalize rapidamente arquivos ou funções específicos na base de código por meio de consultas em linguagem natural.
- Edição de documentosModificar arquivos de código diretamente de acordo com as instruções, por exemplo, para adicionar funcionalidade ou corrigir problemas.
- execução de testeSuporte à execução de casos de teste para ajudar os desenvolvedores a verificar as alterações no código.
- Integração com o GitHubConexão com o GitHub: conecte-se perfeitamente ao GitHub para fazer confirmações de código, corrigir bugs ou desenvolver novos recursos.
- Depuração e refatoraçãoAuxílio na identificação de problemas de código e recomendações de refatoração.
- Desenvolvimento orientado a testes (TDD)Suporte ao processo de desenvolvimento orientado por testes com base na geração de código de teste.
- interação de linguagem naturalOperar tarefas de programação complexas com comandos de linguagem simples.
Usando a Ajuda
Processo de instalação
O Claude Code precisa ser instalado e configurado pelo desenvolvedor no ambiente local. Veja a seguir as etapas detalhadas de instalação:
- Preparação do ambiente
- Certifique-se de que o Node.js esteja instalado em seu computador (a versão recomendada é a versão LTS mais recente). Isso pode ser feito com o comando
node -v
Verifique a versão. - Uma conta do GitHub e uma conta do console do Anthropic são necessárias para a chave da API.
- Certifique-se de que o Node.js esteja instalado em seu computador (a versão recomendada é a versão LTS mais recente). Isso pode ser feito com o comando
- Instalação do código Claude
- Abra um terminal e execute o seguinte comando para instalar o Claude Code globalmente:
npm install -g @anthropic-ai/claude-code
- Após a instalação, o Claude Code estará disponível como uma ferramenta de linha de comando.
- Abra um terminal e execute o seguinte comando para instalar o Claude Code globalmente:
- Configuração de chaves de API
- Faça login no console do Anthropic e gere uma chave de API.
- Execute o seguinte comando no terminal para concluir a primeira autenticação OAuth:
claude-code auth
- Siga as instruções para fazer login em sua conta Anthropic e a chave de API será salva automaticamente em seu perfil local após a autorização.
- Verificar a instalação
- Digite o seguinte comando para verificar se a instalação foi bem-sucedida:
claude-code --version
- Se o número da versão for retornado, a instalação estará concluída.
- Digite o seguinte comando para verificar se a instalação foi bem-sucedida:
Como usar
O Claude Code é executado no terminal e interage com os desenvolvedores por meio de comandos de linguagem natural. Veja abaixo um guia detalhado de como usar os principais recursos:
Pesquisa e compreensão de códigos
- procedimento::
- Vá para o diretório do projeto, por exemplo:
cd /path/to/your/project
- Digite comandos de linguagem natural, por exemplo:
claude-code "查找所有处理用户登录的函数"
- O Claude Code examina a base de código e retorna arquivos e trechos de código relevantes.
- Vá para o diretório do projeto, por exemplo:
- advertênciaSejam claros e específicos os pedidos e evitem descrições vagas para aumentar a precisão da pesquisa.
Edição de documentos
- procedimento::
- Especifique o arquivo a ser editado, por exemplo:
claude-code "在 auth.js 中添加一个新函数 verifyToken"
- O Claude Code gera código a partir das instruções e o aplica ao arquivo.
- Verifique o código gerado e visualize as alterações usando o seguinte comando:
claude-code "显示最近的改动"
- Confirme que não há erros e salve.
- Especifique o arquivo a ser editado, por exemplo:
- Funções em destaqueSuporte a modificações em massa, por exemplo:
claude-code "在所有控制器文件中添加日志记录"
teste operacional
- procedimento::
- Certifique-se de que uma estrutura de teste (por exemplo, Jest, Mocha) já esteja no projeto.
- Digite o comando para executar o teste:
claude-code "运行所有单元测试"
- Para visualizar os resultados de um teste, Claude Code retorna detalhes de sucesso ou fracasso.
- Uso avançadoGeração de casos de teste, por exemplo:
claude-code "为 utils.js 中的 parseData 函数生成测试代码"
Integração com o GitHub
- procedimento::
- Certifique-se de que o projeto esteja associado a um repositório do GitHub.
- Use o seguinte comando para enviar o código:
claude-code "提交所有更改到 GitHub,主分支,提交信息为‘修复登录 bug’"
- O código Claude será executado
git add
egit commit
responder cantandogit push
Operação.
- Funções em destaqueCorrigir problemas do GitHub, por exemplo:
claude-code "根据 issue #123 修复代码并提交"
Depuração e refatoração
- procedimento::
- Registre o problema quando você o encontrar:
claude-code "调试 auth.js 中登录失败的原因"
- O Claude Code analisa o código e fornece descrições de problemas e sugestões de correções.
- Ajuste manualmente, conforme recomendado, ou por ordem direta:
claude-code "按照建议修复 auth.js"
- Registre o problema quando você o encontrar:
- exemplo de refatoração::
claude-code "将 index.js 中的重复代码提取为单独的函数"
Exemplo de fluxo de operação
Suponha que você precise adicionar um novo recurso ao seu projeto:
- Vá para o diretório do projeto::
cd /my-project
- Descreva os requisitos::
claude-code "添加一个处理用户注册的 API 端点"
- Verifique o código gerado::
- O Claude Code adicionará o código ao arquivo relevante, por exemplo
routes.js
. - importação
claude-code "显示改动"
Verifique o código.
- teste operacional::
claude-code "为新端点生成测试并运行"
- Enviar para o GitHub::
claude-code "提交更改到 GitHub,分支为 feature/registration"
advertência
- gerenciamento de direitosA primeira execução pode exigir autorização para acessar a base de código e o GitHub.
- Envio de feedbackSe forem encontrados problemas, um pedido poderá ser usado:
claude-code /bug "Descreva o problema"
- privacidade de dadosFeedback do usuário: O feedback do usuário é retido por apenas 30 dias e não é usado para treinar modelos, garantindo a segurança do código.
Seguindo essas etapas, os desenvolvedores podem começar a usar o Claude Code rapidamente e aproveitar seus recursos inteligentes para aumentar a eficiência da programação.