Noções Básicas do Claude Code 101

10 exemplos para você começar com o Claude Code 101 - 7 básicos e 3 intermediários.

Pré-requisitos

• Um terminal com o qual você se sinta confortável, e um diretório de projeto onde você deseja que o Claude Code trabalhe.
• A CLI do Claude Code instalada em sua máquina (abordado no exemplo 1 abaixo).
• Uma conta Anthropic com acesso ao Claude Code, pois a CLI precisa se autenticar antes de poder executar uma sessão.

Exemplos Básicos

1. Instale a CLI

Instale o Claude Code a partir do seu terminal antes de fazer qualquer outra coisa.

npm install -g @anthropic-ai/claude-code

• A CLI é instalada globalmente para que você possa iniciá-la de qualquer diretório de projeto.
• A instalação é um passo único; depois disso, você só precisa mantê-la atualizada ocasionalmente.
• Se npm não for seu gerenciador de pacotes preferido, verifique platform.claude.com/docs para as opções de instalação atuais.

Relacionado: Instalando o Claude Code e Conectando Seu Primeiro Projeto - o guia completo que este exemplo resume.

2. Verifique a versão instalada

Confirme se a CLI foi instalada corretamente e veja qual versão você está executando.

claude --version

• Um número de versão confirma que a instalação foi bem-sucedida e que o comando claude está no seu PATH.
• Execute isso novamente após uma atualização para confirmar que a nova versão entrou em vigor.
• Se o comando não for encontrado, o PATH do seu shell provavelmente precisa incluir o diretório global de binários do npm.

3. Inicie o REPL em um projeto

Inicie uma sessão interativa do Claude Code dentro do projeto com o qual você deseja ajuda.

cd ~/projects/my-app
claude

• O Claude Code é iniciado como um REPL: uma sessão permanente onde você digita solicitações em linguagem natural.
• Ele se orienta no diretório atual, portanto, sempre navegue (cd) para o projeto primeiro.
• A sessão permanece aberta em várias solicitações até que você a encerre.

Relacionado: Navegando no REPL do Claude Code: Prompts e Comandos de Barra (/) - o que você pode digitar assim que a sessão for aberta.

4. Dê sua primeira solicitação em linguagem natural

Digite uma instrução em inglês simples no prompt em vez de escrever o código você mesmo.

> Add a README.md that explains what this project does

• O Claude Code lê o projeto primeiro, depois planeja e escreve o arquivo.
• Você não precisa de sintaxe especial; descreva o resultado que você deseja.
• Solicitações vagas geram resultados vagos, portanto, nomeie detalhes específicos (arquivos, funções, comportamento) quando puder.

5. Revise uma alteração proposta

Veja o que o Claude Code deseja alterar antes que aconteça.

# Claude Code mostra uma prévia da edição no estilo diff
# você aprova, edita a solicitação ou a rejeita

• Revisar o diff é como você detecta uma solicitação mal compreendida antes que ela se torne uma edição real.
• Se você vê esta prévia por padrão, depende do seu modo de permissão.
• Trate as primeiras sessões em um novo projeto como uma chance de construir confiança em seus planos.

Relacionado: Modos de Permissão Explicados: Aceitar Automaticamente vs. Perguntar a Cada Vez - controla se você vê esta prévia para cada ação.

6. Use um comando de barra embutido

Acione um comportamento embutido com uma barra inicial (/) em vez de uma solicitação em linguagem natural.

> /init

• Comandos de barra são distintos de solicitações em linguagem natural; a barra inicial (/) sinaliza uma ação embutida.
• /init é um comando inicial comum em um novo projeto, pois permite que o Claude Code construa o contexto sobre a base de código.
• Existem outros comandos de barra para limpar ou compactar o contexto da sessão.

7. Saia da sessão de forma limpa

Encerre sua sessão do Claude Code quando terminar.

> /exit

• Sair de forma limpa fecha a sessão REPL sem deixar trabalho em segundo plano em execução.
• Seus arquivos de projeto retêm quaisquer alterações que já foram aprovadas durante a sessão.
• Você sempre pode reiniciar com claude do mesmo diretório para continuar de onde parou.

Exemplos Intermediários

8. Defina seu modo de permissão para uma sessão

Escolha se o Claude Code pergunta antes de cada ação ou prossegue por conta própria.

claude --permission-mode ask-every-time

• ask-every-time solicita aprovação antes de cada edição de arquivo ou comando de shell.
• Omitir o sinalizador usa sua configuração padrão, que pode ser aceitação automática.
• Comece projetos novos ou desconhecidos com ask-every-time até que você confie nos planos do agente nesse codebase.

Relacionado: Modos de Permissão Explicados: Aceitar Automaticamente vs. Perguntar a Cada Vez - a comparação completa de ambos os modos.

9. Pesquise com segurança primeiro com o Modo de Plano

Deixe o Claude Code investigar uma alteração arriscada ou desconhecida antes que ela toque em quaisquer arquivos.

> /plan
> Investigate why the checkout flow fails intermittently and propose a fix

• No Modo de Plano, o Claude Code pode ler arquivos e raciocinar sobre uma abordagem, mas não pode fazer edições reais.
• Revise o plano proposto, em seguida, mude para o modo de execução para deixá-lo aplicar a correção.
• Este fluxo de duas etapas é a maneira mais segura de delegar uma tarefa que você ainda não entende completamente.

Relacionado: Alternando entre o Modo de Plano e o Modo de Execução - o fluxo completo para passar da pesquisa para edições reais.

10. Encaderne uma tarefa multi-etapas entre arquivos

Dê ao Claude Code uma instrução que exija a manipulação de vários arquivos e a execução de um comando.

> Rename getUserData to fetchUserProfile everywhere it's used, then run the test suite

• Uma única instrução pode acionar a leitura de vários arquivos, a edição de cada uso e a execução de um comando de shell para verificar o resultado.
• Este é o loop do agente na prática: ler, planejar, agir, verificar, tudo a partir de uma única solicitação em linguagem natural.
• Revisar o resumo que o Claude Code reporta confirma que a suíte de testes realmente passou, não apenas que os arquivos foram alterados.

Relacionado: O Modelo Mental do Claude Code: Agente, Não Autocompletar - por que uma instrução pode acionar com segurança um plano multi-etapas como este.

Versões da Stack: Escrito contra a linha de modelos Claude atual em ~junho de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (o padrão) e Claude Haiku 4.5. Nomes de modelos, preços e recursos de produtos mudam rapidamente - verifique os detalhes atuais em platform.claude.com/docs antes de confiar neles.