Claude Code: Guia Completo de Comandos, Skills e MCPs para Desenvolvedores

Se você trabalha com desenvolvimento de software, provavelmente já ouviu falar do Claude Code — a CLI oficial da Anthropic que transforma o Claude em um assistente de programação direto no seu terminal. Diferente das interfaces web tradicionais, o Claude Code oferece uma experiência terminal-first que se integra naturalmente ao fluxo de trabalho de desenvolvedores.

Neste guia completo, vou cobrir desde os comandos básicos até funcionalidades avançadas como criação de skills personalizadas e instalação de MCPs (Model Context Protocol). Você vai aprender a extrair o máximo dessa ferramenta e turbinar sua produtividade.

Comandos Essenciais do Claude Code

O Claude Code possui mais de 40 comandos slash integrados. Vamos aos mais importantes organizados por categoria.

Navegação e Controle

/help              # Exibe ajuda detalhada sobre comandos disponíveis
/clear             # Limpa o histórico da conversa atual
/compact           # Comprime o contexto mantendo informações importantes
/exit              # Encerra a sessão do Claude Code
/context           # Mostra uso atual de tokens e breakdown do contexto

O comando /clear é especialmente útil entre tarefas independentes. Limpar o contexto regularmente ajuda a economizar tokens e evita que informações de tarefas anteriores interfiram nas novas.

Comandos de Projeto

/init              # Inicializa projeto criando CLAUDE.md automaticamente
/memory            # Edita arquivos de memória do projeto
/add-dir           # Adiciona diretórios adicionais ao contexto

O /init é o primeiro comando que você deve executar em um novo projeto. Ele analisa sua codebase e cria um arquivo CLAUDE.md com informações relevantes sobre arquitetura, comandos e convenções.

Comandos de Código

/review            # Solicita revisão de código das suas alterações
/security-review   # Executa auditoria completa de segurança

Esses comandos são valiosos antes de fazer commits. O /security-review analisa vulnerabilidades comuns como SQL injection, XSS e outras do OWASP Top 10.

Configuração e Status

/config            # Abre interface de configurações
/model             # Seleciona ou troca o modelo de IA
/permissions       # Visualiza e gerencia permissões de ferramentas
/mcp               # Gerencia conexões com servidores MCP
/status            # Exibe status atual da sessão
/cost              # Mostra estatísticas de uso de tokens

Gerenciamento de Conversas

Uma das funcionalidades mais poderosas do Claude Code é a capacidade de retomar conversas anteriores, mantendo todo o contexto de sessões passadas.

Retomando Conversas Anteriores

Você pode continuar de onde parou usando flags na linha de comando:

claude --continue              # Retoma a conversa mais recente
claude -c                      # Atalho para --continue
claude --resume                # Abre picker interativo para escolher sessão
claude -r "abc123"             # Retoma conversa específica pelo ID

O picker interativo do --resume mostra suas conversas recentes com timestamps e nomes de projeto, facilitando encontrar a sessão desejada.

Onde Ficam as Conversas

O Claude Code armazena seu histórico em dois locais:

• Índice: ~/.claude/history.jsonl — metadados das conversas
• Conversas completas: ~/.claude/projects/ — organizadas por caminho do projeto

Comandos de Sessão

Durante uma sessão ativa, você pode gerenciar o contexto:

/clear             # Limpa histórico completamente
/compact           # Sumariza conversa para economizar tokens
/context           # Verifica uso atual de tokens
/export filename   # Exporta conversa para arquivo
/rewind            # Volta a um ponto específico da conversa

O Claude Code faz compactação automática quando atinge 95% do limite de 200K tokens, mas você pode forçar manualmente com /compact quando necessário.

Modos de Pensamento Estendido

Uma funcionalidade exclusiva do Claude Code são os modos de pensamento estendido. Eles alocam mais recursos computacionais para análises mais profundas.

Níveis de Pensamento

Variações Aceitas

O Claude Code reconhece várias formas de solicitar pensamento estendido:

Nível intermediário (~10K tokens):

• think more
• think about it
• think deeply
• think a lot
• think hard

Nível máximo (~32K tokens):

• think harder
• think intensely
• think longer
• think really hard
• think super hard
• think very hard
• ultrathink

Quando Usar Cada Nível

