SpyBara
Go Premium

quickstart.md 2026-10-06 23:59 UTC to 2026-10-07 19:00 UTC

This page contains 55 additions and 89 deletions.

2026
Tue 6 23:59 Wed 7 20:57

Início rápido

Instale o Claude Code no seu terminal, faça login e use a CLI para explorar sua base de código e fazer sua primeira alteração de código.

Este guia de início rápido aborda o Claude Code no seu terminal: como instalar a CLI, fazer login a partir da sua primeira sessão e usá-lo para tarefas comuns de desenvolvimento no seu próprio projeto.

Antes de começar

Certifique-se de que você tem:

Passo 1: Instale Claude Code

Para instalar Claude Code, abra um terminal e execute o comando para seu sistema. Se você nunca usou um terminal antes, o guia de terminal mostra como abrir um e colar o comando.

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

No Windows, seu prompt mostra PS C:\ quando você está no PowerShell e C:\ sem o PS quando você está no CMD.

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Quando o instalador terminar, abra uma nova janela de terminal e execute claude --version. Uma instalação funcionando imprime um número de versão. Se seu shell disser que claude não foi encontrado ou não é reconhecido, o diretório de instalação ainda não está em seu PATH: consulte Corrija seu PATH.

Se você vir The token '&&' is not a valid statement separator, você está no PowerShell, não no CMD. Se você vir 'irm' is not recognized as an internal or external command, você está no CMD, não no PowerShell.

Se o comando de instalação falhar com syntax error near unexpected token '<', um 403, ou qualquer outro erro, consulte Solucionar problemas de instalação para corresponder o erro a uma correção e para métodos alternativos de instalação.

Git for Windows é recomendado no Windows nativo para que Claude Code possa usar a ferramenta Bash. Se Git for Windows não estiver instalado, Claude Code usa PowerShell como ferramenta de shell. Configurações WSL não precisam de Git for Windows.

Você também pode instalar com apt, dnf, ou apk no Debian, Fedora, RHEL e Alpine.

Para confirmar que a instalação funcionou, execute:

claude --version

O comando imprime um número de versão seguido por (Claude Code).

Passo 2: Inicie sua primeira sessão

Abra seu terminal em qualquer diretório de projeto e inicie o Claude Code:

cd /path/to/your/project
claude

Substitua /path/to/your/project pelo caminho do projeto em que você deseja trabalhar.

O Claude Code solicita que você faça login no primeiro uso. Para contas de assinatura do Claude ou do Console, siga as instruções para concluir a autenticação no seu navegador. Se você definiu a variável de ambiente ANTHROPIC_API_KEY e aprovar a chave quando o Claude Code perguntar se deve usá-la, o Claude Code pula o prompt de login.

Você pode fazer login usando qualquer um destes tipos de conta:

Depois de fazer login, suas credenciais são armazenadas e você não precisará fazer login novamente. Saiba mais em Gerenciamento de credenciais.

O prompt do Claude Code aparece com a versão, o modelo atual e o diretório de trabalho exibidos acima dele. Digite /help para ver os comandos disponíveis ou /resume para continuar uma conversa anterior. Para trocar de conta mais tarde ou autenticar novamente, digite /login dentro da sessão em execução.

Passo 3: Faça sua primeira pergunta

Experimente um destes comandos:

what does this project do?

Claude analisará seus arquivos e fornecerá um resumo. Você também pode fazer perguntas mais específicas:

what technologies does this project use?

where is the main entry point?

explain the folder structure

Você também pode perguntar ao Claude sobre suas próprias capacidades:

what can Claude Code do?

how do I create custom skills in Claude Code?

can Claude Code work with Docker?

Passo 4: Faça sua primeira alteração de código

Experimente uma tarefa pequena:

add a hello world function to the main file

O Claude Code encontra o arquivo apropriado e mostra a alteração para você. Se ele perguntar antes de fazer a alteração, selecione Yes para aprovar.

O modo de permissão da sessão define quais ações o Claude pode realizar sem perguntar a você primeiro. Pressione Shift+Tab a qualquer momento para alternar o modo de permissão da sessão em que você está.

Passo 5: Use o Git com o Claude Code

O Claude Code torna as operações do Git conversacionais:

what files have I changed?

commit my changes with a descriptive message

Você também pode solicitar operações do Git mais complexas:

create a new branch called feature/quickstart

show me the last 5 commits

help me resolve merge conflicts

Passo 6: Corrija um bug ou adicione um recurso

Descreva o que você deseja em linguagem natural:

add input validation to the user registration form

Ou corrija problemas existentes:

there's a bug where users can submit empty forms - fix it

Passo 7: Teste outros fluxos de trabalho comuns

Existem várias maneiras de trabalhar com o Claude:

Refatorar código

refactor the authentication module to use async/await instead of callbacks

Escrever testes

write unit tests for the calculator functions

Atualizar documentação

update the README with installation instructions

Revisão de código

review my changes and suggest improvements

Comandos essenciais

Aqui estão os comandos mais importantes para uso diário. Comandos shell são executados a partir do seu terminal para iniciar ou retomar Claude Code. Comandos de sessão são executados dentro do Claude Code após ele iniciar.

Comandos shell

Comando O que faz Exemplo
claude Iniciar modo interativo claude
claude "task" Iniciar modo interativo com um prompt inicial claude "fix the build error"
claude -p "query" Executar consulta única, depois sair claude -p "explain this function"
claude -c Continuar conversa mais recente no diretório atual claude -c
claude -r Retomar uma conversa anterior claude -r

Comandos de sessão

Comando O que faz Exemplo
/clear Limpar histórico de conversa /clear
/help Mostrar comandos disponíveis /help
/exit ou Ctrl+D duas vezes Sair do Claude Code /exit

Veja a referência CLI para a lista completa de comandos shell e a referência de comandos para a lista completa de comandos de sessão.

Dicas profissionais para iniciantes

Para mais, veja melhores práticas e fluxos de trabalho comuns.

Em vez de: "corrigir o bug" 
Tente: "corrigir o bug de login onde os usuários veem uma tela em branco após inserir credenciais incorretas"
Use instruções passo a passo

Divida tarefas complexas em etapas:

1. criar uma nova tabela de banco de dados para perfis de usuário
2. criar um endpoint de API para obter e atualizar perfis de usuário
3. construir uma página da web que permite aos usuários ver e editar suas informações
Deixe Claude explorar primeiro

Antes de fazer alterações, deixe Claude entender seu código:

analisar o esquema do banco de dados

construir um painel mostrando produtos que são devolvidos com mais frequência por nossos clientes do Reino Unido
Economize tempo com atalhos
  • Digite / para ver todos os comandos e skills disponíveis para você
  • Use Tab para conclusão de comando
  • Pressione ↑ para histórico de comando
  • Pressione Shift+Tab para alternar modos de permissão

Próximos passos

Agora que você aprendeu o básico, explore recursos mais avançados:

Consulte a configuração avançada para opções de instalação, atualizações manuais ou instruções de desinstalação.

Obtendo ajuda

  • Em Claude Code: digite /help ou faça uma pergunta do tipo "como faço para"
  • Documentação: navegue pelos outros guias neste site
  • Cursos: Faça Claude Code 101 e outros cursos gratuitos no seu próprio ritmo em Claude Academy
  • Comunidade: Junte-se ao servidor do Discord para dicas e suporte