1O chat que esquece

Quem usa um chat de IA no navegador conhece a rotina. Abre uma conversa nova e explica tudo de novo: quem é, o que faz, que cliente está atendendo, em que tom escreve.

A Paula, 45, é consultora de RH e trabalha sozinha. Ela perdia uns dez minutos por conversa só apresentando o trabalho para a IA. No Codex, esse material mora numa pasta, e ele vai até lá antes de responder.

2Um projeto é só uma pasta

Não existe nada escondido atrás da palavra "projeto". É uma pasta igual às que você cria no computador, com subpastas e arquivos dentro.

A pasta da Paula se chama paula-escritorio. Dentro, uma subpasta por assunto: clientes, propostas, modelos de e-mail e posts do LinkedIn. O Codex trabalha direto nesses arquivos, sem cópia para outro lugar.

3Abra a pasta no Codex

No aplicativo do Codex, use a opção de adicionar projeto e escolha a pasta. Ela aparece na barra lateral. O nome do botão pode mudar entre versões: procure por "projeto" ou pelo ícone de pasta. Na dúvida, escolha a sua pasta de teste e nunca a pasta Documentos inteira.

O Jorge, 52, tem uma loja de materiais de construção. Ele criou a pasta loja-jorge com três arquivos que usa toda semana. Antes de escrever, conferiu o nome da pasta perto da caixa de mensagem.

$ codex -C loja-jorge

4A primeira resposta que cita seus arquivos

Com a pasta aberta, faça um pedido que só dá para responder lendo o que está nela. Se a resposta citar os seus arquivos, o projeto está funcionando.

O Jorge pediu um resumo da pasta, sem colar nada na conversa. Toque nos dois botões e compare as respostas.

1Um arquivo de texto com marcas leves

O AGENTS.md fica na pasta principal do projeto. O final .md quer dizer que ele está em Markdown: texto comum com duas ou três marcas.

Você não precisa escrever o arquivo à mão: na prática, o Codex escreve e você só confere. Uma cerquilha no começo faz um título; um tracinho faz um item de lista. Só isso.

2Ele lê antes da sua mensagem

Em toda conversa nova daquele projeto, o Codex lê o AGENTS.md antes de ler o seu pedido. O que estiver lá, ele sabe sempre, sem você repetir.

A Paula escreveu no arquivo: "posts do LinkedIn sem emoji e com no máximo 5 linhas". Dias depois, numa conversa nova, pediu um post sem lembrar a regra.

3Quem você é, as regras e o mapa

Um bom AGENTS.md cabe em dez linhas. Primeiro, quem você é e qual o papel do Codex. Depois, as regras de trabalho. Por fim, um mapa de onde está cada coisa na pasta.

O Jorge escreveu o da loja-jorge numa tarde. O mapa evita que o Codex procure às cegas, e evita que o Jorge explique de novo onde fica o estoque.

4Um por projeto, e revisado com o uso

Cada projeto tem o seu AGENTS.md: o da loja-jorge não serve na pasta da Paula. E o arquivo cresce aos poucos. Corrigiu o Codex duas vezes pela mesma coisa? Vira uma linha nova.

A Paula pedia sempre "tire o travessão" das propostas. Na segunda vez, acrescentou a regra ao arquivo e parou de pedir.

1O modelo pensa; o Codex dá as mãos

O modelo de IA é a parte que pensa e escreve. Sozinho, não abre arquivo nem confere nada. O Codex é um harness: liga o modelo às ferramentas e o faz trabalhar em etapas.

O Jorge usava um chat no navegador para conferir o estoque. Colava a planilha toda vez, e a resposta vinha sem conferência. No Codex, o mesmo pedido abre o arquivo da pasta e confere antes de responder.

2Pensar, agir, olhar e só então responder

Quando você manda um pedido, o Codex não sai escrevendo. Pensa no que precisa, usa uma ferramenta e olha o resultado. Pensa de novo. Repete até ter tudo, e só então responde.

O Jorge pediu os itens com menos de 10 unidades. O Codex pensou "preciso do estoque", leu estoque.csv, contou as linhas e só então respondeu.

3Abra o registro do que ele fez

Perto da resposta aparece uma linha curta, algo como "trabalhou por 25 s". Clique nela e o registro abre: o raciocínio resumido e cada ação, na ordem. O texto e o lugar dessa linha podem mudar entre versões. Não achou? Peça: "liste os arquivos que você leu, na ordem".

A Paula pediu um e-mail de retorno para a cliente Acme e abriu o registro para ver de onde veio a informação.

4O registro mostra o que falta na pasta

Ler o registro ensina. Resposta sobre algo da sua pasta sem nenhuma leitura de arquivo é sinal de chute. Peça: "leia o arquivo antes de responder". Se ele procurou muito até achar, falta uma linha no mapa do AGENTS.md.

O Jorge viu o Codex abrir cinco arquivos até achar os preços. Acrescentou ao mapa "preços → catalogo.md". No pedido seguinte, ele foi direto.

