Como Usar o AgentKit com o OpenAI Codex (Passo a Passo 2026)

- Os comandos e preços abaixo foram conferidos na documentação oficial (docs.agentkit.best, canal beta) no momento em que escrevo, 2026-08; confirme na documentação ao vivo antes de depender deles, já que o canal beta muda mais rápido do que uma versão GA.

Três coisas chamadas "AgentKit"/"Codex" - leia isto primeiro

Antes de digitar um único comando, separe três nomes que vivem sendo confundidos. Misturá-los significa comprar o produto errado pelo preço errado, não é só um deslize de palavras:

É por isso que pesquisar "use AgentKit with Codex" ou "AgentKit pricing" mostra resultados do próprio Agent Builder da OpenAI - produto errado, preço errado, caminho de instalação errado. Este artigo é só sobre a segunda linha acima: agentkit.best. Para o detalhamento completo e não comprar a coisa errada, veja OpenAI AgentKit vs AgentKit (agentkit.best) - a comparação completa.

O que você precisa antes de começar

Uma lista de cinco minutos - leia tudo antes de digitar seu primeiro comando:

• Codex CLI, ou um plano do ChatGPT que inclua o Codex, já instalado e com login feito na sua conta da OpenAI.
• Uma licença do AgentKit que você já comprou - Engineer $99 ou Bundle $149, não uma versão gratuita.
• Um terminal aberto exatamente no diretório do projeto onde você quer instalar o kit.
• Cerca de 5 minutos sem interrupções.

O detalhe que as pessoas pulam: fazer login no AgentKit NÃO te conecta ao Codex, e vice-versa - são dois sistemas de autenticação totalmente separados, então você vai fazer login duas vezes para duas coisas diferentes, e vai precisar autenticar cada um separadamente se trocar de máquina. Não chegue no ak kit init e descubra que o Codex nunca esteve logado, ou o contrário - conferir os dois antes te poupa um ciclo de depuração inútil. Ainda não instalou o Codex? Leia primeiro como instalar a CLI do Codex. Não tem certeza do que é o Codex, ou como ele difere do Claude Code? Veja o que é o OpenAI Codex.

Passo 1 - Instale a CLI ak

O AgentKit roda por meio de um único binário nativo de CLI chamado ak - sem Node, sem Bun, sem runtime extra para instalar antes. Escolha seu sistema operacional:

# macOS / Linux
curl -fsSL https://agentkit.best/install.sh | sh

# Windows (PowerShell)
irm https://agentkit.best/install.ps1 | iex

O instalador detecta seu sistema operacional e arquitetura automaticamente. Quando terminar, verifique com dois comandos:

ak --version
ak doctor --json

ak doctor --json imprime a saúde da sua instalação em JSON - rode sempre que algo parecer quebrado, inclusive nos passos seguintes. Por ser um binário nativo, esse caminho de instalação também funciona direitinho em ambientes sandbox/CI sem Node disponível - uma diferença real em relação a kits distribuídos como pacotes npm.

Passo 2 - Faça login e confirme sua licença

Faça login com e-mail ou uma chave de API, o que for mais conveniente:

ak login --email [email protected]
# or
ak login --api-key ak_live_...

Depois confirme que você está na conta certa com a licença certa antes de instalar qualquer coisa - este é o passo que a maioria pula, e aí descobre que a licença nunca foi de fato ativada, ou que está logada em um e-mail diferente do usado na compra:

ak whoami
ak licenses

ak licenses lista exatamente o que você possui (Engineer, Marketing ou Bundle). Se a lista voltar vazia mesmo você tendo certeza de que pagou, confira o e-mail de confirmação do pedido ou a página da sua conta em agentkit.best antes de continuar - não instale às cegas para depois se perguntar por que dá erro de permissão faltando.

Passo 3 - Instale o kit no Codex

Este é o comando central do artigo inteiro - aquele que nenhuma página escreve por completo atualmente:

ak kit init engineer --target codex

Por padrão, isso instala no escopo de projeto - o kit só se aplica dentro do diretório do projeto atual, não em todo lugar. Se quiser que ele fique disponível em TODOS os projetos sem reinstalar toda vez, adicione a flag global:

ak kit init engineer --target codex --global

Antes de escrever qualquer coisa no disco, o ak mostra uma tela de confirmação/prévia: o nome do kit, o local de saída, o modo de instalação (projeto ou global), o escopo e a lista exata dos arquivos que ele está prestes a escrever. Leia essa tela antes de digitar "y" - é o momento em que você sabe exatamente o que o kit vai tocar, em vez de adivinhar depois e vasculhar o que foi escrito.

