Claude Code · Codex · agentes

O Claude mudou. 15 comandos para dominar

Os modelos ficaram bons o bastante para dispensar boa parte das instruções longas. O jogo agora é outro: dar o contexto certo, deixar o agente executar e exigir prova de que terminou.

Banner: robô humanoide de visor preto trabalhando numa bancada com quinze cartões luminosos
Em resumo

Este é um guia grátis para quem usa o Claude Code (e vale quase tudo para o Codex e outros agentes). São 15 mudanças em cinco camadas: skills, modelo e configurações, plano e prova, contexto e delegação, e trabalho rodando sem você. Para cada uma você vê o que mudou, como implementar com o comando exato e o que a comunidade INEMA já tem sobre o assunto. No fim há um kit para baixar, com modelos prontos, e a lista dos próximos kits que vamos criar.

A tese

De prompt detalhado para contexto, execução e prova

Antes a gente escrevia trezentas linhas ensinando o agente a trabalhar. Hoje ele já sabe. O que ele não sabe é o seu contexto, e ninguém garante que terminou se você não pedir prova.

Banner em grade: skills, modelo, prova, contexto, delegação, sem você

🧭 Contexto

Dê ao agente só o que ele não descobre sozinho: o seu negócio, as suas regras, onde estão as coisas. Em arquivos pequenos, chamados quando precisa.

⚙️ Execução

Deixe o agente trabalhar, delegar e continuar. Os padrões melhoraram; mexer em tudo costuma piorar.

✅ Verificação

"Terminei" não é prova. Teste passando, arquivo gerado e um verificador que confere antes de deixar parar.

As 15 dicas

Cinco camadas, quinze mudanças

Cada dica tem três partes: o que mudou, como implementar e o que já existe no INEMA. O selo diz se o comando foi conferido na nossa instalação ou se você deve conferir na sua.

Robô de visor preto diante de um manual enorme fechado e, ao lado, um único cartão pequeno com três linhas
Camada 1

Skills

A skill deixa de ser um manual e vira uma lista de correções.

1

Skills menores

confirmado na 2.1.303
SKILL.md curto
O que mudou

O modelo já escreve bem, organiza e evita texto robótico sem receita. Skill longa repete o que ele já faz e ocupa contexto. Ela deve guardar só o que ele erra e o conhecimento que só você tem.

Como implementar
  1. Faça a tarefa sem skill nenhuma, numa sessão limpa.
  2. Anote só o que saiu errado ou diferente do seu jeito.
  3. A skill vira essa lista: correções, nomes, caminhos, exceções do seu negócio.
  4. Revise a cada troca de modelo: o que ele passou a acertar sai da skill.
No INEMA
2

Avalie com e sem a skill

confirmado na 2.1.303
claude plugin eval --ablation with-without
O que mudou

Skill boa é a que melhora o resultado. A comparação é simples: a mesma tarefa com a skill e sem ela. Se não ganhar, enxugue ou apague.

Como implementar
  1. Escreva 3 a 5 casos reais da tarefa, com o que conta como resultado bom.
  2. Rode a mesma tarefa com e sem a skill (o eval de plugin já faz o braço "sem").
  3. Compare a nota: perdeu ou empatou, corte linhas; continuou empatando, apague.
  4. Guarde os casos: viram o teste da próxima versão da skill.
No INEMA
3

Grave a tarefa e vire skill

conferir na sua versão
Record a skill (app desktop)
O que mudou

Em vez de escrever a skill, você faz a tarefa uma vez e o agente observa. Como ele só registra o que não saberia sozinho, a skill sai pequena.

Como implementar
  1. No app desktop, use a gravação de skill e faça a tarefa como sempre faz.
  2. Sem o recurso: faça a tarefa com o agente e, no fim, peça "liste só o que eu precisei corrigir".
  3. Leia a skill gerada e tire o que for óbvio.
  4. Passe pela dica 2 antes de adotar.
No INEMA
Painel com um único seletor de modelo travado e um botão de esforço girando de alto para médio
Camada 2

Modelo e configurações

Escolha um modelo, fique nele e use o esforço como alavanca.

4

Trocar de modelo custa cache

confirmado na 2.1.303
/model
O que mudou

