Práticas de Programação

Guia básico do Claude Code

O que é

O Claude Code é o Claude que lê e edita os arquivos do seu projeto. O mesmo Claude pode ser aberto de dois jeitos:

Painel do VS CodeTerminal
Como abreícone do Claude na barra lateraldigitar claude no terminal
Aparênciabotões, visualsó texto
Colar printsimplesdepende do terminal
Contador de contexto fixonão garantidosim (status line)
! comando rápidonãosim

Enquanto aprende, o painel é o mais fácil. Os dois convivem: não precisa escolher um só.

Pedidos prontos (como usamos no caderno)

Não precisa de comando: é só escrever. Estas frases já funcionam:

EscrevaO que acontece
"próxima aula" + PDF ou printvira uma página nova do caderno, no mesmo estilo
"o que é isso?" + print da aulaexplica o código da professora
"revisa @js/for.js sem alterar nada"só lê e aponta problemas
"upe no github"testa, faz o commit e envia
"restaure, acho que fiz besteira"confere o que mudou e conserta
"abre o glossario.html"abre a página no navegador
"salve" / "lembre que..."guarda na memória para os próximos chats

Dica: um chat novo por aula. O Claude lembra seu estilo e o progresso pela memória, e conversas muito longas perdem detalhes.

Comandos com /: como funcionam

Fonte: documentação oficial (code.claude.com/docs/en/commands), versão 2.1.287.

Os essenciais (comece por estes)

ComandoApelidosO que fazQuando usar no caderno
/helplista os comandos e a ajudaquando se perder
/contextmostra quanto da conversa já está ocupado (grade colorida)conversa longa? confira aqui
/compact [instruções]resume a conversa para liberar espaço; pode dizer o foco do resumoquando o /context passar de ~60%
/clear/reset, /newcomeça uma conversa do zero (a memória continua)a cada aula nova
/resume/continuevolta para uma conversa antigacontinuar a aula de ontem
/rewind/checkpoint, /undovolta a conversa e/ou o código para um ponto anterioro Claude mexeu errado
/diffmostra tudo que mudou nos arquivosantes de mandar ao GitHub
/code-review/reviewrevisa as mudanças procurando erros; --fix já corrigeconferir o código da aula
/btw [pergunta]pergunta paralela que não entra na conversadúvida rápida no meio de uma tarefa
/plan [tarefa]modo planejar: o Claude explica o plano antes de mexermudança grande (ex.: reorganizar o site)
/modeltroca o modelo (Opus, Sonnet, Haiku...) 
/memoryvê e edita o que o Claude lembra entre conversasconferir o que foi salvo
/usage/cost, /statsconsumo da sessão e limites do planosaber quanto já usou
/copy [N]copia a última resposta (ou a N-ésima) para colar em outro lugarlevar o handoff para o claude.ai
/powerupmini-aulas interativas sobre recursos do Claude Codeaprender brincando

Conversa e sessões

ComandoApelidosO que faz
/rename [nome]dá um nome à conversa (aparece no /resume)
/recapresumo de uma linha da sessão atual
/export [arquivo]salva a conversa como texto
/branch [nome]cria um galho da conversa para testar outro caminho sem perder o atual
/fork [pedido]copia a conversa para uma sessão em segundo plano e continua aqui
/subtask <tarefa>manda um ajudante (subagente) fazer uma tarefa e trazer o resultado
/background [pedido]/bgdeixa a sessão rodando sozinha em segundo plano
/tasks/basheslista o que está rodando em segundo plano
/stoppara uma sessão em segundo plano
/goal [condição]o Claude continua trabalhando até cumprir uma meta
/loop [intervalo] [pedido]/proactiverepete um pedido de tempos em tempos (ex.: /loop 5m ...)
/list-agents/peerslista ajudantes e outras sessões com quem o Claude pode falar
/exit/quitsai do Claude Code (terminal)

Modelo e raciocínio

ComandoApelidosO que faz
/effort [nível]quanto o Claude pensa: low até max, ou auto
/fast [on | off]modo rápido: respostas mais ligeiras
/advisor [modelo | off]liga um segundo modelo que dá conselhos em momentos importantes
/output-style [estilo]muda o jeito das respostas (ex.: mais curtas)
/autocompact [tamanho | auto]define quando a conversa é resumida automaticamente

Projeto, arquivos e permissões

ComandoApelidosO que faz
/initcria um CLAUDE.md: instruções fixas do projeto
/add-dir <pasta>deixa o Claude ler outra pasta além desta
/cd <pasta>muda a sessão para outra pasta, mantendo a conversa
/permissions/allowed-toolso que o Claude pode fazer sem perguntar
/fewer-permission-promptsanalisa seu uso e libera comandos seguros para perguntar menos
/auto-mode-setupconfigura o modo automático com base no seu projeto
/sandboxliga/desliga o modo isolado (sandbox)
/hooksmostra ações automáticas configuradas (hooks)
/update-config [pedido]descreva uma configuração e o Claude edita o settings.json

Revisar, testar e corrigir código

ComandoApelidosO que faz
/simplify [alvo]procura código repetido ou complicado e simplifica (não caça erros)
/security-reviewprocura falhas de segurança nas mudanças
/ultrareview [PR]revisão profunda na nuvem (mesmo que /code-review ultra; tem custo)
/runabre e usa o app para ver a mudança funcionando
/verifyroda o app e confere se a mudança faz o que devia
/run-skill-generatorensina o /run e o /verify a abrir este projeto
/debug [problema]liga o registro de erros e investiga um problema do Claude Code
/batch <instrução>divide uma mudança enorme em partes e faz em paralelo

