Cómo Usar AgentKit con OpenAI Codex (Paso a Paso 2026)

- Los comandos y precios de abajo se contrastaron con la documentación oficial (docs.agentkit.best, canal beta) al momento de escribir, 2026-08; verifica la documentación en vivo antes de depender de ellos, ya que el canal beta cambia más rápido que una versión GA.

Tres cosas llamadas "AgentKit"/"Codex" - lee esto primero

Antes de teclear un solo comando, separa tres nombres que se confunden constantemente. Mezclarlos significa comprar el producto equivocado al precio equivocado, no es solo un desliz de palabras:

Por eso, buscar "use AgentKit with Codex" o "AgentKit pricing" muestra resultados del propio Agent Builder de OpenAI - producto equivocado, precio equivocado, ruta de instalación equivocada. Este artículo trata solo de la segunda fila de arriba: agentkit.best. Para el desglose completo y no comprar lo que no es, consulta OpenAI AgentKit vs AgentKit (agentkit.best) - la comparación completa.

Lo que necesitas antes de empezar

Una lista de cinco minutos - léela entera antes de teclear tu primer comando:

• Codex CLI, o un plan de ChatGPT que incluya Codex, ya instalado y con sesión iniciada en tu cuenta de OpenAI.
• Una licencia de AgentKit que ya hayas comprado - Engineer $99 o Bundle $149, no una versión gratuita.
• Una terminal abierta exactamente en el directorio del proyecto donde quieres instalar el kit.
• Unos 5 minutos sin interrupciones.

El detalle que la gente se salta: iniciar sesión en AgentKit NO te conecta a Codex, y viceversa - son dos sistemas de autenticación totalmente separados, así que iniciarás sesión dos veces para dos cosas distintas, y tendrás que autenticarte en cada uno por separado si cambias de equipo. No llegues a ak kit init y descubras que nunca iniciaste sesión en Codex, o al revés - comprobar ambos primero te ahorra un ciclo de depuración inútil. ¿Todavía no has instalado Codex? Lee primero cómo instalar la CLI de Codex. ¿No tienes claro qué es Codex, o en qué se diferencia de Claude Code? Mira qué es OpenAI Codex.

Paso 1 - Instala la CLI ak

AgentKit funciona mediante un único binario nativo de CLI llamado ak - sin Node, sin Bun, sin ningún runtime extra que instalar antes. Elige tu sistema operativo:

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

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

El instalador detecta tu sistema operativo y arquitectura automáticamente. Cuando termine, verifícalo con dos comandos:

ak --version
ak doctor --json

ak doctor --json imprime el estado de tu instalación en JSON - ejecútalo cada vez que algo parezca roto, también en los pasos siguientes. Al ser un binario nativo, esta ruta de instalación también funciona sin problemas en entornos sandbox/CI sin Node disponible - una diferencia real frente a los kits que se distribuyen como paquetes npm.

Paso 2 - Inicia sesión y confirma tu licencia

Inicia sesión con correo o con una clave de API, lo que te resulte más cómodo:

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

Luego confirma que estás en la cuenta correcta con la licencia correcta antes de instalar nada - este es el paso que la mayoría se salta, para luego descubrir que la licencia nunca se activó de verdad, o que iniciaron sesión con un correo distinto al de la compra:

ak whoami
ak licenses

ak licenses enumera exactamente lo que posees (Engineer, Marketing o Bundle). Si la lista vuelve vacía aunque estés segura de haber pagado, revisa el correo de confirmación del pedido o la página de tu cuenta en agentkit.best antes de continuar - no instales a ciegas para luego preguntarte por qué da error por un permiso que falta.

Paso 3 - Instala el kit en Codex

Este es el comando central de todo el artículo - el que ninguna página escribe hoy por completo:

ak kit init engineer --target codex

Por defecto se instala en ámbito de proyecto - el kit solo aplica dentro del directorio del proyecto actual, no en todas partes. Si quieres tenerlo disponible en TODOS los proyectos sin reinstalar cada vez, añade la flag global:

ak kit init engineer --target codex --global

Antes de escribir nada en el disco, ak muestra una pantalla de confirmación/vista previa: el nombre del kit, la ubicación de salida, el modo de instalación (proyecto o global), el ámbito y la lista exacta de archivos que está a punto de escribir. Lee esa pantalla antes de teclear "y" - es el momento en que sabes con precisión qué va a tocar el kit, en lugar de adivinar después y rebuscar entre lo que se escribió.

