Dez minutos até algo que você pode mandar para alguém
Grátis10 min de leituraAula 1 de Um terminal, feito direito
Ao final desta aula o Claude Code está instalado na sua máquina, você já rodou ele uma vez, e existe uma página pronta na sua área de trabalho que você fez pedindo em palavras comuns. Dá para abrir com dois cliques, e dá para mandar para alguém. Dez minutos, uma janela de terminal, nada para configurar.
Você provavelmente está aqui porque já usa o Claude Code, e usa do jeito que quase todo mundo usa: uma janela aberta, uma pergunta por vez, olhando ele trabalhar e esperando terminar. Esse é um jeito perfeitamente bom de começar e um jeito ruim de passar um dia.
Este curso reconstrói isso num dia de trabalho. Mas um dia é feito de horas, e cada hora é feita de uma sessão que se comporta. Então o módulo 1 é a sessão única, feita direito — instalada, entendida, nomeada e recuperável quando você quebrar alguma coisa.
Comece com uma vitória que dá para mostrar para alguém.
Instale
Uma linha. Escolha a sua máquina.
Abra o Windows Terminal ou o PowerShell pelo menu Iniciar e rode:
PowerShell. Esta é a instalação recomendada no Windows e ela se atualiza sozinha.
irm https://claude.ai/install.ps1 | iex
Prática
Abra o Claude Cowork no seu computador e experimente em arquivos reais. Cada módulo termina com um checkpoint onde você envia o que criou.
Feche o terminal e abra um novo. Instaladores adicionam o Claude Code ao seu PATH, e uma janela que já estava aberta ainda não sabe disso. Esse único passo responde pela maioria das mensagens de "está dizendo que não reconhece" que a gente recebe.
claude --version
Você deve ver
Um número de versão, algo como 2.1.240. Se aparecer 'not recognized' ou 'command not found', você está na janela antiga — abra uma nova.
Faça alguma coisa
Dê a si mesmo uma pasta para trabalhar. O Claude Code lê e escreve arquivos na pasta de onde você o iniciou, então iniciar numa pasta nova e vazia significa que ele não consegue tocar em nada de que você gosta.
mkdir first-day
cd first-day
claude
A primeira execução pede para você entrar na conta e escolher um estilo de texto. Depois você ganha um prompt, e essa é a interface inteira.
Quatro coisas sobre essa caixa, porque são as quatro que derrubam as pessoas:
Você digita, você não clica. Não existem botões. É uma conversa.
Esc interrompe. Se ele começar a fazer algo que você não quis, aperte Esc uma vez. Ele para. Você não quebrou nada.
Ctrl+D duas vezes sai. Uma vez é um aviso, duas vezes é a saída.
/help lista tudo. Todo comando começa com /. Você vai conhecer umas oito neste curso e ignorar o resto.
Agora peça a coisa. Digite isto, exatamente como está, e aperte Enter:
Faça uma única página HTML chamada card.html — um cartão de uma página do tipo "o que eu faço" com o meu nome, uma frase sobre o meu trabalho e três coisas com que eu posso ajudar alguém. Faça ficar bom no celular. Use um arquivo só, sem build, sem internet. Depois me diga como abrir.
O Claude vai ler a pasta vazia, dizer o que planeja escrever e pedir permissão antes de criar o arquivo. Diga que sim. Ele escreve card.html e para.
Você deve ver
Uma lista curta do que ele fez — um arquivo criado — e uma linha dizendo como abrir. Não parágrafos de explicação. Se veio uma redação e nenhum arquivo, você está numa janela de chat, não no Claude Code.
A primeira execução inteira. Ele lê a pasta, diz o que vai escrever, espera um sim, depois escreve um arquivo e para.
Abra
Saia do Claude com /exit, depois abra o arquivo.
PowerShell. Abre no seu navegador padrão, e resolve o nome em relação à pasta em que você está pisando.
Invoke-Item card.html
Esse arquivo é seu. Ele não tem dependências e não tem servidor por trás. Você pode mandar por e-mail, colar numa mensagem, ou jogar numa pasta e esquecer dele por um ano, que ele ainda abre.
Mande para alguém. É esse o ponto desta aula: dez minutos depois, você tem uma coisa em vez de uma opinião sobre uma coisa.
Confira
claude --version imprime um número de versão numa janela de terminal nova
card.html existe dentro da pasta first-day
Abrir com dois cliques mostra uma página legível com o seu nome de verdade nela
A página continua certa quando a janela do navegador é estreitada até a largura de celular
Você sabe como interromper o Claude sem fechar a janela
Se você vir 'claude' is not recognized as an internal or external command
Você está na janela de terminal que estava aberta durante a instalação. Feche, abra uma nova e tente claude --version de novo. Se uma janela nova ainda falhar, o instalador colocou o Claude Code num lugar que o seu PATH não cobre, e o claude doctor da próxima aula vai te dizer onde.
Se você vir ele escreveu o arquivo num lugar que eu não acho
Rode pwd no macOS ou no Linux, ou só cd no Windows, e ele imprime a pasta em que você realmente está pisando. É para lá que o arquivo foi. O Claude Code escreve relativo a onde você o iniciou, sempre.
Se você vir no Windows, start card.html abre o arquivo errado ou não abre nada
O start entrega o nome para o Windows resolver, e o Windows nem sempre resolve ele em relação à pasta que o seu prompt está mostrando. Use Invoke-Item card.html no lugar, ou .\card.html com a ponto-contrabarra na frente — os dois são explicitamente relativos a onde você está pisando. Se você não tiver certeza de onde é isso, rode cd sozinho e ele imprime a pasta.
O que você acabou de aprender
O Claude Code instala em uma linha e precisa de uma janela de terminal nova depois disso, que é a falha número um de todo mundo.
Ele trabalha nos arquivos da pasta em que você o inicia, então uma pasta vazia é um lugar seguro para experimentar.
Esc interrompe, Ctrl+D duas vezes sai, /help lista o resto.
Um pedido em linguagem comum com um arquivo de saída nomeado produz um artefato de verdade, não a descrição de um.