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:

• Um terminal ou prompt de comando aberto
• Um projeto de código para trabalhar
• Uma assinatura Claude (Pro, Max, Ultra, Team ou Enterprise), conta do Claude Console, ou acesso através de um provedor de nuvem suportado

[!NOTE]

Estes casos são abordados em outras páginas:

• Nunca usou um terminal antes: comece com o guia de terminal
• Quer usar o Claude Code em outro lugar que não seja o terminal: Claude Code também está disponível na web, como um aplicativo de desktop, em VS Code e IDEs JetBrains, no Slack, e em CI/CD com GitHub Actions e GitLab. Veja todas as interfaces.

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.

[tab] Instalação Nativa (Recomendado)

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

O comando de instalação não mostra nenhum progresso enquanto baixa o Claude Code. 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.

[!NOTE]

As instalações nativas são atualizadas automaticamente em segundo plano para mantê-lo na versão mais recente.

[tab] Homebrew

brew install --cask claude-code

Homebrew oferece dois casks. claude-code rastreia o canal de versão estável, que normalmente fica cerca de uma semana atrás e pula versões com regressões importantes. claude-code@latest rastreia o canal mais recente e recebe novas versões assim que são lançadas.

[!NOTE]

As instalações do Homebrew não são atualizadas automaticamente. Execute brew upgrade claude-code ou brew upgrade claude-code@latest, dependendo de qual cask você instalou, para obter os recursos mais recentes e correções de segurança.

[tab] WinGet

winget install Anthropic.ClaudeCode

[!NOTE]

As instalações do WinGet não são atualizadas automaticamente. Execute winget upgrade Anthropic.ClaudeCode periodicamente para obter os recursos mais recentes e correções de segurança.

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:

• Claude Pro, Max, Ultra, Team ou Enterprise (recomendado)
• Claude Console (acesso à API com créditos pré-pagos). No primeiro login, um workspace "Claude Code" é criado automaticamente no Console para rastreamento centralizado de custos.
• Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry (provedores de nuvem empresariais)
• Um gateway de apps do Claude auto-hospedado, se sua organização executar um: seu administrador pré-configura a URL do gateway, e /login abre diretamente na tela Cloud gateway para que você entre com o SSO corporativo

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?

[!NOTE]

O Claude Code lê os arquivos do seu projeto conforme necessário. Você não precisa adicionar contexto manualmente.

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

Experimente mais alguns prompts. Você pode pedir ao Claude para refatorar código, escrever testes, atualizar a documentação ou revisar suas alterações:

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

write unit tests for the calculator functions

update the README with installation instructions

review my changes and suggest improvements

[!TIP]

Converse com o Claude como você faria com um colega prestativo. Descreva o que você deseja alcançar, e ele ajudará você a chegar lá.

Comandos essenciais

Aqui estão os comandos mais importantes para uso diário, agrupados por onde você os executa.

Comandos shell

Execute estes a partir do seu terminal para iniciar ou retomar Claude Code.

Veja a referência CLI para a lista completa de comandos shell.

Comandos de sessão

Execute estes dentro do Claude Code após ele iniciar.

Veja 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.

[accordion] Seja específico com seus pedidos

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"

[accordion] 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

[accordion] 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

[accordion] 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:

• Como Claude Code funciona: entenda o loop agêntico, ferramentas integradas e como Claude Code interage com seu projeto
• Boas práticas: obtenha melhores resultados com prompting eficaz e configuração de projeto
• Fluxos de trabalho comuns: guias passo a passo para tarefas comuns
• Estenda Claude Code: personalize com CLAUDE.md, skills, hooks, MCP e muito mais

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