Aparência e configurações

ComandoApelidosO que faz
/config/settingsabre as configurações (tema, modelo...); aceita chave=valor
/statusversão, modelo, conta e conexão
/thememuda as cores (claro, escuro, para daltônicos...)
/color [cor]muda a cor da barra de digitação desta sessão
/statuslineconfigura a linha de status do terminal
/keybindingsabre o arquivo de atalhos de teclado
/terminal-setupfaz Shift+Enter quebrar linha no terminal
/tui [default | fullscreen]muda o modo de tela do terminal
/focusmostra só seu pedido e a resposta final (tela cheia)
/scroll-speedvelocidade da rolagem do mouse (tela cheia)
/voiceliga o ditado por voz
/ideconecta o terminal ao VS Code
/release-notesnovidades de cada versão

Extensões: skills, plugins e MCP

ComandoApelidosO que faz
/skillslista as skills (comandos extras) disponíveis
/reload-skillsrecarrega skills criadas ou mudadas
/skill-doctormostra quanto cada skill pesa e se é usada
/plugininstala e gerencia plugins
/reload-pluginsaplica mudanças de plugins sem reiniciar
/mcpconexões com serviços externos (MCP)
/agentslembra como criar ajudantes (subagentes)
/importtraz configurações do Codex, Gemini CLI ou Cursor
/chromeconfigura o Claude no navegador Chrome
/claude-in-chrome [tarefa]o Claude faz uma tarefa no seu Chrome (testar página, preencher formulário)

Criar páginas, apresentações e pesquisas

ComandoApelidosO que faz
/artifactslista as páginas publicadas (artifacts) e abre ou copia o link
/slides [tema]cria uma apresentação
/design [ideia]desenha telas e protótipos
/design-syncenvia o design system do projeto para o Claude Design
/design-loginautoriza o /design-sync
/dataviz [pedido]guia para gráficos e painéis
/artifact-capabilitiesrecursos que uma página publicada pode usar
/artifact-diagrammingguia para diagramas nas páginas
/deep-research <pergunta>pesquisa na internet com várias fontes e gera relatório
/workflowsacompanha tarefas grandes em várias etapas
/workflow-authoringreferência para escrever workflows
/claude-apimaterial para programar com a API do Claude

GitHub, nuvem e outros aparelhos

ComandoApelidosO que faz
/install-github-appliga o Claude a um repositório do GitHub
/autofix-pr [pedido]na nuvem, corrige um pull request quando os testes falham
/web-setupconecta o GitHub para sessões na nuvem
/remote-envescolhe o ambiente padrão na nuvem
/schedule [descrição]/routinesagenda tarefas que rodam na nuvem
/teleport/tptraz uma sessão da nuvem para este terminal
/remote-control/rccontinua esta sessão pelo claude.ai ou celular
/desktop/appcontinua a sessão no app Claude para desktop
/mobile/ios, /androidQR code para baixar o app do celular
/install-slack-appinstala o Claude no Slack

Conta, plano e uso

ComandoApelidosO que faz
/loginentra na conta Anthropic
/logoutsai da conta
/rate-limit-optionso que fazer quando bate o limite de uso
/usage-creditscréditos extras de uso
/upgradepágina para mudar de plano
/privacy-settingsconfigurações de privacidade (Pro e Max)
/insightsrelatório de como você usa o Claude Code
/team-onboardinggera um guia de uso para outra pessoa começar
/passescompartilha uma semana grátis (se disponível)

Problemas e suporte

ComandoApelidosO que faz
/doctor/checkupcheck-up da instalação: acha e corrige problemas
/bug [relato]/sharerelata um erro (no VS Code abre a janela de feedback)
/feedback [relato]envia sugestões sobre o Claude Code
/heapdumpdiagnóstico de memória (escondido: digite inteiro)
/setup-bedrockconfigura Amazon Bedrock (só empresas)
/setup-vertexconfigura Google Cloud (só empresas)

Diversão

ComandoApelidosO que faz
/radioabre a rádio lo-fi Claude FM
/stickerspedir adesivos do Claude Code

Comandos que saíram

Se achar em tutorial antigo: /vim (agora em /config), /pr-comments (peça direto ao Claude) e /ultraplan (use /plan) foram removidos.

Você também pode criar seus próprios comandos (skills): peça "cria um comando /aula que faz...".

Atalhos e símbolos

TeclaO que faz
Enterenvia a mensagem
Shift+Enterquebra a linha sem enviar
Escinterrompe o Claude no meio do que está fazendo
Esc duas vezesvolta para uma mensagem anterior (terminal)
Seta para cimarepete mensagens que você já mandou
Shift+Tabtroca o modo: pedir permissão, aceitar edições, planejar (terminal)
@ + nomeaponta um arquivo: @js/for.js
! + comandoroda um comando na hora: !git status (terminal)
Ctrl+`abre o terminal do VS Code (tecla da crase)

Desfazer um erro

  1. Ctrl+Z no arquivo aberto desfaz as últimas edições.
  2. Pedir ao Claude: "restaure", "volta como estava".
  3. GitHub: cada envio é um ponto seguro. Envie quando algo estiver funcionando.

Se ficar perdido

  1. Esc para parar o que está acontecendo.
  2. /help para ver os comandos.
  3. Pergunte em português mesmo: "como faço para...?"
  4. No terminal, /exit sai. Nada se perde: claude -c volta.