Como compartilhar contexto no Claude com o time sem repetir a mesma explicação?

Toda vez que alguém do time abre um chat novo e começa explicando de novo como a empresa funciona, o time paga um imposto invisível

Aquele bloco de "a gente usa esse padrão, o cliente é aquele, o build roda assim" é sempre o mesmo texto, reescrito por pessoas diferentes, em versões levemente diferentes

E aí vem o efeito colateral: contexto que mora na cabeça de cada um gera resposta diferente pra cada pessoa

A boa notícia é que o Claude tem lugares próprios pra guardar material de referência compartilhado: projetos com base de conhecimento persistente, skills provisionadas pela organização e arquivos CLAUDE.md no Claude Code

A decisão difícil nem é técnica, é editorial: o que fica no espaço comum e o que continua na conta de cada pessoa?

Bora ver na prática 🙂

O que você precisa antes de compartilhar contexto com o time

Compartilhar um projeto com outras pessoas e provisionar skills pra organização inteira são recursos dos planos Team e Enterprise

O plano Team exige no mínimo 2 membros e custa US$ 20 por assento/mês na cobrança anual ou US$ 25 por assento/mês na cobrança mensal

Se a conta de fechar assentos ainda estiver em aberto no seu time, dá pra ver quanto custa por dev por mês antes de sair migrando todo mundo

A lista do que precisa estar de pé:

• plano Team ou Enterprise pra compartilhar projeto e provisionar skills
• papel de owner, porque adicionar e remover skills da organização é restrito a owners
• em Organization settings > Skills, "Code execution and file creation" e "Skills" ligados
• Cowork e Skills habilitados, se a ideia também for usar marketplace de plugins

Tome cuidado com um detalhe que pega muita gente: ao assinar o Team é criada uma organização NOVA, e sua conta individual (Free, Pro ou Max) continua separada

A troca entre as duas é pelo nome ou iniciais no canto inferior esquerdo, então não estranhe se seus chats antigos "sumirem": eles estão na outra conta

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

Como criar um projeto compartilhado no Claude passo a passo

Antes do como, o porquê

Um projeto no Claude é um espaço que junta instruções próprias e uma base de conhecimento reutilizável, e todos os chats criados dentro dele usam esse material

Se você conhece a ideia de um README que todo mundo lê antes de mexer no repositório, é bem parecido: escreve uma vez, vale pra todo chat do espaço

1. Crie o projeto e escreva as instruções

As instruções são o "como a gente trabalha aqui", e a base de conhecimento é o material que sustenta isso

Erro comum deste passo: tratar o campo de instruções como um prompt de tarefa única. Ele é regra permanente do espaço, não pedido do dia

2. Escolha a visibilidade inicial

Em Team e Enterprise, na criação do projeto existem duas opções: Public (todo mundo da organização pode ver e usar) ou Private (só membros convidados)

Erro comum deste passo: confundir projeto público com conversa pública. Mesmo em projeto público, as conversas de cada pessoa dentro dele continuam privadas pro resto da organização, a não ser que sejam compartilhadas manualmente

3. Suba o material na seção Files do projeto

Arquivo enviado pra seção de arquivos do projeto vira referência persistente entre conversas, em vez de ficar preso a um chat só

É exatamente aqui que entra a documentação que o time mais reexplica

Erro comum deste passo: anexar o PDF no chat, resolver o problema do dia e no dia seguinte a pessoa do lado anexar o mesmo PDF de novo

4. Respeite os formatos e os limites

Os tipos de documento suportados são PDF, DOCX, CSV, TXT, HTML, ODT, RTF, EPUB, JSON e XLSX (o XLSX exige code execution e file creation habilitados)

Em imagem, dá pra subir JPEG, PNG, GIF e WebP

Erro comum deste passo: jogar o manual gigante no projeto e achar que travou tudo. Não travou, ele simplesmente não sobe

5. Defina a permissão de cada pessoa

O compartilhamento tem dois níveis: Can view (ver conteúdo, conhecimento e instruções e conversar, sem editar) e Can edit (alterar instruções e conhecimento, além de adicionar e remover membros)

Erro comum deste passo: dar "Can edit" pra todo mundo. Aí a base comum vira terra de ninguém e ninguém sabe mais qual versão da instrução está valendo

"E o RAG, preciso configurar?"

Não

Quando o conhecimento do projeto se aproxima do limite da janela de contexto, o Claude ativa o modo RAG automaticamente, sem configuração, e isso permite até 10x mais conteúdo armazenado no projeto

E aqui vale separar duas coisas que se misturam fácil: o que exige Team ou Enterprise é o COMPARTILHAMENTO do projeto, ou seja, a visibilidade Public/Private e as permissões Can view e Can edit

O RAG não segue essa régua: RAG para projetos está disponível em todos os planos, de Free a Enterprise, valendo também pro projeto individual de quem está no Free, no Pro ou no Max

Como distribuir skills e plugins para toda a organização

Projeto resolve o material de referência

Skill resolve outra coisa: um jeito de trabalhar que você quer que apareça pronto pra todo mundo, sem cada pessoa ter que subir o mesmo arquivo na própria conta

O gerenciamento de skills pra organização inteira está nos planos Team e Enterprise

1. Ligue os pré-requisitos

Em Organization settings > Skills, habilite "Code execution and file creation" e "Skills"

Erro comum deste passo: tentar adicionar a skill antes de ligar essas duas chaves

2. Envie a skill em + Add

Ainda em Organization settings > Skills, clique em "+ Add" e envie um arquivo .zip que contenha um SKILL.md

minha-skill.zip
└── SKILL.md

