Aula 03Instalando o Claude Code

🖥️ Versão Desktop. Nesta versão do curso, você usa o Claude Code no app Claude Desktop, na aba Code. No Mac e no Windows, o app se instala como qualquer programa. No Linux, a instalação usa o terminal, e esta aula mostra exatamente o que digitar.

Objetivos

Ao final desta aula você vai saber:

• Instalar o app Claude Desktop, que já traz o Claude Code
• Entrar com a sua conta, abrir a aba Code e escolher a pasta do projeto
• Criar a primeira página do projeto e abrir no navegador
• Onde mais o Claude Code funciona, e qual caminho combina com você

---

Antes de instalar

Você precisa de duas coisas:

• Um plano pago do Claude: Pro, Max, Team ou Enterprise. A aba Code exige um deles.
• A pasta do projeto: na Aula 00, você criou dentro de Documentos uma pasta para o seu projeto, como confeitaria ou meu-site. Pulou a Aula 00? Crie agora: abra a pasta Documentos no Finder (Mac) ou no Explorador de Arquivos (Windows), clique com o botão direito num espaço vazio e crie uma pasta nova, com um nome sem espaço e sem acento.

Instale o app

O app Claude Desktop já traz o Claude Code dentro dele. Para usar a aba Code, você não precisa instalar mais nada. Se uma aula mais adiante precisar de outro programa, ela avisa.

No Mac e no Windows

Baixe o instalador em claude.com/download e instale como qualquer programa. Os links diretos de cada versão também estão na página de primeiros passos do app.

• Mac: existe um instalador só, que serve tanto para os Macs com processador Intel quanto para os com Apple Silicon (os chips M1, M2 e seguintes).
• Windows: o instalador normal é para processadores x64, que é o caso da maioria dos computadores. Se o seu tiver processador ARM, use o instalador ARM64. Para saber qual é o seu, abra as Configurações do Windows, depois Sistema e Sobre, e veja a linha Tipo de sistema: ela diz se o processador é x64 ou ARM.

Depois, abra o Claude pela pasta Aplicativos, no Mac, ou pelo menu Iniciar, no Windows.

💡 No Mac e no Windows, o app se atualiza sozinho quando você o abre. Para procurar uma versão nova na hora, use Claude → Check for Updates (procurar atualizações) no Mac, ou Help → Check for Updates no Windows.

No Windows, instale também o Git (recomendado)

O Git é um programa que guarda as versões dos seus arquivos, e o curso volta a ele a partir da Aula 06. No Windows, vale instalar o Git for Windows. Para começar, ele não é obrigatório, mas o app precisa dele para as sessões que trabalham numa cópia separada da pasta, chamada worktree, um recurso que a Aula 10 apresenta. Se um dia aparecer o aviso "Git is required" (o Git é obrigatório), é ele que está faltando. Para instalar, baixe pelo link e vá avançando com as opções que já vêm marcadas.

No Mac, este passo não existe.

No Linux (beta)

🐧 No Linux, o app está em beta e roda no Ubuntu 22.04 ou mais novo e no Debian 12 ou mais novo, em computadores x86_64 ou arm64. Aqui, a instalação usa o terminal do sistema (Aula 00): siga os passos da página Claude Desktop no Linux, colando um comando de cada vez e apertando Enter. Eles terminam com sudo apt update && sudo apt install claude-desktop. O sudo pede a senha do seu usuário, e é normal nada aparecer na tela enquanto você digita. Depois, as atualizações do app chegam junto com as do sistema. Em versões do Linux que não são baseadas no Debian, como Fedora ou Arch, use a versão terminal do Claude Code.

🔧 Para ir além (para quem já programa; pode pular): no Windows com WSL 2, instale o app do Windows normalmente. Ao abrir uma sessão, você pode escolher uma distribuição na seção WSL do seletor de ambiente: aí o Claude Code, as ferramentas e o git rodam dentro do Linux. Nessas sessões, alguns recursos ainda não funcionam, como o terminal integrado, os conectores e os plugins.

Primeiro uso

Abra o app e entre com a sua conta do Claude, a do plano pago. Se a sua empresa usa Team ou Enterprise, entre com a conta em que o time te convidou, ou pelo login único da organização (SSO).

Com a conta pronta:

1. Clique na aba Code, no alto da barra lateral (se aparecerem só ícones, pare o mouse em cima de um para ver o nome). Se o app pedir um upgrade, você precisa de um plano pago. Se pedir para entrar online, faça o login e reinicie o app.
2. Na linha logo abaixo da caixa de mensagem, clique no primeiro controle, o do ambiente, e escolha a primeira opção do grupo Local. Esse menu decide onde o Claude trabalha:
   • Local: no seu computador, direto nos arquivos da pasta que você escolher. É o que este curso usa.
   • Cloud (nuvem): num computador da Anthropic, pela internet. A sessão continua mesmo se você fechar o app ou desligar o computador, mas ela trabalha com projetos guardados no GitHub, um site que guarda projetos na internet, e por isso pede a sua conta de lá.
   • As outras opções do menu, como SSH e WSL, são para quem já programa.
