Claude Code para iniciantes: instale, entre e faça sua primeira tarefa

A maioria das pessoas conhece o Claude Code como conhece qualquer ferramenta nova: abre um terminal, se sente perdida e volta a colar código numa janela de chat. Funciona, mas joga fora justamente o que torna o Claude Code diferente. Ele não precisa que você cole nada.

Este guia leva você de nada instalado até uma primeira tarefa concluída. Você vai instalar, entrar na conta, fazer perguntas sobre um projeto de verdade, fazer uma pequena mudança e aprender os poucos comandos que cobrem a maior parte da sua primeira semana.

O que o Claude Code realmente é

O Claude Code é um assistente que roda no seu terminal, dentro da pasta do seu projeto. Quando você dá uma tarefa, ele trabalha em um ciclo de três fases: reúne contexto, age e verifica o resultado. Repete o ciclo até a tarefa terminar, e você pode interrompê-lo a qualquer momento.

A diferença para o chat está nas ferramentas. Um chat só responde com texto. O Claude Code pode ler seus arquivos, editá-los, pesquisar no projeto, rodar comandos como a sua suíte de testes e usar o git. Cada resultado alimenta a decisão seguinte.

Digamos que você peça para consertar os testes que estão falhando. Em geral ele roda os testes para ver o que falha, lê a saída de erro, procura os arquivos envolvidos, lê esses arquivos, edita e roda os testes de novo. Você escreveu uma frase. Ele fez seis passos.

Se você ainda está decidindo se o Claude Code é a ferramenta certa para o que está fazendo, leia primeiro Claude Code, Projetos ou Chat. Este guia parte do princípio de que você já decidiu.

Antes de começar

Você precisa de três coisas, e nenhuma é difícil de conseguir.

O Claude Code não faz parte do plano gratuito do Claude, então uma dessas contas é necessária. Se você nunca abriu um terminal, o guia oficial do terminal mostra como abrir um e colar um comando. Leva uns dois minutos.

Passo 1: instale o Claude Code

Há várias formas de instalar. O instalador nativo é o recomendado, porque se atualiza sozinho em segundo plano.

Escolha a linha que corresponde ao seu sistema, cole no terminal e aperte Enter. O instalador não mostra progresso durante o download, então não ache que travou.

No Linux você também pode instalar com apt, dnf ou apk no Debian, Fedora, RHEL e Alpine. No Windows nativo, o Git for Windows é recomendado para que o Claude Code possa usar a ferramenta Bash. Sem ele, o Claude Code usa o PowerShell. Se você usa o WSL, não precisa do Git for Windows.

Confira se funcionou

Quando o instalador terminar, abra uma nova janela de terminal. Isso importa: a janela antiga ainda não conhece o programa novo. Depois rode o comando de versão.

$ claude --version2.1.283 (Claude Code)

Se o seu shell disser que claude não foi encontrado ou não é reconhecido, a pasta de instalação ainda não está no seu PATH. Fechar e reabrir o terminal resolve na maioria das vezes. Se não resolver, a página oficial de solução de problemas de instalação liga cada mensagem de erro a uma correção.

Passo 2: comece sua primeira sessão

Vá até a pasta do seu projeto e digite o nome do programa.

$ cd ~/projects/my-website$ claude

Na primeira vez, o Claude Code pede que você entre na conta. Com uma assinatura do Claude ou uma conta do Console, ele abre o navegador, você aprova o acesso lá e volta ao terminal. Suas credenciais ficam guardadas, então você não fará isso de novo.

Você pode entrar de qualquer um destes jeitos:

• Uma conta Claude Pro, Max, Team ou Enterprise, que é o caminho recomendado.
• Uma conta do Claude Console. Na primeira vez, um workspace "Claude Code" é criado automaticamente para você acompanhar quanto ele custa.
• Amazon Bedrock, Google Cloud ou Microsoft Foundry, para quem tem acesso fornecido pela empresa dessa forma.

Se a variável de ambiente ANTHROPIC_API_KEY estiver definida e você aprovar a chave quando for perguntado, o Claude Code pula a etapa de login.

Depois de entrar, você vê um prompt com a versão, o modelo atual e a pasta em que está trabalhando. Digite /help para listar os comandos, /resume para continuar uma conversa antiga ou /login mais tarde, se precisar trocar de conta.

Passo 3: faça perguntas antes de mudar qualquer coisa

Seus primeiros prompts não devem mudar nada. Perguntas são o jeito mais seguro de ver como o Claude Code lê o seu projeto, e ensinam o que ele já sabe.

O Claude lê os arquivos de que precisa e responde. Você não adiciona arquivos à mão, ele os encontra. Continue com perguntas mais específicas, uma de cada vez:

> o que este projeto faz?Lendo package.json, README.md, src/ ...É um site de marketing estático feito com Next.js. As páginas ficam em src/app, os componentes compartilhados em src/components e o conteúdo na pasta content/.

Você também pode perguntar ao Claude Code sobre ele mesmo. Perguntas como "o que o Claude Code consegue fazer?" ou "como criar habilidades personalizadas no Claude Code?" recebem respostas de verdade, porque ele conhece a própria documentação.

Dentro do Claude Tutorial

Perguntar antes de agir é um hábito que vale construir

Fazer o assistente explicar o que ele enxerga antes de você pedir mudanças é a mesma disciplina que o app ensina para qualquer tipo de trabalho, não só para código.

Em breve

Baixe naApp Store

DISPONÍVEL NOGoogle Play

Passo 4: faça sua primeira mudança