1Pedido é um passo; objetivo é o destino

Na aula 3 você viu o ciclo do agente: pensar, usar uma ferramenta, responder. Num pedido comum, ele faz esse ciclo e devolve a vez para você. Se algo falta, ele para e pergunta.

Com o /goal, você entrega um objetivo. Ele repete o ciclo quantas vezes precisar: tenta, confere, muda de caminho. Só para quando chega lá ou quando você manda parar.

Jorge pediu os cartões das promoções da semana, mas errou o nome do arquivo da lista. Veja as duas reações ao mesmo obstáculo.

2O objetivo precisa dizer quando acabou

Quem persegue um destino precisa reconhecer a chegada. Por isso o melhor objetivo é verificável: tem número, formato ou uma conferência que dá para fazer.

Objetivo de gosto, como "até ficar bom", também roda. Só que aí quem decide o fim é o Codex, não você.

Paula queria atualizar os posts do LinkedIn. A primeira versão do objetivo não dizia quando parar.

3Escreva o que ele não pode fazer

Um agente que insiste até o fim precisa de cerca. Termine todo objetivo com uma linha de limites: o que não apagar, o que não mudar, o que não enviar.

O seu controle fica no começo e no fim. No começo, você escreve o critério e os limites. No fim, você confere. No meio, deixe trabalhar: dar ordem nova a cada minuto faz o Codex perder o fio.

Jorge pediu os 18 cartões da liquidação de fim de mês. A regra da loja de não mexer em preços já estava no AGENTS.md dele.

4Quando não usar /goal

Insistir até o fim é ótimo para pesquisar e organizar. Em outras tarefas, é justamente o perigo: se o caminho estiver errado, ele erra muitas vezes seguidas.

Três sinais pedem pedido comum, passo a passo: risco (dinheiro, apagar, enviar a cliente), objetivo vago e nenhum jeito de conferir.

Numa segunda cheia, Paula pensou em pôr no /goal as respostas a todos os e-mails de candidatos. Desistiu e separou as tarefas assim.

1Local é a sua máquina; nuvem é a de outra empresa

Local é o que existe só no computador à sua frente. Se ele estiver desligado, ninguém chega naquele arquivo.

Nuvem é um computador de uma empresa, ligado o tempo todo, que você acessa pela internet. O drive na internet é nuvem. No Codex, nuvem quer dizer um computador da OpenAI.

Paula guarda os contratos assinados num drive na internet e a pasta paula-escritorio no notebook. São dois lugares, com regras diferentes.

2localhost só abre na sua máquina

Quando o Codex cria uma página, ele costuma abrir uma prévia num endereço como localhost:8008.

A palavra localhost quer dizer "este computador aqui". Em outro aparelho, ela aponta para aquele aparelho, onde não existe página nenhuma.

Jorge pediu um rascunho da página da loja e mandou o link no grupo da família. O filho abriu no celular.

3Cada conversa roda em um lugar

No aplicativo, ao começar uma conversa, você escolhe onde ela roda. Local: o Codex trabalha na pasta do projeto, com o modelo e a permissão que você escolheu. Nuvem: ele trabalha num ambiente separado da OpenAI, sem os seus arquivos.

A escolha fica perto da caixa de mensagem. O nome do botão pode mudar entre versões.

Jorge ia atualizar a planilha estoque.csv e quase começou a conversa na nuvem. Uma pergunta resolveu: a tarefa precisa dos meus arquivos?

4Com o computador ligado, o celular vira controle

Com o notebook ligado e o Codex aberto, o local já se comporta quase como nuvem. No aplicativo do ChatGPT no celular, na área de acesso remoto, aparecem as conversas do Codex do computador. Você continua de onde parou.

O celular só manda o pedido e mostra a resposta. Quem trabalha é o computador, com os arquivos dele.

Paula estava na sala de espera de um cliente e precisou relembrar uma proposta antiga, que ficou no notebook de casa.

1Teste no original não tem volta

Quando o Codex mexe direto nos arquivos do projeto, a mudança vale na hora. Se o resultado ficar estranho, o jeito antigo já se foi.

Jorge tem uma página simples da loja, na pasta loja-jorge/site, que os clientes já usam. Ele quis cores novas e um menu diferente. Compare as duas vezes que ele pediu.

2Worktree é uma cópia ligada ao original

Copiar a pasta na mão ("site-copia", "site-copia2") vira bagunça rápido. O Git faz isso de forma organizada.

Ele guarda o histórico, isto é, as versões salvas da pasta. E cria uma worktree: outra pasta de trabalho, ligada ao mesmo histórico. Como as duas se conhecem, dá para levar só as mudanças boas da cópia para o original depois.

Na loja do Jorge, a cópia ficou no mesmo computador, numa pasta ao lado do projeto.

3main é o original; o resto é linha de teste

