O Que É o Claude Code? Guia Completo da Instalação ao Primeiro Uso

O Que É o Claude Code

Claude Code é um assistente de programação com IA baseado em terminal, criado pela Anthropic. Diferentemente de extensões do VS Code, ele roda como uma ferramenta CLI — e essa é sua característica principal. Ele compreende toda a sua base de código e pode editar arquivos, criar novos, executar comandos e lidar com operações Git, tudo em um só lugar.

Como não depende de nenhum editor específico, você pode usá-lo em qualquer ambiente de desenvolvimento.

Instalação

Pré-requisitos

• Node.js 18 ou superior instalado
• Uma conta Anthropic (plano Max ou acesso à API)

Instalar via npm

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

Após a instalação, verifique:

claude --version

Autenticação Inicial

A autenticação é necessária na primeira execução.

claude

O comando abrirá seu navegador para autenticação com sua conta Anthropic. Após concluir a autenticação, você retornará ao terminal e estará pronto para começar.

Uso Básico

Modo Interativo

Basta digitar claude no diretório raiz do seu projeto para iniciar uma sessão interativa.

cd my-project
claude

Dentro da sessão, você pode dar instruções em linguagem natural:

> Explique a estrutura deste projeto
> Adicione uma função de validação em src/utils/helper.ts
> Execute os testes e certifique-se de que passem

Modo de Comando Único

Para executar um único comando sem iniciar uma sessão interativa, use a flag -p:

claude -p "Verifique as dependências no package.json e liste as que não estão sendo usadas"

Entrada via Pipe

Você também pode enviar dados para o Claude Code via stdin:

cat error.log | claude -p "Analise este log de erros e sugira uma correção"

git diff | claude -p "Revise este diff"

Comandos Slash Úteis

Aqui estão alguns comandos slash práticos que você pode usar durante uma sessão:

Comando	Descrição
/help	Mostrar ajuda
/clear	Limpar histórico da conversa
/compact	Resumir e comprimir a conversa
/init	Gerar um arquivo CLAUDE.md
/cost	Mostrar uso de tokens da sessão atual

O Que Experimentar Primeiro

1. Entenda Seu Projeto

> Explique a arquitetura deste projeto

O Claude Code lê todos os arquivos e fornece uma visão geral da estrutura.

2. Gere um CLAUDE.md

> /init

Isso gera automaticamente um arquivo de configuração que informa ao Claude Code sobre as regras e convenções de código do seu projeto.

3. Corrija um Bug

> Execute npm test, encontre os testes que estão falhando e corrija-os

O Claude Code cuida de todo o fluxo — executar testes, identificar erros e corrigir o código.

Configurações de Permissão

Como o Claude Code pode editar arquivos e executar comandos, ele solicita confirmação para cada ação. Você pode pré-aprovar comandos confiáveis nas suas configurações:

// .claude/settings.json
{
  "permissions": {
    "allow": [
      "Read",
      "Bash(npm test)",
      "Bash(npm run lint)"
    ]
  }
}

Conclusão

O Claude Code é fácil de instalar e permite que você comece a trabalhar com um assistente de programação com IA diretamente do terminal. Comece executando claude em um diretório de projeto e experimente coisas como explicações de código ou refatoração. Em próximos artigos, abordaremos comparações com outras ferramentas de IA e workflows mais avançados.