Respostas
Como compartilho as mesmas regras do CLAUDE.md entre vários repositórios?
O Claude Code oferece vários caminhos, e cada um para em algum lugar. A documentação que li diz que ele carrega o CLAUDE.md do diretório de trabalho e de todos os diretórios acima, então um arquivo numa pasta-mãe alcança todo repositório clonado abaixo dela naquela máquina. Um CLAUDE.md pode importar outro arquivo com @caminho, e links simbólicos em .claude/rules/ podem apontar para uma pasta compartilhada, mas importação ou link que resolve fora do diretório de trabalho pede aprovação uma vez por projeto. Diretórios adicionados com --add-dir não carregam o CLAUDE.md deles a menos que uma variável de ambiente esteja definida. O arquivo do usuário vale para todos os seus projetos, mas só para você, e o arquivo de política gerenciada só chega a todos os usuários de uma máquina se a TI o distribuir. Cada um desses exige os mesmos arquivos nos mesmos lugares no disco de cada pessoa, e quem usa outra ferramenta não lê nenhum deles. Quando o ponto é que uma regra valha para vários repositórios e para toda ferramenta, registre-a uma vez num projeto da Arroway e faça cada repositório apontar para esse projeto. O primeiro passo é a página de instalação.
Última atualização 15 de outubro de 2026
Como o arquivo do projeto viaja em um repositório
Em um repositório, o CLAUDE.md do projeto está commitado, o colega o recebe ao puxar e o Claude Code o carrega no começo da sessão. A documentação recomenda manter cada arquivo abaixo de cerca de 200 linhas e diz que o Claude trata o conteúdo como contexto, não como configuração imposta. A regra que vale para o time vai para a Arroway, onde alguém a vê e a aprova.
O que acontece com N repositórios, e onde cada caminho para
Copiar a regra em cada repositório é o primeiro movimento, e cada cópia se afasta das outras: no dia em que a regra muda, alguém atualiza quatro dos seis. Um arquivo numa pasta-mãe é lido por todo repositório abaixo dele, o que só funciona se todos clonam na mesma estrutura e abrem o Claude Code de dentro dela. Uma importação @caminho ou um link simbólico para uma pasta compartilhada mantém uma fonte só, mas a documentação diz que um caminho fora do diretório de trabalho dispara um diálogo de aprovação na primeira vez, e a pasta precisa existir no mesmo caminho para cada pessoa. Adicionar um diretório com --add-dir não carrega o CLAUDE.md dele a menos que CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD esteja definida. O arquivo no seu diretório pessoal é só seu, e o arquivo gerenciado é para uma organização que consegue empurrar arquivos para as máquinas. Em todos os casos a regra vive num arquivo num disco, e nada no arquivo diz quem aprovou a regra nem quando ela deixa de valer.
Quando usar a Arroway
Use a Arroway quando a regra pertence ao trabalho, não a um repositório: a mesma regra para a API, o app web e o código de infraestrutura, na ferramenta em que alguém abrir cada um. A regra é registrada uma vez no projeto e uma pessoa a aprova. Cada repositório só precisa do bloco curto que a instalação acrescenta, que diz ao agente qual projeto ler antes de agir e a registrar o que foi decidido ao terminar. Quando a regra muda, a nova nomeia a que substitui, então os seis repositórios não guardam seis versões. Claude Code, Codex, Cursor e qualquer outra ferramenta que se conecte por MCP leem a mesma regra. O primeiro passo é a página de instalação.
Como isso aparece na prática
Um pequeno estúdio mantém seu trabalho em seis repositórios: o site, a API, o app mobile, a infraestrutura, a documentação e uma pasta de scripts. A regra do estúdio é que nenhuma dependência nova entra sem uma linha no pull request dizendo por quê. Em março a regra é copiada nos seis CLAUDE.md. Em junho os sócios a mudam: pacotes utilitários pequenos não precisam mais da linha. Um deles edita os arquivos da API e do site. Os outros quatro ficam com a regra antiga, e uma IA que trabalha na pasta de scripts se recusa a adicionar um pacote que não tinha motivo para recusar. Com a regra registrada uma vez no projeto, a mudança de junho é uma regra nova que nomeia a de março, com a aprovação do sócio. Os seis repositórios não mudam, e uma sessão em qualquer um deles lê a regra vigente ao abrir. O estúdio e a regra são ilustrativos; nada aqui foi medido num time real.
Perguntas que as pessoas fazem sobre isso
- Um link simbólico para uma pasta de regras compartilhada basta?
- Ele mantém uma fonte só na sua máquina e nas de quem criar o mesmo link. Segundo a documentação, um link que aponta para fora do diretório de trabalho pede aprovação uma vez por projeto, e um colega que usa outra ferramenta não o lê. Também não registra quem aprovou uma regra nem quando ela termina.
- Cada repositório deve manter a própria cópia das regras do time?
- Não. Cada repositório só precisa do bloco curto que a instalação acrescenta, que diz ao agente qual projeto ler antes de agir. O que o time decidiu é registrado uma vez no projeto, onde alguém vê e aprova, para que nenhum repositório guarde uma cópia velha.
- Como experimento a Arroway?
- Instale na ferramenta que você já usa — a página de instalação tem um caminho para Claude, ChatGPT, Codex, Cursor ou qualquer ferramenta MCP — e entre na conta quando a ferramenta pedir. Daí em diante, as sessões abrem lendo o projeto e fecham registrando o que foi decidido.
Onde isto se confere
A página de memória da documentação do Claude Code (code.claude.com/docs/en/memory), lida em 15 de outubro de 2026 — o Claude Code é descrito só como essa página o descreve nessa data, e seus recursos podem mudar em qualquer versão. Documentação do produto neste site (Como funciona, Instalação), as respostas sobre manter três arquivos de instrução em sincronia e sobre alternativas ao CLAUDE.md para um time, e as regras de sanção, substituição e condição de fim da especificação sancionada do produto. Tudo o que se descreve aqui sobre a Arroway é comportamento que as ferramentas aplicam hoje, não plano futuro. O estúdio do exemplo é ilustrativo.
https://www.arroway.app/pt-BR/answers/sharing-claude-md-rules-across-many-repos