A skill é provisionada imediatamente pra todos os usuários da organização

Erro comum deste passo: tentar pela conta errada. Adição e remoção de skills da organização são restritas a owners, então owner é papel, não é força de vontade haha

3. Avise o time onde elas aparecem

As skills enviadas pela organização ficam disponíveis em Customize > Skills pra todos, e dispensam upload individual

Elas vêm ligadas por padrão, e cada membro pode desligar individualmente a que não usa

Erro comum deste passo: assumir que "provisionado" é igual a "em uso". Alguém pode ter desligado do lado dele

4. Para plugins, use o caminho próprio

Owners e Primary Owners de Team e Enterprise gerenciam plugins em Organization settings > Plugins

Dá pra adicionar por upload manual de arquivos ZIP pela interface de admin ou por sincronização com um repositório privado do GitHub

Pra usar marketplaces de plugins na organização, Cowork e Skills precisam estar habilitados

Erro comum deste passo: procurar plugin dentro da tela de Skills. São caminhos diferentes

Como padronizar o contexto do time no Claude Code com CLAUDE.md

Quem programa tem um canal ainda mais direto

No Claude Code, arquivos CLAUDE.md dão instruções persistentes e são lidos no início de cada sessão

A orientação oficial sobre o conteúdo é honestamente a melhor régua que existe: escreva ali o que você teria que reexplicar toda vez

Comandos de build, convenções, layout do projeto e regras do tipo "sempre faça X"

1. Crie o CLAUDE.md do repositório

No diretório de trabalho, vale CLAUDE.md ou .claude/CLAUDE.md

meu-projeto/
├── CLAUDE.md
└── .claude/
    └── CLAUDE.md

Esse é o contexto do repositório, o que serve pra qualquer pessoa que abrir aquele código

Erro comum deste passo: escrever ali preferência pessoal de estilo de resposta. Isso não é do repositório, é sua

2. Deixe o que é seu no arquivo de usuário

O ~/.claude/CLAUDE.md guarda instruções globais que valem em todos os seus projetos

Erro comum deste passo: colocar no arquivo pessoal uma convenção que o time inteiro precisa seguir. Aí só você segue, e o commit do colega vem diferente

3. Para a organização, distribua um CLAUDE.md em nível de sistema

Organizações podem colocar um CLAUDE.md em nível de sistema na máquina, e os caminhos são estes:

/Library/Application Support/ClaudeCode/CLAUDE.md   # macOS
/etc/claude-code/CLAUDE.md                          # Linux e WSL
C:\Program Files\ClaudeCode\CLAUDE.md               # Windows

Esse arquivo de managed policy não pode ser excluído pelo usuário, então a instrução da organização sempre vale

(o claudeMdExcludes só afeta memória de usuário, projeto e local)

Erro comum deste passo: achar que alguém consegue "desligar" isso localmente. A precedência de configurações no Claude Code coloca o nível managed acima de user, project, local e até de argumentos de linha de comando, salvo as exceções documentadas

4. Saiba que existe um segundo sistema de memória

O Claude Code tem dois sistemas complementares, ambos carregados no início da conversa: o CLAUDE.md, escrito por você, e a auto memory, com notas que o próprio Claude salva

A auto memory vem ligada por padrão e é alternada pelo comando /memory dentro da sessão, gravando autoMemoryEnabled em ~/.claude/settings.json

Erro comum deste passo: contar com a auto memory pra padronizar o time. Ela é da máquina de quem está rodando, não é combinado coletivo

O que deixar compartilhado e o que continua na conta de cada pessoa

Aqui está a parte que ninguém te conta, e que decide se isso vira organização ou bagunça

O que vai pro espaço comum é o material ESTÁVEL: aquilo que muda pouco e vale pra qualquer pessoa que pegar a tarefa

Sobre memória, vale um aviso: planos Team não têm controles de memória em nível de organização, o controle é individual de cada usuário

Ou seja, memória não é ferramenta de padronização de time, é conforto de cada pessoa

E tem um tipo de conversa que é bom mesmo que continue individual: quando alguém está aprendendo e prefere pedir explicação em vez de resposta pronta, aquilo é sessão de estudo, não é documentação da empresa

Se o time usa o Claude Cowork, a lógica se repete: projetos lá agrupam tarefas em espaços separados, com arquivos, links, instruções e memória próprios do espaço

Pra quem precisa de controle mais duro, o Claude for Enterprise adiciona SSO e domain capture, permissões baseadas em papéis, acesso à Compliance API e managed policy settings

E lembra da migração da conta pessoal pra organização? Ela move chats, projects, arquivos e memória pro workspace da organização

Decida isso com calma antes, porque é sobre onde seu material vai morar daqui pra frente

Vídeo do canal pra começar do zero com IA que programa

Se você ainda está montando o repertório de ferramentas antes de organizar o contexto do time, este vídeo do canal mostra uma IA de programar gratuita, sem login e com 1 milhão de contexto, o MiMo Code

Conclusão

A ideia central é bem simples: contexto escrito uma vez e reutilizado por todo mundo vale MUITO mais que contexto reexplicado por cada pessoa, todo dia

Projeto compartilhado resolve o material de referência, skills e plugins da organização resolvem o jeito de trabalhar, e o CLAUDE.md resolve o repositório

O próximo passo que eu sugiro é o menor possível: crie UM projeto compartilhado e coloque nele só o material que o time mais reexplica

E se você usa o Claude Code, escreva o CLAUDE.md do repositório antes de partir pra skills e políticas da organização, porque é ali que o ganho aparece na primeira sessão

Depois é só ir subindo o nível, conforme a bagunça for aparecendo 😀

até o próximo post!