Nota práctica: al ejecutar esto por primera vez, la pantalla de confirmación lo dejó todo claro - kit Engineer, escribiendo en .agents/skills, ámbito de proyecto y una lista concreta de los archivos a punto de crearse. Nada oculto detrás; confirma y sabes exactamente qué se tocó.

¿Aún no tienes un kit? Necesitas una licencia Engineer o Bundle antes de que el comando de arriba se ejecute de verdad. Consulta el precio actual y cualquier oferta activa, y luego vuelve a este paso.

Consigue el AgentKit Engineer Kit →

Paso 4 - Ejecuta tu primera skill con $ak:cook

Codex solo reconoce la skill después de que abras una nueva sesión de Codex en el mismo proyecto donde acabas de instalar - necesita recargar para volver a escanear y descubrir las skills. No sigas escribiendo en la sesión antigua preguntándote por qué no pasa nada.

En la nueva sesión, invoca la skill con la sintaxis $ak: de Codex:

$ak:cook Add a health-check endpoint

Cambia la tarea de ejemplo por la tuya - es solo un ejemplo ilustrativo de la sintaxis de llamada, no una fórmula fija. El detalle que vale la pena recordar es la diferencia de sintaxis entre los dos runtimes: Codex usa $ak:, mientras que Claude Code usa /ak: - mismo kit, mismas skills, solo un carácter de invocación distinto según dónde se ejecute. No teclees /ak:cook dentro de Codex y des por hecho que el kit está roto; casi siempre es una discrepancia de sintaxis, no un fallo de instalación.

Nota práctica: al llamar a $ak:cook en una sesión nueva de Codex, la skill se reconoció de inmediato sin configuración extra - tal como describe la documentación, que el descubrimiento necesita una sesión nueva tras la instalación.

Dónde se comporta AgentKit distinto en Codex vs Claude Code

Esta es la información realmente nueva aquí - ninguna otra página lo escribe actualmente. AgentKit no funciona de forma idéntica en todos los runtimes, y Codex tiene límites concretos frente a Claude Code, detallados en la documentación de runtime-adapters (docs.agentkit.best/en/beta/concepts/runtime-adapters, consultada en 2026-08):

En resumen: las skills, las reglas y el despacho de agentes funcionan por completo en Codex - ese es todo el mecanismo detrás de llamar a $ak:cook. Los hooks son parciales, y los comandos del kit (los comandos con formato de barra del propio kit, distintos de las skills) más la barra de estado sencillamente no existen en Codex. Si un flujo del que dependes se apoya mucho en comandos del kit o en un hook fuera del grupo soportado, cuenta con que esa parte no se ejecute en silencio en Codex aunque funcione perfectamente en Claude Code - no es un bug, es el adaptador declarando sus límites por adelantado, no algo que descubras por las malas después de depender de ello.

Si estás acostumbrada a Claude Code y Codex es nuevo para ti, no te sorprendas cuando algunas cosas "desaparezcan" - nunca estuvieron soportadas en Codex, no las rompió tu instalación.

Un ejemplo concreto: si un flujo al que estás acostumbrada en Claude Code incluye un paso que se dispara mediante un comando del kit, o depende de un hook fuera del grupo soportado, cuenta con que ese paso concreto no se ejecute en silencio en Codex, mientras que la capa central de skills ($ak:cook y el resto) sigue funcionando sin problema. Lo seguro es probar justo después de instalar en lugar de suponer un comportamiento idéntico solo porque es el mismo kit.

Codex gratis vs AgentKit de pago - el límite honesto

Dicho claro desde el principio: no estás pagando por "usar Codex". Codex CLI, Codex en la nube e incluso el modo goal /goal son gratis o ya están cubiertos por el plan de ChatGPT que pagas (Free/Go/Plus/Pro/Business). AgentKit es una capa de skills, agentes y flujos ya hechos que instalas encima de ese mismo motor gratuito de Codex - pagas por ahorrarte escribir las skills tú misma, no por desbloquear nada dentro de Codex.

Los precios de arriba reflejan la página de precios al momento de escribir (2026-08); el sitio suele tener una oferta del -20% a través del enlace de ref (Engineer por unos $79.20) - revisa el banner actual antes de pagar, no des ningún número por fijo, ya que la oferta puede cambiar. Hay garantía de devolución de dinero, pero el sitio no publica un plazo concreto - confirma las condiciones exactas en el checkout en lugar de suponer "14 días" o "30 días". Para el panorama completo del producto y un desglose de ROI por hora antes de comprar, lee la reseña completa de AgentKit o los precios detallados en precios de AgentKit, si vale la pena - esos dos profundizan en la valoración; este artículo solo cubre la línea entre gratis y de pago, lo justo para decidir antes de instalar.