Toda worktree trabalha numa branch. Pense numa linha de metrô: a main é a linha que todo mundo usa. A branch é um ramal que sai dela para testar uma estação nova.

Se o teste der certo, o ramal volta para a linha principal. Se não der, ele é desativado e a main nem percebe.

Paula abriu o aplicativo e viu "main" e outro nome que não conhecia ao lado do projeto dela. O Codex tinha criado uma cópia sozinho para trabalhar em paralelo. Nada estava errado.

4Teste na cópia, depois junte ou descarte

No aplicativo, ao começar uma conversa, existe a opção de trabalhar numa nova worktree local. Ela fica perto da caixa de mensagem. O nome do botão pode mudar entre versões.

Para levar o resultado ao original, peça ao Codex. O cuidado é um só: ele mostra o que vai mudar antes de juntar.

Jorge gostou do visual novo na cópia. Antes de pôr no ar, pediu para ver o que mudaria.

$ codex --worktree

1A pasta existe, só está escondida

Toda pasta cujo nome começa com ponto fica oculta. O ponto quer dizer "isto é ajuste do programa, não mexa sem querer". Para ver, peça ao sistema para mostrar os itens ocultos. Nada muda nos arquivos: eles só aparecem.

Vamos usar a pasta do projeto da aula 1. Não fez a aula 1? Abra qualquer pasta que você já usou no Codex.

A Paula abriu a pasta paula-escritorio e não achou nenhum .codex. Apertou o atalho de itens ocultos e ele apareceu, meio transparente, junto do AGENTS.md.

2Projeto ou usuário: a sala ou o prédio

A primeira .codex fica dentro do projeto e vale só para ele. A segunda fica na sua pasta pessoal do computador e vale para todos os projetos. É a diferença entre a regra de uma sala e a regra do prédio inteiro.

A pasta pessoal é a que tem o seu nome de usuário. No Windows fica em C:\Usuários\seu-nome; no Mac, em Usuários › seu-nome. Mostre os itens ocultos nela e a .codex global aparece.

Nos comandos, a pasta pessoal ganha o apelido ~ (o sinal de til). Por isso a global aparece escrita como ~/.codex.

O Jorge queria que a loja-jorge usasse sempre o modelo mais leve. Mas não queria mudar a pasta das propostas para a prefeitura, que pede mais cuidado. A preferência foi para a sala, não para o prédio.

3O config.toml por dentro é uma lista

O coração dessas pastas é o config.toml. O nome assusta, mas cada linha traz o nome da preferência, um sinal de igual e o valor. Texto vai entre aspas.

A Paula abriu o arquivo global no bloco de notas e encontrou duas linhas. Em cinco minutos entendeu: o modelo que ela usa por padrão e quanto ele pensa antes de responder.

model = "gpt-6-astra"
model_reasoning_effort = "medium"

4Peça a mudança e pergunte onde ela vai

Você não precisa saber o nome da preferência. Diga em português o que quer e faça a pergunta que evita surpresa: "isso vai no .codex do projeto ou no global?". O Codex consulta a própria documentação e mostra a linha antes de gravar.

O Jorge pediu para a loja-jorge pensar no nível médio, sem mexer nos outros projetos. Veja o que voltou.

Mexe com comandos? No terminal dá para mudar o esforço só por uma sessão, sem tocar no arquivo. Ao fechar, volta ao padrão.

codex -c model_reasoning_effort="high"

1Cada modelo tem força e gasto

O Codex é o programa em volta. Quem pensa lá dentro é o modelo de IA, e você escolhe qual. Os mais fortes resolvem problemas difíceis, mas consomem mais da sua cota. Os leves respondem rápido e gastam pouco.

Cota é o limite semanal de uso da sua assinatura. Não é dinheiro: é quanto trabalho você pode pedir na semana.

Para entregar um saco de cimento na rua de trás, o Jorge manda a moto. Para uma carga de tijolos, manda o caminhão. Ninguém usa caminhão para levar um parafuso.

2Três prateleiras: Luna, Sol e Astra

Abra o seletor de modelo e veja os nomes. Hoje, a família principal tem três. O GPT-6-Astra é o mais forte e o que mais consome. O GPT-6.1-Sol é o cavalo de trabalho do dia a dia. O GPT-6-Luna é rápido e econômico, feito para tarefas fáceis.

A lista também mostra a geração anterior: GPT-5.6-Sol, Terra e Luna. Funciona, mas num trabalho novo não há motivo para escolhê-la. Os nomes mudam com o tempo; as três prateleiras ficam.

A Paula clicou no seletor embaixo da caixa de mensagem e viu a lista. O nome do botão pode mudar entre versões; ele costuma mostrar o modelo atual.

3O gasto se mede em pedaços de texto

O modelo não lê palavras inteiras. Ele lê tokens, e são eles que medem o gasto. A entrada é o que ele lê: seu pedido, o AGENTS.md, os arquivos. A saída é o que ele escreve, inclusive o raciocínio. Saída gasta mais que entrada.

