O Claude Code agora oferece suporte para trabalhar em vários diretórios em uma única sessão usando a flag --add-dir e o comando interativo /add-dir. Isso elimina a constante troca de contexto entre projetos.
O Que É Suporte Multi-diretório
Funcionalidade Central
A flag --add-dir /path/to/dir adiciona diretórios à sua sessão do Claude Code sem alterar seu diretório de trabalho. Use /add-dir <path> durante sessões interativas para expandir seu espaço de trabalho dinamicamente.
O Claude Code mantém relacionamentos de arquivos entre diferentes estruturas de diretórios, preservando o desempenho. O sistema lida com a resolução de caminhos automaticamente quando você referencia arquivos de diretórios adicionados.
Principais Casos de Uso
Monorepos
Trabalhe em módulos de frontend, backend e compartilhados sem trocar de sessão. Grandes aplicações com separação lógica se beneficiam do acesso unificado a todos os componentes.
Arquivos de Configuração Compartilhados
Acesse arquivos de configuração, documentação e artefatos de desenvolvimento armazenados em locais separados. Arquivos de produtividade pessoal e documentação da equipe tornam-se consistentemente disponíveis em todas as sessões.
Desenvolvimento Multi-projeto
Gerencie repositórios interconectados simultaneamente. Clientes de API permanecem sincronizados com implementações de servidor. A documentação é atualizada junto com as mudanças no código.
Estratégias de Implementação
Configuração do Espaço de Trabalho
- Identifique seu diretório de trabalho principal
- Adicione diretórios relacionados usando
--add-dir - Crie aliases de shell para configurações comuns
- Estabeleça padrões de diretório para toda a equipe
Otimização de Desempenho
- Adicione apenas os diretórios que você usa ativamente
- Evite diretórios com artefatos de build
- Monitore o uso de tokens de contexto com grandes configurações
- Use caminhos absolutos para acesso confiável
Integração de Desenvolvimento
O suporte multi-diretório funciona com fluxos de trabalho Git existentes, sistemas de CI e pipelines de implantação. Ferramentas de desenvolvimento de API como o Apidog podem monitorar especificações em vários diretórios de projeto.
Exemplos Práticos
Arquitetura de Microsserviços
Acesse implementações de serviço, bibliotecas compartilhadas, modelos de configuração e scripts de implantação em uma única sessão. Referencie padrões existentes enquanto desenvolve novos serviços.
Contribuições de Código Aberto
Trabalhe com repositórios bifurcados, fontes upstream e configurações pessoais simultaneamente. Mantenha contribuições limpas enquanto acessa todas as bases de código relevantes.
Infraestrutura como Código
Gerencie definições de aplicativos, configurações de implantação e configurações de monitoramento em vários repositórios. Mantenha a consistência durante as mudanças de infraestrutura.
Melhores Práticas
Gerenciamento de Configuração
Use caminhos absolutos para evitar problemas de resolução. Verifique as permissões de leitura para todos os diretórios. Crie configurações padronizadas para consistência da equipe.
Considerações de Segurança
Revise o conteúdo do diretório antes de adicioná-los. Exclua informações confidenciais e credenciais de produção. Use diretórios de desenvolvimento dedicados.
Monitoramento de Desempenho
Observe o uso da memória com estruturas de diretório extensas. Diretórios locais oferecem melhor desempenho do que os montados em rede. Remova diretórios não utilizados das sessões.
Recursos Avançados
Integração de Linha de Comando
claude-code --add-dir /path/to/backend --add-dir /path/to/frontend
Comandos Interativos
/add-dir /path/to/shared-config
/add-dir /path/to/documentation
Fluxos de Trabalho da Equipe
Padronize configurações multi-diretório entre as equipes. Documente padrões comuns para uma experiência de desenvolvedor consistente. Integre com processos de onboarding.
Fluxo de Trabalho de Desenvolvimento de API
O suporte multi-diretório aprimora o desenvolvimento API-first. Serviços de backend, documentação, SDKs de cliente e conjuntos de testes frequentemente existem em repositórios separados, mas exigem atualizações sincronizadas.
O Apidog fornece interfaces de teste unificadas que funcionam em seu espaço de trabalho multi-diretório. Isso garante a consistência da API à medida que você desenvolve recursos que abrangem vários projetos.
Solução de Problemas Comuns
Problemas de Resolução de Caminho
- Use caminhos absolutos em vez de relativos
- Verifique se os links simbólicos funcionam corretamente
- Verifique as permissões do diretório
Problemas de Desempenho
- Limite os diretórios adicionados aos necessários
- Monitore os recursos do sistema
- Remova diretórios não utilizados durante sessões longas
Controle de Acesso
- Garanta permissões de leitura adequadas
- Evite adicionar diretórios com dados confidenciais
- Use estruturas de diretório específicas para desenvolvimento
Melhorias Futuras
A comunidade solicita arquivos de configuração para configurações de espaço de trabalho persistentes. Isso permitiria a padronização em toda a equipe e reduziria tarefas de configuração repetitivas.
As oportunidades de integração com plataformas de desenvolvimento continuam se expandindo. Ferramentas de desenvolvimento de API, sistemas de gerenciamento de projetos e plataformas de colaboração podem aproveitar os recursos aprimorados do espaço de trabalho.
Conclusão
O suporte multi-diretório do Claude Code elimina o atrito do fluxo de trabalho no desenvolvimento moderno. Monorepos, microsserviços e colaboração multi-projeto tornam-se contínuos, sem a sobrecarga de troca de contexto.
Comece com configurações simples de dois diretórios e expanda com base nas necessidades do projeto. A curva de aprendizado mínima oferece melhorias significativas de produtividade à medida que a complexidade do projeto cresce.
Combinado com ferramentas abrangentes de teste de API como o Apidog, o suporte multi-diretório cria experiências de desenvolvimento ponta a ponta simplificadas. Experimente configurações que correspondam aos requisitos específicos do seu projeto para obter o máximo benefício.