O que é Claude Code
~15 min Iniciante Parte 1

O que é Claude Code

Conheça o agente de IA de linha de comando da Anthropic e como ele opera diretamente no seu ambiente de desenvolvimento

Objetivos

  • Entender o que é Claude Code e como ele difere de outros assistentes de IA
  • Instalar e configurar Claude Code no seu ambiente
  • Autenticar com a API da Anthropic
  • Executar sua primeira sessão interativa
  • Compreender a arquitetura de ferramentas do Claude Code

O que é Claude Code

Claude Code é um agente de IA de linha de comando desenvolvido pela Anthropic. Diferente de chatbots tradicionais que vivem em interfaces web, o Claude Code opera diretamente no seu terminal com acesso real ao seu ambiente de desenvolvimento.

Isso significa que ele pode ler e escrever arquivos, executar comandos shell, interagir com git, instalar dependências e realizar qualquer tarefa que você faria no terminal — tudo de forma autônoma ou com sua supervisão.

Claude Code usa os modelos Claude da Anthropic (Opus, Sonnet e Haiku) como seu backend de inteligência. Você escolhe o modelo de acordo com a complexidade da tarefa e o custo que está disposto a pagar.

Por que usar Claude Code

Veja como o Claude Code se compara a outras ferramentas de IA para desenvolvedores:

Feature Claude Code ChatGPT GitHub Copilot
Acesso ao filesystem Total Nenhum Parcial (no editor)
Executa comandos shell Sim Não Não
Edição multi-arquivo Sim Não Sim
Hooks e automação Sim Não Não
Subagentes paralelos Sim Não Não
Integração com git Nativa Não Parcial
Contexto do projeto Via CLAUDE.md Manual (paste) Parcial (workspace)
Uso via terminal CLI nativo Não Não

Pré-requisitos

Antes de instalar o Claude Code, você precisa ter:

  • Node.js 18+ instalado (verifique com node --version)
  • npm ou outro package manager
  • Uma conta Anthropic em console.anthropic.com
  • Uma API key da Anthropic (gerada no Console)

Instalação

# Instalar globalmente via npm
npm install -g @anthropic-ai/claude-code

# Verificar a instalação
claude --version

# Exemplo de saída esperada:
# claude v1.x.x

# Iniciar o Claude Code pela primeira vez
claude
Info: Em ambientes corporativos com proxies ou registries privados, pode ser necessário configurar o npm para usar o registry correto. Use npm config set registry <url> ou configure via variáveis de ambiente. O Claude Code também suporta ANTHROPIC_BASE_URL para apontar para gateways de API internos.

Autenticação com API Key

# Opção 1: Variável de ambiente (recomendado para desenvolvimento)
export ANTHROPIC_API_KEY="sk-ant-api03-..."

# Adicionar ao seu .bashrc ou .zshrc para persistir
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-..."' >> ~/.zshrc
source ~/.zshrc

# Opção 2: Login interativo (salva credenciais localmente)
claude auth login

# Verificar autenticação
claude auth status
Atenção: NUNCA commite sua API key em repositórios. Use variáveis de ambiente ou arquivos .env listados no .gitignore. A API key começa com sk-ant- e deve ser tratada como uma senha — quem a tiver pode usar sua conta e incorrer em custos.

Sua primeira sessão

Ao executar claude pela primeira vez, você verá uma interface REPL (Read-Eval-Print Loop) no terminal. A interface mostra:

  • O modelo em uso (ex: claude-sonnet-4-6)
  • O diretório de trabalho atual
  • Um prompt para você digitar sua mensagem

Você pode pedir qualquer coisa: analisar código, criar arquivos, executar comandos, fazer perguntas sobre seu projeto. O Claude Code vai usar suas ferramentas para completar a tarefa, pedindo confirmação antes de ações potencialmente destrutivas.

# Inicie o Claude Code
claude

# Você verá algo como:
# ╭─────────────────────────────────────╮
# │ Claude Code v1.x.x                  │
# │ Model: claude-sonnet-4-6            │
# │ Working dir: /seu/projeto           │
# ╰─────────────────────────────────────╯
# >

# Digite sua primeira pergunta:
# > liste os arquivos do diretório atual

# Claude Code vai executar ls e mostrar o resultado
# > qual é a estrutura do projeto?

# Claude Code vai ler os arquivos e explicar a estrutura

Como o Claude Code funciona por baixo dos panos

O Claude Code opera através de um conjunto de ferramentas que permitem ao modelo interagir com seu ambiente. Cada vez que você faz uma solicitação, o modelo decide quais ferramentas usar e em que ordem.

Ferramentas principais

Ferramenta O que faz
ReadLê o conteúdo de arquivos
WriteCria ou sobrescreve arquivos
EditFaz edições cirúrgicas em arquivos existentes
BashExecuta comandos shell
GlobBusca arquivos por padrão
GrepBusca conteúdo dentro de arquivos
WebFetchAcessa URLs (documentação, APIs)
TodoWriteGerencia tarefas durante sessões longas

O modelo usa essas ferramentas de forma encadeada: lê arquivos para entender o contexto, planeja a solução, escreve ou edita arquivos, executa testes — tudo de forma autônoma.

Dica: Para projetos complexos, sempre inicie a sessão pedindo ao Claude Code para "explorar o projeto e entender sua estrutura antes de fazer qualquer mudança". Isso garante que ele tenha contexto suficiente para tomar decisões melhores.

Exercício Prático

Primeira instalação e sessão — Instale o Claude Code, configure sua API key e execute seu primeiro comando para listar arquivos do diretório.

  1. Abra seu terminal
  2. Execute npm install -g @anthropic-ai/claude-code
  3. Configure sua API key: export ANTHROPIC_API_KEY='sua-key-aqui'
  4. Execute claude --version para verificar a instalação
  5. Navegue até um projeto existente: cd /seu/projeto
  6. Execute claude "liste os arquivos do diretório atual e explique para que serve cada um"
  7. Observe como o Claude Code usa a ferramenta Bash para listar os arquivos e Read para entender cada um
Resultado esperado: O Claude Code deve listar os arquivos do diretório e fornecer uma explicação do propósito de cada arquivo, demonstrando que ele realmente leu e compreendeu o contexto do projeto.

Recursos

0%