A Paula fez dois pedidos na mesma manhã. Os dois gastaram cota, mas de jeitos diferentes.

No Codex você entra com a conta do ChatGPT e usa a assinatura, com cota semanal. A API é outro caminho, para programas e automações. Ela cobra por milhão de tokens, e o modelo mais forte custa mais. Para uso pessoal, a assinatura rende muito mais.

4Troque de modelo no meio da conversa

Você não fica preso ao modelo do começo. A troca vale para a próxima mensagem: escolha no seletor e só então escreva o pedido. A conversa continua; muda só quem pensa na próxima resposta.

A Paula desenhou a estrutura de um treinamento novo com o Astra. Na hora dos e-mails de convite, passou para o Luna.

Prefere digitar comandos? No terminal, você escolhe o modelo ao abrir. O padrão de todas as sessões fica no config.toml da aula 7.

codex -m gpt-6-luna

1Esforço é o tempo de rascunho do modelo

Pergunte a uma consultora experiente "que horas é a reunião?" e ela responde na hora. Pergunte como reestruturar o RH de uma empresa de 80 pessoas e ela pede tempo para pensar. O esforço é isso: o mesmo modelo, com mais ou menos rascunho antes de responder.

São seis degraus, com nomes em inglês: low (baixo), medium (médio), high (alto), xhigh (extra alto), max (máximo) e ultra. O ultra, além de pensar o máximo, divide o trabalho sozinho com subagentes (aula 16). O GPT-6-Luna vai só até max.

O Jorge abriu o seletor de esforço, embaixo da caixa de mensagem, ao lado do modelo. O nome do botão pode mudar entre versões.

2Suba o esforço só quando há algo a descobrir

O raciocínio conta como saída, o tipo de gasto mais pesado (aula 8). Cada degrau a mais é mais rascunho, e todo esse rascunho sai da sua cota, mesmo que você nunca leia. A qualidade sobe, mas cada degrau rende menos que o anterior.

Esforço não deixa um e-mail mais bonito. Ele ajuda quando existe um erro escondido, um plano com etapas ou uma decisão com prós e contras.

O Jorge deixou o esforço em xhigh depois de um problema difícil e esqueceu. No dia seguinte, usou assim para revisar placas.

3Modo rápido: mesma resposta, entregue antes

O modo rápido é um botão de ligar e desligar perto do seletor, chamado "Fast" no aplicativo; o nome pode mudar entre versões. Ele entrega duas vezes mais depressa e consome mais cota pelo mesmo trabalho. O raciocínio é o mesmo: é como pagar a entrega expressa do mesmo produto.

Um cliente da Paula ligou pedindo um resumo da proposta enquanto esperava na linha. Ela ligou o modo rápido, mandou o pedido e desligou em seguida.

4Monte uma vez a sua tabela pessoal

Decidir modelo e esforço a cada conversa cansa. Monte uma vez a tabela tarefa → modelo → esforço e consulte. Comece tudo em GPT-6.1-Sol com medium. Veio fraco? Suba o esforço. Ainda fraco? Troque para o Astra. Foi exagero? Desça para o Luna ou para low.

A Paula salvou a tabela dela em paula-escritorio/tabela-modelos.md. Depois citou o arquivo no AGENTS.md. Agora o Codex avisa quando um pedido parece pedir outro nível.

Tarefa                        Modelo        Esforço
E-mail de confirmação         GPT-6-Luna    low
Proposta a partir do modelo   GPT-6.1-Sol   medium
Post do LinkedIn              GPT-6.1-Sol   medium
Programa de treinamento novo  GPT-6-Astra   high

Mexe com comandos? No terminal, dá para abrir uma sessão com outro esforço sem mudar o padrão. O padrão de todas fica no config.toml da aula 7.

codex -c model_reasoning_effort="high"

1Ele mexe de verdade, por isso pede licença

O Codex cria, renomeia e apaga arquivos. Também roda comandos e usa a internet. Para isso não virar risco, ele trabalha dentro de uma sandbox. Dentro dela, ele mexe na pasta do projeto, que é a pasta aberta no Codex, com o nome na barra lateral. Para sair dela, ele para e pergunta.

Jorge pediu "limpe a pasta do site da loja". O Codex leu a pasta e, antes de apagar qualquer coisa, mostrou o que pretendia fazer e esperou a resposta dele.

2Três modos, um seletor

No aplicativo, o seletor de permissão fica embaixo da caixa de mensagem, junto do modelo e do esforço. O nome do botão pode mudar entre versões. Hoje são três modos, e cada um pergunta menos que o anterior.

Arriscado, para ele, é apagar arquivos ou mandar dados para fora do computador. Ele mesmo faz essa triagem.

Paula deixa o seletor em Pedir aprovação quando abre uma pasta de cliente pela primeira vez. Assim ela vê cada passo antes de acontecer.

