Como configurar o Claude Code CLI: Quickstart de 5 minutos

Mais de 29.000 desenvolvedores na ServiceNow agora usam o Claude Code diariamente, e a Allianz implementou a ferramenta em toda a empresa no início de 2026. A curva de adoção da ferramenta reflete um padrão: uma vez que os desenvolvedores experimentam a codificação agêntica em seu próprio terminal, eles não voltam a copiar e colar de janelas de chat. Este quickstart leva você do zero a uma sessão funcional do Claude Code em cerca de cinco minutos, com configurações reais que você pode continuar usando depois.

Resumo: Instale o Claude Code via npm install -g @anthropic-ai/claude-code, autentique-se pelo navegador, crie um arquivo CLAUDE.md com o contexto do seu projeto e configure as permissões em .claude/settings.json. Adicione um hook do Prettier para formatar automaticamente os arquivos após cada edição. Toda a configuração leva menos de cinco minutos e persiste entre sessões.

Principais conclusões

Desenvolvedores solo: CLAUDE.md e um hook de formatação cobrem 80% do que você precisa. Comece com as permissões padrão e pré-aprove ferramentas conforme for ganhando confiança.
Líderes de equipe: Faça commit do .claude/settings.json no seu repositório para que toda a equipe compartilhe as mesmas listas de permissões e hooks.
Engenheiros de segurança: O modelo de permissões em três níveis (padrão, pré-aprovado, pular) mapeia diretamente para níveis de confiança. O modo padrão exige aprovação explícita para cada escrita e cada comando.

Pré-requisitos

Você precisa de três coisas antes de instalar o Claude Code:

Node.js 18 ou superior. O Claude Code é distribuído como um pacote npm. Verifique sua versão:

node --version
# v18.0.0 or higher

Se você precisar instalar ou atualizar o Node.js, use o nvm ou baixe diretamente em nodejs.org.

Uma conta Anthropic com acesso à API. Crie uma chave de API em console.anthropic.com em Settings > API Keys. O Claude Code cobra do seu saldo de API ou plano de assinatura Max. Mantenha a chave disponível para a etapa de autenticação.

Um terminal. O Claude Code funciona em qualquer emulador de terminal: Terminal.app, iTerm2, Windows Terminal, Alacritty ou o terminal integrado do VS Code. Eu recomendo um terminal com pelo menos 120 colunas de largura, já que o Claude Code exibe diffs de arquivos e saídas de ferramentas que se beneficiam de espaço horizontal.

Instalação

Instale o Claude Code globalmente via npm:

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

Verifique se a instalação foi bem-sucedida:

claude --version

Você deve ver um número de versão impresso no stdout. Se receber um erro “command not found”, certifique-se de que o diretório global de binários do npm está no seu PATH. Execute npm config get prefix e adicione o subdiretório /bin dessa saída ao seu PATH.

Na primeira execução, o Claude Code abre seu navegador no console da Anthropic para autenticação OAuth. Você faz login, autoriza, e o token é armazenado localmente em ~/.claude/. Alternativamente, você pode definir a variável de ambiente ANTHROPIC_API_KEY antes de iniciar. De qualquer forma, as credenciais ficam na sua máquina e são usadas apenas para autenticar as requisições à API.

Primeira sessão

Navegue até qualquer diretório de projeto e execute:

cd ~/Projects/my-app
claude

O Claude Code inicia uma sessão REPL interativa. Na primeira execução em um novo projeto, ele faz várias coisas automaticamente:

Escaneia a estrutura de diretórios para entender o layout do projeto
Lê arquivos de configuração como package.json, pyproject.toml ou Cargo.toml para identificar a stack tecnológica
Procura um arquivo CLAUDE.md na raiz do projeto para instruções específicas do projeto

Tente um prompt simples para confirmar que tudo funciona:

> Explain the structure of this project

O Claude lê seus arquivos, sintetiza a arquitetura e responde no terminal. Você verá as chamadas de ferramentas em tempo real (cada leitura de arquivo, cada comando executado) junto com uma solicitação de permissão antes de qualquer operação de escrita.

Configurando o CLAUDE.md

O CLAUDE.md é o arquivo mais importante para o uso eficaz do Claude Code. Ele fica na raiz do seu projeto e contém instruções que o Claude lê no início de cada sessão. Pense nele como um README para seu colaborador de IA.

Crie o arquivo:

touch CLAUDE.md

Aqui está um template prático para começar:

# My App

## Project Context
Express.js API with React frontend. PostgreSQL database.

## Stack
- Backend: Node.js 20, Express 4, TypeScript
- Frontend: React 18, Vite
- Database: PostgreSQL 16, Prisma ORM
- Testing: Vitest for unit tests, Playwright for e2e

## Code Standards
- Use async/await, never raw Promises
- All API endpoints need input validation with Zod
- Tests required for new endpoints before merging

## Commands
- `npm run dev` starts the dev server on port 3000
- `npm test` runs the test suite
- `npx prisma migrate dev` runs database migrations

Na minha experiência, as seções mais valiosas são as que previnem erros repetidos. Se o Claude continua usando CommonJS quando seu projeto usa ESM, adicione isso ao CLAUDE.md. Se há um comando de teste específico ou uma etapa de configuração do banco de dados, documente-o. O Claude lê o CLAUDE.md a cada sessão, então qualquer coisa que você colocar lá se torna uma instrução persistente.

