Pular para o conteúdo

Comandos do Claude Code: atalhos, flags e configurações

Comandos do Claude Code em uma página: comandos de barra, atalhos de teclado, flags e onde fica cada arquivo de configuração, conferidos nos docs oficiais.

Por Yotam DahanAtualizado 13 min de leituraClaude Code

Nesta página
  1. Iniciar, retomar e atualizar (no terminal)
  2. Comandos de barra do Claude Code para o dia a dia
  3. Modelos, modos e permissões
  4. Configurar um projeto
  5. Conferir o trabalho e acompanhar o uso
  6. Conta e todo o resto
  7. Atalhos de teclado do Claude Code
  8. Prefixos e texto em várias linhas
  9. Modos de permissão de relance
  10. Configuração do Claude Code: onde ficam os arquivos de configuração e memória
  11. Um settings.json inicial
  12. O que fazer agora

Os comandos do Claude Code são de dois tipos: comandos de barra que você digita dentro de uma sessão, como /clear ou /model, e comandos de terminal com flags que você digita antes de ela começar, como claude -c. Esta folha de consulta lista os que você vai usar de verdade, agrupados por tarefa, mais os atalhos de teclado e o local de cada arquivo de configuração. Tudo foi conferido na referência oficial de comandos da Anthropic em outubro de 2026, quando a versão atual era a 2.1.302.

É novo na ferramenta? O tutorial para iniciantes mostra a maioria destes comandos em ação, um passo de cada vez.

Os três comandos que resolvem a maioria dos problemas

/clear

Começa uma conversa do zero. Use entre tarefas sem relação, para o contexto antigo parar de confundir o Claude e de gastar o seu plano.

/context

Mostra o que está ocupando a janela de contexto. Rode quando o Claude parecer esquecer detalhes anteriores.

/rewind

Abre o menu para restaurar o código, a conversa ou os dois. Apertar Esc duas vezes com o campo vazio faz o mesmo.

Iniciar, retomar e atualizar (no terminal)

Digite estes no Terminal ou no PowerShell, não dentro do Claude Code. A lista completa está na referência da CLI.

ComandoO que faz
claudeInicia uma sessão interativa na pasta atual
claude "sua tarefa"Inicia uma sessão com o primeiro prompt já enviado
claude -p "pergunta"Responde uma vez e sai, sem sessão interativa (modo print)
claude -cContinua a conversa mais recente nesta pasta
claude -rEscolhe uma conversa anterior para retomar; claude -r "nome" vai direto para uma com nome
claude -n "nome"Inicia uma sessão com um nome que você pode retomar depois
claude --model sonnetComeça em um modelo específico, pelo apelido ou nome completo
claude --permission-mode planComeça em um modo de permissão específico
claude --add-dir ../sharedDá acesso também a outra pasta
claude --versionMostra a versão instalada
claude updateInstala a versão mais nova agora
claude doctorConfere a instalação e as configurações sem iniciar uma sessão
claude auth statusMostra com qual conta você está conectado (adicione --text para texto simples)
claude mcp listLista os servidores MCP que você adicionou
claude --desktopAbre a pasta atual no app de desktop (macOS e Windows x64, contas com assinatura)

Comandos de barra do Claude Code para o dia a dia

ComandoO que fazQuando usar
/helpMostra a ajuda e os comandos disponíveisVocê esqueceu um comando
/clearComeça uma conversa nova com o contexto vazio (também /new, /reset)Você muda para uma tarefa sem relação
/compact [foco]Resume a conversa até aqui para liberar espaçoUma tarefa longa está enchendo o contexto
/contextMostra o que está ocupando a janela de contexto, em uma grade coloridaO Claude parece esquecer detalhes anteriores
/resumeReabre uma conversa anterior (também /continue)Você quer de volta a sessão de ontem
/rename [nome]Dá nome à sessão atualAntes do /clear, para achar depois
/branchCria uma cópia da conversa para testar outro caminhoVocê quer experimentar sem perder o caminho atual
/rewindVolta código e conversa a um ponto anterior (também /undo, /checkpoint)Uma mudança deu errado
/btw [pergunta]Faz uma pergunta paralela que não entra na conversaVocê precisa de uma conferência rápida no meio da tarefa
/copyCopia a última resposta para a área de transferênciaVocê quer colar uma resposta em outro lugar
/export [arquivo]Salva a conversa como texto simplesVocê quer um registro
/recapDá um resumo de uma linha da sessão até aquiVocê volta depois de uma pausa
/exitSai do Claude Code (também /quit)Você terminou