Quem prefere digitar comandos pode usar o terminal no lugar do seletor. É opcional.

$ codex -s workspace-write -a on-request
$ codex --approve-for-me
$ codex -s danger-full-access -a never

3Comece perguntando tudo, depois afrouxe

Nas primeiras semanas, fique em Pedir aprovação. Cada pergunta mostra em que arquivo ele vai mexer e por quê. Quando você perceber que aprova sempre as mesmas coisas, passe para Aprovar por mim.

Paula pediu uma proposta para a cliente Acme salva em Documentos, fora da pasta do projeto. Veja a diferença entre os dois modos.

4O que ele nunca pode fazer, vira regra escrita

A revisão automática separa o que parece arriscado em geral. Ela não sabe que a sua planilha de estoque é sagrada. Para isso, peça ao Codex que registre a proibição na configuração do projeto. Você não precisa achar o arquivo: ele mostra o texto antes de gravar e, se quiser, diz onde gravou. Depois, teste a regra.

Jorge não quer que nenhum preço mude sem ele ver antes. Ele pediu a regra e, em seguida, testou pedindo uma remarcação.

1Uma skill é uma receita que melhora

Pense numa panqueca que queimou. Você anota na receita: "trinta segundos a menos de cada lado". A próxima sai boa, e você nem pensa mais nisso. Uma skill funciona igual: cada correção entra na receita.

Paula escreve a descrição dos posts do LinkedIn toda semana. Antes, repetia as regras a cada pedido. Hoje, ela pede a descrição e o Codex já segue o jeito dela.

2Por dentro: etiqueta no topo, receita embaixo

A skill mora numa pasta própria, com um arquivo chamado SKILL.md. No topo, entre duas linhas de três traços, ficam o nome e a descrição de quando usar. Embaixo, as instruções em texto comum.

O Codex não lê todas as receitas inteiras. Ele olha só as descrições e escolhe a que serve. Por isso a descrição precisa dizer, com clareza, em que situação a skill entra.

Esta é a skill de descrição de posts da Paula, inteira.

---
name: descricao-post
description: Use quando eu pedir a descrição de um post para o LinkedIn.
---
# Regras
- De 2 a 4 frases. Sem tópicos.
- Tom próximo e profissional.
- Termine com uma pergunta para o leitor.
# Passos
1. Leia o rascunho que eu passar.
2. Ache o tema central em uma frase.
3. Escreva seguindo as regras.

3Crie a partir do que já deu certo

Não escreva a skill do zero. Faça a tarefa uma vez com o Codex, corrija até ficar boa e, no fim, peça a receita. Ele já viu cada correção e escreve a skill a partir daí.

Jorge montou a promoção da semana com os itens parados no estoque. Pediu duas correções: desconto de no máximo 20% e o preço antigo riscado. Depois, pediu a skill.

4Chame por texto ou pela barra, e melhore

Há dois jeitos de usar a skill. Pedir em português, e o Codex escolhe a receita pela descrição. Ou digitar na caixa de mensagem o nome dela com uma barra na frente: é o jeito garantido.

Na segunda seguinte, Jorge abriu uma conversa nova e testou os dois jeitos.

Saiu algo de que você não gostou? Diga "gostei disso, não daquilo; atualize a skill". A próxima vez já sai corrigida.

1As receitas moram na pasta .agents

Cada skill tem uma pasta própria dentro de .agents/skills/. Dentro dela fica o SKILL.md. Ao lado ficam o AGENTS.md e a pasta .codex, das preferências.

Pastas que começam com ponto ficam escondidas por padrão. Não achou? Pergunte ao Codex: "liste as pastas que começam com ponto neste projeto e o que há dentro de .agents".

Paula fez essa pergunta e viu as três receitas que já tinha criado no escritório.

2No projeto ou global: a pergunta que decide

Há dois endereços. Em .agents/skills/ dentro do projeto, a skill vale só ali. Em ~/.agents/skills/, na sua pasta pessoal, ela vale em todos os projetos. O sinal ~ é o atalho para a sua pasta pessoal: no Windows, C:\Usuários\seu-nome; no Mac, a pasta com o seu nome.

Pergunte: "eu usaria esta receita em outro projeto?". Se sim, ela é global.

A skill da promoção da semana lê o estoque.csv da loja: fica no projeto loja-jorge. A skill que revisa a ortografia de qualquer texto serve para tudo o que Jorge escreve: fica na pasta pessoal.

3A receita pode abrir outros arquivos

O SKILL.md não precisa carregar tudo. Ele pode apontar para um guia de voz, um modelo ou uma tabela. O Codex abre esses arquivos quando a receita manda. Mudou o modelo? Você edita um arquivo só, e a skill passa a usar a versão nova.

A skill proposta-cliente da Paula manda ler três arquivos antes de escrever. Ela pediu uma proposta e conferiu o que ele abriu.

4Projeto do Claude Code: peça para ele fazer a mala

