Cola rápida do Claude Code

Para quem faz o curso no terminal: os comandos, os atalhos e os pedidos prontos de cada aula. Quem usa o app tem a cola rápida do app.

Instalação

Depois: cd meu-projeto && claude

Atalhos

Comandos de barra

Permissões (Aula 05)

{
  "permissions": {
    "allow": ["Bash(npm run *)", "Bash(git commit *)"],
    "ask": ["Bash(git push *)", "Bash(gh pr create *)"],
    "deny": ["Read(./.env)", "Read(./.env.*)"]
  }
}

• Ordem: deny → ask → allow. A primeira regra que combina decide, e um allow nunca abre exceção num deny.
• .claude/settings.json vale para o time (commite); .claude/settings.local.json vale só para você.
• As regras da casa, no CLAUDE.md, orientam, mas não trancam: o que precisa ser garantido vai numa regra.

Versões e sessões (Aulas 06 e 10)

Peça em português, e o Claude roda o Git por você:

• "guarde uma versão com uma mensagem em português explicando o que mudou"
• "me mostre as versões guardadas, da mais nova para a mais velha, em português simples"
• "tem alguma mudança que ainda não foi guardada numa versão?"
• "desfaça as mudanças desde a última versão guardada": o que não foi guardado vai embora, inclusive o que estava bom
• "volte o index.html para como estava na versão 'Cardápio com filtro por tipo de doce', sem apagar nenhuma versão guardada"

claude --continue                 # retoma a conversa mais recente desta pasta (-c)
claude --resume                   # escolhe uma conversa na lista (-r)
claude --resume formulario        # volta direto para a conversa com esse nome

• No app: as conversas ficam na barra lateral, e um clique no título da conversa aberta dá nome a ela.
• Para quem já programa: claude --worktree login-social abre uma sessão numa pasta e num branch separados (-w).

Modelos (Aula 08)

Escolha o modelo e o esforço no começo da sessão: trocar no meio da tarefa faz o próximo pedido reler tudo sem o desconto do cache. Para pensar mais num pedido só, escreva ultrathink no prompt. Para economizar sem perder a força nas horas difíceis: /model sonnet com /advisor opus.

As regras da casa (Aula 11)

As regras que valem em toda conversa ficam no CLAUDE.md, na pasta da página. O Claude escreve, e você aprova:

• "Crie um CLAUDE.md com as regras da casa desta página: o texto é em português do Brasil; as cores são os tons de rosa de hoje; o modo escuro, o filtro do cardápio e o formulário de encomenda têm de continuar funcionando; a página precisa ficar fácil de ler no celular; não instale nada sem me perguntar; e, antes de rodar um comando, explique em português simples o que ele faz."
• Para conferir, numa conversa nova (/clear): "quais são as regras desta página?". Ele responde sem você contar e pergunta antes de instalar.
• Para mudar: "acrescente ao CLAUDE.md que a confeitaria fecha às segundas". Para tirar: "tire do CLAUDE.md a regra sobre...". Depois, guarde uma versão.
• "lembre que eu prefiro fotos com fundo claro" vai para a memória automática, só neste computador. Para ver: "o que você guardou na memória sobre este projeto?", ou /memory.
• O /context mostra em Memory files o que o Claude carregou.
• Fica de fora: senha, telefone e dado de cliente. No projeto final, o CLAUDE.md vai para o GitHub.
• As regras da casa orientam, mas não trancam: o que precisa ser garantido vai numa regra deny ou ask (Aula 05).

Ajudantes (Aula 12)

• "Use um subagente para revisar o português de todos os textos da página e me trazer só a lista de erros, sem mudar nada." Diga no pedido o que você quer de volta: em geral, o ajudante começa sem a conversa.
• Enquanto ele trabalha, a conversa continua. Cada ajudante aparece numa linha embaixo da caixa de mensagem, e o /tasks mostra a lista. Se ele precisar de licença, o pedido aparece na conversa, com o nome dele.
• O /context, antes e depois: a conversa principal quase não cresce.
• Um ajudante seu: "Crie um subagente do projeto chamado revisor-de-textos, que só lê os arquivos, aponta erros de português e de acentuação e nunca muda nada." A pasta .claude é protegida: leia o pedido de licença e escolha Yes, que vale só para esta vez.
• O primeiro ajudante criou a pasta agents? Saia com /exit, abra de novo com claude --continue e confira o manual mode on. Os próximos aparecem sem reabrir.
• Para chamar pelo nome: "use o revisor-de-textos para revisar a página".

