Como o Claude Code "enxerga" suas pastas (e por que isso importa)
Você abriu o Claude Code, fez sua primeira sessão e conversou com ele no terminal. Funcionou. Mas talvez tenha ficado uma dúvida no ar: como é que ele sabe o que tem no seu computador? Ele vê tudo? Ele vê fotos, mensagens, senhas?
A resposta é tranquilizadora e importante: não. O Claude Code só enxerga uma coisa — a pasta onde você o abriu. Entender isso muda tudo na hora de trabalhar com ele.
A ideia: ele só vê o cômodo onde você o colocou
Imagine que você contratou alguém pra organizar um cômodo da sua casa. Você leva essa pessoa até a sala e fecha a porta. Ela vai organizar a sala. Ela não sabe o que tem no quarto, na cozinha ou no porão — porque ela está trancada na sala com você.
O Claude Code funciona assim. A "pasta" onde você o abre é o cômodo. Tudo que está dentro dessa pasta (e das subpastas dentro dela), ele pode ler e mexer. Tudo que está fora, ele nem sabe que existe.
No mundo da programação, isso tem um nome: diretório de trabalho (em inglês, working directory). "Diretório" é só outra palavra para "pasta". O diretório de trabalho é a pasta onde o Claude Code está "parado" no momento.
Como saber em que pasta você está
Quando você abre o terminal (aquele programa de tela preta com texto), ele sempre começa parado em algum lugar do computador. Pra descobrir onde:
- No Mac: digite
pwde aperte Enter. Vai aparecer um caminho tipo/Users/seunome. - No Windows: digite
cdsozinho e aperte Enter. Vai aparecer algo tipoC:\Users\seunome.
Esse texto é o "endereço" da pasta onde você está. É exatamente o cômodo que o Claude Code vai enxergar se você abri-lo agora.
Por que você abre o Claude Code DENTRO da pasta do projeto
Aqui está a regra de ouro: antes de abrir o Claude Code, vá até a pasta do seu projeto. Assim ele enxerga só o que importa para aquele trabalho.
O comando pra "andar" entre pastas no terminal é o cd (vem de change directory, "mudar de pasta"):
- Crie uma pasta para o projeto. Pode ser pelo próprio Finder (Mac) ou Explorador de Arquivos (Windows). Dê um nome simples, sem espaços nem acentos — por exemplo
meu-site. - No terminal, digite
cd(com um espaço depois) e arraste a pasta para dentro da janela do terminal. O caminho aparece sozinho. Aperte Enter. - Agora você está "dentro" da pasta. Abra o Claude Code aqui. Ele vai enxergar essa pasta como o mundo dele.
Confira que deu certo: depois do cd, rode pwd (Mac) ou cd (Windows) de novo. O endereço deve terminar com o nome da sua pasta.
Boas práticas de organização
Três hábitos simples que evitam dor de cabeça:
- Uma pasta por projeto. Cada coisa que você for construir ganha sua própria pasta. Não misture um site com uma planilha de contas na mesma pasta. Separados, fica fácil pro Claude Code (e pra você) entender o que é o quê.
- Nunca abra na raiz do computador. A "raiz" é o nível mais alto —
/no Mac,C:\no Windows. Ali estão arquivos do sistema. Abrir o Claude Code nesse nível é como dar a ele a casa inteira de uma vez: confuso e desnecessário. Sempre prefira uma pasta específica e pequena. - Nomes simples. Letras minúsculas, sem espaço e sem acento.
meu-blogfunciona melhor queMeu Blog do João!.
Ele explora os arquivos sozinho
Uma das coisas mais legais: quando você pede algo, o Claude Code não precisa que você liste cada arquivo. Ele "anda" pela pasta sozinho, abre os arquivos, lê o conteúdo e monta na cabeça um mapa do projeto — igual a uma pessoa nova que chega e dá uma olhada geral antes de começar.
Por isso, deixar a pasta organizada ajuda ele a te ajudar. Quanto mais clara a casa, mais rápido o ajudante entende onde fica cada coisa.
Se algo der errado
- "Ele não encontra meu arquivo." Provavelmente o arquivo está fora da pasta onde você abriu o Claude Code. Lembre: ele só vê o cômodo atual. Mova o arquivo pra dentro da pasta do projeto, ou feche e reabra o Claude Code já dentro da pasta certa.
- O terminal abriu numa pasta que você não reconhece. Normal. Ele sempre começa na sua pasta pessoal. Use o
cdpara navegar até onde você quer antes de começar. - Você abriu sem querer na raiz ou na Área de Trabalho cheia de coisa. Sem pânico. Feche o Claude Code (geralmente digitando
exitou apertando Ctrl+C duas vezes), usecdpara ir até a pasta do projeto e abra de novo.
No próximo post, a gente para de teorizar e bota a mão na massa: você vai pedir pro Claude Code criar seu primeiro arquivo de verdade — e ver acontecer na sua frente.