O Claude Code é outro agente que trabalha em pastas. As ideias são as mesmas; mudam os nomes. Lá, as regras ficam no CLAUDE.md e as receitas na pasta .claude. Aqui, no AGENTS.md e em .agents. Os dois arquivos de regras podem conviver na mesma pasta. Nunca usou o Claude Code? Este passo é só para quem usa: pule para a prática.

Jorge tinha montado o projeto da loja no Claude Code. Primeiro copiou a pasta para outro lugar, como segurança. Depois pediu ao Codex a adaptação.

1Um plugin acaba com o copia e cola

Um plugin é uma conexão pronta entre o Codex e um aplicativo que você já usa. Com ele ligado, o Codex lê e age no aplicativo direto, dentro do que você autorizou.

Existem plugins para Gmail, Google Drive, Canva, ClickUp, LinkedIn e muitos outros. O catálogo cresce o tempo todo.

Paula respondia candidatos assim: abria o Gmail, copiava a mensagem, colava no Codex, pegava o rascunho e colava de volta. Se esquecia um anexo, a resposta saía torta.

2Conecte uma vez, com a sua conta

No aplicativo do Codex existe uma área de Plugins. Você procura o aplicativo pelo nome, clica para conectar e entra com a sua conta. O nome do botão pode mudar entre versões; procure por "Plugins" ou pelo ícone de peça.

Na tela de autorização, o próprio aplicativo pergunta o que o Codex pode ver e mexer. Leia antes de aceitar: procure as palavras ver, editar e apagar. Quando der, fique só com ver, que é só leitura.

Jorge começou pelo Google Drive, onde fica o catálogo da loja. Liberou só leitura. Para testar, pediu a lista das cinco pastas mais recentes e viu nomes reais voltarem.

$ codex plugin list
$ codex plugin add <nome>
$ codex plugin remove <nome>

3Depois é só pedir em português

Você não precisa "chamar" o plugin. Cite o aplicativo no pedido e o Codex usa a conexão no mesmo ciclo de sempre: pensa, usa a ferramenta, responde.

O plugin traz o material. Uma skill, se você tiver, dá o padrão da resposta. E rascunho vem antes de envio: e-mail mandado não volta.

Paula pediu os rascunhos de resposta aos candidatos da vaga de analista da cliente Acme, usando a skill que montou na aula 11. Nada saiu sem a revisão dela. Não fez a aula 11? Tire do pedido a linha da skill: o plugin funciona igual.

4Libere pouco e desconecte o que não usa

Cada plugin é uma porta aberta para uma conta sua. A regra é dar só o que a tarefa precisa e revisar a lista de tempos em tempos. Para desconectar, abra o plugin na área de Plugins e use o botão de desconectar.

E quando o aplicativo não tem plugin? Ainda há saídas. Uma é o MCP, se o serviço oferecer. Outra é uma API com chave guardada fora da conversa. A última é o navegador, tema da próxima aula.

Jorge revisou os plugins no fim do mês. Achou um de design que nunca usou e um de agenda com poder de apagar eventos. Desconectou o primeiro e refez o segundo só para leitura.

1Um navegador dentro do Codex

O aplicativo do Codex tem um navegador embutido: uma aba de internet que mora dentro dele, separada do seu navegador de sempre, para o Codex trabalhar sem mexer nas suas abas. O Codex abre essa aba, lê a página, clica nos botões e preenche campos. Você acompanha ao vivo e pode interromper.

O nome do botão pode mudar entre versões; procure por "navegador" ou pelo ícone de globo.

Toda segunda, Jorge entrava no portal do fornecedor, copiava os pedidos da semana e conferia um por um com a planilha estoque.csv. O portal não tem plugin. Agora o Codex faz a coleta e a comparação.

2Quem digita a senha é você

O navegador do Codex guarda a sessão, como o seu navegador de sempre. Você faz o login uma vez, com as próprias mãos, na aba do navegador. Nas próximas tarefas, ele já encontra a porta aberta.

Senha nunca vai na conversa nem em arquivo da pasta. E lembre: sessão aberta dá ao Codex o mesmo acesso que você tem naquele site.

Paula participa de uma comunidade de RH sem integração nenhuma. Ela abriu a aba do navegador no projeto paula-escritorio, digitou usuário e senha e viu o nome dela no topo da página.

3Peça a tarefa e diga onde está a cerca

O pedido é como qualquer outro: o site, o que buscar e onde guardar. A diferença é a cerca. Ali ele mexe numa conta real, então você escreve o que ele não pode fazer.

Paula lia as discussões da comunidade toda segunda e anotava as dúvidas repetidas para virar post. Agora pede a coleta e só escreve.

4Navegador é o último degrau

Existem três jeitos de o Codex falar com um serviço, como degraus de uma escada. Primeiro, o plugin, a porta pronta da aula 13. Depois, uma API ou um MCP, portas oficiais que pedem configuração. Por último, o navegador.

