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
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
.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 |
|---|---|
Read | Lê o conteúdo de arquivos |
Write | Cria ou sobrescreve arquivos |
Edit | Faz edições cirúrgicas em arquivos existentes |
Bash | Executa comandos shell |
Glob | Busca arquivos por padrão |
Grep | Busca conteúdo dentro de arquivos |
WebFetch | Acessa URLs (documentação, APIs) |
TodoWrite | Gerencia 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.
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.
- Abra seu terminal
- Execute
npm install -g @anthropic-ai/claude-code - Configure sua API key:
export ANTHROPIC_API_KEY='sua-key-aqui' - Execute
claude --versionpara verificar a instalação - Navegue até um projeto existente:
cd /seu/projeto - Execute
claude "liste os arquivos do diretório atual e explique para que serve cada um" - Observe como o Claude Code usa a ferramenta Bash para listar os arquivos e Read para entender cada um