Cada modelo guarda o próprio cache da conversa. Trocar no meio faz o histórico inteiro ser lido de novo, sem desconto, e de novo na volta. Modelo menor também pode precisar de mais tentativas: barato por token não é barato por tarefa.

Como implementar
  1. Escolha o modelo no começo do trabalho e fique nele.
  2. Pergunta fácil no meio? Peça "resposta rápida, sem pensar muito" em vez de trocar.
  3. Precisa de outro modelo? Abra outra sessão para aquela tarefa.
  4. Fique de olho no consumo com /context e /usage.
No INEMA
5

Esforço é a alavanca

confirmado na 2.1.303
claude --effort medium
O que mudou

Em vez de descer de modelo, baixe o esforço. Esforço alto não é sempre melhor: o modelo pode pensar demais e gastar à toa.

Como implementar
  1. Deixe o esforço padrão para a maior parte do trabalho.
  2. Tarefa simples e repetitiva: esforço baixo.
  3. Só suba quando um problema difícil travar, e volte depois.
  4. Para a sessão toda: claude --effort low|medium|high.
No INEMA
6

Advisor: o forte só quando precisa

confirmado na 2.1.303
/advisor
O que mudou

Um modelo mais barato faz o trabalho e consulta um mais forte só nas decisões difíceis: antes de escolher o caminho, quando o mesmo erro volta e antes de dizer que terminou. Ligar o advisor não quebra o cache da sessão.

Como implementar
  1. Numa sessão em modelo médio, ligue o advisor com o modelo forte.
  2. Deixe o agente decidir quando consultar.
  3. Recurso experimental: veja se compensa no seu plano.
  4. Em assinatura, ficar num modelo só costuma ser o mais simples.
No INEMA
7

Os padrões melhoraram

confirmado na 2.1.303
/config
O que mudou

Modelo, esforço, permissões e o ponto de compactar já vêm ajustados para cada modelo. Quem mexe em tudo "para melhorar" costuma piorar.

Como implementar
  1. Comece com os padrões.
  2. Só mude uma configuração quando algo der errado, e anote o motivo.
  3. Mudou? Meça antes e depois (dica 2 vale aqui também).
  4. Revise o que você mudou há meses: talvez já não precise.
No INEMA
Robô de visor preto entregando uma caixa a um inspetor que confere com uma lupa e um selo verde
Camada 3

Plano e prova

O plano é para você aprovar. A prova é para ninguém precisar acreditar.

8

Plano é para o humano

confirmado na 2.1.303
Shift+Tab · --permission-mode plan
O que mudou

O modelo já planeja bem sem o modo de plano. O que continua valendo é o plano para você: definir o objetivo, os limites e o que conta como pronto. Mudar um plano é muito mais barato que desfazer cem linhas.

Como implementar
  1. Trabalho grande ou confuso: peça que o agente te entreviste e grave o plano num arquivo.
  2. Comece a construção numa sessão nova, lendo esse arquivo.
  3. Trabalho que cabe num parágrafo: pule o plano, escreva só objetivo, pronto e limites.
  4. Quer travar edições até aprovar? Aí o modo de plano ainda ajuda.
No INEMA
9

/goal precisa de prova

confirmado na 2.1.303
/goal <condição com prova>
O que mudou

O /goal faz o agente continuar até cumprir uma condição. Mas quem confere lê só a conversa: não abre arquivo nem roda teste. Se o agente disser "terminei", ele acredita.

Como implementar
  1. Antes, peça ao agente um script de checagem com regras objetivas (ex.: checa.sh).
  2. Escreva a condição com prova: "checa.sh passa e você mostra a saída".
  3. Inclua o que não pode mudar e um limite de voltas.
  4. Exemplo: /goal checa.sh passa e a saída aparece aqui; o modelo fica igual; pare em 15 voltas.
No INEMA
10

Hook que confere antes de parar

conferir na sua versão
hook Stop · type prompt | agent
O que mudou

Hook roda sempre, no momento certo, sem depender da boa vontade do modelo. Agora o hook pode ser um prompt ou um agente: quando o Claude tenta parar, outro modelo olha o trabalho e diz "pode" ou "não pode, porque…". O motivo volta como próxima instrução.