O navegador funciona em quase tudo, mas é o mais lento e quebra quando o site muda um botão de lugar. Tarefa semanal por ele precisa ser conferida de vez em quando.

Antes de pedir a coleta no portal do fornecedor, Jorge perguntou se havia caminho melhor. E deixou uma regra fixa no AGENTS.md da loja-jorge: pagamento, compra e envio, pare e me chame.

1Localhost é só para você

Quando o Codex faz uma página, ela costuma rodar em localhost. Na sua tela fica perfeita. No celular do cliente, o mesmo link não abre.

Publicar é copiar a página para um computador na nuvem, ligado dia e noite, e ganhar um endereço público. Para projetos simples, o próprio Codex faz isso, na área de Sites.

Jorge pediu uma página com as promoções da semana, a partir do arquivo promocoes.csv da loja-jorge. Mandou o link no grupo de clientes. Ninguém conseguiu abrir.

2Peça a publicação com uma revisão antes

Na mesma conversa em que a página foi feita, escreva "transforme isso num site". Os sites publicados ficam numa área própria do aplicativo. O nome do botão pode mudar entre versões; procure por "Sites".

Antes de subir, peça três conferências: nada de dado pessoal de cliente, a lista do que vai subir e o site fechado no começo.

Jorge revisou preços, telefone e endereço da loja no localhost. Só então pediu a publicação.

3Público ou privado: decida pelo conteúdo

Todo site publicado tem uma chave de visibilidade. Público: qualquer pessoa com o link abre. Privado: só você ou o seu time, entrando com a conta.

Link difícil de adivinhar não é privado. Basta alguém repassar.

O catálogo do Jorge é público: quanto mais gente vir, melhor. Paula montou um painel com o andamento dos processos seletivos dos clientes dela. Tem nome de candidato, então fica privado.

4Acompanhe e tire do ar quando precisar

Na área de Sites, cada site tem um painel de visitas, a chave de visibilidade e a opção de tirar do ar. Site privado só abre para você e o seu time. Para mostrar a outra pessoa, publique só o que pode ser público.

Jorge viu no painel quais dias trazem mais visitas e mudou o dia de mandar a promoção. A regra de publicar virou linha no AGENTS.md da loja: nenhum dado de cliente em página pública.

1Um principal planeja, os ajudantes trabalham juntos

O Codex com quem você conversa é o agente principal. Ele pode disparar subagentes. Cada ajudante recebe uma parte, roda o próprio ciclo de pensar, agir e responder, e devolve um relatório.

Cada ajudante começa só com a instrução que recebeu, sem a conversa inteira. Por isso o foco dele fica estreito. No fim, o principal junta os relatórios numa resposta.

A Paula escreve um post por semana sobre RH e inteligência artificial. A pesquisa tinha três frentes e tomava a manhã de segunda. Agora as três frentes rodam ao mesmo tempo.

2Peça as partes e o modelo dos ajudantes

Não precisa programar. O pedido diz três coisas: quais são as partes, que o principal não deve fazer sozinho e onde guardar o resultado.

A assinatura tem um limite semanal de uso, a cota. Três ajudantes ao mesmo tempo gastam cota ao mesmo tempo. Vale a regra da aula 8: modelo pela tarefa, e o modelo mais forte gasta mais. O principal planeja e junta, então fica com o GPT-6-Astra. Os ajudantes buscam e resumem, então podem usar o GPT-6-Luna, rápido e econômico.

A Paula abriu o projeto paula-escritorio e mandou o pedido abaixo. Veja o começo da resposta: primeiro ele lê o AGENTS.md dela, depois divide.

$ codex -m gpt-6-astra

3Acompanhe cada ajudante e junte bem

Quando os ajudantes entram em ação, a conversa mostra um marcador colorido para cada um, com o nome dele. Clicando no marcador, você vê o registro daquele ajudante: o que pensou, que ferramentas usou e o que respondeu. O formato pode mudar entre versões.

Você conversa só com o principal. Se um ajudante saiu do tema, diga ao principal para refazer só aquela parte.

O Jorge, da loja de materiais de construção, queria comparar três fornecedores de cimento. Pediu um ajudante por fornecedor, olhando preço, prazo e frete, e uma tabela final no projeto loja-jorge.

4Nem toda tarefa merece ser dividida

Dividir tem custo. Cada ajudante gasta cota para entender a parte dele, e o principal gasta mais para juntar. Em tarefa pequena, sai mais caro e mais lento.

Três perguntas decidem. As partes são independentes? Cada uma é grande o bastante? Elas mexem em arquivos diferentes? Com três "sim", divida. Com um "não", faça numa conversa só.

O Jorge pensou em pôr três ajudantes para atualizar o estoque.csv ao mesmo tempo. Seria um erro: um apagaria a mudança do outro.

1A tarefa é um pedido com horário

