Cheat sheet do Claude Code

• Documento-resumo para desenvolvedores que organiza os principais comandos, atalhos, configurações, variáveis de ambiente, servidores MCP e configuração de agentes da versão mais recente do Claude Code
• A nova versão adiciona o modo headless (--bare), envio de mensagens para Discord/Telegram via MCP (--channels), frontmatter (effort) para skills/comandos slash, mudança de fork para /branch e recurso de retomada automática do SendMessage
• A maior parte dos comandos, como atalhos de teclado, servidores MCP, comandos slash, gerenciamento de skills e agentes e execução headless e controle remoto, está organizada de forma clara
• Suporte a alternância de visualização separada para Windows/Mac

---

Atalhos de teclado

• Controle geral

  • Ctrl C cancela entrada/geração, Ctrl D encerra a sessão, Ctrl L limpa a tela, Ctrl O alterna a saída detalhada, Ctrl R busca no histórico, Ctrl G abre o editor de prompt
  • Ctrl B executa em segundo plano, Ctrl T alterna a lista de tarefas, Ctrl V cola imagem, Ctrl F encerra o agente em segundo plano (requer 2 vezes), Esc desfaz

• Alternância de modo

  • Shift Tab percorre os modos de permissão, Alt P alterna o modelo, Alt T alterna o modo de raciocínio (thinking)

• Controle de entrada

  • Enter quebra de linha rápida, Ctrl J quebra de linha com sequência de controle

• Prefixos

  • / comando slash, ! executa bash diretamente, @ menciona arquivos e autocompleta

• Seletor de sessão

  • Navegar e expandir/recolher com as setas, P pré-visualização, R renomear, / buscar, A projeto inteiro, B branch atual

Gerenciamento de servidores MCP

• Adicionar servidor

  • --transport http HTTP remoto (recomendado), --transport stdio processo local, --transport sse SSE remoto

• Escopo

  • local (~/.claude.json), projeto (project.mcp.json), usuário (~/.claude.json)

• Comandos de gerenciamento

  • /mcp UI interativa, claude mcp list lista completa de servidores, claude mcp serve executa o CC como servidor MCP

• Elicitation Servers

  • Recurso de solicitação de entrada durante a tarefa (novo)

Comandos slash

• Relacionados à sessão

  • /clear, /compact, /resume, /rename, /branch, /cost, /context, /diff, /copy, /export

• Relacionados a configurações

  • /config, /model, /fast, /vim, /theme, /permissions, /effort, /color

• Relacionados a ferramentas

  • /init, /memory, /mcp, /hooks, /skills, /agents, /chrome, /reload-plugins

• Comandos especiais

  • /btw, /plan, /loop, /voice, /doctor, /rc, /pr-comments, /stats, /insights, /desktop, /remote-control, /stickers

Memória e estrutura de arquivos

• Localização do CLAUDE.md

  • projeto (./CLAUDE.md), pessoal (~/.claude/CLAUDE.md), organização (/etc/claude-code/Managed)

