Codex CLI: su propia clave en lugar de suscripción

Codex no es un asistente en el editor, sino un ejecutor independiente. Usted formula la tarea con palabras, y él decide qué archivos leer, qué comandos ejecutar y qué cambiar. Tiene a su disposición cerca de una docena de herramientas: ejecución de comandos, lectura de archivos, gestión de planes de trabajo, solicitud de aclaraciones al usuario y generación de agentes subordinados para subtareas.

Dos modos de trabajo. Interactivo: codex sin argumentos, diálogo en la terminal mostrando cada paso. No interactivo: codex exec «tarea», ejecución única hasta el resultado: útil en scripts y CI.

La seguridad está integrada: por defecto, el agente funciona en un sandbox y pide confirmación antes de los cambios. El nivel de control se establece en la configuración, desde «preguntar todo» hasta una ejecución totalmente autónoma con derecho a escribir en el directorio de trabajo.

Otra característica es el estado del diálogo. Codex no le pide al servidor que recuerde nada: mantiene todo el historial consigo y lo envía completo con cada paso. Para usted, esto significa que la correspondencia no se queda del lado del proveedor del modelo y el cambio de endpoint no rompe la sesión iniciada.

La diferencia con Claude Code y otros agentes de terminal es precisamente el protocolo. Codex se comunica con el modelo a través de Responses API, donde la correspondencia no se describe como una lista plana de mensajes, sino como una cadena de elementos: texto, llamada a herramienta, resultado de la llamada, bloque de razonamiento. Para la herramienta, esto proporciona un modelo de diálogo más estricto, y para usted, la necesidad de tener un endpoint que entienda este protocolo.

Codex almacena la configuración en ~/.codex/config.toml. Su propio proveedor se describe mediante el bloque [model_providers.*], y el campo clave aquí es wire_api: sin él, Codex intentará hablar mediante Chat Completions y no ensamblará el ciclo de agente.

# ~/.codex/config.toml
model_provider = "joingonka"
model = "deepseek-ai/DeepSeek-V4-Flash-0731"

[model_providers.joingonka]
name = "JoinGonka Gateway"
base_url = "https://gate.joingonka.ai/v1"
env_key = "JOINGONKA_API_KEY"
wire_api = "responses"

La clave no se escribe en el archivo: env_key nombra la variable de entorno de la cual Codex la tomará. Es un nombre de variable propio, no OPENAI_API_KEY, así la configuración no interfiere con otras herramientas suyas que trabajen con OpenAI.

export JOINGONKA_API_KEY=jg-su-clave

El campo model establece el modelo por defecto, y model_provider define qué bloque usar. Ambos se pueden sobrescribir al momento de ejecutar, así que una sola configuración sirve tranquilamente para varios proveedores: de trabajo, experimental y de respaldo.

La clave se entrega en el panel personal después del registro; allí mismo puede ver el saldo y el consumo. Si prefiere no tocar la configuración general, el mismo bloque puede pasarse una sola vez a través de -c: codex -c model_provider=joingonka …. Y para mantener varias configuraciones independientes, indique el directorio de ajustes con la variable CODEX_HOME.

La forma más rápida de asegurarse de que la conexión funciona es una prueba única:

codex exec "Responde en una línea: ¿cuánto es 17*3?"

En la cabecera de la respuesta, Codex imprime con quién está trabajando: model, provider: joingonka, el modo sandbox y el identificador de sesión. Si aparece tu proveedor y recibes una respuesta abajo, la conexión está activa.

A continuación, conviene verificar lo principal para lo que se instala Codex: trabajar con archivos. Coloca un archivo pequeño con un error evidente en el directorio y pídele que lo encuentre:

codex exec "Lee calc.py y dime en una frase si hay algún error."

El agente debe invocar por sí mismo la herramienta de lectura, abrir el archivo y responder al punto, indicando la línea. Si esto ocurre, el ciclo completo del agente (solicitud → llamada a la herramienta → resultado → respuesta) se ensambla correctamente a través de la puerta de enlace.

Si algo sale mal, el diagnóstico suele leerse directamente desde el mensaje:

La primera solicitud en la sesión puede tardar unos segundos: Codex envía un prompt del sistema extenso y la descripción de todas sus herramientas, y el nodo de la red necesita aceptar la tarea. Las respuestas posteriores llegan más rápido.

Todos los modelos de la red están disponibles al mismo precio, por lo que la elección depende del comportamiento y no del presupuesto. A continuación se muestra el resultado de una prueba real de la misma tarea (leer un archivo y buscar un error) a través de Codex en cada uno de los modelos.

La recomendación por defecto es DeepSeek V4 Flash: el trabajo del agente agota rápidamente el volumen del contexto, y 380K tokens permiten mantener muchos archivos en memoria a la vez. Si deseas respuestas extremadamente cortas, usa Kimi K2.6. El modelo se puede cambiar con una sola línea model en la configuración o con la bandera -c model=… sin editar el archivo.

La lista actualizada de los modelos de la red siempre se obtiene mediante GET https://gate.joingonka.ai/v1/models.

Las herramientas de agente consumen tokens de manera diferente a un chat: por cada frase tuya, Codex añade un prompt del sistema y la descripción de todas las herramientas, manteniendo un diálogo de múltiples pasos con el modelo. En una prueba real, una tarea sencilla de "leer un archivo y encontrar un error" costó aproximadamente entre 18 y 20 mil tokens. Es un coste normal por la autonomía, y por eso el precio por token es decisivo.

A través de JoinGonka Gateway, los tokens cuestan $0.0047 por millón de entrada y $0.014 por millón de salida; el precio es idéntico para todos los modelos de la red y se muestra en esta página desde una fuente en tiempo real.

Para comparar, así funcionan las opciones de pago de Codex y las de sus competidores:

El pago se realiza por el consumo real, sin suscripción mensual ni cuotas de solicitudes: no hay ventanas de cinco horas, límites de "prompts" ni multiplicadores en horas pico. El saldo se recarga con criptomonedas, y el remanente y consumo diario se pueden consultar en el área personal. Un análisis detallado de la economía está en el artículo sobre la API más barata.

El propio Codex mantiene el historial de la conversación. Envía el historial completo con cada solicitud y no pide al servidor que recuerde nada; nosotros tampoco almacenamos los chats. Tu código y tus prompts no permanecen en la puerta de enlace después de una respuesta.

La búsqueda web está activa. Codex declara una herramienta de búsqueda en cada solicitud y la puerta de enlace la acepta: la búsqueda se realiza de nuestro lado y los resultados se integran en la respuesta del modelo.

Las herramientas son locales, no en la nube. Codex ejecuta comandos y lee archivos localmente en tu máquina, por lo que el acceso al proyecto no depende del proveedor del modelo.

Sandbox. En Linux, Codex utiliza bubblewrap para aislar los comandos que se ejecutan. Si no está en tu sistema, Codex te avisará y usará una copia integrada; esto no afecta al funcionamiento, pero es más cómodo instalar el paquete mediante el gestor de paquetes estándar.

Si necesitas trabajar con imágenes —capturas de pantalla de la interfaz, diagramas en fotos—, utiliza una herramienta con un modelo con capacidad de visión para esas tareas: los modelos en la red Gonka son de solo texto. Esto no supone una limitación para código, comandos y archivos.

Otros agentes de terminal, si Codex no encajó: el inicio rápido de la API muestra cómo conectar cualquier herramienta compatible en un par de minutos.