Não há nada de especial dentro de uma tarefa agendada. É o pedido que você escreveria na caixa de mensagem, mais um dia e uma hora. Quando o relógio chega lá, o Codex cola esse pedido numa sessão e começa a trabalhar.

Essa sessão é igual a qualquer outra. Abre o mesmo projeto, lê o mesmo AGENTS.md e usa as mesmas skills. Se o pedido é bom à mão, será bom agendado.

Toda sexta no fim da tarde, a Paula abria o Codex e digitava o mesmo pedido: o resumo da semana do projeto paula-escritorio. Agora o pedido está agendado.

2Quatro escolhas montam a tarefa

No aplicativo, as tarefas ficam numa área chamada Agendadas. O nome do botão pode mudar entre versões; procure por "agendar" ou por um ícone de relógio.

Toda tarefa pede quatro escolhas: onde roda, em que projeto, em que conversa e com que frequência. A mais esquecida é onde roda. Uma tarefa local usa os arquivos do seu computador, então ele precisa estar ligado na hora marcada. Para começar, escolha local e um horário em que o computador fica ligado.

O Jorge quer, toda segunda às 7h, a lista dos itens com estoque baixo do projeto loja-jorge. Se ele desligar o computador da loja na sexta, a tarefa de segunda só roda quando ele ligar de novo.

3Peça ao Codex para criar a tarefa

Preencher o formulário funciona, mas existe um caminho mais curto: pedir em português. O Codex conhece o projeto. Sabe onde está a planilha e o que as regras proíbem, então escreve o pedido da tarefa com esses detalhes.

Termine pedindo para ver o pedido antes de salvar. É ali que você percebe um horário errado ou um limite esquecido.

O Jorge abriu o projeto da loja e escreveu o pedido abaixo, com dia, hora, o limite de unidades e o que a tarefa não pode fazer.

4O que roda sozinho prepara; quem decide é você

Na frente da tela, você vê cada passo e pode interromper. Numa tarefa agendada, ninguém está olhando. Por isso a regra é simples: rascunho, lista e relatório podem rodar sozinhos. Enviar, pagar e apagar só com você presente.

Escreva no pedido o que a tarefa não pode fazer. Peça também um registro no fim, e revise uma a uma as execuções da primeira semana.

A tarefa de sexta da Paula escreve o resumo da semana e os rascunhos de e-mail de acompanhamento. Mas os e-mails ficam como rascunho: quem envia é ela, na segunda, depois de ler.

1A voz comanda, não só transcreve

Ditado você já conhece: fala, e o texto aparece. O modo de voz do Codex vai além. Você conversa como falaria com um assistente, e ele age: cria conversas no projeto e manda cada parte do trabalho para o lugar certo.

Ele também liga uma conversa à outra. Sem isso, você seria o mensageiro, copiando daqui e colando ali.

O Jorge falou: "abra duas conversas; na primeira, crie a imagem da promoção da semana a partir do catálogo; na segunda, escreva o texto do post. Quando a imagem ficar pronta, mande para a segunda e junte num post só. Não publique nada."

2Comece pelo projeto e peça o plano de volta

No aplicativo, há um botão para começar uma conversa nova por voz, perto da caixa de mensagem. O nome do botão pode mudar entre versões; procure pelo ícone de microfone. Na primeira vez, o computador pede permissão para usar o microfone.

Fale o objetivo na primeira frase, depois os detalhes, e termine com o limite. Áudio corta palavras, então peça o plano em três frases antes de ele começar.

A Paula escolheu o projeto paula-escritorio na barra lateral e tocou no microfone. Enquanto ela falava, a transcrição aparecia na tela.

3No celular: voz na rua, decisão na mesa

O modo de voz continua ouvindo enquanto você troca de aplicativo no computador. Pelo acesso remoto no app do ChatGPT no celular, que você viu na aula 5, dá para falar com o Codex que roda no seu computador. O computador precisa estar ligado. Não ligou o acesso remoto? Use a voz no próprio computador: o resto da aula vale igual.

Pelo celular, peça leitura, resumo, rascunho e lista. Deixe envio, pagamento e exclusão para a frente da tela. A permissão que você escolheu na aula 10 continua valendo pela voz.

No caminho para a loja, o Jorge pergunta se precisa ligar hoje para o fornecedor de cimento. Quando ele chega, a resposta está na conversa.

4Os 18 conceitos num pedido só

A Paula tem reunião com um cliente novo amanhã. A caminho de casa, ela abre o modo de voz no celular e fala por um minuto. Ela não cita nenhum conceito pelo nome: fala do trabalho.

Quem conhece as peças monta um pedido assim. Toque nos dois botões para ver a fala e os conceitos que ela aciona. Não precisa decorar os números: são só as aulas onde cada peça apareceu.

Ela pede uma pesquisa com subagentes, a skill de proposta, uma worktree para comparar versões e os plugins do Drive e do Gmail. O projeto já traz o AGENTS.md dela.