Aula 9 · 15 min
Esta é a aula de consulta. Aqui estão os principais recursos do curso num lugar só, em cinco grupos: rodar em paralelo, coordenar, nuvem, entregar e controlar. Cada um tem o que é em uma frase, o status (oficial, prévia, beta ou experimental), quando usar e um exemplo na agência da Ana. Volte aqui sempre que esquecer um comando.
Começar a aula
Objetivo: achar o recurso certo para cada situação e usar o exemplo dele como ponto de partida no seu trabalho.
Toque ou clique em cada grupo.
Role a página: cada etapa abaixo acende a sua parte do diagrama.
Recursos do Claude Code no terminal para deixar várias sessões trabalhando sozinhas e ver todas numa tela só. As sessões em segundo plano e a tela de todas (agent view) estão em prévia (research preview): funcionam, mas podem mudar.
Recursos para uma sessão acompanhar as outras e só trazer a você o que é decisão. No app Desktop, a própria sessão lê e avisa as outras. Agent teams é experimental e vem desligado.
Projects é uma conversa que coordena várias tarefas rodando na nuvem, mesmo com o seu computador desligado. Beta pública nos planos Pro e Max, liberando aos poucos.
O resultado da conversa vira uma página pronta no claude.ai: documento, apresentação, design ou painel. É privado até você decidir compartilhar o link.
Comandos que você digita dentro da sessão para medir o consumo, enxugar o contexto, diagnosticar a instalação e deixar tudo à vista na barra de status.
Cada grupo resolve um problema: fazer várias coisas ao mesmo tempo, não se perder entre elas, continuar com o computador desligado, mostrar o resultado e não gastar demais.
Rodar em paralelo, coordenar, levar para a nuvem, entregar o resultado e controlar o custo.
Recursos do Claude Code no terminal. Os que começam com claude você digita no terminal; os que começam com / você digita dentro da sessão. Prévia (research preview) = já funciona, mas ainda pode mudar. A tecla ←: numa sessão normal, com o prompt vazio, manda a sessão para trás; dentro da agent view, volta para a lista.
O que é: começa uma sessão que trabalha sozinha, sem ocupar o seu terminal. Ela mostra um código curto (o id) e os comandos para acompanhar.
Quando usar: numa tarefa que demora e não precisa de você a cada passo. Ponha o --bg logo depois de claude.
claude --bg --name padaria "monte o relatório semanal da padaria com os números de segunda-feira"
O que é: a agent view, uma tela com todas as sessões em segundo plano, em grupos. Needs input = precisa de você. Working = trabalhando. Ready for review = tem um PR (pedido de mudança no código) esperando revisão. Completed = terminadas, com falha ou paradas. Pinned = as que você fixou (Ctrl+T).
Quando usar: para ver de uma vez quem precisa de você. Enter entra numa sessão; ← no prompt vazio volta para a lista. Na caixa de busca, s:blocked mostra só quem espera por você.
Ana digita claude agents e vê a sessão da clínica em Needs input: ela quer saber qual foto usar no post de quarta. Ana aperta Enter, responde e volta com ←.
O que é: três comandos para uma sessão específica. claude attach [id] abre a sessão no terminal. claude logs [id] mostra o que ela fez por último, sem entrar. claude stop [id] para a sessão. O id é o código curto que o claude --bg mostrou; troque [id] por ele, sem os colchetes.
Quando usar: quando você quer espiar ou parar uma sessão sem abrir a tela de todas.
claude logs [id da sessão da loja] mostra que a planilha de preços já tem a coluna nova. Ana não precisa entrar.
O que é: manda a sessão em que você está para o segundo plano. A tecla ← no prompt vazio faz o mesmo.
Quando usar: você começou uma tarefa na sessão normal, percebeu que vai demorar e quer o terminal de volta.
Ana começou a planilha de preços da loja na sessão normal. Vai demorar: ela digita /background e a sessão aparece no claude agents, trabalhando.
O que é: dá uma cor à sessão. A cor aparece na agent view.
Quando usar: quando você tem várias sessões e quer reconhecer cada uma de relance.
Ana digita /color em cada sessão e escolhe uma cor por cliente: na lista, ela acha a da padaria, a da clínica e a da loja sem ler o nome.
Sessão gestora é um papel, não um botão: uma sessão que acompanha as outras. Estes são os recursos que fazem esse papel.
O que é: no app Desktop, aba Code, uma sessão lista as outras sessões dessa aba, lê o que cada uma fez e manda recado entre elas. Você pede em linguagem simples.
Quando usar: para saber quem fez o quê e passar um aviso sem abrir cada sessão. Limite: ela vê só as sessões do próprio Desktop (não as da nuvem nem as do terminal), por padrão as 20 mais recentes.
Numa sessão nova, Ana pergunta: "qual sessão mexeu no relatório da padaria?" e depois pede: "avise a sessão da loja que a tabela de preços mudou".
O que é: no app Desktop, Ctrl+N (Cmd+N no Mac) abre uma sessão nova e Ctrl+Tab troca entre elas. Alt+clique (Option no Mac) numa sessão da barra abre as duas lado a lado.
Quando usar: para acompanhar duas sessões ao mesmo tempo sem trocar de aba.
Ana deixa a sessão dos posts da clínica à esquerda e a da planilha da loja à direita, e vê as duas andando.
O que é: uma sessão vira a líder (lead) e cria colegas (teammates). Cada colega trabalha no próprio contexto, eles conversam entre si e dividem uma lista de tarefas.
Como ligar: vem desligado. No Mac ou Linux, digite no terminal, antes de abrir o claude: export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. No Windows (PowerShell): $env:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. Para ficar ligado sempre, use o settings.json (está na cola de comandos).
Limites: um time por sessão, colega não cria colega, a líder é fixa. Antes de montar time, veja se sessões separadas já resolvem: é mais leve.
"Monte um time com dois colegas: um escreve os posts da semana da clínica e o outro revisa cada post antes de mim."
O que é: uma pergunta rápida que não interrompe a sessão nem entra no histórico. Ela responde só com o que a sessão já sabe, sem usar ferramentas. No Desktop, o mesmo é o side chat (Ctrl+; ou Cmd+; no Mac).
Quando usar: para tirar uma dúvida no meio de uma tarefa longa sem atrapalhar.
Enquanto a sessão da loja preenche a planilha: /btw em qual coluna você está agora?
Projects do Claude Code (barra lateral do claude.ai/code ou aba Code do app Desktop) não é o mesmo que os Projetos do chat do claude.ai, que são pastas de conversas. Beta pública nos planos Pro e Max, liberando aos poucos; sem acesso, aparece uma lista de espera. Antes de usar, decida o que pode subir para a nuvem.
O que é: um projeto é uma conversa só, em que o Claude abre uma thread (uma tarefa) para cada trabalho. Cada thread costuma ser uma sessão na nuvem e continua com o seu computador desligado.
Quando usar: quando você quer deixar trabalho andando sem depender da sua máquina.
Ana cria o projeto Agência e pede: "proponha uma thread para cada cliente e espere meu OK".
O que é: as instruções do projeto são o combinado que toda thread nova recebe: para que serve, como conferir antes de dizer pronto e o que precisa do seu OK. A memória são as notas que o Claude grava: decisões, requisitos, armadilhas.
Quando usar: no começo do projeto, para não repetir as mesmas regras em cada tarefa.
Instruções da Ana: "Toda entrega passa pela regra de pronto antes de você dizer que terminou. Nada é publicado sem o meu OK. No máximo duas threads ao mesmo tempo."
O que é: um painel ao lado que acompanha as threads e mostra um ponto quando uma espera por você. O app Desktop avisa quando uma thread erra ou precisa de você.
Quando usar: para saber, de relance, o que está andando e o que está parado.
De manhã, Ana escreve no projeto: "status de todas as threads". A thread dos posts da clínica está esperando a aprovação dela.
O que é: dá para pedir que uma thread rode no seu computador em vez da nuvem (Work locally, ou claude remote-control no terminal).
Atenção: aí o computador precisa estar ligado e acordado, como numa sessão local.
A planilha de preços da loja fica só no computador da Ana. Ela pede que essa thread rode no computador dela e deixa a máquina ligada.
No claude.ai, o resultado da conversa vira uma página pronta. O artifact publicado é privado até você compartilhar.
O que é: o Claude monta um documento, uma apresentação ou um design a partir da conversa, com visual pronto.
Quando usar: quando o resultado vai para alguém ler, e não só para você.
"Transforme o relatório semanal da padaria num documento de uma página, com os três números principais no alto."
O que é: painel (dashboard) é uma página com números e gráficos. Motion é um vídeo animado feito por código, que exporta em MP4. Os dois ainda estão em beta.
Quando usar: quando uma tabela fica mais clara como gráfico, ou quando você quer uma animação curta.
"Faça um painel com a planilha de preços da loja: os dez produtos mais caros e a variação desde o mês passado."
O que é: o artifact pode ter IA embutida: a pessoa pergunta em linguagem simples dentro da página. Para mostrar a alguém, use o botão Share. Quem abre precisa entrar com uma conta Claude.
Atenção: nos planos Pro e Max dá para liberar para qualquer pessoa com o link, menos quando o artifact usa o Claude (IA embutida) ou conecta seus apps. Nesse caso, convide a pessoa por e-mail.
O painel da loja tem IA embutida, então Ana não pode liberar por link: ela convida a dona da loja por e-mail. A dona entra com a conta Claude dela e pergunta na própria página: "qual produto subiu mais?".
Comandos que você digita dentro da sessão do Claude Code.
O que é: /usage mostra o custo da sessão e quanto do limite do plano você já usou. Nos planos Pro e Max, o limite vale por janelas de tempo: uma de 5 horas e uma semanal. /context mostra uma grade colorida do que ocupa o contexto. No app Desktop, o anel ao lado do seletor de modelo mostra o uso.
Quando usar: antes de abrir mais sessões, e sempre que o limite parecer acabar rápido.
Antes de abrir a sessão dos posts da clínica, Ana roda /usage e vê quanto já gastou da janela de 5 horas.
O que é: mostra quais skills carregadas você não usa, quanto contexto elas custam e onde desligar cada uma. Skill é uma pasta com instruções que o Claude pode usar; a lista de todas entra em cada mensagem.
Quando usar: quando o /context mostra muita coisa carregada sem uso.
Na sessão da padaria, /skill-doctor mostra duas skills que Ana testou uma vez e nunca mais usou. Eram skills pessoais: ela move as duas pastas para fora de ~/.claude/skills (o ~ é a sua pasta pessoal; no Windows, C:\Users\[você]\.claude\skills). A aula 7 mostra o passo a passo.
O que é: diagnóstico da instalação e da configuração. Dentro da sessão, /doctor propõe correções e espera você confirmar. No terminal, claude doctor só lê e mostra.
Quando usar: quando algo não funciona como antes.
A sessão da loja passou a dar erro ao abrir. Ana roda claude doctor no terminal: ele só lê e mostra o que achou. Depois, dentro da sessão, /doctor propõe a correção e espera o OK dela.
O que é: liga um modelo mais forte que o Claude consulta nos momentos-chave. Os nomes, do mais forte para o mais leve: Fable, Opus, Sonnet. Digite /advisor fable, /advisor opus ou /advisor sonnet; /advisor off desliga.
Atenção: consultar outro modelo gasta mais. Use só onde a decisão vale.
Na sessão que monta a regra de pronto dos posts da clínica, Ana liga /advisor opus. Nas outras, deixa desligado.
O que é: um resumo de uma linha do que a sessão fez, na hora.
Quando usar: ao voltar para uma sessão depois de um tempo fora.
Ana volta do almoço, entra na sessão da loja e digita /recap: uma linha diz que faltam duas categorias na planilha.
O que é: a status line é a barra no rodapé do Claude Code. Com /statusline seguido do que você quer ver, o Claude monta essa barra sozinho.
Quando usar: para ver o tempo todo o uso do contexto e do limite do plano, sem digitar comando.
/statusline mostre a pasta, o modelo e o uso do contexto e do limite de 5 horas em %
O que é: plugin é um pacote de extensões do Claude Code. Mod é um plugin que muda como o Claude Code aparece e se comporta: uma faixa, um painel, um aviso, um comando novo. Mods não têm proteção (sandbox): rodam com o mesmo acesso que você.
Antes de instalar: claude plugin validate ./pasta-do-mod lista o que ele faz sozinho (hooks) e o que ele pede. Para começar sem nenhuma customização: claude --safe-mode.
Ana abre o repositório inema-mods (link no fim da aula), clica em Code › Download ZIP, descompacta e roda claude plugin validate na pasta do mod escolhido. Só instala se a lista do que ele faz sozinho fizer sentido.
Todos os comandos do guia, para copiar. Troque o que está entre [ ] pelo seu, sem os colchetes.
claude --bg --name [nome] "[pedido]" claude agents claude attach [id] claude logs [id] claude stop [id]
/background /color /btw [pergunta]
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
$env:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
{
"env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" }
}proponha uma thread para cada tarefa e espere meu OK no máximo duas threads ao mesmo tempo status de todas as threads
/usage /context /skill-doctor /doctor /advisor opus /advisor off /recap /statusline mostre a pasta, o modelo e o uso do contexto e do limite de 5 horas em %
claude doctor claude plugin validate ./pasta-do-mod claude --safe-mode
Use um trabalho seu de verdade, de preferência um dos que você listou na aula 1.
Abra o terminal (no Windows, o PowerShell pelo menu Iniciar; no Mac, o app Terminal), rode claude --version e anote a versão. Abra a barra lateral do claude.ai/code ou a aba Code do app Desktop e veja se aparece Projects. Os recursos em prévia e beta mudam e chegam aos poucos. Se Projects pedir para entrar na lista de espera, anote isso: é a resposta.
Pronto quando: você anotou a versão do Claude Code e se tem ou não Projects.
Escolha um recurso de três grupos diferentes do mapa (por exemplo: claude --bg, a conversa entre sessões e /usage). Use o exemplo da Ana como modelo e troque pelo seu trabalho. Sem terminal? Use só o app Desktop: a conversa entre sessões, o anel de uso e um artifact.
Pronto quando: você escreveu, para cada um dos três, o comando ou pedido que usou e o que apareceu na tela.
Cada pergunta é uma situação. A explicação aparece depois da sua resposta.
Pergunta 1 de 4
Ana quer ver, numa tela só, qual das três sessões em segundo plano está esperando por ela. O que ela usa?
Pergunta 2 de 4
Ana vai viajar e quer que os posts da clínica continuem sendo feitos com o computador dela desligado. Qual recurso serve?
Pergunta 3 de 4
Qual destes recursos é experimental e vem desligado?
Pergunta 4 de 4
Ana baixou um mod e quer saber o que ele faz sozinho antes de instalar. Qual comando ela roda?
Escolha uma alternativa. A explicação aparece depois da sua tentativa.