Skills, as receitas (Aula 13)

• "crie uma skill do projeto chamada post-instagram, em .claude/skills/post-instagram/SKILL.md, que escreve um post para o Instagram da confeitaria: frases curtas, tom carinhoso, o preço do doce, o link da página no fim e cinco hashtags. A descrição deve dizer para usar quando eu pedir um post para o Instagram. O preço sai do cardápio da página; se o doce não estiver lá, me pergunte o preço antes de escrever. Enquanto a página não estiver no ar, use [link da página] no lugar do link." A pasta .claude é protegida: leia o pedido de licença e escolha Yes.
• A pasta das skills acabou de nascer? Digite /reload-skills e depois /clear. Daí em diante, as mudanças na receita valem na hora.
• Use pelo pedido, sem citar a skill ("escreva um post sobre o bolo de cenoura"), ou pelo nome: /post-instagram bolo de pote. Quando é ele quem decide usar, no Manual, o Claude pede licença antes.
• Para mudar a receita: "na skill post-instagram, acrescente que o post termina convidando para encomendar pelo WhatsApp".
• Explicou a mesma coisa mais de duas vezes? É uma skill esperando para ser escrita.
• Nada de senha nem dado de cliente na receita: a pasta .claude vai para o GitHub no projeto final.

Conectores (Aula 14)

• Ligar: no navegador, claude.ai/customize/connectors, com a mesma conta do Claude Code: + ao lado de Connectors → Google Calendar → Connect. Depois, abra o Claude Code de novo: a lista é buscada ao abrir.
• Conferir: /mcp. Não apareceu? O /status mostra como você entrou: os conectores só chegam com o login da assinatura (/login), e não com chave de API.
• Usar: "quais compromissos eu tenho amanhã? Monte um plano do dia, com um horário para preparar as encomendas". No Manual, ele pede licença até para ler: leia e escolha Yes.
• Escrever: "crie na minha agenda um lembrete na sexta às 9h: comprar ingredientes". Confira o dia e a hora antes de aprovar.
• Ordem escondida: um convite ou um e-mail pode trazer uma. O que você não pediu, recuse com No e pergunte de onde veio.
• Desligar nesta pasta: /mcp → o conector → Disable. De vez, em todo lugar: no claude.ai, Customize → Connectors → o conector → Disconnect.

Para quem já programa:

claude mcp add --transport http <nome> <url>     # servidor pela internet
claude mcp add <nome> -- <comando> [args]        # servidor no computador (stdio)
claude mcp add --scope project ...               # compartilhado via .mcp.json

Ações automáticas (Aula 15)

Uma ação automática (hook) roda um comando sozinha, num momento certo, toda vez. O curso não precisa de nenhuma: o modo Manual e as suas regras deny e ask já protegem o essencial.

• Ver as da sua pasta, sem mudar nada: "liste as ações automáticas e as regras deste projeto, em português simples, sem mudar nada", ou /hooks, uma lista só para leitura (Esc fecha).
• Pasta de outra pessoa? Antes de confiar nela, abra o Claude Code na sua pasta de sempre e peça: "leia o .claude/settings.json da pasta ~/Downloads/pagina-recebida e explique, em português simples, o que cada ação automática faz, sem rodar nada" (troque pelo caminho da pasta).
• Confie só na pasta de cada projeto: a confiança numa pasta grande costuma valer também para as de dentro.
• Desligar todas: "desligue todas as ações automáticas nas minhas configurações pessoais".
• Aviso quando o Claude terminar: já vem no Claude Code. No iTerm2, no Ghostty e no Kitty, ele aparece na tela; nos outros, peça "troque o aviso de tarefa terminada pelo bipe do terminal", ou /config → Local notifications.
• Opcional: "crie uma regra ask no .claude/settings.json para que você sempre me pergunte antes de apagar um arquivo".

🛡️ Antes de aprovar algo que roda código no seu computador (uma ação automática, um mod, um plugin, um conector que roda no computador): instale só o que vem de quem você confia, peça ao Claude para explicar em português simples o que aquilo faz e desligue o que não usa.

Para quem programa: exit 0 segue; exit 2 bloqueia, e o stderr vira recado para o Claude; outro código só avisa (com "onFailure": "block" no hook, bloqueia). O ajuste que desliga todas é o "disableAllHooks": true.