Modelos, modos e permissões

ComandoO que faz
/model [nome]Troca de modelo e salva como padrão; aperte s no seletor para trocar só nesta sessão
/effort [nível]Define o quanto o modelo pensa: low, medium, high, xhigh ou max
/fastLiga ou desliga o modo rápido, um Opus mais rápido por um preço maior; nos planos de assinatura ele é cobrado em créditos de uso
/plan [tarefa]Entra no modo de planejamento, opcionalmente já com uma tarefa
/permissionsMostra e edita as suas regras de permitir, perguntar e negar
/configAbre as configurações (também /settings); /config theme=dark define um valor direto
/themeMuda o tema de cores
/output-style [estilo]Muda como o Claude formata as respostas

Configurar um projeto

ComandoO que faz
/initGera um arquivo CLAUDE.md inicial para o projeto
/memoryAbre e edita os seus arquivos CLAUDE.md, e liga ou desliga a memória automática
/mcpGerencia os servidores MCP conectados e os logins deles
/skillsLista as skills disponíveis nesta sessão
/pluginExplora, instala e gerencia plugins
/hooksMostra os hooks configurados
/add-dir <caminho>Dá a esta sessão acesso a outra pasta
/cd <caminho>Move a sessão para outra pasta e mantém a conversa
/keybindingsAbre o seu arquivo de atalhos de teclado
/terminal-setupConfigura os atalhos de nova linha do seu terminal (Shift+Enter no VS Code e no Cursor, teclas Option no Terminal da Apple)
/statuslineConfigura a linha de status embaixo do prompt
/doctorFaz uma revisão da configuração que encontra problemas e oferece correções

Skills e MCP têm cada um o seu guia: como criar uma skill do Claude e o que é MCP.

Conferir o trabalho e acompanhar o uso

ComandoO que faz
/diffRevisa as mudanças na sua pasta de trabalho, incluindo as edições do Claude
/code-reviewRevisa as mudanças atuais em busca de bugs (também /review); adicione --fix para aplicar o que encontrar
/security-reviewConfere as mudanças do seu branch em busca de problemas de segurança
/usageMostra o custo da sessão, os limites de uso do plano e a atividade (também /cost, /stats)
/statusMostra versão, modelo, conta e detalhes de conexão
/insightsGera um relatório em HTML sobre como você usa o Claude Code
/release-notesMostra o que mudou em cada versão

Conta e todo o resto

ComandoO que faz
/login e /logoutEntra ou sai da sua conta da Anthropic
/upgradeAbre a página para subir de plano
/usage-creditsAtiva ou solicita créditos de uso para quando você bater um limite
/rate-limit-optionsEscolhe o que acontece quando um limite de uso para uma tarefa
/privacy-settingsMostra e atualiza as configurações de privacidade (Pro e Max)
/feedbackEnvia um comentário ou relato de bug (/bug abre a mesma janela)
/powerupFaz lições interativas curtas sobre recursos do Claude Code
/desktopContinua esta sessão no app de desktop
/remote-controlContinua esta sessão pelo celular ou por um navegador (também /rc)
/mobileMostra um QR code para baixar o app do Claude para celular
/loop [intervalo] [prompt]Repete um prompt em um intervalo enquanto a sessão fica aberta
/scheduleCria rotinas que rodam na nuvem em um horário programado
/goal [condição]Mantém o Claude trabalhando por várias rodadas até uma condição ser cumprida

Não lembra qual comando serve? O Claude Code responde perguntas sobre si mesmo, então pergunte direto:

Pergunte ao Claude Code sobre os próprios comandos
Vou [TAREFA]. Quais comandos de barra, atalhos ou configurações mais me ajudariam? Explique cada um em uma linha e diga quando não usar.

Atalhos de teclado do Claude Code

Da referência do modo interativo. As teclas são iguais no Mac e no Windows, salvo indicação.