Como implementar
  1. Peça ao próprio Claude: "adicione um hook de Stop que confira X antes de deixar parar".
  2. Tipo prompt: lê só a conversa, rápido e barato.
  3. Tipo agente: abre arquivos e confere de verdade (experimental).
  4. Use para regra que não pode falhar: "nunca mandar e-mail ao cliente, só rascunho".
No INEMA
Arquivo com gavetas pequenas etiquetadas por ícones e um robô puxando só uma delas
Camada 4

Contexto e delegação

Janela grande não é memória boa. Guarde em arquivos e delegue certo.

11

Contexto gigante perde detalhe

confirmado na 2.1.303
/context · /clear · /compact
O que mudou

Ter um milhão de tokens de espaço não quer dizer lembrar de tudo. Testes de recuperação mostram que a taxa de acerto cai quando o contexto enche. Mais janela é mais lugar para perder detalhe.

Como implementar
  1. Guarde o contexto reutilizável em arquivos pequenos, em pastas.
  2. No CLAUDE.md, ponha só ponteiros: "para X, leia pasta/x.md".
  3. Trabalho longo: grave um handoff, dê /clear e retome com /prime.
  4. Use /context para ver o que está ocupando espaço.
No INEMA
12

Subagente ou fork

confirmado na 2.1.303
subagente · fork
O que mudou

Subagente começa do zero, recebe só o que você passa e devolve só o resultado: deixa a conversa principal limpa. Fork é uma cópia da conversa: sabe tudo o que foi dito e aproveita o mesmo cache. O Claude já escolhe entre os dois sozinho.

Como implementar
  1. Tarefa isolada (gerar uma imagem, buscar um dado): subagente.
  2. Tarefa paralela que precisa de todo o histórico: fork.
  3. Deixe o Claude escolher; peça fork só quando souber que precisa do histórico.
  4. Lembre: subagente pode não ler o seu CLAUDE.md. Passe as regras no pedido.
No INEMA
13

Workflows de vários agentes

confirmado na 2.1.303
/config → Dynamic workflow size
O que mudou

Para pesquisa de verdade, o Claude monta um fluxo com vários agentes que buscam por ângulos diferentes, cruzam as fontes e descartam o que não se sustenta antes de você ver.

Como implementar
  1. Use só quando a tarefa pede: pesquisa, comparação, verificação cruzada.
  2. Antes, em /config, ponha o tamanho do workflow em pequeno (menos de cinco agentes).
  3. Defina o que conta como resposta boa e as fontes aceitas.
  4. Confira o custo depois da primeira rodada.
No INEMA
Escritório à noite com o notebook fechado e, numa tela grande na parede, robôs trabalhando numa sala de servidores
Camada 5

Rodando sem você

Com verificação garantida, o trabalho pode rodar com o computador desligado.

14

Rotinas que acordam com um evento

confirmado na 2.1.303
/schedule (ou /routines)
O que mudou

Rotinas rodam o Claude na nuvem. Além do horário, podem começar por um pedido web ou um evento do GitHub, como um pull request novo. Qualquer sistema que mande um pedido para a URL dispara o agente.

Como implementar
  1. Crie a rotina com nome, pedido, repositório e gatilho.
  2. Gatilho por API (confira na sua versão): você recebe uma URL e um token. Guarde o token como senha.
  3. Deixe só os conectores que essa rotina usa.
  4. Ponha a verificação (dicas 9 e 10) antes de deixar rodar sozinha.
No INEMA
15

Sessões na nuvem

confirmado na 2.1.303
claude --cloud · claude --teleport
O que mudou

Cada tarefa ganha uma máquina na nuvem. Você abre várias, fecha o notebook e elas continuam. Depois puxa a sessão inteira de volta para o seu computador.

Como implementar
  1. Comece com claude --cloud "descrição da tarefa".
  2. Acompanhe pelo navegador ou pelo app.
  3. Traga de volta com claude --teleport.
  4. Confira se o seu plano retoma a tarefa sozinho quando o limite de uso renova: se sim, ela gasta a próxima janela sem perguntar.
No INEMA
Kit para baixar

Kit 15 Comandos

Um .zip com modelos prontos para copiar: skill de correções, roteiro de avaliação com e sem skill, /goal com prova, script de checagem, hook de Stop, handoff, ponteiros de contexto e a cola dos 15 comandos.