• Standard (4K): Correções simples, adição de features pequenas, formatação de código
• Megathink (10K): Integração com APIs de terceiros, otimização de queries, reestruturação modular
• Ultrathink (32K): Migrações de banco de dados, decisões arquiteturais, resolução de problemas sistêmicos, design de novos patterns

Importante: Os modos de pensamento funcionam apenas no terminal do Claude Code. Eles não funcionam na interface web (claude.ai) ou via API direta.

Criando Skills e Comandos Personalizados

Você pode estender o Claude Code criando seus próprios comandos e skills.

Comandos Personalizados

Comandos são arquivos Markdown salvos em diretórios específicos:

Comandos do projeto:    .claude/commands/
Comandos pessoais:      ~/.claude/commands/

Criando um Comando

1. Crie o diretório: .claude/commands/
2. Adicione um arquivo Markdown: fix-issue.md
3. Use $ARGUMENTS para receber parâmetros

Exemplo: .claude/commands/fix-issue.md

---
description: "Corrige uma issue do GitHub"
argument-hint: "issue-id"
allowed-tools: ["Bash(git:*)", "Bash(gh:*)", "Read", "Grep"]
model: "claude-sonnet-4-5"
---

# Fix GitHub Issue

Analise e corrija a issue #$ARGUMENTS do repositório atual.

## Passos:
1. Leia os detalhes da issue usando `gh issue view $ARGUMENTS`
2. Entenda o problema e identifique arquivos relevantes
3. Proponha e implemente a solução
4. Crie um commit descritivo

Uso: /fix-issue 42

Frontmatter Disponível

• description — Aparece na ajuda do comando
• argument-hint — Indica argumentos esperados
• allowed-tools — Restringe ferramentas disponíveis
• model — Define modelo específico para o comando

Namespacing com Diretórios

Organize comandos em subdiretórios para criar namespaces:

.claude/commands/
├── fix-issue.md           → /fix-issue
└── db/
    ├── migrate.md         → /db:migrate
    └── seed.md            → /db:seed

Skills Avançadas

Skills são mais poderosas que comandos simples, permitindo workflows complexos com ativação automática.

Estrutura de uma Skill:

~/.claude/skills/minha-skill/
├── SKILL.md           # Definição principal
├── REFERENCE.md       # Material de referência
└── examples.md        # Exemplos de uso

Exemplo de SKILL.md:

---
description: "Automatiza deploy para produção"
---

# Deploy Skill

Esta skill gerencia deploys para produção de forma segura.

## Quando Ativar
- Usuário menciona "deploy", "produção" ou "release"
- Arquivos de configuração de deploy são modificados

## Workflow
1. Executar testes automatizados
2. Validar variáveis de ambiente
3. Criar tag de release
4. Executar deploy
5. Verificar health check

Diferença entre Comandos e Skills:

Instalação e Configuração de MCPs

MCPs (Model Context Protocol) são servidores que estendem as capacidades do Claude Code com ferramentas e integrações especializadas.

O que são MCPs

MCPs permitem que o Claude acesse:

• Ferramentas e serviços externos
• Dados em tempo real de APIs
• Conhecimento especializado de domínio
• Integrações customizadas com sua infraestrutura

Comandos de MCP

claude mcp add [nome]              # Adiciona servidor globalmente
claude mcp add [nome] --scope user # Adiciona ao escopo do usuário
claude mcp list                    # Lista servidores configurados
claude mcp remove [nome]           # Remove um servidor
claude mcp get [nome]              # Testa conexão com servidor

Dentro do Claude Code, use /mcp para ver o status de todos os servidores conectados.

MCPs Recomendados

GitHub MCP

Permite operações completas com repositórios, PRs e issues:

{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxx"
    }
  }
}

Firebase MCP

Integração completa com Firebase (database, hosting, auth):

{
  "firebase-mcp": {
    "command": "npx",
    "args": ["-y", "@anthropic/firebase-mcp"],
    "env": {
      "SERVICE_ACCOUNT_KEY_PATH": "/path/to/serviceAccountKey.json"
    }
  }
}

Playwright MCP

Automação de browser para testes e scraping:

{
  "playwright": {
    "command": "npx",
    "args": ["-y", "@anthropic/mcp-server-playwright"]
  }
}

Context7 MCP

Gerenciamento estendido de contexto e documentação:

{
  "context7": {
    "command": "npx",
    "args": ["-y", "@anthropic/context7-mcp"]
  }
}