Lembretes e tarefas agendadas (Aula 16)

• "daqui a 20 minutos, me lembre de conferir a página no celular", "quais lembretes eu tenho?" e "cancele o lembrete da página".
• Para repetir enquanto a conversa está aberta: /loop 30m olhe a minha agenda de hoje e me avise se entrou um compromisso novo (m é minuto, h é hora, d é dia). Para parar: "cancele o lembrete repetido". No Manual, o conector pede licença, e a verificação espera você.
• Os lembretes só rodam com a conversa aberta e o Claude parado, esperando você, e os repetidos param depois de 7 dias. Ao voltar com claude --continue, voltam os que ainda não venceram.
• Para toda semana, até com o computador desligado, depois da Aula 19, a tarefa agendada na nuvem:

/schedule toda segunda às 9h, no repositório confeitaria, sem nenhum conector: leia as versões guardadas dos últimos 7 dias e escreva, em português simples, um resumo do que mudou na página. Não mude nenhum arquivo: o resumo é a sua resposta final.

• Ela trabalha sozinha, sem pedir licença, e por padrão recebe todos os seus conectores: diga no pedido o que ela pode fazer e confira, na página da tarefa, se a lista de conectores ficou vazia (se não, /schedule update).
• O resultado: em claude.ai/code/routines, clique na tarefa e na execução, e leia a última resposta. Ou pergunte: /schedule o que a última execução do resumo da semana respondeu?. Verde não quer dizer certo: leia.
• /schedule list mostra as suas tarefas. Na página da tarefa ficam o Run now, a chave que pausa e, no menu, Edit e Delete.
• Para quem programa (parte opcional da aula): git log --oneline -20 | claude -p "resuma esses commits", o @claude no GitHub com /install-github-app e o /goal.

Projetos (Aula 17)

• Os Projetos não ficam no terminal: em claude.ai/code, no navegador (ou na aba Code do app), clique em Projects, na barra lateral. Estão em beta no Pro e no Max; não apareceu, entre na lista de espera: claude.com/form/projects.
• New project: o nome, o objetivo de uma linha e, em Context, os arquivos (o index.html e o decisoes.md; o .env, nunca). Depois, Create project.
• Antes do primeiro pedido grande: Project settings (a engrenagem) → General → Thread model para o Sonnet e Thread effort mais baixo. O Pause e o Resume ficam no fim de General.
• Pedidos sem relação numa mensagem só viram conversas do Projeto, que trabalham ao mesmo tempo, na nuvem, no modo auto. Diga no pedido o que precisa da sua palavra: "antes de começar, me pergunte…" e "não use nenhum conector e não mande nada para ninguém".
• Painel Overview: as abas Threads (Waiting on you, Working, Idle e Resolved), Library, Pull requests e Scheduled tasks. O que está em Waiting on you: abra a própria conversa e responda lá dentro.
• Mudou um arquivo no seu computador? Library → Add → Replace: o que está no Projeto é cópia.
• Depois da Aula 19: "adicione o repositório confeitaria a este Projeto" (ou Project settings → Environment). As mudanças chegam por pedidos para juntar, na aba Pull requests.
• Para quem programa (parte opcional da aula): uma thread no seu computador, com claude remote-control rodando na pasta e Work locally, no menu +.

Mods (Aula 18)

Um mod é um código que muda o Claude Code por dentro e roda com as suas permissões. Quem não lê código não instala mod de terceiros: o curso não precisa de nenhum. A regra para tudo o que roda código no seu computador está na seção da Aula 15.

• Ver o que está instalado: /plugin e Tab até a aba Installed. Os de fábrica ficam em Built-in; fora dele, não deve haver nenhum. Esc fecha.
• Desligar um: na aba Installed, escolha com as setas e aperte Espaço (de novo, liga).
• Uma conversa sem mods: /exit e claude --safe-mode. As regras deny e ask continuam valendo, e os mods de fábrica também.
• Desligar todos os que você instalou, em todas as conversas: "desligue todos os mods e as ações automáticas nas minhas configurações pessoais". Os de fábrica continuam.
• A versão: claude --version, antes de abrir o Claude Code (2.1.287 ou mais nova).

Para quem programa:

claude plugin validate ./algum-mod      # ver o que o mod faz antes de carregar (linhas hooks: e calls:)
claude --plugin-dir ./algum-mod         # testar por uma sessão
/plugin install <mod>@<marketplace>     # instalar (na sessão)