Agora peça algo pequeno e fácil de desfazer.

O Claude Code encontra o arquivo certo e mostra a mudança que quer fazer. Dependendo das suas configurações, ele pode pedir sua aprovação antes. Se pedir, leia o que ele propõe e escolha Yes.

Esse pedido é minúsculo de propósito. O objetivo deste passo não é a função. É ver o ciclo completo uma vez: você pede, o Claude encontra o arquivo, mostra a edição, você aprova e o arquivo muda.

O que o Claude Code pode fazer sem perguntar é controlado pelo modo de permissão da sessão. Aperte Shift+Tab a qualquer momento para alternar entre os modos. As versões mais novas iniciam as sessões interativas de terminal no modo automático (auto), em que uma verificação em segundo plano bloqueia ações arriscadas em vez de perguntar sobre cada uma, e versões mais antigas ou outras configurações perguntam com mais frequência. Olhe a linha de status para ver em que modo você está. O próximo guia, Modos de permissão e modo plan do Claude Code, explicados, cobre todos os modos e quando usar cada um.

Passo 5: use o git conversando com ele

Se o seu projeto usa git, você pode operá-lo por conversa. Tudo isto funciona como está escrito.

Mesmo quando você confia nele, leia a mensagem do commit e o diff antes de aceitar. Quem revisa tudo o que o Claude Code produz é você.

Passo 6: corrija um bug ou adicione uma funcionalidade

Tarefas reais funcionam melhor com detalhes reais. Compare estas duas formas de pedir a mesma correção.

As versões melhores dizem o sintoma, o lugar e como é o "pronto". O Claude Code encontra arquivos sozinho, então você não precisa listá-los, mas ele não adivinha qual problema você tem em mente.

Para trabalhos maiores, divida o serviço em etapas numa lista numerada.

E quando você ainda não conhece o código, deixe o Claude explorar primeiro: peça que analise o esquema do banco de dados, ou como funciona o checkout, antes de pedir que mude qualquer um dos dois. Alguns minutos de leitura costumam evitar uma mudança errada.

Os comandos que você vai usar todo dia

Alguns comandos você roda no seu shell, antes de o Claude Code iniciar, e outros dentro de uma sessão.

Algumas teclas economizam muito tempo. Digite / para ver todos os comandos e habilidades que você tem. Aperte Tab para completar um comando, ↑ para trazer prompts anteriores e Shift+Tab para alternar o modo de permissão. Aperte Esc para parar o Claude imediatamente se ele for na direção errada.

Quando o primeiro dia dá errado

Estes são os problemas mais comuns e o que cada um significa.

Quando nada disso servir, pergunte ao próprio Claude Code. Digite algo como "como corrijo este erro?" com a mensagem colada. O comando /doctor também faz uma checagem da configuração e diagnostica problemas de instalação e de ajustes.

Você não precisa usar o terminal

O terminal é a casa original do Claude Code, e tudo o que está acima vale lá. O mesmo assistente também está disponível como app de desktop, dentro do VS Code e dos editores JetBrains, na web em claude.ai/code, no Slack e em pipelines automatizados com GitHub Actions e GitLab. A interface muda como você o vê e conversa com ele. O ciclo de reunir contexto, agir e verificar é o mesmo em todo lugar.

Perguntas frequentes

O Claude Code é gratuito?

Não. Ele exige uma assinatura Claude Pro, Max, Team ou Enterprise, uma conta do Claude Console com créditos de API, ou acesso por um provedor de nuvem compatível. O plano gratuito do Claude não o inclui.

Preciso saber programar para usar o Claude Code?

Você precisa de um projeto para apontá-lo, e quanto mais entender o projeto, melhor poderá julgar o trabalho dele. Não precisa escrever o código você mesmo. Quem está começando aproveita mais o hábito de perguntar primeiro do Passo 3: peça ao Claude que explique antes de pedir que mude.

É seguro deixá-lo editar meus arquivos?

Você controla o que ele pode fazer sem perguntar pelo modo de permissão, e as edições de arquivos podem ser desfeitas com Esc duas vezes. Trate o resultado como o pull request de um colega: leia o diff antes de fazer o commit. Mantenha o projeto no git para que toda mudança seja fácil de revisar ou reverter.

Qual é a diferença entre o Claude Code e o Claude no chat?

Um chat responde com texto sobre o que você cola. O Claude Code trabalha dentro do seu projeto: lê os arquivos sozinho, edita, roda comandos e confere o próprio trabalho. Use o chat para pensar, use o Claude Code para fazer.

O Claude Code lembra do meu projeto entre as sessões?

Cada sessão começa com um contexto novo. Para levar conhecimento de uma sessão a outra, você o escreve num arquivo chamado CLAUDE.md, e o Claude Code também guarda anotações próprias sobre as suas preferências. O guia seguinte ao próximo, CLAUDE.md explicado, mostra como.

Seu checklist do primeiro dia

Continue lendo

• Modos de permissão e modo plan do Claude Code, explicados para decidir quanto o Claude Code pode fazer sem perguntar.
• CLAUDE.md explicado: ensine o seu projeto ao Claude Code uma vez só para parar de repetir as mesmas instruções a cada sessão.
• Boas práticas do Claude Code: hábitos que dão melhores resultados para prompts, verificações e gestão de contexto.
• Como fazer mudanças em vários arquivos com o Claude Code para a sua primeira mudança que toca muitos arquivos.
• Conectando o Claude aos seus próprios dados e ferramentas com o MCP para ir além da sua própria pasta.