BrazLabsLaboratório de Soluções DigitaisCursos e infoprodutos
Claude Code na Prática Todas as aulas
Módulo 1 · O que é o Claude Code?

Aula 01O que é o Claude Code?

versão do app Claude Desktop7 min de estudo
Prefere o terminal? Veja esta aula na versão do terminal
Inscreva-se no canalOs vídeos da versão do app vão para o canal da BrazLabs no YouTube.

🖥️ Versão Desktop. Nesta versão do curso, você usa o Claude Code no app Claude Desktop, na aba Code. Quase tudo é feito por janelas e botões. Quando uma aula pedir para digitar um comando, ela mostra exatamente o que digitar.

Objetivos

Ao final desta aula você vai saber:

  • O que é o Claude Code, em palavras simples, e onde ele fica no app
  • O que muda entre conversar com o Claude no chat e pedir para o Claude Code fazer
  • O que é um agente de IA
  • O que dá para criar com ele, mesmo sem saber programar
  • Os três cuidados que fazem você usar o Claude Code bem

O que é

O Claude Code é o Claude trabalhando dentro do seu computador. No chat, o Claude conversa e explica. No Claude Code, ele faz: cria e altera arquivos numa pasta que você escolhe, confere o que fez e corrige o que deu errado, até a tarefa ficar pronta.

Você pede em português, do jeito que pediria a uma pessoa. Por exemplo:

crie uma página para a minha confeitaria, com o cardápio, os preços e um botão para chamar no WhatsApp

E ele cria os arquivos da página. Você abre no navegador, vê o resultado e pede o que quiser mudar: "deixe as fotos maiores", "troque o verde por rosa".

💡 Você não precisa saber programar. Sites, apps e automações são feitos de arquivos de texto escritos numa linguagem que o computador entende: é isso que se chama código. O Claude Code escreve esse código por você. O seu trabalho é dizer com clareza o que você quer e conferir se ficou do jeito certo, e é isso que este curso ensina.

O Claude Code dentro do app

O app Claude Desktop (para macOS, Windows e, em beta, Linux) tem três abas no alto da barra lateral:

  • Chat: a conversa com o Claude, como no claude.ai. Aqui ele não mexe nos seus arquivos.
  • Cowork: um agente que cuida de tarefas sozinho, em segundo plano, enquanto você faz outra coisa.
  • Code: o Claude Code. É a aba deste curso.

Na aba Code, você escolhe com um clique a pasta onde ele vai trabalhar, escreve o pedido na caixa de mensagem e acompanha tudo pela conversa. Quando ele muda um arquivo, o app mostra exatamente o que mudou, linha por linha, numa tela chamada diff. E o Claude Code já vem dentro do app: basta instalar o Claude Desktop, sem instalar mais nada (a Aula 03 mostra o passo a passo).

O mesmo Claude Code também roda no terminal, uma janela de texto onde se digitam comandos, em editores de código como o VS Code e na web. Cada aula deste curso tem uma versão no terminal, mas, se você nunca programou, o app é o caminho mais tranquilo. E, se pastas e arquivos escondidos ainda são novidade, a Aula 00 mostra o básico do computador que o curso usa.

O que muda entre o chat e o Claude Code

No app, essa diferença fica lado a lado, em duas abas. Imagine que você quer aquela página da confeitaria:

Aba Chat Aba Code (Claude Code)
Ele explica como fazer e mostra o código na conversa Ele cria os arquivos da página direto na pasta que você escolheu
Você copia, cola num arquivo e tenta abrir O arquivo já está lá, pronto para abrir, e o diff mostra o que ele fez
Se algo não funciona, você volta e descreve o problema Ele confere o que fez, acha o problema e corrige
Uma resposta por pergunta Um trabalho contínuo até a tarefa ficar pronta

No chat, você vira o carteiro entre a IA e o computador. Com o Claude Code, ele entra na pasta e faz o trabalho.

O que é um agente?

O que torna isso possível é que o Claude Code é um agente de IA: uma IA que não só responde, mas age para cumprir um objetivo. Ele usa ferramentas, como abrir e criar arquivos ou rodar um programa, e trabalha num ciclo: pensa, faz, confere o resultado e decide o próximo passo, até terminar.

💡 Analogia: o chat é como pedir uma receita por telefone: a pessoa explica, mas quem cozinha é você. O agente é o cozinheiro na sua cozinha: ele pega os ingredientes, cozinha, prova e acerta o sal. E quem decide o que vai para a mesa continua sendo você.

O que dá para fazer com ele