Você também pode colocar um CLAUDE.md no seu diretório home (~/.claude/CLAUDE.md) para instruções globais que se aplicam a todos os projetos, e em subdiretórios para contexto que se aplica apenas a partes específicas de um monorepo.

Noções básicas de permissões

O Claude Code opera em três níveis de permissão que determinam quanta autonomia o agente tem:

Modo padrão pede permissão antes de cada escrita de arquivo, execução de comando ou ação destrutiva. Você vê exatamente o que o Claude pretende fazer e aprova ou rejeita cada etapa. Eu recomendo começar por aqui.

Permissões pré-aprovadas permitem que você adicione ferramentas e padrões específicos a uma lista de permissões, para que o Claude não pergunte toda vez. Você configura isso no .claude/settings.json do seu projeto:

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm test)",
      "Bash(npx prisma migrate dev)"
    ]
  }
}

Este exemplo permite que o Claude leia arquivos, pesquise no código-fonte e execute seus comandos de teste e migração sem perguntar. Ele ainda pede permissão antes de escrever arquivos ou executar qualquer outro comando bash.

Pular permissões perigosamente (--dangerously-skip-permissions) desativa todos os prompts de confirmação. Esta flag é destinada exclusivamente para pipelines de CI/CD e workflows automatizados onde nenhum humano está presente para aprovar. Nunca use em sessões interativas em um código-fonte que você valoriza.

O sistema de permissões é a razão pela qual o Claude Code é seguro para usar em projetos reais. Comece com o modo padrão, observe quais aprovações se tornam repetitivas e pré-aprove seletivamente apenas essas operações específicas.

Seu primeiro hook

Hooks são comandos shell que executam em pontos específicos do ciclo de vida do Claude Code. Eles fornecem garantias determinísticas sobre o comportamento probabilístico do LLM. Aqui está um primeiro hook prático: formatar automaticamente os arquivos após o Claude editá-los.

Crie ou edite o .claude/settings.json no seu projeto:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\" 2>/dev/null || true"
          }
        ]
      }
    ]
  }
}

Este hook é disparado após cada chamada das ferramentas Edit ou Write. O Claude Code define $FILE_PATH como o arquivo que foi modificado. O Prettier formata o arquivo no local, e || true garante que o hook não bloqueie o Claude se o Prettier não estiver instalado ou o tipo de arquivo não for suportado.

Outros hooks iniciais práticos que eu recomendo:

PreToolUse no Bash: Bloqueie comandos perigosos como rm -rf / ou git push --force
SessionStart: Injete a data atual, branch ativa do git ou variáveis de ambiente no contexto (o stdout dos hooks de SessionStart alimenta o contexto do Claude)
Stop: Execute sua suíte de testes automaticamente quando o Claude terminar uma tarefa

Hooks transformam o Claude Code de uma ferramenta conversacional em um ambiente de desenvolvimento governado. Mesmo um ou dois hooks bem escolhidos eliminam categorias inteiras de erros.

Próximos passos

Este quickstart cobre o essencial: instalação, sua primeira sessão, configuração do projeto, permissões e um hook inicial. Para a referência completa cobrindo todos os 5 sistemas principais (hierarquia do CLAUDE.md, o modelo completo de permissões, arquitetura de hooks, comandos slash personalizados e workflows multi-agente), leia O Guia Completo do Claude Code.

O guia cobre gerenciamento de janela de contexto, delegação para subagentes, ativação automática de skills e os padrões que emergem após meses de uso diário do Claude Code. Se você achou este quickstart útil, o guia completo é o próximo passo natural.

FAQ

Quanto custa o Claude Code?

O Claude Code suporta dois modelos de cobrança. O modelo pay-as-you-go da API cobra por token nas taxas padrão da API da Anthropic. Uma sessão típica de 30 a 60 minutos custa entre $0,50 e $3,00, dependendo do tamanho do código-fonte e do volume de geração. Alternativamente, o plano Max da Anthropic ($100/mês individual, $200/mês para equipes) inclui o uso do Claude Code com limites de taxa mais altos. Você pode monitorar o uso da API em console.anthropic.com.

Posso usar o Claude Code com o VS Code?

Sim. O Claude Code funciona em qualquer terminal, incluindo o terminal integrado do VS Code. Abra o painel do terminal no VS Code, navegue até o diretório do seu projeto e execute claude exatamente como faria em um terminal independente. O Claude Code lê e edita arquivos no disco, então as alterações aparecem imediatamente nas abas do seu editor VS Code. Não é necessária nenhuma extensão separada para o VS Code. Alguns desenvolvedores mantêm uma divisão de terminal dedicada para o Claude Code ao lado do editor, o que funciona bem para revisar as alterações conforme elas acontecem.

O Claude Code é seguro para usar em código-fonte de produção?

O modo de permissão padrão do Claude Code pede aprovação explícita antes de cada escrita de arquivo e cada execução de comando. Nada muda no disco sem sua confirmação. O sistema de permissões, combinado com hooks que podem bloquear operações perigosas como force pushes ou comandos shell destrutivos, torna-o prático para trabalho em produção. Eu uso o Claude Code diariamente em projetos que atendem usuários reais. O segredo é começar no modo padrão, entender o que cada chamada de ferramenta faz antes de aprová-la e pré-aprovar gradualmente apenas as operações em que você confia. O controle de versão é sua rede de segurança final: faça commit antes de iniciar qualquer sessão significativa do Claude Code para que você sempre possa reverter.