Aula 00Antes de começar

🖥️ Versão Desktop, para quem nunca programou. Esta aula mostra o básico do computador que o curso usa. Se você já sabe o que é uma pasta oculta e já usou o terminal, pode pular para a Aula 01.

Objetivos

Ao final desta aula você vai saber:

• O que são pastas, arquivos e extensões, e o que é o caminho de um arquivo
• Como mostrar os arquivos escondidos, que o Claude Code usa
• Quando o terminal aparece na versão Desktop, e o que fazer nessas horas
• O que fazer quando aparecer uma mensagem de erro

Pastas, arquivos e caminhos

Tudo o que fica no seu computador é um arquivo: uma foto, uma planilha, uma página da internet. Os arquivos ficam guardados em pastas, e uma pasta pode ter outras pastas dentro.

No app Claude Desktop, você escolhe a pasta do projeto com um clique, no controle da pasta, logo abaixo da caixa de mensagem, sem digitar nada. Mesmo assim, vale entender o caminho, que é o endereço de um arquivo, porque o Claude fala dele o tempo todo:

Documents/confeitaria/index.html

Lendo da esquerda para a direita: dentro da pasta Documents (os seus Documentos) há a pasta confeitaria, e dentro dela o arquivo index.html. É assim que o Claude conta o que fez: "criei o arquivo index.html", "mudei o estilo.css". No Windows, o caminho completo usa a barra invertida (C:\Users\seu-nome\Documents).

💡 Documentos ou Documents? No Explorador de Arquivos e no Finder, a pasta aparece como Documentos, em português. Por dentro, o nome dela é Documents, em inglês, e é assim que ela aparece nos caminhos. É a mesma pasta. O mesmo vale para a pasta Downloads e para a Desktop (a Área de Trabalho do Windows, ou a Mesa do Mac).

A extensão diz o tipo do arquivo

O final do nome, depois do ponto, é a extensão: foto.jpg é uma imagem, index.html é uma página, notas.md é um texto. O Windows e o Mac costumam esconder a extensão, mas no curso ela importa, porque é por ela que você sabe o que o Claude criou. Para ver sempre:

• Windows 11: no Explorador de Arquivos, clique em Exibir → Mostrar → Extensões de nomes de arquivos.
• Windows 10: no Explorador de Arquivos, abra a aba Exibir e marque Extensões de nomes de arquivos.
• Mac: no Finder, abra Finder → Ajustes → Avançado e marque Mostrar todas as extensões de nome de arquivo.

Os arquivos escondidos

Alguns arquivos e pastas têm o nome começando com um ponto, como .claude ou .env. Normalmente são ajustes que ninguém precisa ver, e por isso o Mac e o Linux escondem esses itens. No Windows, a maioria aparece normalmente, mas alguns ficam ocultos, como a pasta .git, que aparece mais adiante no curso. O Claude Code guarda os ajustes dele numa pasta chamada .claude, e algumas aulas pedem para você conferir o que tem lá. Para mostrar os itens escondidos:

• Mac: no Finder, aperte Command + Shift + . (a tecla do ponto). Apertar de novo esconde outra vez.
• Windows 11: no Explorador de Arquivos, Exibir → Mostrar → Itens ocultos.
• Windows 10: na aba Exibir, marque Itens ocultos.
• Linux: na maioria dos gerenciadores de arquivos, aperte Ctrl + H.

A sua pasta pessoal, o ~

Cada pessoa que usa o computador tem uma pasta pessoal, com o nome do usuário, onde ficam os Documentos, os Downloads e as outras pastas. Nas aulas, ela aparece com o símbolo ~ (o til). Então ~/.claude quer dizer "a pasta escondida .claude, dentro da sua pasta pessoal".

• Windows: C:\Users\seu-nome
• Mac: /Users/seu-nome

Quando o terminal aparece

O terminal é uma janela onde você dá instruções ao computador digitando, em vez de clicar. Cada instrução se chama comando. Na versão Desktop, quase sempre é o Claude quem roda os comandos, e você só acompanha o resultado na conversa. Algumas aulas, porém, pedem que você mesmo rode um comando. Pode ser em dois lugares:

• No terminal integrado do app, que abre com Ctrl + ` (a tecla da crase) e já começa na pasta do projeto.
• No terminal do computador: no Mac, aperte Command + Espaço, digite Terminal e aperte Enter; no Windows, abra o menu Iniciar, digite Terminal (no Windows 11) ou PowerShell (no Windows 10) e aperte Enter.

Quando isso acontecer, a aula mostra exatamente o que digitar. O jeito de usar é sempre o mesmo: cole o comando (Command + V no Mac, Ctrl + V no Windows), aperte Enter e leia a resposta que aparece logo abaixo.

⚠️ Só aprove ou cole comandos que você entende. Um comando pode instalar programas ou apagar arquivos. Quando o Claude pedir licença para rodar um comando que você não conhece, pergunte antes: "explique este comando em português simples e me diga se ele apaga ou envia alguma coisa".

Nomes sem espaço e sem acento

Nos comandos, o espaço separa uma coisa da outra, e uma pasta chamada Meu Site vira duas palavras. Por isso, nos projetos do curso, use nomes sem espaço e sem acento, com hífen no lugar do espaço: meu-site, confeitaria, orcamento-festa.

Quando aparece um erro

Mensagem de erro assusta, mas quase sempre é só o computador dizendo o que faltou. Ler não estraga nada. O caminho é sempre o mesmo:

1. Leia as últimas linhas: é ali que costuma estar a explicação.
2. Copie a mensagem inteira.
3. Cole na conversa e peça: "apareceu este erro. Explique em português simples o que aconteceu e o que eu faço agora".

Isso vale para o app, para o terminal e para uma página que não abriu. E é justamente uma das coisas que o Claude Code faz melhor: ler o erro, achar a causa e corrigir.

Na prática

1. Mostre as extensões e os itens ocultos no seu computador, como explicado acima.
2. Na pasta Documentos, crie uma pasta para o seu projeto do curso, com um nome sem espaço e sem acento, como confeitaria ou meu-site. Na Aula 03, você vai escolher essa pasta no app, com um clique.
3. Se quiser treinar, abra o terminal do computador, cole o comando pwd e aperte Enter: ele mostra em que pasta você está. Se preferir pular, tudo bem: quando uma aula precisar do terminal, ela mostra o passo a passo.

Resumo

• Os arquivos ficam em pastas, e o caminho é o endereço deles, como Documents/confeitaria/index.html.
• A extensão diz o tipo do arquivo. No Mac e no Linux, os arquivos com ponto no começo do nome ficam escondidos até você mandar mostrar.
• O ~ é a sua pasta pessoal.
• O terminal aparece pouco na versão Desktop. Quando aparecer, a aula mostra o que digitar, e na dúvida você pergunta ao Claude o que o comando faz.
• Apareceu um erro? Copie a mensagem e peça ao Claude uma explicação em português simples.