Várias tarefas ao mesmo tempo (Aula 20)

/rename posts          # dá um nome à conversa
/tasks                 # o que está rodando em segundo plano nesta conversa
/usage                 # quanto do limite de uso já foi
/deep-research ...     # uma pesquisa grande, com as fontes (opcional, e a forma mais cara)

• Duas conversas: abra o terminal mais uma vez (no Mac, Cmd + N abre uma janela nova), entre na mesma pasta e rode claude. Uma tarefa em cada conversa, cada uma no seu arquivo, e as duas no Manual.
• Antes de começar: "tem alguma mudança que ainda não foi guardada numa versão? Se tiver, guarde uma versão com uma mensagem em português".
• Desfazer vale para a pasta inteira: com a outra conversa ainda trabalhando, peça só o que é desta, como "apague o posts/semana.md". Desfaça e guarde com as duas terminadas.
• Cada conversa e cada ajudante gastam o seu uso: escolha a forma mais leve que resolve.
• No plano Pro, o /deep-research pede os workflows ligados antes: /config, linha Dynamic workflows.
• Para ir além: claude --worktree (uma cópia separada da pasta para cada conversa), claude agents (todas as conversas numa tela só), /fork, /batch, as equipes de agentes e os workflows, com a palavra ultracode.

Plugins (Aula 21)

/plugin install frontend-design@claude-plugins-official   # abre a página do plugin, para ler antes de instalar
/plugin                                                   # Discover para procurar, Installed para ligar e desligar
/frontend-design:frontend-design                          # a receita do plugin, chamada pelo nome

• Antes de instalar: guarde uma versão. Para testar, escolha Install for you, in this repo only (local scope): só você, só nesta pasta.
• No modo de planejar: "use o frontend-design para propor um visual novo para o cabeçalho, sem mudar nada ainda". Não gostou? "desfaça as mudanças desde a última versão guardada".
• O custo: plugin ligado pesa em toda mensagem, mesmo sem uso. O Context cost mostra a estimativa: Every turn (a cada mensagem) e When invoked (quando usado).
• Desligue o que não usa: /plugin, aba Installed, o plugin e Espaço.
• 🛡️ Instale só o que vem de quem você confia, e peça: "explique em português simples o que o plugin traz e o que ele pode fazer no meu computador".
• Para ir além: /plugin marketplace add dono/repositorio (outro catálogo), claude --plugin-dir ./meu-plugin (testar o seu plugin sem instalar) e claude plugin validate ./meu-plugin (conferir o seu plugin).

O Claude vendo a sua página (Aula 22)

📱 Print do celular → 🛠️ Correção → ✅ Conferir no celular

1. O print. Tire um print do defeito no celular, mande para o computador (e-mail ou WhatsApp) e arraste para a janela do terminal, ou cole com Ctrl + V (Alt + V no Windows).
2. O pedido, com o que não pode mudar: "No celular, os botões do filtro ficam cortados, como neste print. Arrume sem mudar nada do jeito que a página aparece no computador."
3. A conferência. No navegador, com a janela grande e estreita; depois, "guarde uma versão com uma mensagem em português explicando o que mudou e envie para o GitHub" e, em até 10 minutos, o celular de verdade.

claude --chrome    # conversa com o Claude no Chrome: ele abre a página no seu Chrome, clica e conta o que viu

