Modulo 2.1: Introducao ao Claude Code

🚀 O que e Claude Code

Claude Code e a interface de linha de comando (CLI) oficial da Anthropic para interagir com Claude em projetos de desenvolvimento. E mais do que um chatbot - e um agente de codigo completo que pode ler, escrever, executar comandos e automatizar tarefas.

💡 Por que Claude Code?

• Agente completo: Nao apenas responde - executa acoes no seu codigo
• Contexto de projeto: Entende a estrutura completa do seu repositorio
• Skills e MCP: Extensivel com skills customizadas e integrações externas
• Terminal nativo: Funciona onde voce ja trabalha - no terminal

Comparacao: Claude Code vs Outras Ferramentas

Feature	Claude Code	Chatbots Web	Copilot
Executa comandos	✓	✗	✗
Edita multiplos arquivos	✓	✗	~
Skills customizadas	✓	✗	✗
Integracao MCP	✓	✗	✗

📦 Instalacao e Requisitos

Claude Code e instalado via npm (Node Package Manager). Voce precisa de Node.js 18+ instalado no seu sistema antes de comecar.

Requisitos do Sistema

✓ Node.js: Versao 18 ou superior
✓ npm: Incluido com Node.js
✓ Sistema: macOS, Linux ou Windows (WSL recomendado)
✓ Terminal: Bash, Zsh ou compativel

Comandos de Instalacao

# Verificar versao do Node
node --version  # Deve ser v18.0.0 ou superior

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

# Verificar instalacao
claude --version

# Alternativa: usando npx (sem instalacao global)
npx @anthropic-ai/claude-code

💡 Dica: Atualizacao

Para atualizar o Claude Code para a versao mais recente, execute: npm update -g @anthropic-ai/claude-code

🔐 Autenticacao e API Keys

Claude Code oferece duas formas de autenticacao: login interativo (recomendado para uso pessoal) ou API key (para automacao e CI/CD).

Login Interativo (Recomendado)

claude login

Abre navegador para autenticacao OAuth. Mais seguro para uso diario.

API Key (Automacao)

export ANTHROPIC_API_KEY="sk-..."

Variavel de ambiente. Ideal para CI/CD e scripts.

⚠️ Seguranca de API Keys

✗ NUNCA commite API keys no Git
✗ NUNCA exponha em logs ou output
✓ Use variaveis de ambiente ou secrets manager
✓ Rotacione keys regularmente

⚙️ Configuracao Inicial

As configuracoes do Claude Code ficam em ~/.claude/settings.json. Este arquivo controla preferencias globais como modelo padrao, tema e permissoes.

Exemplo de settings.json

{
  "model": "claude-sonnet-4-20250514",
  "theme": "dark",
  "autoApprove": ["Read", "Glob", "Grep"],
  "permissions": {
    "allowedTools": ["Read", "Write", "Edit", "Bash"]
  }
}

Configuracoes Principais

model: Modelo Claude a usar (sonnet, opus, haiku)
theme: Tema visual (dark, light, auto)
autoApprove: Tools que executam sem confirmacao
permissions: Controle granular de acesso

💻 Primeiros Comandos

Apos instalacao e autenticacao, voce pode comecar a usar o Claude Code. Os comandos basicos sao intuitivos e seguem padroes de CLI comuns.

Comandos Essenciais

# Iniciar sessao interativa
claude

# Comando unico (one-shot)
claude -p "Explique este codigo" arquivo.js

# Ver ajuda
claude --help

# Ver versao
claude --version

# Continuar ultima sessao
claude --continue

# Usar modelo especifico
claude --model claude-opus-4-20250514

Flags Uteis

-p Prompt direto
--print Output sem interacao
--continue Retomar sessao
--model Especificar modelo

Slash Commands na Sessao

/help Ver comandos
/clear Limpar contexto
/cost Ver custos
/compact Compactar historia

🎯 Modos de Operacao

Claude Code oferece diferentes modos de operacao para diferentes casos de uso: interativo, one-shot e pipe.

💬

Modo Interativo (REPL)

Sessao de chat continua

claude

Ideal para: desenvolvimento, exploracao, tarefas complexas com multiplas iteracoes.

⚡

Modo One-Shot

Comando unico, resposta direta

claude -p "gere testes para utils.js" --print

Ideal para: scripts, automacao, CI/CD, tarefas simples.

🔀

Modo Pipe

Entrada via stdin

cat error.log | claude -p "analise este erro"

Ideal para: processar output de outros comandos, pipelines Unix.

📚 Resumo do Modulo

✓

Claude Code - CLI oficial da Anthropic para desenvolvimento assistido por IA

✓

Instalacao - npm install -g @anthropic-ai/claude-code (requer Node 18+)

✓

Autenticacao - claude login (interativo) ou ANTHROPIC_API_KEY (automacao)

✓

Configuracao - ~/.claude/settings.json para preferencias globais

✓

Modos - Interativo (REPL), one-shot (-p), pipe (stdin)

Proximo Modulo:

2.2 - Comandos Essenciais

← Voltar para Trilha Proximo Modulo →