Nota da prática: quando rodei isso pela primeira vez, a tela de confirmação deixou tudo claro - kit Engineer, escrevendo em .agents/skills, escopo de projeto e uma lista concreta dos arquivos prestes a serem criados. Nada escondido por trás; confirme e você sabe exatamente o que foi tocado.

Ainda não tem um kit? Você precisa de uma licença Engineer ou Bundle antes que o comando acima realmente rode. Confira o preço atual e qualquer promoção ativa, depois volte a este passo.

Adquira o AgentKit Engineer Kit →

Passo 4 - Rode sua primeira skill com $ak:cook

O Codex só reconhece a skill depois que você abre uma nova sessão do Codex no mesmo projeto onde acabou de instalar - ele precisa de um recarregamento para varrer de novo e descobrir as skills. Não fique digitando na sessão antiga se perguntando por que nada acontece.

Na nova sessão, invoque a skill com a sintaxe $ak: do Codex:

$ak:cook Add a health-check endpoint

Troque a tarefa de exemplo pela sua - isso é só um exemplo ilustrativo da sintaxe de chamada, não uma fórmula fixa. O detalhe que vale lembrar é a diferença de sintaxe entre os dois runtimes: o Codex usa $ak:, enquanto o Claude Code usa /ak: - mesmo kit, mesmas skills, só um caractere de invocação diferente dependendo de onde está rodando. Não digite /ak:cook dentro do Codex e ache que o kit está quebrado; quase sempre é uma incompatibilidade de sintaxe, não uma falha de instalação.

Nota da prática: ao chamar $ak:cook em uma nova sessão do Codex, a skill foi reconhecida na hora, sem nenhuma configuração extra - exatamente como a documentação descreve, que a descoberta precisa de uma sessão nova após a instalação.

Onde o AgentKit se comporta diferente no Codex vs no Claude Code

Esta é a informação genuinamente nova aqui - nenhuma outra página escreve isso atualmente. O AgentKit não roda de forma idêntica em todo runtime, e o Codex tem limites específicos em relação ao Claude Code, detalhados na documentação de runtime-adapters (docs.agentkit.best/en/beta/concepts/runtime-adapters, acessada em 2026-08):

Resumindo: skills, regras e o despacho de agentes rodam totalmente no Codex - é todo o mecanismo por trás de chamar $ak:cook. Os hooks são parciais, e os comandos do kit (os comandos em formato de barra do próprio kit, distintos das skills) mais a barra de status simplesmente não existem no Codex. Se um fluxo do qual você depende se apoia muito em comandos do kit ou em um hook fora do grupo suportado, espere que essa parte silenciosamente não rode no Codex, mesmo funcionando perfeitamente no Claude Code - isso não é um bug, é o adaptador declarando seus limites logo de cara, não algo que você descobre do jeito difícil depois de depender dele.

Se você está acostumada com o Claude Code e o Codex é novidade, não se assuste quando algumas coisas "desaparecerem" - elas nunca foram suportadas no Codex, não foram quebradas pela sua instalação.

Um exemplo concreto: se um fluxo ao qual você está acostumada no Claude Code inclui um passo que dispara por um comando do kit, ou depende de um hook fora do grupo suportado, espere que esse passo específico silenciosamente não rode no Codex, enquanto a camada central de skills ($ak:cook e o resto) continua funcionando normalmente. O movimento seguro é testar logo após instalar, em vez de presumir comportamento idêntico só porque é o mesmo kit.

Codex gratuito vs AgentKit pago - o limite honesto

Dito de forma direta logo de início: você não está pagando para "usar o Codex". Codex CLI, Codex na nuvem e até o modo goal /goal são gratuitos ou já cobertos pelo plano do ChatGPT que você paga (Free/Go/Plus/Pro/Business). O AgentKit é uma camada de skills, agentes e fluxos prontos que você instala por cima desse mesmo motor gratuito do Codex - você está pagando para pular a etapa de escrever as skills você mesma, não para desbloquear nada dentro do Codex.

Os preços acima refletem a página de preços no momento em que escrevo (2026-08); o site costuma rodar uma promoção de -20% pelo link de ref (Engineer por cerca de $79.20) - confira o banner atual antes de pagar, não trate nenhum número como fixo, já que a promoção pode mudar. Há garantia de reembolso, mas o site não publica um prazo específico - confirme os termos exatos no checkout em vez de presumir "14 dias" ou "30 dias". Para o panorama completo do produto e uma análise de ROI por hora antes de comprar, leia a resenha completa do AgentKit ou os preços detalhados em preços do AgentKit, vale a pena - esses dois aprofundam a avaliação; este artigo cobre só a linha entre gratuito e pago, o suficiente para você decidir antes de instalar.