AtalhoO que faz
EscPara o Claude no meio de uma etapa (ele mantém o que já fez); fecha uma janela
Esc duas vezesCom o campo vazio, abre o menu de voltar atrás; com texto, apaga o rascunho
Shift+TabAlterna os modos de permissão
Ctrl+CInterrompe; sem nada rodando, o primeiro toque limpa o prompt e o segundo sai
Ctrl+DAperte duas vezes com o campo vazio para sair
Setas para cima e para baixoNavega pelos seus prompts anteriores
Ctrl+RBusca no histórico de prompts
TabAceita uma sugestão de preenchimento automático
Ctrl+OMostra a transcrição completa, com cada chamada de ferramenta
Ctrl+TMostra ou esconde a lista de tarefas do Claude
Ctrl+BManda um comando em execução para o segundo plano
Ctrl+GAbre o seu prompt, ou um plano proposto, no seu editor de texto
Ctrl+SGuarda o rascunho atual; aperte de novo com o campo vazio para trazer de volta
Ctrl+LRedesenha a tela se a exibição ficar bagunçada
Ctrl+V (Cmd+V no iTerm2, Alt+V no Windows)Cola uma imagem da área de transferência
Option+P (Mac) ou Alt+PTroca de modelo sem perder o rascunho
Option+T (Mac) ou Alt+TLiga ou desliga o raciocínio estendido, nos modelos em que ele pode ser desligado
? com o campo vazioMostra o painel de ajuda de atalhos

No app de desktop, Shift+Tab não alterna os modos, então use o seletor de modo. Aperte Cmd+/ no Mac ou Ctrl+/ no Windows para ver os atalhos do próprio app.

Prefixos e texto em várias linhas

Digite istoO que acontece
/ no inícioRoda um comando ou uma skill
! no inícioRoda você mesmo um comando de terminal; a saída entra na conversa e o Claude responde a ela
@Menciona um arquivo ou pasta, com preenchimento automático do caminho
\ e depois Enter, ou Ctrl+JNova linha sem enviar, em qualquer terminal
Shift+EnterNova linha no iTerm2, Terminal da Apple, Windows Terminal, Ghostty, Kitty, WezTerm e Warp; rode /terminal-setup uma vez no VS Code ou no Cursor

Modos de permissão de relance

A linha de status mostraModoRoda sem perguntar
⏸ manual mode onManual (valor de configuração default)Só leituras
⏵⏵ accept edits onacceptEditsLeituras, edições de arquivo e comandos comuns de arquivo como mkdir e mv
⏸ plan mode onplanLer e explorar; nenhuma edição até você aprovar um plano
⏵⏵ auto mode onautoA maioria das ações, com uma verificação de segurança em segundo plano; o modo inicial nas versões atuais

Configuração do Claude Code: onde ficam os arquivos de configuração e memória

~ significa a sua pasta pessoal (%USERPROFILE% no Windows), ~/.claude é uma pasta oculta dentro dela, e um .claude sozinho significa a pasta dentro do seu projeto. Os detalhes estão no guia oficial de configurações.

