Nível 2 — Ferramenta de trabalho · Módulo 2.3 — CLAUDE.md que o Claude realmente segue
2.3.3 · Imports para organizar
3 min de vídeoTODOS
Objetivo: ao final, o consultor divide um CLAUDE.md grande em arquivos menores com @caminho/arquivo.md, e explica por que isso não reduz o contexto consumido.
O que você precisa levar desta aula
A sintaxe @caminho/arquivo.md, dentro do CLAUDE.md, divide um arquivo grande em partes menores, cada uma com um assunto.
Os imports são expandidos inline no carregamento da sessão — o conteúdo entra no contexto do mesmo jeito que estaria colado ali, sem redução alguma.
Import não é carregamento sob demanda. Quem carrega sob demanda é a regra com paths: (aula 2.3.6, por tipo de arquivo) e a skill (módulo 2.4, por assunto da tarefa). Todo import carrega em toda sessão, seja qual for a conversa.
Import vs skill
Import (@arquivo.md no CLAUDE.md)
Skill
Quando carrega
Sempre, em toda sessão, no momento em que o CLAUDE.md é lido
Sob demanda, só quando o assunto da conversa aciona a skill
O que resolve
Organização do arquivo para leitura humana
Economia de contexto — conteúdo que só entra quando é necessário
Efeito no contexto consumido
Nenhum — o conteúdo importado ocupa o mesmo espaço que ocuparia colado
Reduz — o que não é acionado, não entra
Se o objetivo é economizar contexto, dividir um CLAUDE.md grande em imports não resolve sozinho — o total carregado continua o mesmo.
O que resolve, então? Dois caminhos, e cada um tem a sua aula:
Se a instrução está ligada a um tipo de arquivo (convenção de ABAP, formato de spec), ela vira uma regra em .claude/rules/ com paths: no frontmatter — carrega só quando o Claude abre um arquivo que casa. É a aula 2.3.6, no fim deste módulo.
Se a instrução é um procedimento ligado a um tipo de tarefa, ela vira uma skill — carrega quando o assunto da conversa pede. É o módulo 2.4.
Guarde a distinção assim: import organiza, rule com paths: e skill economizam.
1.Você divide um CLAUDE.md de 150 linhas em três arquivos de 50 linhas cada, ligados por @arquivo.md no arquivo principal. O que acontece com o contexto consumido em cada sessão?
a)Continua o mesmo — os três arquivos entram no contexto como se estivessem colados no arquivo principal
Correto.
b)Reduz para um terço, já que só uma parte é carregada por vez
Todo import expande inline no carregamento — o total consumido continua o mesmo.
c)Reduz, mas só depois que a sessão já está em andamento há algum tempo
Não há esse tipo de redução progressiva — o carregamento é integral, desde o início da sessão.
Ver resposta e por quê
✅a) Correto.
❌b) Todo import expande inline no carregamento — o total consumido continua o mesmo.
❌c) Não há esse tipo de redução progressiva — o carregamento é integral, desde o início da sessão.
2.Um consultor divide o CLAUDE.md em imports achando que só o arquivo relevante ao assunto da conversa será lido. Qual é o erro nessa expectativa?
a)Nenhum — é exatamente assim que imports funcionam
Import não seleciona por assunto; carrega tudo, sempre.
b)O erro é técnico: a sintaxe @arquivo.md só funciona dentro de uma skill, não num CLAUDE.md
A sintaxe funciona normalmente num CLAUDE.md; o erro é sobre quando o conteúdo carrega, não sobre onde a sintaxe é válida.
c)Ele está confundindo import com skill — skill carrega sob demanda, import carrega sempre, em toda sessão
Correto. É o erro comum descrito na aula.
Ver resposta e por quê
❌a) Import não seleciona por assunto; carrega tudo, sempre.
❌b) A sintaxe funciona normalmente num CLAUDE.md; o erro é sobre quando o conteúdo carrega, não sobre onde a sintaxe é válida.
✅c) Correto. É o erro comum descrito na aula.
3.Qual é o principal ganho real de dividir um CLAUDE.md grande em arquivos menores com import? ---
a)Organização do arquivo para quem mantém — cada assunto no seu próprio arquivo, mais fácil de navegar e editar
Correto.
b)Redução do contexto consumido pela sessão
Não há redução — é justamente o ponto central desta aula.
c)Carregamento mais rápido da sessão, por serem arquivos menores
Não há esse ganho de velocidade — o total lido no carregamento é o mesmo, dividido ou não.
Ver resposta e por quê
✅a) Correto.
❌b) Não há redução — é justamente o ponto central desta aula.
❌c) Não há esse ganho de velocidade — o total lido no carregamento é o mesmo, dividido ou não.