Objetivo: Em cerca de 15 minutos, você instalará o Claude Code, fará login e completará sua primeira alteração assistida por IA. Este guia cobre apenas o necessário no primeiro dia; links para material mais aprofundado aparecem no final.
Etapa 1: Instalar Claude Code (2 minutos)
Escolha o comando que corresponde à sua máquina e cole-o em um terminal.
Sua configuração | Comando |
macOS / Linux / WSL | `curl -fsSL https://claude.ai/install.sh |
Windows (PowerShell) | |
Homebrew |
|
npm (Node 18+) |
|
Dica: Não execute o npm install com sudo, pois isso causa problemas de permissão de arquivo posteriormente.
Verifique a instalação:
claude --version
Etapa 2: Fazer login (2 minutos)
A forma como você se autentica depende de como sua organização provisionou o acesso. Escolha uma das seguintes opções:
Se sua organização usa… | Faça isto |
Assentos Claude Enterprise | Execute |
Uma chave de API do Anthropic Console | Execute |
Amazon Bedrock | Execute |
Google Vertex AI | Execute |
Se você não tiver certeza de qual método se aplica, verifique com seu administrador ou tente /login primeiro, que é o padrão para a maioria das organizações.
Etapa 3: Abrir um projeto (1 minuto)
cd path/to/your/project claude
O Claude Code lê seus arquivos sob demanda, portanto não há nada para fazer upload ou anexar. Simplesmente inicie-o dentro do repositório em que deseja trabalhar.
Etapa 4: Entender a única regra de segurança (1 minuto)
Claude sempre pedirá permissão antes de alterar um arquivo ou executar um comando. Quando propõe uma alteração, você verá um diff e três opções:
Sim — aplicar esta alteração única.
Sim, e não pergunte novamente para edições — aprovar automaticamente edições de arquivo pelo restante da sessão.
Não — rejeitar a alteração e explicar por quê.
Você pode pressionar Shift+Tab a qualquer momento para alternar entre modos (Planejar → Aceitar Edições → padrão). Se uma alteração produzir um resultado inesperado, seu histórico git permanecerá intacto até você fazer commit, então git checkout desfará.
Etapa 5: Cinco coisas para tentar primeiro
Copie e cole estes no prompt um de cada vez. Cada exemplo demonstra uma capacidade principal diferente.
1. Orientar-se
Give me a 5-bullet summary of what this codebase does and where the entry point is.
Por que isso é útil: Mostra como Claude explora arquivos por conta própria, sem ser apontado para caminhos específicos.
2. Encontrar algo
Where is user authentication handled? Show me the file and the key function.
Por que isso é útil: Geralmente é mais rápido que grep quando você não conhece o símbolo ou nome de arquivo exato.
3. Fazer uma edição segura
Add a docstring to the function <name> in <file>. Keep it to 2 lines.
Por que isso é útil: Permite que você pratique revisar e aprovar um diff em uma alteração de baixo risco.
4. Corrigir algo real
This test is failing: <paste the error>. Find the cause and fix it.
Por que isso é útil: Este é o fluxo de trabalho principal — você descreve o sintoma e Claude investiga e propõe uma correção.
5. Deixar que ele gerencie git
Stage my changes and write a commit message that follows our existing style.
Por que isso é útil: Claude pode executar git em seu nome (com aprovação) e corresponderá às convenções de commit existentes do seu repositório.
Etapa 6: Antes de terminar pelo dia
Execute isto uma vez por projeto:
/init
Isso gera um arquivo CLAUDE.md na raiz do seu projeto que captura as convenções do seu código. Claude o lê automaticamente no início de cada sessão, portanto respostas futuras já estarão personalizadas para seu projeto. É a etapa de configuração de maior valor que você pode fazer.
Próximos passos
Você agora instalou o Claude Code, autenticou, fez uma edição e configurou a memória do projeto. Quando estiver pronto para ir além, a documentação oficial cobre memória e CLAUDE.md, comandos de barra e atalhos do modo interativo em profundidade.
Se você encontrou problemas durante a instalação ou login, consulte o guia de solução de problemas.