ArquivoVale paraO que guarda
~/.claude/settings.jsonVocê, em todos os projetosConfigurações pessoais: tema, modelo padrão, as suas regras de permissão
.claude/settings.jsonTodos no projetoPermissões, hooks e plugins compartilhados; faça commit para compartilhar
.claude/settings.local.jsonVocê, neste projetoAjustes pessoais; as aprovações "Yes, and don't ask again" ficam salvas aqui
managed-settings.jsonA organização inteiraPolítica da empresa que nada sobrescreve; fica em /Library/Application Support/ClaudeCode/ (Mac), /etc/claude-code/ (Linux) ou C:\Program Files\ClaudeCode\ (Windows)
~/.claude.jsonVocêEstado de login, os seus servidores MCP, confiança nas pastas; o Claude Code cuida dele por você
~/.claude/CLAUDE.mdVocê, em todos os projetosInstruções pessoais
CLAUDE.md ou .claude/CLAUDE.mdO projetoInstruções do projeto
CLAUDE.local.mdVocê, neste projetoNotas privadas do projeto; adicione ao .gitignore
.claude/rules/*.mdO projetoInstruções divididas por tema, opcionalmente só para certos arquivos
.claude/skills/<nome>/SKILL.mdO projeto (ou ~/.claude/skills/ para você)Skills que você roda com /nome
.claude/agents/*.mdO projeto (ou ~/.claude/agents/ para você)Definições de subagentes
.mcp.jsonO projetoServidores MCP compartilhados com a equipe
~/.claude/keybindings.jsonVocêAtalhos de teclado personalizados
~/.claude/projects/<projeto>/memory/Você, por projetoMemória automática: notas que o Claude escreve para si mesmo

Quando a mesma configuração aparece em vários arquivos, vence a que estiver mais alta nesta ordem:

Qual arquivo de configuração vence, do mais forte ao mais fraco
  1. Configurações gerenciadas

    A política da sua organização, que nada sobrescreve

  2. Linha de comando

    Um valor de --settings, só para aquela sessão

  3. Projeto local

    .claude/settings.local.json, os seus ajustes pessoais do projeto

  4. Projeto compartilhado

    .claude/settings.json, com commit para a equipe

  5. Usuário

    ~/.claude/settings.json, os seus padrões em todo lugar

Listas como as regras de permissão são combinadas entre os arquivos em vez de substituídas, e uma regra de negar em qualquer lugar vence uma regra de permitir em qualquer lugar. O que vai dentro dos arquivos CLAUDE.md tem o seu próprio guia: o arquivo CLAUDE.md explicado.

Um settings.json inicial

Salve isto como .claude/settings.json em um projeto, ou como ~/.claude/settings.json para valer em todo lugar:

json
{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "defaultMode": "default",
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  }
}

"defaultMode": "default" faz as novas sessões no terminal começarem no modo Manual, então o Claude pergunta antes de cada edição e comando. As regras deny impedem as ferramentas de arquivo do Claude de ler arquivos de ambiente, onde normalmente ficam senhas e chaves, e qualquer coisa dentro de uma pasta secrets.

O Claude Code recarrega sozinho a maioria das edições de configuração. Rode /status para confirmar quais arquivos foram carregados.

Teste rápido0 de 3 corretas

Qual comando começa uma conversa do zero quando você muda para uma tarefa sem relação?

Onde ficam as suas configurações pessoais para todos os projetos?

O .claude/settings.json da sua equipe permite um comando e as suas configurações de usuário negam. O que acontece?

O que fazer agora

Imprima esta página ou deixe fixada, e aprenda três comandos por semana em vez de todos de uma vez, começando por /clear, /context e /rewind. Quando sessões longas começarem a consumir o seu plano, o guia de limites de uso do Claude Code mostra quais destes comandos fazem o plano render mais. O curso de Claude Code tem uma aula dedicada aos atalhos que mais economizam tempo.

Folha para imprimir e 12 receitas para situações

Os 30 comandos e atalhos que você mais usa em uma única página para imprimir, mais 12 receitas do tipo 'quando isso acontecer, digite isto' para os momentos em que todo mundo trava.

Digite seu e-mail e a seção completa abre aqui mesmo. Você também ganha uma aula grátis do curso.

Sem spam. Cancele com um clique. Usamos seu e-mail para enviar o curso e dicas de IA.

Perguntas frequentes

Por que alguns destes comandos não aparecem para mim?

Alguns comandos dependem da sua plataforma, do plano ou da configuração. Por exemplo, /desktop só aparece no macOS e no Windows x64 quando você entra com uma assinatura do Claude, e /upgrade não aparece nos planos Enterprise. Se um comando mais novo não aparece em lugar nenhum, rode claude update.

Posso criar os meus próprios comandos de barra?

Sim. Um comando personalizado é uma skill: uma pasta com um arquivo SKILL.md, salva em .claude/skills/ para um projeto ou em ~/.claude/skills/ para todos os seus projetos, que você roda como /nome-da-pasta. Os comandos antigos de arquivo único em .claude/commands/ também continuam funcionando.

Posso mudar os atalhos de teclado?

Sim. Rode /keybindings para criar ou abrir ~/.claude/keybindings.json, onde você pode remapear ou desligar a maioria das ações, e as mudanças valem sem reiniciar. Alguns atalhos de edição de texto, como Ctrl+W, não podem ser remapeados.

O Claude Code tem modo Vim?

Sim. Ative em /config, em Editor mode, ou defina editorMode como vim em ~/.claude/settings.json. O antigo comando /vim foi removido.

Onde ficam guardadas as minhas conversas do Claude Code?

No seu próprio computador, como arquivos de texto em ~/.claude/projects/, apagados depois de 30 dias por padrão; a configuração cleanupPeriodDays muda isso. Rodar claude purge apaga tudo o que o Claude Code guardou de um projeto.

Continue lendo