• Regras e imports

  • .claude/rules/*.md, ~/.claude/rules/*.md, é possível importar com @path/to/file

• Memória automática

  • Carregamento automático de MEMORY.md e arquivos por tópico em ~/.claude/projects//memory/

Fluxos de trabalho e dicas

• Plan Mode

  • Shift Tab alterna entre modo geral→automático→planejamento, também é possível iniciar com --permission-mode plan

• Thinking & Effort

  • Alt T alterna o modo de raciocínio, "ultrathink" é o modo de esforço máximo, /effort define o nível (low, med, high)

• Git Worktrees

  • --worktree cria branches separadas por funcionalidade, sparsePaths faz checkout apenas dos diretórios necessários

• Voice Mode

  • /voice ativa entrada por voz, barra de espaço para gravar e enviar, suporte a 20 idiomas

• Gerenciamento de contexto

  • /context, /compact para otimização de contexto, suporte a até 1M de contexto, CLAUDE.md é mantido mesmo após compactação

• Comandos rápidos de sessão

  • claude -c continua a última conversa, claude -r "name" retoma por nome, /btw para pergunta separada

SDK e modo headless

• Execução não interativa

  • claude -p "query", --output-format json, --max-budget-usd limita custo, suporte a entrada via pipe

• Agendamento e remoto

  • /loop tarefas periódicas, /rc controle remoto, --remote conecta uma sessão web

Configurações e ambiente

• Arquivos de configuração

  • usuário (~/.claude/settings.json), projeto (.claude/settings.json), local (.claude/settings.local.json)
  • OAuth, MCP, estado (~/.claude.json), servidor MCP do projeto (.mcp.json)

• Principais itens de configuração

  • modelOverrides, autoMemoryDirectory, worktree.sparsePaths

• Variáveis de ambiente

  • ANTHROPIC_API_KEY, ANTHROPIC_MODEL, CLAUDE_CODE_EFFORT_LEVEL, MAX_THINKING_TOKENS, ANTHROPIC_CUSTOM_MODEL_OPTION, CLAUDE_CODE_PLUGIN_SEED_DIR

Skills e agentes

• Skills embutidas

  • /simplify, /batch, /debug, /loop, /claude-api

• Localização das skills customizadas

  • projeto (.claude/skills//), pessoal (~/.claude/skills//)

• Frontmatter de skills

  • description, allowed-tools, model, effort, context, $ARGUMENTS, ${CLAUDE_SKILL_DIR}, !cmd

• Agentes embutidos

  • Explore, Plan, General, Bash

• Frontmatter de agentes

  • permissionMode, isolation, memory, background, maxTurns, SendMessage (nova retomada automática)

CLI e flags

• Comandos principais

  • claude, claude "q", claude -p "q", claude -c, claude -r, claude update

• Principais flags

  • --model, -w, -n, --add-dir, --agent, --allowedTools, --output-format, --json-schema, --max-turns, --max-budget-usd, --console, --verbose, --bare, --channels, --remote, --chrome

• Modos de permissão

  • default, acceptEdits, plan, dontAsk, bypassPermissions

• Variáveis de ambiente principais

  • ANTHROPIC_API_KEY, ANTHROPIC_MODEL, CLAUDE_CODE_EFFORT_LEVEL, MAX_THINKING_TOKENS, CLAUDE_CODE_MAX_OUTPUT_TOKENS, CLAUDE_CODE_DISABLE_CRON

[click]

Eu uso tanto o claude code quanto o codex, e no claude code acho um pouco incômodo não ter $. Quando tento especificar várias skills em um único prompt, isso funciona de forma natural no codex, mas não no claude code, e esse é um ponto meio decepcionante.

[GN⁺]

Comentários do Hacker News

• Eu uso Claude Code todos os dias, mas esqueço os comandos com frequência, então pedi ao Claude para pesquisar todos os recursos na documentação oficial e no GitHub e criar uma cola em HTML A4 horizontal onde fosse possível ver de relance atalhos, comandos com barra, fluxos de trabalho, sistema de skills, memória/CLAUDE.md, configuração de MCP, flags de CLI e arquivos de configuração
  Ela detecta automaticamente os atalhos de Mac/Windows, mostra a versão mais recente e o changelog. Um cron job diário verifica mudanças e atualiza tudo automaticamente, colocando um selo “NEW” nos recursos novos
  É leve, grátis e não exige cadastro. Dá para imprimir com Ctrl+P em cc.storyfox.cz e também funciona no celular

  • Achei engraçada a frase “dá para imprimir com Ctrl+P, também funciona no celular”. Meu telefone não tem tecla Ctrl e, no Mac, provavelmente seria Cmd+P
  • Fiquei curioso sobre em qual versão do Claude Code esta folha se baseia. Na minha versão não existe o comando /cost
  • O símbolo ^ significa a tecla Control, não ⌘
  • Existe algum plano de abrir o código-fonte?
  • Belo trabalho. Obrigado

• Recentemente troquei o CC no terminal pela extensão do VS Code e gostei muito mais

  • Comigo também foi assim. Fica muito mais fácil trabalhar pela UI e explorar, revisar e editar os arquivos do repositório

• Na seção “MCP”, o “~” antes de “Local” está incorreto. A configuração por projeto deveria ser simplesmente .claude.json

• “Colar imagem com CMD + V” está incorreto. Mesmo no Mac, usa-se CTRL + V como no Windows. CMD + V é para colar texto

  • No Warp Terminal, dá para colar imagens com CMD + V no Mac também
  • Outros comandos são parecidos. Por exemplo, abrir o editor externo também é CTRL+G, não CMD+G, mesmo no Mac
  • No Linux, pelo que sei, usa-se CTRL + SHIFT + V. CTRL + V é reconhecido como outra combinação

• Na prática, existem muito mais variáveis de ambiente. A minha favorita é IS_DEMO=1, que remove o banner de boas-vindas desnecessário

  • A documentação relacionada está em code.claude.com/docs/en/env-vars

• Fico me perguntando se o conceito de ‘project rules’ realmente existe
  Existem os diretórios .claude/rules/ e ~/.claude/rules/, e eu queria saber se isso serve apenas para organizar arquivos que serão carregados por prompts diferentes

• Obrigado por criar esse tipo de folha-resumo de recursos. Como novos recursos são adicionados com frequência, dá para ver tudo de uma vez e precisar menos de fuçar a documentação

• É surpreendente como o Claude Code está muito à frente do Codex no lado de CLI

  • Eu cheguei a criar um agente auto-replicante com Claude Code. Ele ramificava 5 git worktrees a partir da branch principal para trabalhar de forma independente, e a cada 60 segundos analisava o desempenho para melhorar a si mesmo na direção mais promissora.
    Depois de 43 iterações, ele passou a levar só de 10 a 30 minutos para converter qualquer site em uma API JSON tipada usando vários protocolos (WebSocket, GraphQL, gRPC-Web etc.).
    Depois, pretendo fazê-lo aprender com 263 GB de dados de 4 anos de negociações de ações e opções para encontrar uma estratégia de trading. Acho que o Claude Code vai ser o primeiro a chegar à AGI
  • Mas é lento demais. Muitas vezes perde entradas, e eu achei que, por ser TUI, seria rápido, mas não é
  • Mesmo assim, as pessoas que a OpenAI adquiriu ainda dizem que o Codex é “o futuro”
  • Na verdade, sinto que em desempenho o Codex é melhor que o Claude Code

• Vi o link do changelog na página e tentei visualizar o histórico de mudanças. Pedi ao ChatGPT para desenhar um gráfico com a quantidade de itens adicionados por dia no CHANGELOG.md, e parece aproximadamente correto
  imgur.com/a/tky9Pkz

• “Undo (cancelar entrada)” funciona com Ctrl + _ (Ctrl + sublinhado). Isso também vale para editores de linha fora do CC