O que vem no kit

Três modelos para copiar agora

Dica 9

/goal com prova

Cole na sessão depois de criar o checa.sh.

/goal o script ./checa.sh termina com código 0 e você cola a saída completa aqui; nada fora da pasta src/ foi alterado; pare depois de 15 voltas e diga o que faltou
Dica 1

Skill só de correções

Estrutura mínima de uma skill que vale a pena.

---
name: relatorio-semanal
description: Relatório semanal de vendas da loja. Use quando pedirem o relatório da semana.
---

# Só o que o agente erra sem esta skill
- Os números vêm de dados/vendas.csv, nunca da memória.
- Semana = segunda a domingo (não domingo a sábado).
- Devolução entra como venda negativa, não some.
- Nomes de produto como estão na planilha, sem traduzir.
- Fecho sempre com 3 ações para a próxima semana.
Dica 10

Pedido do hook de Stop

Peça ao próprio Claude para montar o hook.

Adicione um hook de Stop neste projeto. Quando você tentar parar, um verificador deve: (1) ler o docs/padrao.md, (2) ler o último arquivo em relatorios/, (3) responder se o relatório quebra alguma regra do padrão. Se quebrar, você continua corrigindo. Mostre o trecho do settings.json antes de gravar.
Outras considerações

Antes de sair mudando tudo

🔎 Confira na sua versão

Recursos novos mudam de nome e saem do experimental. Rode claude --help e /help antes de seguir uma receita. O selo de cada dica diz o que conferimos aqui.

💳 Assinatura × API

Em assinatura o que pesa é o limite de uso; na API é a conta. Advisor e troca de modelo fazem sentido diferente em cada caso.

🧪 Experimental é experimental

Advisor e hook do tipo agente ainda podem mudar. Use em projeto de teste antes do principal.

🔐 Gatilho é porta aberta

A URL e o token de uma rotina disparam o agente. Trate como senha, limite os conectores e ponha teto de gasto.

📏 Meça, não acredite

Vale para skill, configuração e para este guia. Compare antes e depois com a mesma tarefa.

🗂️ Contexto ainda é seu

Nenhum recurso novo substitui saber o que o agente precisa ler. Pastas pequenas e ponteiros continuam sendo o melhor investimento.

Próximos kits

Kits que podemos criar

Propostas para a comunidade, cada uma ligada a um projeto que já temos. Ainda não estão prontas.

Kit Skill Enxuta

Roda cada skill instalada com e sem, mostra a nota e sugere o que cortar.

↳ Auditar Skills · Ablação

Kit Prova de Pronto

Gera o checa.sh a partir do pedido e monta o /goal com prova e limite de voltas.

↳ Execução Longa

Kit Handoff Verificado

Hook que confere o handoff contra os arquivos reais antes do /clear.

↳ skillmanager3x · /prime

Kit Verificador de Stop

Biblioteca de hooks de Stop por tipo de trabalho: relatório, código, post, vídeo.

↳ cchooks · inema-mods

Kit Delegar Certo

Regra prática de subagente, fork e workflow, com teto de agentes e custo.

↳ OSWork · Arquiteto de Execução

Kit Agente por Evento

Rotina que acorda com webhook (pedido novo, mensagem, PR) para negócios.

↳ LOOP-R · agentes comerciais

Kit Config Limpa

Compara o seu settings com o padrão e lista o que mudou sem motivo.

↳ faxina-agentes

Na comunidade

O que o INEMA já tem sobre isso

Cursos, guias e kits abertos que aprofundam cada camada.

Vídeo

As 15 mudanças em vídeo

O explicativo completo e um reel curto para mandar para quem ainda escreve prompt de trezentas linhas.

Explicativo (16:9)

Baixar MP4 · YouTube

Reel (9:16)

Baixar MP4

Para lembrar

Menos instrução, mais prova

Robô de visor preto e uma pessoa diante de um quadro com três ícones: pasta, engrenagem e selo de verificado
Skillsó o que ele erra
Modeloescolha um e fique
Provateste, arquivo, verificador
Contextoarquivos pequenos e ponteiros
Sem vocêsó depois da verificação

O avanço não é dar mais autonomia ao agente. É ele trabalhar com menos instrução, gastar menos contexto e provar que terminou.