Solución de problemas

• Sospechas de una instalación rota: ejecuta ak doctor --json y lee la sección de errores del JSON antes de reinstalar desde cero.
• Quieres comprobar las versiones de kit/skill: ak versions compara con la última versión, útil si sospechas que el kit está desactualizado.
• $ak:cook no se reconoce: casi siempre significa que no has abierto una nueva sesión de Codex exactamente en el directorio del proyecto donde se instaló el kit - cierra la sesión antigua, reábrela en el directorio correcto e inténtalo de nuevo.
• Instalaste en ámbito de proyecto pero lo necesitas en otro lugar: es el comportamiento esperado, no un bug - el ámbito de proyecto solo aplica donde lo instalaste; vuelve a ejecutar el comando con --global si lo quieres en todas partes.
• No estás segura de si la licencia sigue siendo válida: ak whoami más ak licenses confirman la cuenta y qué kits posee en realidad.
• La pantalla de confirmación muestra algo que no esperabas (ámbito incorrecto, ruta de salida incorrecta): cancélala, vuelve a comprobar si querías añadir --global y ejecútala de nuevo - sale más barato cancelar una vista previa que limpiar archivos escritos en el lugar equivocado.

Preguntas frecuentes (FAQ)

¿AgentKit es gratis cuando se usa con Codex?

No. Codex (CLI/nube/ChatGPT) es gratis o ya está cubierto por el plan que pagas. AgentKit es un kit de pago que se instala encima - Engineer $99, Bundle $149, el mismo precio para cualquier objetivo, incluido Codex.

¿Cuál es la diferencia entre /ak: y $ak:?

Mismo kit, mismas skills, solo una sintaxis de invocación distinta por runtime. Claude Code usa /ak:cook; Codex usa $ak:cook. Teclear el carácter equivocado es el motivo más común de que una skill "no se ejecute".

¿Necesito también Claude Code, o puedo instalar AgentKit solo para Codex?

Con Codex solo basta. ak kit init engineer --target codex se instala de forma independiente para Codex - no hace falta Claude Code al lado.

¿Es lo mismo que el propio AgentKit de OpenAI?

No. El AgentKit de este artículo es agentkit.best, un producto de terceros impulsado por la CLI ak. OpenAI AgentKit es el Agent Builder/ChatKit de la propia OpenAI - un producto completamente distinto que solo comparte el nombre.

¿AgentKit cuesta más para Codex que para Claude Code?

Sin diferencia. La misma licencia, al mismo precio ($99 por kit o $149 por el Bundle), aplica a cualquier --target que instales - Codex no tiene un precio aparte ni más alto.

¿Puedo usar una licencia entre Claude Code y Codex?

No hay confirmación pública de que una sola licencia permita objetivos simultáneos ilimitados - las licencias se gestionan por activación de dispositivo, y --target es solo un parámetro de instalación para dónde acaba el kit. Si piensas ejecutar ambos runtimes con la misma licencia, confirma los límites de activación en el checkout en lugar de suponerlo.

Todavía no he instalado Codex - ¿puedo instalar AgentKit primero?

No vale mucho la pena. ak kit init … --target codex solo escribe skills en un directorio que Codex lee (.agents/skills); sin Codex instalado, todavía no hay nada ahí que las ejecute. Instala Codex primero con la guía de instalación de la CLI de Codex, inicia sesión y luego vuelve a los pasos de arriba.

¿La pantalla de confirmación realmente me deja cancelar antes de que se escriba nada?

Sí - ese es justamente su propósito. ak kit init muestra el nombre del kit, la ubicación de salida, el modo de instalación, el ámbito y la lista de archivos antes de escribir nada; puedes echarte atrás en esa pantalla si el ámbito o el destino se ven mal, en lugar de enterarte después.

Conclusión

Todo el camino real cabe en cuatro pasos: instalar ak, ak login, ak kit init engineer --target codex, abrir una nueva sesión de Codex y luego llamar a $ak:cook. Codex sigue siendo gratis o ya está cubierto por el plan de ChatGPT que pagas; AgentKit es el costo extra por una capa de skills/agentes ya hecha, no una tarifa para "desbloquear" Codex. Vale la pena comprarlo si ya usas Codex a diario y no quieres escribir skills desde cero; no es urgente si todavía te estás acostumbrando a Codex a secas.