3. Ao lado dele, clique no controle da pasta, escolha Open folder… (abrir pasta), entre em Documentos e escolha a pasta do seu projeto, como confeitaria.
4. Deixe o modelo que já vem escolhido, no fim dessa mesma linha, à direita. O modelo é a IA que pensa e escreve, e o padrão hoje (outubro de 2026) é o Opus mais recente, o mais capaz. Ele também é o que mais gasta do limite de uso do seu plano, e a Aula 08 mostra quando vale trocar.
5. Escreva o que você quer e aperte Enter.

Nessa mesma linha fica também o seletor de modo, que mostra o quanto o Claude pode fazer sem perguntar (Aula 02). Se ele estiver em Manual, o Claude pede licença antes de cada mudança: o app mostra o que vai mudar no arquivo e os botões Accept (aceitar) e Reject (recusar). As Aulas 04 e 05 mostram quando trocar de modo.

💡 O seu app mostra o ambiente e a pasta acima da caixa de mensagem? É o layout anterior, de uma versão mais antiga. Atualize o app (no Mac, Claude → Check for Updates; no Windows, Help → Check for Updates). Enquanto isso, o caminho é o mesmo e só muda o lugar: o Local e a pasta, no botão Select folder, ficam acima da caixa de mensagem, e o modo e o modelo, na linha de baixo.

🔧 Para ir além (para quem já programa; pode pular): uma conta da Claude Console, que cobra por uso, por token, não serve aqui: o app não aceita a chave de API dela. Ela funciona no terminal e nas extensões do VS Code e do JetBrains, mas o app Desktop, a web e o celular exigem uma assinatura.

Se algo der errado, comece por aqui:

• Erro 403 ou de autenticação (login) na aba Code: saia e entre de novo pelo menu do app. Confira se a sua assinatura é paga. Se ainda não resolver, feche o app por completo, não só a janela, e abra de novo.
• Outro erro: copie a mensagem e peça ajuda ao Claude na aba Chat: "apareceu este erro no app. Explique em português simples o que eu faço agora". A seção Troubleshooting (solução de problemas) da documentação traz outros casos.

🔧 Para ir além (para quem já programa; pode pular):

• O Claude não encontra ferramentas que você usa, como npm ou node: confira se elas funcionam no seu terminal de sempre e reinicie o app, para ele recarregar as variáveis de ambiente.
• Versões: para conferir a versão do app, clique em Claude → About Claude no Mac, ou em Help → About Claude no Windows. Para ver a versão do Claude Code que a aba Code usa, digite /status numa sessão local e leia a linha Claude Code. O app baixa e atualiza a própria cópia do Claude Code, que pode ter uma versão diferente do comando claude do terminal, se você também tiver a CLI. O claude --version e o claude doctor são da versão terminal.

📁 Importante: o Claude Code trabalha a partir da pasta que você escolheu e de todas as pastas que estão dentro dela. Por isso, escolha sempre a pasta principal do projeto (quem programa chama de raiz do projeto), e nunca a sua pasta pessoal inteira, onde ficam todas as suas outras pastas. Essa pasta também não é uma cerca: com a sua permissão, ele pode ler arquivos de outros lugares, e pode rodar qualquer comando que você rodaria no terminal. A Aula 05 mostra como cuidar disso.

Abra a página no navegador

Uma página da internet é um arquivo com a extensão .html, e index.html é o nome que se costuma dar à página principal de um site. Quando o Claude Code cria a página do seu projeto, ela fica na pasta, e você abre de dois jeitos:

• Pela pasta: no Finder ou no Explorador de Arquivos, abra a pasta do projeto e dê dois cliques no arquivo index.html. Ele abre no seu navegador. Se as extensões estiverem escondidas, o arquivo aparece só como index, com o ícone do navegador.
• Pedindo ao Claude: escreva "abra a página no navegador". Ele roda o comando que abre o arquivo e pode pedir a sua licença antes.

Depois de cada mudança, atualize a página no navegador para ver a versão nova: F5 no Windows e no Linux, Command + R no Mac.

Quando o terminal aparece

No Mac e no Windows, você não precisa do terminal para instalar o app nem para fazer os primeiros pedidos na aba Code. Mesmo assim, ele aparece em alguns momentos do curso, e a aula avisa quando:

