Glossário
📚 Navegação da Série: O artigo anterior [37 Solução de Problemas Comuns] ajudou você a eliminar um a um os erros mais comuns, travamentos e comportamentos estranhos ao executar o Codex. Este artigo tem um uso diferente — não foi feito para ser lido do início ao fim, mas para ser consultado a qualquer momento: reunimos todos os termos que surgiram ao longo do livro em um dicionário portátil; se você não se lembrar bem de algum termo, basta voltar aqui e pesquisar. O próximo artigo [39 Gestão e Governança Corporativa] abordará como gerenciar o Codex nos níveis de equipe e empresa.
Pessoal, chegamos até aqui neste tutorial e já nos deparamos com um caminhão de termos.
Ciclo de agente, sandbox, aprovação, esforço de raciocínio, service_tier, MCP, subagente, Skill, Hook... Quando aprendi sistematicamente esse tipo de ferramenta pela primeira vez, o que mais me desanimou foi exatamente isso — não porque algum conceito fosse muito difícil, mas porque havia nomes demais e eles se misturavam, de modo que, ao chegar no décimo, os cinco primeiros já tinham virado uma bagunça na minha cabeça.
Para ser sincero, ser desencorajado por termos técnicos é um problema comum para iniciantes, e não tem nada a ver com falta de inteligência. A solução para isso é simples: não tente decorar, consulte. Quando precisar de algum termo, volte aqui para dar uma olhada e depois continue trabalhando — depois de consultar três ou cinco vezes, ele vai se fixar na sua mente naturalmente.
Este artigo é aquele dicionário portátil preparado para você. Ele foi organizado por temas, com uma explicação bem simples em linguagem cotidiana para cada termo, seguida de uma frase sobre "o que isso realmente significa no Codex" ou uma analogia. Não precisa ler do início ao fim, use Ctrl+F para buscar o termo que travou você, leia e siga em frente.
Ao terminar de ler este artigo, você obterá:
- Um dicionário de termos do Codex agrupado por temas, onde cada termo é explicado em linguagem simples e acessível
- Conceitos básicos (ciclo de agente, janela de contexto, token) explicados de uma vez por todas, servindo de base para todos os outros termos
- Um local centralizado para consultar termos específicos do Codex (como
AGENTS.md,codex exec, sandbox, aprovação, esforço de raciocínio,service_tiere Chronicle) - Uma distinção clara em uma frase para o conjunto de cinco ferramentas de extensão (MCP, subagente, Skill, Hook, Plugin), para nunca mais confundi-las
- A distinção de posicionamento da série de modelos (como a linha
gpt-5.5), o significado de "visualização de pesquisa" (Research Preview) e quais dois modelos já foram descontinuados para você não usar mais
⚠️ Os comandos, chaves de configuração e comportamentos padrão neste artigo são baseados na documentação oficial do Codex; informações que mudam com a versão, como nomes de modelos e limites de planos, devem ser verificadas de acordo com o que é exibido no seu painel local de
/modelou no comandocodex --help. Não decore os nomes.
01 Conceitos Básicos: A Base de Todos os Termos
Este grupo reúne conceitos fundamentais — que não se limitam ao Codex, mas com os quais quase todas as ferramentas de programação de AI se deparam. Compreenda bem estes conceitos primeiro, para que depois seja mais fácil associar os demais.
Agente (Agent)
Em uma frase: Uma AI capaz de decompor tarefas por conta própria, chamar ferramentas, analisar os resultados e decidir o próximo passo — e não apenas uma caixa de chat de perguntas e respostas.
O que significa no Codex: O Codex é o "agente de programação" da OpenAI. Ele consegue ler código, alterar arquivos, executar comandos e rodar testes sozinho, enquanto você apenas acompanha o processo. Trata-se de uma categoria totalmente diferente do chatbot que você costuma usar — a caixa de chat apenas responde com um texto, enquanto o agente executa o trabalho completo.
Ciclo de Agente (Agentic Loop)
Em uma frase: O ritmo básico de trabalho do agente — Pensar → Fazer → Observar; se uma rodada não funcionar, tenta-se outra.
Analogia: O encanador. Ele não dá apenas uma olhada, cobra e vai embora — primeiro ele "pensa" (onde está vazando), depois "faz" (aperta algo, troca uma junta) e, em seguida, "observa" (abre a água para testar se ainda vaza). Se não funcionar, ele volta a apertar. O Codex trabalha exatamente nesse ciclo: lê arquivos, modifica o código, executa verificações e, se a validação falhar, faz mais uma rodada até resolver. Esse mecanismo é idêntico ao do Claude Code, apenas com uma roupagem diferente.
Janela de Contexto (Context Window)
Em uma frase: A quantidade total de informações que o modelo consegue "enxergar simultaneamente" de uma só vez; tem um limite e, se estiver cheio, o conteúdo mais antigo será descartado.
Analogia: A superfície de uma mesa de escritório. A mesa tem um tamanho limitado e a quantidade de documentos que você pode espalhar nela é restrita. Quando novos papéis são colocados sobre a mesa, os primeiros são empurrados para a borda ou até caem no chão — quando o modelo "esquece" o que foi dito anteriormente, na maioria das vezes é isso que acontece. Portanto, se você conversar por muito tempo ou inserir muito conteúdo irrelevante, ele acabará ficando menos eficiente. Esse também é o motivo da existência dos subagentes: mover os subprodutos ruidosos para fora da mesa de trabalho principal.
token
Em uma frase: A menor unidade de cobrança para o processamento de texto pelo modelo, equivalente aproximadamente a "uma palavra ou metade de uma palavra", pela qual todas as suas entradas e saídas são contabilizadas.
O que significa no Codex: Duas coisas estão diretamente atreladas a ele — créditos e dinheiro. Os planos de assinatura oferecem limites baseados no consumo de tokens, e o uso da chave de API consome dinheiro diretamente conforme os tokens utilizados; o preço unitário do modelo topo de linha é várias vezes superior ao do modelo leve. O "tamanho" da janela de contexto também é medido em quantidade de tokens.
| Termo | Resumo em uma frase |
|---|---|
| Agente | Uma AI que age por conta própria, não apenas responde a você |
| Ciclo de Agente | Pensar → Fazer → Observar; se não funcionar, tenta-se novamente |
| Janela de Contexto | A quantidade total de informações que consegue ver de uma vez; tem limite |
| token | Menor unidade para medir texto, relacionada a créditos e custo |
💡 Resumo em uma frase: Estes quatro são a base — o agente trabalha de forma independente, o ciclo é o seu ritmo, a janela de contexto é o tamanho de sua mesa e o token é a régua de precificação.
02 Conceitos Exclusivos do Codex: Termos Próprios desta Ferramenta
Este grupo é composto de recursos exclusivos do Codex, sendo também a origem de comportamentos que iniciantes costumam achar "instáveis". Entenda-os bem para não achar que o Codex age de maneira imprevisível.
AGENTS.md (Manual de Instruções do Projeto)
Em uma frase: Um arquivo markdown inserido no seu projeto que descreve as regras dele, o qual o Codex lê antes de começar qualquer trabalho.
Analogia: Um post-it colado na estação de trabalho. Você não fica repetindo todo dia para o seu colega: "usamos pnpm em vez de npm"; você apenas cola um post-it ali e ele lê por conta própria. O AGENTS.md é esse post-it para o Codex: como rodar a build, como executar os testes e como definir as nomenclaturas são coisas que você escreve uma vez e ele lê todas as vezes. Ele pode ser colocado globalmente (~/.codex/AGENTS.md) ou no diretório raiz do projeto, sendo que quanto mais próximo do diretório de trabalho, maior será a prioridade (ele equivale basicamente ao CLAUDE.md do Claude Code com outro nome).
codex exec (Comando Não Interativo)
Em uma frase: Uma forma de execução que não entra na interface interativa, na qual você envia um comando direto e obtém o resultado imediatamente, ideal para scripts e automações.
Analogia: Uma máquina de vendas automáticas (vending machine). O modo interativo padrão é como conversar com um atendente — você pergunta e ele responde, em várias rodadas. O codex exec é como comprar água em uma máquina: você insere a moeda, aperta o botão e o produto sai; tudo em um passo direto, sem conversas. Ele é a principal escolha para integração em CI, tarefas agendadas (cron jobs) e scripts em lote.
Sandbox
Em uma frase: Uma fronteira delimitada para o Codex: tudo o que estiver dentro dela ele faz sozinho, mas para sair dela ele precisa pedir sua autorização.
Analogia: As cercas de segurança de um parquinho. Os brinquedos dentro da cerca podem ser usados livremente sem precisar de supervisão constante; mas se a criança tentar pular a cerca para ir à rua, você precisa intervir. O sandbox controla duas coisas — quais arquivos ele pode modificar e se pode acessar a internet. Geralmente existem três níveis: read-only (apenas leitura, sem permissão para alterar nada), workspace-write (gravação no espaço de trabalho, o padrão diário, que permite alterar apenas o diretório onde você iniciou o Codex e bloqueia o acesso à internet por padrão) e danger-full-access (acesso total, o nome contém danger não é à toa, use com cautela).
Aprovação (Approval / Estratégia de Aprovação)
Em uma frase: Se o Codex deve parar e perguntar a você quando tentar "sair da fronteira" — este é outro controle que funciona em conjunto com o sandbox.
Analogia: O humor do segurança do portão. O sandbox é o portão físico, enquanto a aprovação é a rigidez do segurança. O nível untrusted bloqueia apenas comandos desconhecidos; o on-request executa o trabalho dentro dos limites e só pergunta quando precisar sair deles (o modo equilibrado mais comum); e o never faz tudo direto sem incomodar você. Lembre-se: o sandbox controla o "pode ou não pode", e a aprovação controla o "pergunta ou não pergunta" — não confunda as duas dimensões.
Esforço de Raciocínio (Reasoning Effort, chave de configuração model_reasoning_effort)
Em uma frase: O controle que define "quanto tempo o modelo deve pensar antes de agir"; quanto mais ele pensa, geralmente mais preciso ele é, mas também mais lento.
Analogia: O tempo concedido para resolver uma questão de prova. Diante do mesmo aluno brilhante, o resultado se ele apenas bater o olho e responder será muito diferente de quando ele tempo tempo para rascunhar e revisar os cálculos antes de entregar — a qualidade no segundo caso é infinitamente superior, embora seja mais demorado. Existem cinco níveis: minimal (quase sem pensar, resposta instantânea), low, medium, high e xhigh (nível máximo, dependendo do suporte do modelo). Se não estiver satisfeito com o resultado, não se apresse em trocar de modelo — aumentar um nível costuma resolver o problema; se achar muito lento, diminua um nível.
Resumo de Raciocínio (chave de configuração model_reasoning_summary)
Em uma frase: O quanto você deseja visualizar do "processo de raciocínio" do modelo.
O que significa no Codex: Os valores possíveis são auto / concise / detailed / none. Se quiser ver como ele pensa passo a passo, configure para detailed; se achar que isso polui a tela, mude para none para desativar. É apenas um ajuste de experiência de visualização, sem relação com a qualidade do resultado.
Nível de Serviço (service_tier)
Em uma frase: Define a prioridade da sua requisição — priorizar economia de custos ou velocidade.
Analogia: Envio padrão vs. envio expresso de uma transportadora. O nível fast (rápido) é definido oficialmente como "adicionar credits para acelerar o modelo em 1,5x", agindo como uma entrega expressa para garantir o prazo; o flex (flexível) é um nível convencional, sem aceleração extra. Se estiver com pressa e não se importar com o consumo de credits, você pode experimentar o fast, caso contrário, mantenha o padrão.
config.toml (Arquivo de Configuração)
Em uma frase: O arquivo de configuração global do Codex, localizado em ~/.codex/config.toml, no formato TOML.
O que significa no Codex: Aqueles controles mencionados acima — modelo padrão, esforço de raciocínio, modo sandbox, estratégia de aprovação e MCP servers — devem ser gravados neste arquivo caso queira que entrem em vigor a cada inicialização. Alterações temporárias são feitas por comandos com barra; alterações permanentes são salvas aqui.
Chronicle / Memória (Memory)
Em uma frase: Permite que o Codex se lembre de preferências e convenções do projeto discutidas anteriormente, para que você não precise explicá-las todas as vezes.
O que significa no Codex: A memória vem desativada por padrão, precisando ser ativada nas configurações ou adicionando memories = true na seção [features] do seu config.toml. Além disso, possui restrições regionais e é armazenada localmente. O Chronicle é uma visualização de pesquisa (Research Preview) experimental que vai além — utilizando o conteúdo da sua tela para ajudá-lo a entender no que você tem trabalhado recentemente, disponível atualmente apenas para usuários do ChatGPT Pro e apenas no macOS. Um conselho sincero: regras que realmente precisam entrar em vigor todas as vezes devem ser escritas no AGENTS.md, não dependa da memória para garantir isso.
Quando comecei a usar o Codex, o primeiro obstáculo que enfrentei foi o sandbox — pedi a ele para renomear arquivos em lote e dois arquivos na área de trabalho não mudaram nada. Achei que ele estava com problemas, mas ao ler a documentação descobri que o modo workspace-write os havia isolado fora do diretório do meu projeto. Neste grupo, a dupla mais importante para guardar na memória é formada pelo sandbox e pela aprovação; eles explicam 80% das vezes em que o Codex "se recusa a agir".
💡 Resumo em uma frase: Entre os termos exclusivos do Codex, sandbox + aprovação gerenciam as permissões,
AGENTS.mdgerencia as regras, esforço de raciocínio gerencia "quanto tempo pensar" ecodex execcuida da automação — tudo salvo noconfig.tomlpara vigorar permanentemente.
03 Capacidades de Extensão: Conectando as Habilidades do Codex ao Exterior
Enquanto os conceitos básicos e exclusivos formam o "corpo" do Codex, este grupo serve para "equipar" a ferramenta — estes cinco termos são semelhantes e muito fáceis de confundir, então vou diferenciá-los com uma frase cada.
MCP (Model Context Protocol / Protocolo de Contexto do Modelo)
Em uma frase: Um conjunto de padrões unificados que permite ao Codex conectar-se a várias ferramentas externas — bancos de dados, arquivos de design, navegadores e serviços de terceiros.
Analogia: Uma porta USB. Por padrão, o Codex alcança apenas arquivos e comandos locais, sem acesso ao seu Figma, documentações recentes ou bancos de dados online. O MCP é essa interface unificada: conecte uma vez e uma série de ferramentas externas estará disponível para ele. Não há necessidade de escrever código de integração específico para cada ferramenta, e esse é exatamente o valor de um "padrão".
Subagente (Subagent)
Em uma frase: Pequenos agentes despachados temporariamente pela conversa principal para realizar tarefas específicas em paralelo, trabalhando de forma independente e retornando apenas um resumo consolidado.
Analogia: Mensageiros trabalhando em paralelo. Se você (na linha principal de desenvolvimento) precisa revisar uma alteração sob três aspectos — segurança, desempenho e testes —, não precisa verificar os três pessoalmente um por um. Envie três mensageiros simultaneamente e cada um trará um resumo. Ponto crítico: o Codex nunca divide o trabalho automaticamente; você precisa especificar explicitamente em sua conversa para "iniciar alguns agentes em paralelo, aguardar que todos terminem e consolidar os resultados" para que ele aja. O seu principal valor é remover os subprodutos ruidosos do seu espaço de trabalho principal (lembra-se da janela de contexto?).
Habilidade (Skill / Agent Skills)
Em uma frase: Empacota um conjunto de etapas fixas em uma habilidade específica; você a escreve uma vez e, depois, o Codex pode executá-la facilmente seguindo as instruções.
Analogia: Um cartão de receita. Para tarefas que você pede repetidamente, como "resumir alterações não salvas e sinalizar riscos", em vez de digitar o comando inteiro todas as vezes, é melhor criar um cartão de receita (SKILL.md) contendo o name, description e as etapas. Depois disso, você pode chamá-la pelo nome ou o Codex pode associá-la automaticamente com base no que você disser. Funciona de maneira parecida com os "Atalhos" (Shortcuts) do celular.
Gancho (Hook)
Em uma frase: Um script automático atrelado a um momento específico do ciclo de vida de execução do Codex; uma vez ocorrido o evento, o script será obrigatoriamente acionado.
Analogia: Uma lâmpada com sensor de presença. Ela não quer saber quem você é ou para onde está indo; se o evento "alguém passar por perto" ocorrer, a luz acenderá inevitavelmente. O Hook funciona dessa forma — em momentos como "antes de chamar uma ferramenta", "depois de chamar uma ferramenta", "após responder" ou "no início da sessão", ele executa automaticamente o script que você definiu. A diferença entre ele e o AGENTS.md é: o manual de instruções é uma "solicitação", enquanto o Hook é uma "garantia de execução obrigatória".
Plugin
Em uma frase: Empacota várias Skills, MCP servers e integrações em um kit completo, permitindo a instalação de uma só vez, além de gerenciamento e remoção centralizados.
Analogia: Um "apartamento decorado planejado". Se comprar os itens avulsos, você terá que procurar cada modelo, conferir medidas e montar tudo sozinho; no formato de kit, você faz um único pedido e recebe o ambiente completo montado. Para uso pessoal de um único fluxo de trabalho, basta escrever uma Skill; se precisar reutilizar entre vários projetos, compartilhar com a equipe ou manter controle de versão unificado, aí sim vale a pena empacotar tudo como um plugin.
| Termo | Distinção rápida | Quando você vai utilizá-lo |
|---|---|---|
| MCP | Interface unificada para conectar ferramentas externas | Deseja conectá-lo a bancos de dados / arquivos de design / navegadores |
| Subagente | Executa tarefas específicas em paralelo e retorna o resumo | Uma tarefa precisa ser analisada sob vários aspectos simultaneamente |
| Skill | Empacota etapas fixas em uma única habilidade | O mesmo fluxo de processos é exigido repetidamente por você |
| Hook | Script acionado automaticamente em momentos específicos | Deseja forçar que "determinada ação rode automaticamente sempre" |
| Plugin | Vários recursos empacotados em um kit para instalação em um clique | Precisa de compartilhamento em equipe e gerenciamento de configurações completas |
💡 Resumo em uma frase: MCP conecta ferramentas, subagente divide tarefas, Skill empacota processos, Hook define os momentos e Plugin instala kits completos — guardando o que cada um resolve, você não irá confundi-los.
04 Relação de Modelos: Quem Enviar para Realizar o Trabalho
Este último grupo refere-se a "qual modelo está ajudando você no exato momento em que pressiona a tecla Enter". Os nomes dos modelos mudam com as versões; o que apresentamos aqui é o posicionamento e os conceitos, e para ver quais estão disponíveis de fato, consulte o painel local de /model.
gpt-5.5 (Topo de Linha, Padrão)
Em uma frase: O modelo topo de linha recomendado atualmente, sendo o mais poderoso e também o mais caro; caso não seja feita nenhuma configuração, ele é usado por padrão.
O que significa no Codex: Para tarefas complexas de programação, refatoração de múltiplos módulos, bugs difíceis e fluxos de pesquisa, ele é a escolha ideal. Na maioria dos casos ele é suficiente e, se você nunca configurou nada, ele é quem estará em execução.
gpt-5.4-mini (Leve, Rápido e Econômico)
Em uma frase: Um modelo leve que roda rápido e custa pouco, adequado para tarefas volumosas e simples, muito utilizado também por subagentes.
O que significa no Codex: Para trabalhos repetitivos e simples como corrigir pequenos bugs, ajustar formatações, adicionar comentários ou fazer limpezas em lote, utilizá-lo economiza tempo e dinheiro comparado ao modelo topo de linha.
gpt-5.4 (Versão Oficial, Diferente do mini)
Em uma frase: Um modelo intermediário oficial que se posiciona entre o topo de linha e o mini; continua ativo, não foi descontinuado e faz parte do mesmo grupo do gpt-5.4-mini — não confunda os dois.
O que significa no Codex: "Tem o mesmo nome, mas sem o sufixo mini" — ele é mais forte do que a versão mini, porém mais rápido e econômico que o modelo topo de linha gpt-5.5. Considere utilizá-lo quando precisar equilibrar custo e qualidade. O gpt-5.4-mini é a variante leve deste modelo, portanto não se tratam da mesma IA.
gpt-5.3-codex-spark (Tipo Instantâneo, Visualização de Pesquisa)
Em uma frase: Um modelo instantâneo otimizado para responder em segundos, ideal para iterações de alta frequência e ritmo dinâmico.
O que significa no Codex: Por ser uma visualização de pesquisa (Research Preview), atualmente está disponível apenas para assinantes do ChatGPT Pro; portanto, é normal caso ele não apareça para você, não significa um erro de instalação. É útil apenas em sessões de programação em par em tempo real, onde você precisa de respostas em frações de segundos para cada pergunta.
Visualização de Pesquisa (Research Preview)
Em uma frase: Uma versão experimental antecipada disponibilizada oficialmente para um grupo limitado de usuários para testes; seus recursos podem mudar a qualquer momento e a disponibilidade costuma ser restrita.
O que significa no Codex: Elementos rotulados como "Research Preview", como o gpt-5.3-codex-spark e o Chronicle, têm em comum o fato de que podem estar disponíveis apenas para planos ou plataformas específicas e podem desaparecer de uma versão para outra. Ao deparar-se com esse termo, considere-o apenas como um "recurso experimental, evite utilizá-lo em ambientes de produção".
Modelos Descontinuados (Deprecated)
Em uma frase: Modelos antigos que a fabricante já classificou como obsoletos e não são mais recomendados; evite inseri-los nas suas configurações.
O que significa no Codex: O gpt-5.2 e o gpt-5.3-codex foram marcados oficialmente como descontinuados sob o método de login do ChatGPT. Se os seus scripts, seu config.toml ou o comando codex exec --model ainda fazem referência a eles, substitua-os pelo modelo mais recente o quanto antes. Eu mesmo cometi esse erro no mês passado — um script de automação que escrevi há meio ano tinha o nome do modelo antigo codificado no código; ao rodá-lo, o sistema retornou um erro de indisponibilidade de modelo direto e demorei um tempo até lembrar o que era.
| Modelo | Posicionamento | Ideal para |
|---|---|---|
gpt-5.5 | Topo de linha / Padrão | Programação complexa, refatoração, bugs difíceis e pesquisa |
gpt-5.4 | Versão oficial (nível intermediário) | Equilibrar qualidade e custo |
gpt-5.4-mini | Leve / Rápido e econômico | Tarefas simples em lote, uso com subagentes |
gpt-5.3-codex-spark | Tipo instantâneo (Research Preview) | Iterações frequentes em tempo real, respostas imediatas |
gpt-5.2 / gpt-5.3-codex | Descontinuado | Não utilize mais, substitua pelas versões mais recentes |
💡 Resumo em uma frase: O modelo topo de linha
gpt-5.5cuida das tarefas difíceis, ogpt-5.4serve como intermediário, ogpt-5.4-miniatende às demandas rápidas e baratas e ogpt-5.3-codex-sparkbusca respostas imediatas; "visualização de pesquisa" (Research Preview) equivale a uma versão de testes e evite usar os dois nomes de modelos descontinuados em suas configurações.
05 Como Aproveitar ao Máximo este Dicionário
Um dicionário guardado na gaveta não serve para nada. Aqui estão três maneiras práticas e testadas por mim para você utilizá-lo:
Primeiro: ao ler outros artigos e travar, volte aqui para buscar o termo, leia e retorne. Não perca muito tempo tentando decifrar um termo técnico sozinho; este artigo foi feito exatamente para ser consultado e interrompido a qualquer momento — essa é a diferença principal em relação aos outros artigos da série: os demais são lidos do começo ao fim, enquanto este é usado via Ctrl+F.
Segundo: memorize separadamente as "duplas mais fáceis de confundir". Eu mesmo acabei me confundindo com algumas no início, então confira a lista a seguir para não cometer o mesmo erro:
| Dupla fácil de confundir | Como diferenciar |
|---|---|
| Sandbox vs Aprovação | O sandbox controla o "pode ou não pode", e a aprovação controla o "pergunta ou não pergunta" |
| Esforço de raciocínio vs Modelo | O esforço de raciocínio define "quanto tempo pensar", e o modelo define "qual profissional enviar" |
AGENTS.md vs Memória | O manual de instruções define regras obrigatórias de execução, enquanto a memória é uma lembrança probabilística |
| Skill vs Plugin | A Skill é uma habilidade única, enquanto o Plugin é um pacote contendo várias habilidades integradas |
| Subagente vs Hook | O subagente só é acionado quando solicitado por você, enquanto o Hook é disparado inevitavelmente no momento exato |
Terceiro: a prática é o caminho mais rápido para fixar o aprendizado. Escolha o conceito de que você mais se esquece e execute a prática no capítulo correspondente — por exemplo, se você não compreendeu bem o sandbox, volte ao [02 Conceitos Fundamentais] e execute o pequeno experimento "arquivo bloqueado no modo somente leitura". Já guiei alguns amigos que não sabiam nada de linha de comando no início do aprendizado do Codex; aqueles que rodaram pessoalmente o teste de bloqueio do sandbox nunca mais perguntaram "por que ele não quer modificar o arquivo" — ver acontecer uma única vez vale mais do que ler dez explicações.
💡 Resumo em uma frase: Este dicionário serve para "referência rápida" — se travar, pesquise o termo; memorize as duplas confusas de forma separada e volte para praticar o conceito menos familiar.
Resumo
Este artigo reuniu os termos técnicos do livro em um dicionário portátil, estruturado em quatro grupos definidos:
- Conceitos Básicos: Agente, ciclo de agente, janela de contexto e token — a base de todos os conceitos.
- Exclusivos do Codex:
AGENTS.md,codex exec, sandbox, aprovação, esforço de raciocínio,service_tiere Chronicle — os termos próprios desta ferramenta e a fonte comum de "instabilidade". - Capacidades de Extensão: MCP, subagente, Skill, Hook e Plugin — um conjunto de cinco ferramentas em que cada uma resolve uma questão diferente; lembre-se do propósito de cada uma para não confundi-las.
- Relação de Modelos: O posicionamento da linha
gpt-5.5, o significado de visualizações de pesquisa e os dois modelos que foram descontinuados.
Agora você deve ser capaz de: saber a qual grupo recorrer aqui sempre que encontrar novos termos técnicos nos demais capítulos; distinguir de imediato as duplas com maior potencial de confusão; e saber a qual capítulo retornar para testar de forma prática os conceitos que ainda não compreendeu bem.
No final das contas, os termos técnicos nunca devem ser decorados, mas sim incorporados naturalmente à sua rotina com o uso constante. O papel deste dicionário é fornecer uma base segura para consulta imediata enquanto eles ainda não foram completamente fixados na sua mente.
No próximo artigo [39 Gestão e Governança Corporativa], mudaremos o foco de "como uma pessoa usa o Codex" para "como uma empresa gerencia o Codex de forma centralizada": como conceder permissões unificadas, como garantir a conformidade e como evitar que dezenas ou centenas de usuários causem desorganização ao utilizar a mesma ferramenta. Deixo aqui uma pequena reflexão — olhando para o sandbox e a aprovação apresentados neste capítulo, quando você é a única pessoa a usá-los, eles funcionam como um 'cinto de segurança que você mesmo afivela'; mas quando uma equipe de dezenas de pessoas compartilha o uso, quem deve afivelar esse cinto e os usuários podem simplesmente desafivelá-lo a qualquer momento? Este é o problema que o próximo artigo pretende solucionar.