Configuração de MCPs

Os MCPs são configurados em arquivos JSON específicos:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Escopos de configuração:

• local (padrão): Apenas projeto atual
• project: Compartilhado via .mcp.json no repositório
• user: Disponível em todos os seus projetos

Troubleshooting de MCPs

Se um servidor aparecer como "failed" no /mcp:

1. Verifique se o pacote está instalado corretamente
2. Confirme que variáveis de ambiente estão definidas
3. Valide credenciais e tokens
4. Teste a conexão com claude mcp get [nome]

Windows (sem WSL): Servidores locais precisam do wrapper cmd /c:

claude mcp add --transport stdio meu-server -- cmd /c npx -y @some/package

Configurando o CLAUDE.md

O arquivo CLAUDE.md é a forma mais importante de personalizar o comportamento do Claude Code no seu projeto.

O que Incluir

# CLAUDE.md

## Visão Geral
Descreva brevemente o projeto e sua arquitetura.

## Comandos
yarn dev          # Desenvolvimento
yarn build        # Build de produção
yarn test         # Executar testes

## Estrutura
src/
├── components/   # Componentes React
├── services/     # Lógica de negócio
└── utils/        # Utilitários

## Convenções
- Use TypeScript strict mode
- Prefer named exports
- Testes devem estar junto ao código

## Stack
- Next.js 14 (App Router)
- TypeScript
- Tailwind CSS
- PostgreSQL

Criando Automaticamente

claude
/init    # Claude analisa o projeto e gera CLAUDE.md

Dicas para um Bom CLAUDE.md

1. Seja conciso — Use bullet points, não parágrafos longos
2. Seja declarativo — Escreva regras claras e diretas
3. Evite redundância — Não explique estruturas óbvias
4. Foque em regras — Inclua apenas o que Claude precisa saber
5. Sem comentários — Exclua informações "nice-to-have"

Hierarquia de Configuração

O Claude Code usa três níveis de settings:

1. User (~/.claude/settings.json) — Aplicado a todos os projetos
2. Project (.claude/settings.json) — Compartilhado via git
3. Local (.claude/settings.local.json) — Overrides pessoais, não commitado

Exemplo de .claude/settings.json:

{
  "permissions": {
    "allow": [
      "Bash(git:*)",
      "Bash(npm:*)",
      "Read",
      "Write"
    ],
    "deny": [
      "Bash(rm -rf:*)"
    ]
  }
}

Dicas e Melhores Práticas

Gerenciamento de Tokens

1. Use /clear frequentemente — Limpe entre tarefas independentes
2. Monitore com /context — Acompanhe o uso de tokens
3. Deixe o auto-compact agir — Ativa automaticamente em 95% do limite
4. Retome conversas — Mantém consistência em projetos longos

Workflow Recomendado

# Iniciar sessão
claude

# Trabalhar na tarefa
# ...

# Revisar código antes de commitar
/review

# Auditoria de segurança se necessário
/security-review

# Limpar contexto para próxima tarefa
/clear

Projetos Paralelos

Use git worktrees para trabalhar em features independentes:

git worktree add ../feature-branch feature/nova-feature
cd ../feature-branch
claude    # Sessão independente com contexto limpo

Segurança

1. Revise permissões — Use /permissions para controlar acesso
2. Configure frontmatter — Restrinja tools em comandos customizados
3. Variáveis de ambiente — Mantenha secrets em .env (fora do git)
4. Confirme operações destrutivas — Configure para pedir confirmação

Comandos Personalizados

1. Identifique padrões repetitivos no seu workflow
2. Crie comandos em .claude/commands/
3. Teste e refine os prompts
4. Compartilhe via git com sua equipe

Conclusão

O Claude Code é uma ferramenta poderosa que vai muito além de um simples chatbot. Com os comandos certos, configuração adequada e uso estratégico dos modos de pensamento, você pode transformar significativamente sua produtividade como desenvolvedor.

Comece com os comandos básicos (/help, /clear, /init), explore os modos de pensamento conforme a complexidade das tarefas, e gradualmente adicione MCPs e comandos personalizados ao seu workflow.

Para mais informações, consulte a documentação oficial do Claude Code.

Dica final: Use ultrathink quando estiver tomando decisões arquiteturais importantes. Os tokens extras de pensamento fazem diferença real na qualidade das recomendações.