• No Linux, para instalar o app.
• No terminal integrado do app, que abre com Ctrl + ` (a tecla da crase) já na pasta da sessão. Algumas aulas pedem um comando ali, e mostram exatamente o que digitar.
• Na versão terminal do Claude Code, se você quiser usar também. O app não coloca o comando claude no seu terminal: essa versão se instala à parte, como mostra a versão terminal desta aula.

🔧 Para ir além (para quem já programa; pode pular): no terminal, os recursos novos chegam primeiro, e é o caminho para scripts e automações. O app e o terminal convivem: você pode usar os dois ao mesmo tempo, até no mesmo projeto, e eles compartilham as configurações e os arquivos CLAUDE.md. O terminal integrado serve para os seus próprios comandos, como git status ou npm test; o app não instala o comando claude nele.

Onde mais o Claude Code funciona

O app não é o único caminho. O mesmo Claude Code também roda:

• Na web, em claude.ai/code, ou clicando em Code na barra lateral do app de chat. É parecido com o app, mas ali o Claude trabalha com projetos guardados no GitHub, e a sessão roda na nuvem: ele continua trabalhando mesmo depois que você fecha o navegador. No app, você abre o mesmo tipo de sessão escolhendo Cloud em vez de Local.
• No celular, no app Claude para iOS e Android, na aba Code: você começa uma tarefa na nuvem, acompanha e responde de onde estiver. Com o Remote Control (controle remoto), o celular também comanda uma sessão que está rodando no seu computador. O trabalho não roda no celular; ele é só o controle remoto.
• Em editores de código, como o VS Code e os da JetBrains, que são programas para escrever código. Se você não usa nenhum, pode pular esta parte.

🔧 Para ir além (para quem já programa; pode pular): no VS Code:

1. Abra o painel de Extensões e busque por "Claude Code".
2. Escolha a extensão publicada pela Anthropic, com o selo azul de verificação, e clique em Instalar.
3. Talvez seja preciso reiniciar o VS Code.
4. Abra a paleta de comandos com Ctrl/Cmd + Shift + P e busque "Claude Code: Open in New Tab". Ou clique no logo do Claude na barra lateral, se ele aparecer.

A extensão oferece uma experiência bem parecida com a do terminal. Se preferir, dá para desligar a interface gráfica nas configurações e usar a experiência de terminal direto no VS Code.

No JetBrains (IntelliJ, PyCharm, WebStorm e outros): instale primeiro o Claude Code no terminal (a CLI), seguindo a versão terminal desta aula, porque o plugin usa o comando claude, que o app Desktop não instala. Sem ele, aparece o aviso "Cannot launch Claude Code". Depois, instale o plugin Claude Code pelo JetBrains Marketplace, reinicie a IDE e clique no logo do Claude: abre um painel com a experiência de terminal ao lado do editor. Se o Esc não interromper o Claude no terminal da IDE, vá em Settings → Tools → Terminal e desmarque "Move focus to the editor with Escape".

Qual devo usar?

Não existe resposta certa: o jeito de usar é escolha sua. Nesta versão do curso, o caminho é o Claude Desktop.

---

Na prática

1. Baixe e instale o Claude Desktop para o seu sistema (no Linux, a versão beta, pelo terminal). No Windows, instale também o Git for Windows.

2. Abra o app, entre com a sua conta e clique na aba Code.

3. Na linha abaixo da caixa de mensagem, escolha Local e, no controle da pasta, Open folder… e a pasta do seu projeto, dentro de Documentos.

4. Deixe o modelo como está e confira o seletor de modo, na mesma linha. A sugestão da Aula 02, enquanto você aprende, é o Manual: se estiver em outro modo, clique no seletor e escolha Manual. As Aulas 04 e 05 mostram quando usar os outros.

5. Peça a primeira página, trocando a confeitaria pela sua ideia da Aula 01:

   crie uma página simples para a minha confeitaria, num arquivo index.html, com o nome da confeitaria, uma frase de boas-vindas e três doces com o preço. Depois me diga como abrir a página no navegador

6. Enquanto ele trabalha, digite use tons de rosa e aperte Enter, sem parar o Claude. A ação em andamento não é interrompida: ele lê a mensagem assim que ela termina e se ajusta antes do próximo passo. Se ele terminar antes, tudo bem: mande como um pedido novo.

7. Quando o app pedir a sua licença para criar o arquivo, veja o que vai mudar e clique em Accept.

8. Acompanhe os passos na conversa: o que ele leu, o que criou e o que conferiu. Quando ele terminar, abra a página no navegador.

9. Peça uma mudança, como "acrescente o endereço e o horário de funcionamento", e clique no botão de parar no meio do trabalho (ou aperte Esc). Ele para e espera. Diga o novo rumo, como "coloque só o horário, no fim da página", e veja como ele muda o plano.

10. Atualize a página no navegador e confira o resultado.

Resumo

• O app Claude Desktop já traz o Claude Code: para usar a aba Code, você não precisa instalar mais nada.
• Baixe para Mac (um instalador para todos) ou Windows (x64, ou ARM64 nos processadores ARM). No Linux (beta, Ubuntu e Debian), a instalação usa o terminal.
• No Mac e no Windows, o app se atualiza sozinho; no Linux, pelas atualizações do sistema. No Windows, o Git for Windows é recomendado.
• Entre com a conta do plano pago (Pro, Max, Team ou Enterprise).
• Na aba Code, na linha abaixo da caixa de mensagem, escolha Local e a pasta principal do projeto: ele trabalha nessa pasta e em tudo o que está dentro dela.
• Deixe o modelo padrão por enquanto. O seletor de modo mostra o quanto ele faz sem perguntar, e no Manual você aceita cada mudança.
• A página fica na pasta: dois cliques no index.html abrem no navegador, e F5 ou Command + R mostram a versão nova.
• O Claude Code também funciona no terminal, na web, no celular e em editores como o VS Code.