Alguns exemplos do que você pode pedir, sem escrever uma linha de código:

  • Uma página na internet para o seu trabalho, o seu portfólio ou um evento.
  • Uma ferramenta para uso próprio, como uma lista de tarefas, um controle de gastos ou uma calculadora do seu jeito.
  • Uma tarefa chata feita sozinha, como renomear centenas de fotos, juntar várias planilhas numa só ou organizar uma pasta bagunçada.
  • Explicações sobre um projeto que já existe. Se alguém te passou os arquivos de um site, ele lê tudo e explica, em português, como funciona.

Quem já programa usa o mesmo Claude Code em tarefas bem maiores. O que muda é o tamanho do pedido, não a ferramenta.

Três cuidados para usar bem

1. A memória de trabalho tem limite

O Claude lembra do que foi dito na conversa e do que ele leu nos arquivos. Essa memória, chamada janela de contexto, é como uma mesa de trabalho: cabe muita coisa, mas não tudo de uma vez, e em tarefas longas ela enche. No app, o anel de uso, ao lado do seletor de modelo, mostra o quanto ela já encheu. Na Aula 07, você aprende a cuidar dela.

2. Você decide quanta liberdade ele tem

O Claude Code trabalha na pasta que você escolher, e você decide o quanto ele pode fazer sem perguntar. No app, isso fica no seletor de modo, na linha abaixo da caixa de mensagem:

  • Manual: ele pede licença antes de mudar um arquivo ou rodar um comando, e você aceita ou recusa cada vez.
  • Accept edits: as mudanças nos arquivos (e comandos simples, como criar uma pasta) passam direto; os outros comandos ainda pedem licença.
  • Plan: ele estuda a pasta e propõe um plano, sem mudar nada.
  • Auto: ele trabalha sem pedir licença a cada passo, e uma checagem de segurança revisa as ações antes de elas acontecerem.

O app lembra o modo que você escolheu para cada pasta (o Plan vale só para a conversa atual). A Aula 04 mostra quando usar cada um.

3. Ele pode errar

Como qualquer pessoa, ele pode entender errado o que você pediu ou fazer diferente do que você imaginou. Por isso, acompanhe o trabalho, confira o resultado e peça ajustes. O diff ajuda nisso: antes de seguir, você vê exatamente o que mudou em cada arquivo. Pedidos claros ajudam muito (Aula 04), e dá para desfazer uma mudança que não ficou boa (Aula 09).


Na prática

  1. Pense em algo que você gostaria de ter e que ainda não existe do seu jeito: uma página, uma ferramenta simples ou uma tarefa que você faz à mão toda semana.
  2. Escreva, em duas ou três frases, como você explicaria isso para uma pessoa: o que é, para quem é e o que precisa ter.
  3. Se você já tem o app Claude Desktop, abra e encontre as três abas no alto da barra lateral: Chat, Cowork e Code (se aparecerem só ícones, pare o mouse em cima de um para ver o nome). Ainda não tem? A Aula 03 mostra como instalar.
  4. Guarde o texto do passo 2. Nas próximas aulas, você vai transformá-lo num pedido na aba Code.

Resumo

  • O Claude Code é o Claude trabalhando no seu computador: você pede em português, e ele cria e altera arquivos numa pasta, confere o resultado e corrige o que deu errado.
  • No app Claude Desktop, ele fica na aba Code, ao lado da aba Chat.
  • Você não precisa saber programar: ele escreve o código, e você diz o que quer e confere se ficou certo.
  • Ele é um agente: pensa, faz, confere e decide o próximo passo, até a tarefa ficar pronta.
  • Três cuidados: a memória de trabalho tem limite, as permissões estão nas suas mãos (no seletor de modo) e ele pode errar, então acompanhe e confira o diff.

Perguntas de fixação

Três perguntas rápidas para conferir se a ideia principal da aula ficou. Escolha uma opção: a página mostra se você acertou e explica a resposta.

Pergunta 1 de 3

Você faz o mesmo pedido no chat e no Claude Code: "uma página para a minha confeitaria". O que muda?

Ver a resposta

Resposta: c) No chat, você vira o carteiro entre a IA e o computador. No Claude Code, ele cria os arquivos direto na pasta, confere o que fez e corrige o que deu errado (Aula 01).

Pergunta 2 de 3

O que faz do Claude Code um agente?

Ver a resposta

Resposta: a) Um agente é uma IA que não só responde, mas age para cumprir um objetivo, num ciclo: pensa, faz, confere e decide o próximo passo, até terminar (Aula 01).

Pergunta 3 de 3

Por que vale acompanhar o trabalho e conferir o resultado?

Ver a resposta

Resposta: b) Como qualquer pessoa, ele pode entender errado o pedido ou fazer diferente do que você imaginou. Acompanhar e conferir faz você pegar isso cedo e pedir o ajuste (Aula 01).