68 pontos por GN⁺ 2026-03-24 | 2 comentários | Compartilhar no WhatsApp
  • 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

2 comentários

 
click 2026-03-27

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⁺ 2026-03-24
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

  • 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