O Claude-Code-Multi-Agent é um projeto de código aberto hospedado no GitHub que visa otimizar o processo de desenvolvimento de software por meio da orquestração de vários agentes de IA. Ele é baseado em Antrópica (usado em uma expressão nominal) Claude Ferramenta de código que usa a colaboração de vários agentes para ajudar os desenvolvedores a concluir com eficiência tarefas como criação, depuração e teste de código. O projeto reduz as operações manuais e melhora a eficiência do desenvolvimento automatizando a atribuição de tarefas e o processamento paralelo. Os usuários podem usar a ferramenta no terminal ou no ambiente de desenvolvimento integrado, adequado para equipes de desenvolvimento que precisam iterar rapidamente ou lidar com projetos complexos. O projeto enfatiza o design modular, oferece suporte a várias pilhas de tecnologia e simplifica o gerenciamento do fluxo de trabalho por meio da integração com o GitHub.
Lista de funções
- Coordenar vários agentes de IA para processar tarefas de desenvolvimento em paralelo.
- Automatize os processos de gravação, teste e depuração de código.
- Suporte a várias pilhas de tecnologia, como Python, JavaScript, TypeScript e muito mais.
- Integração com o GitHub para automatizar o rastreamento de problemas, solicitações pull e confirmações de código.
- Fornecer um mecanismo de atribuição de tarefas para garantir uma colaboração sem conflitos entre os agentes.
- Suporte à configuração personalizada do agente para se adaptar a diferentes requisitos do projeto.
- Monitore o comportamento do agente em tempo real, fornecendo registros de operação e atualizações de status.
Usando a Ajuda
O Claude-Code-Multi-Agent requer a instalação do pacote Código Claude CLI e configurar o ambiente do projeto. Abaixo estão as etapas detalhadas de instalação e uso para ajudar os usuários a começar rapidamente.
Processo de instalação
- Instalação da CLI do Claude Code
Certifique-se de que a CLI do Claude Code esteja instalada. Os comandos de instalação podem ser obtidos na documentação oficial do Anthropic. Normalmente, os comandos a seguir são executados em um terminal:curl -fsSL https://raw.githubusercontent.com/anthropics/claude-code/main/install.sh | bash
Isso instalará a CLI do Claude Code no
~/.local/bin
diretório. Certifique-se de que o caminho esteja em sua variável de ambientePATH
Médio. - Clonagem do depósito do projeto
Clone o repositório Claude-Code-Multi-Agent localmente usando o Git:git clone https://github.com/Prorise-cool/Claude-Code-Multi-Agent.git cd Claude-Code-Multi-Agent
- Instalação de dependências
O projeto pode exigir dependências adicionais, comotmux
(para gerenciar sessões de vários agentes). Instale usando o Homebrew no macOS:brew install tmux
Para Linux ou Windows (via WSL), use o gerenciador de pacotes para instalar:
sudo apt-get install tmux # Debian/Ubuntu sudo yum install tmux # CentOS/RHEL
- Configuração do ambiente do projeto
O diretório raiz do projeto contém.claude
para armazenar as configurações e os comandos do agente. Certifique-se de que a pasta.claude/agents/
responder cantando.claude/commands/
existe. Se for necessário um agente personalizado, copie o arquivo de modelo para o diretório.claude/agents/
::cp agents/example-agent.md .claude/agents/
compilador
.claude/agents/
Arquivo markdown que define as funções e tarefas do agente. - Lançamento de um sistema multiagente
Inicie o sistema multiagente executando o seguinte comando no diretório raiz do projeto:claude-code run multi-agent
Isso inicia vários agentes do Claude Code, atribui tarefas automaticamente e inicia a colaboração.
Funções principais
- Atribuição e coordenação
O sistema funciona da seguinte forma.claude/commands/
O arquivo de comando (por exemplostart.md
) Definir a lógica de atribuição de tarefas. Os usuários podem executar:claude-code run start
Esse comando inicia um loop multiagente que atribui automaticamente tarefas ao agente apropriado. Por exemplo.
backend-architect
Responsável por projetar a API.code-reviewer
Verificação da qualidade do código. Não há necessidade de intervenção manual por parte do usuário, o sistema seleciona o agente com base no contexto da tarefa. - Redação e teste de código
Os agentes podem gerar código e executar testes automaticamente. Os usuários inserem tarefas por meio de linguagem natural:claude-code "Create a REST API for user management"
O sistema chamará o
backend-architect
Projetando a estrutura da API.spec-developer
Implementação do código.spec-tester
Gerar casos de teste. Os resultados dos testes são salvos automaticamente na pastaexample_output/
Catálogo. - Integração com o GitHub
O projeto é compatível com a CLI do GitHub (gh
) para interagir com o GitHub. Certifique-se de instalar ogh
e concluir a autenticação:gh auth login
Os agentes podem criar perguntas e enviar solicitações pull automaticamente. Exemplo:
claude-code "Analyze GitHub issue #123 and propose a fix"
O sistema chamará o
gh issue view 123
Obtenha os detalhes do problema, gere o código de correção e envie a solicitação pull. - monitoramento em tempo real
O sistema funciona da seguinte formatmux
Crie uma sessão separada para monitorar o status de cada agente. Execute o seguinte comando para visualizar os logs do agente:tmux attach -t claude_agents
Os arquivos de registro são armazenados no
logs/
que registra todas as operações do agente.
Operação da função em destaque
- Processamento paralelo de vários agentes
O sistema suporta a execução de vários agentes ao mesmo tempo (20 por padrão, que podem ser definidos por meio da opção--agents
(Ajuste de parâmetros). Inicie a tarefa paralela:claude-code --path /project --agents 5
Cada agente no sistema independente
tmux
são executados na sessão para evitar conflitos. O proxy é passado pelo/coordination/
no catálogoactive_work_registry.json
Tarefas de coordenação. - Configuração de proxy personalizado
Os usuários podem criar agentes específicos de domínio. Por exemplo, a criação de um agentesecurity-auditor
Agente:cat > .claude/agents/security-auditor.md <<'EOF' --- name: security-auditor description: Scan code for vulnerabilities and ensure compliance. tools: grep, mcp-gemini --- You are a security expert. Scan code for vulnerabilities and report issues. EOF
O agente é chamado explicitamente ao executar a tarefa:
claude-code "Have security-auditor scan my code"
- Controle de qualidade automatizado
O sistema tem um mecanismo integrado de verificação de qualidade em que o agente executa testes e lint antes de o código ser confirmado. Por exemplo:claude-code "Run code-reviewer on my latest commits"
Os resultados geram um relatório detalhado que é salvo no
outputs/
Catálogo.
cenário do aplicativo
- Prototipagem rápida
Os desenvolvedores precisam criar rapidamente um protótipo de aplicativo da Web, incluindo a interface de front-end e a API de back-end, e o Claude-Code-Multi-Agent pode atribuir tarefas aofrontend-developer
responder cantandobackend-architect
O código é gerado em paralelo para reduzir o ciclo de desenvolvimento. - Colaboração em projetos complexos
Em grandes projetos, vários membros da equipe precisam trabalhar em diferentes módulos ao mesmo tempo. O sistema coordena por proxy para garantir que cada módulo seja desenvolvido de acordo com os padrões do projeto e, ao mesmo tempo, gera automaticamente documentação e testes. - Revisão e otimização de código
A equipe de desenvolvimento queria melhorar a qualidade do código.code-reviewer
responder cantandosecurity-auditor
Os agentes podem analisar automaticamente o código enviado, identificar possíveis problemas e sugerir melhorias. - Aprendizado e experimentação
Estudantes ou iniciantes podem usar a ferramenta para aprender programação. O agente pode gerar códigos de instrução, explicar lógicas complexas e fornecer instruções passo a passo.
QA
- Como faço para garantir que os proxies não entrem em conflito?
uso do sistema/coordination/
O mecanismo de travamento no catálogo (por exemploagent_locks/
), garantindo que cada agente lide com tarefas independentes e evitando a concorrência por recursos. - Quais linguagens de programação são compatíveis?
Há suporte para várias pilhas de tecnologia, incluindo Python, JavaScript, TypeScript, Go, Java e muito mais. Os usuários podem encontrar mais informações no site.claude/agents/
para adicionar proxies específicos do idioma ao - Precisa de uma chave de API do Anthropic?
Sim, o Claude Code requer uma chave de API do Anthropic. Os usuários precisam configurar a chave no terminal ou obtê-la por meio do console do Anthropic. - Como posso monitorar o desempenho do agente?
fazer uso detmux
Assista a uma sessão ao vivo ou verifiquelogs/
arquivos de registro no diretório. O sistema também suporta o fornecimento de atualizações em tempo real via WebSocket (é necessária configuração adicional).