• Pedido: "Abra no Chrome a página https://seu-usuario.github.io/confeitaria/, clique em cada botão do filtro e me conte o que aparece em cada um." Cada site pede licença (Claude in Chrome wants to), e ele usa os seus logins.
• O Chrome não é o celular: a palavra final é do celular de verdade.
• Precisa da extensão do Claude, na mesma conta, e de um plano direto da Anthropic, com o /login. O /chrome mostra Status: Enabled e Extension: Installed.
• Uso do computador (prévia, Pro e Max; no terminal, só no Mac): /mcp → computer-use → Enable. Licença app por app, e o Esc para tudo.
• Para quem programa: imagens citadas como [Image #N], o console e o DOM no Chrome, o servidor de desenvolvimento no localhost e a prévia do app desktop (.claude/launch.json).

Claude Code em qualquer lugar (Aula 23)

📱 Celular: Remote Control → ☁️ Nuvem: claude.ai/code → 🔀 Volta: pedido para juntar

1. O celular. Na conversa aberta, digite /remote-control Confeitaria (ou /rc) e confirme com Enable Remote Control. No app do Claude no celular, aba Code, escolha "Confeitaria" (ícone de computador, bolinha verde). O /mobile mostra um QR code para baixar o app.
2. O que fica ligado. O computador, com o terminal aberto. Se ele dormir ou a internet cair, a conversa volta sozinha; se o terminal fechar, ela sai do ar.
3. A nuvem (depois da Aula 19). Em claude.ai/code, escolha o repositório confeitaria e o modo Plan, mande a tarefa e aprove o plano. Ela segue com o computador desligado, mas só vê o que você enviou para o GitHub.
4. A volta. A mudança chega numa linha paralela:
   • na página da sessão, Create PR;
   • no GitHub, revise em Files changed e junte (Merge pull request, Confirm merge);
   • em até 10 minutos, a mudança está no site;
   • no computador, peça: "Volte para a linha principal e traga do GitHub as versões novas dela."

• Antes de mandar uma tarefa para a nuvem: "tem alguma mudança que ainda não foi enviada para o GitHub?"
• Avisos no celular: /config → Push when actions required e Push when Claude decides.
• Para quem programa: claude --cloud "pedido", claude --teleport (ou /teleport), git fetch e git checkout para trazer a linha paralela, claude remote-control (modo servidor) e o Dispatch, no app desktop.

Quando algo dá errado (Aula 24)

↩︎️ Desfazer → 💬 Entender → 🗺️ Planejar o conserto

1. Desfaça primeiro. Antes do sim, escolha No e, com Tab, diga o motivo. Depois do sim: "desfaça a última mudança que você fez", o /rewind (ou Esc duas vezes) ou "desfaça as mudanças desde a última versão guardada". Recarregue a página no navegador.
2. Mostre o erro. Cole a mensagem na conversa, ou um print com Ctrl + V (Alt + V no Windows), e peça: "explique em português simples o que aconteceu e o que eu faço".
3. Peça um plano. No Plan Mode: "proponha um plano para consertar isso, sem mudar nada ainda". Aprove mudança por mudança, confira no navegador e guarde uma versão.

claude doctor            # o claude nem abre? confere só a instalação, sem mudar nada
claude update            # termina a atualização que falhou (Auto-update failed)

• Na conversa, o /doctor faz o check-up e só corrige o que você confirmar. Regra da casa ignorada: /context (Memory files). Skill sumida: /skills e /reload-skills. Conector pedindo login: /mcp.
• Ajuda: pergunte ao Claude; relate com o /feedback (a conversa vai junto: confira antes); conta e cobrança na central de ajuda, em support.claude.com.
• Para quem programa: /doctor prompt-audit, /debug, claude --debug, claude --safe-mode e os erros de lugar e de formato (skill sem pasta própria, matcher com minúscula, .mcp.json dentro de .claude/).

Artifacts: uma página com link (Aula 25)

• Peça dizendo o que a página faz: "faça um artifact com uma calculadora de orçamento de festa da confeitaria, com os preços do cardápio da página".
• Confira pelo que se vê: a página abre, e a conta feita à mão bate com o total.
• Para mudar, peça ("acrescente a opção de topo de bolo"): o Claude publica de novo no mesmo endereço, numa versão nova. Ctrl + ] reabre a página mais recente.
• Numa conversa nova, dê o link no pedido ou anexe a página pelo /artifacts. Todas ficam na galeria, em claude.ai/code/artifacts.
• Compartilhar, no navegador: Share, Anyone with the link e Copy link; confira numa janela anônima. Para parar: Only you.
• Antes de compartilhar, releia a página: nada de dado de cliente num link público.
• Precisa de login com assinatura (/login); com chave de API, não publica. Para desligar num projeto: "enableArtifact": false.

Onde fica cada coisa

O fluxo

🔍 Explorar → 🗺️ Planejar → 🛠️ Fazer → 💾 Guardar

1. Explorar: peça para o Claude ler e explicar, sem mudar nada
2. Planejar: no Plan Mode, com o critério de pronto que se vê na tela, e ajuste o plano antes de aprovar
3. Fazer: aprove mudança por mudança e confira com um print
4. Revisar: veja o que mudou e peça um /code-review antes de guardar
5. Guardar: "guarde uma versão com uma mensagem em português", e /clear antes da próxima tarefa

Qual recurso usar?