Solução de problemas

• Suspeita de instalação quebrada: rode ak doctor --json e leia a seção de erros do JSON antes de reinstalar do zero.
• Quer conferir as versões de kit/skill: ak versions compara com o último lançamento, útil se você suspeita que o kit está desatualizado.
• $ak:cook não é reconhecido: quase sempre significa que você não abriu uma nova sessão do Codex exatamente no diretório do projeto onde o kit foi instalado - feche a sessão antiga, reabra no diretório certo e tente de novo.
• Instalou no escopo de projeto mas precisa em outro lugar: isso é comportamento esperado, não um bug - o escopo de projeto só se aplica onde você instalou; rode o comando de novo com --global se quiser em todo lugar.
• Não tem certeza se a licença ainda é válida: ak whoami mais ak licenses confirmam a conta e quais kits ela realmente possui.
• A tela de confirmação mostra algo que você não esperava (escopo errado, caminho de saída errado): cancele, confira de novo se você queria adicionar --global e rode outra vez - é mais barato cancelar uma prévia do que limpar arquivos escritos no lugar errado.

Perguntas frequentes (FAQ)

O AgentKit é gratuito quando usado com o Codex?

Não. O Codex (CLI/nuvem/ChatGPT) é gratuito ou já coberto pelo plano que você paga. O AgentKit é um kit pago instalado por cima - Engineer $99, Bundle $149, o mesmo preço para qualquer alvo, incluindo o Codex.

Qual a diferença entre /ak: e $ak:?

Mesmo kit, mesmas skills, só uma sintaxe de invocação diferente por runtime. O Claude Code usa /ak:cook; o Codex usa $ak:cook. Digitar o caractere errado é o motivo mais comum de uma skill "não rodar".

Preciso do Claude Code também, ou posso instalar o AgentKit só para o Codex?

O Codex sozinho já basta. ak kit init engineer --target codex instala de forma independente para o Codex - o Claude Code não é necessário junto.

Isto é o mesmo que o próprio AgentKit da OpenAI?

Não. O AgentKit deste artigo é o agentkit.best, um produto de terceiros movido pela CLI ak. O OpenAI AgentKit é o Agent Builder/ChatKit da própria OpenAI - um produto completamente diferente que só divide o nome.

O AgentKit custa mais para o Codex do que para o Claude Code?

Nenhuma diferença. A mesma licença, pelo mesmo preço ($99 por kit ou $149 pelo Bundle), vale para qualquer --target que você instalar - o Codex não tem preço separado nem mais alto.

Posso usar uma licença entre Claude Code e Codex?

Não há confirmação pública de que uma única licença permita alvos simultâneos ilimitados - as licenças são gerenciadas por ativação de dispositivo, e --target é só um parâmetro de instalação para onde o kit vai parar. Se você planeja rodar os dois runtimes na mesma licença, confirme os limites de ativação no checkout em vez de presumir.

Ainda não instalei o Codex - posso instalar o AgentKit primeiro?

Não vale muito a pena. ak kit init … --target codex só escreve skills em um diretório que o Codex lê (.agents/skills); sem o Codex instalado, não há nada ali ainda para executá-las. Instale o Codex primeiro pelo guia de instalação da CLI do Codex, faça login e depois volte aos passos acima.

A tela de confirmação realmente me deixa cancelar antes de qualquer coisa ser escrita?

Sim - é justamente esse o objetivo dela. ak kit init mostra o nome do kit, o local de saída, o modo de instalação, o escopo e a lista de arquivos antes de escrever qualquer coisa; você pode recuar nessa tela se o escopo ou o destino parecerem errados, em vez de descobrir depois.

Conclusão

O caminho real inteiro cabe em quatro passos: instalar o ak, ak login, ak kit init engineer --target codex, abrir uma nova sessão do Codex e então chamar $ak:cook. O Codex continua gratuito ou já coberto pelo plano do ChatGPT que você paga; o AgentKit é o custo extra por uma camada pronta de skills/agentes, não uma taxa para "desbloquear" o Codex. Vale comprar se você já usa o Codex todo dia e não quer escrever skills do zero; não é urgente se você ainda está se acostumando com o Codex puro.