Cómo usar Codex — desde la instalación hasta ejecutarlo con una clave API sin suscripción

Codex es el agente de programación de OpenAI. Para usarlo básicamente, instala Codex CLI, que funciona en el terminal (npm install -g @openai/codex), inicia codex en el repositorio en el que quieras trabajar y solicita tareas en japonés. Hay 2 formas de empezar: iniciar sesión con un plan de ChatGPT (Plus, Pro, Business, etc.) y usarlo dentro de la cuota, o ejecutarlo con una clave de API y pagar solo por los tokens utilizados. Como la mayoría de los artículos explicativos en japonés solo tratan la primera opción, esta página explica la segunda: cómo ejecutar Codex CLI sin suscripción, cómo elegir un modelo para cada tarea y el coste real de una tarea.

Codex no es una herramienta para pegar código en una pantalla de chat; es un agente que lee y modifica archivos dentro del repositorio y ejecuta pruebas y comandos. Puedes decidir cuánto delegar sin confirmación después de iniciarlo con /permissions.

Las 2 formas de usar Codex

Cuando se ejecuta con una clave de API, la facturación se contabiliza por separado de la cuota del plan de OpenAI. También puedes usar directamente una clave de API de OpenAI, pero esta página trata el método de dirigirlo a un endpoint compatible con Responses API. Puedes cambiar con la misma clave entre GPT-6 Astra y GPT-5.6 Terra; por ejemplo, GPT-5.6 Sol cuesta $2.00 / $12.00 por 1M de tokens, frente al precio de lista de OpenAI de $5.00 / $30.00(OpenAI lo ofrece actualmente a un precio promocional de $4.00 / $20.00. Según la página de precios, al menos hasta 21 de noviembre de 2026) (las tarifas se cargan directamente del catálogo).

Instalación — npm o Homebrew

# npm（Node.js が入っていれば macOS / Linux / Windows 共通）
npm install -g @openai/codex

# Homebrew（macOS）
brew install --cask codex

Ambos son métodos indicados en el README oficial de OpenAI. También puedes instalarlo en Windows con el comando de npm. Cuando termine la instalación, escribe codex en el directorio del repositorio en el que quieras trabajar para iniciarlo. Si vas a iniciar sesión con ChatGPT, aquí termina el proceso y no necesitas más configuración.

Ejecutarlo con una clave de API — 1 bloque en config.toml

Primero crea una cuenta, recarga desde $10 y crea una clave en la pantalla de claves de API. La clave se muestra una sola vez, así que guárdala inmediatamente. Después, escribe un bloque de proveedor en el archivo de configuración de Codex.

# ~/.codex/config.toml（無ければ作る）
model          = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name     = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key  = "KUNAVO_API_KEY"   # キーそのものではなく「環境変数の名前」
wire_api = "responses"        # 唯一の有効値。省略しても同じ

El error más fácil de cometer aquí está en env_key. Lo que debes escribir es el nombre de la variable de entorno que contiene la clave, no la clave en sí. La clave no se guarda en el archivo de configuración, por lo que es seguro hacer commit de config.toml o pegarlo en una pregunta tal cual.

# env_key で指定した名前の変数にキーを入れる（キーは sk-kn- で始まる）
export KUNAVO_API_KEY="sk-kn-..."

# 毎回 export しないよう、使っているシェルの設定ファイルに追記しておく
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

En Windows PowerShell, ejecuta setx KUNAVO_API_KEY sk-kn-... y después vuelve a abrir un terminal nuevo. El archivo de configuración está en %USERPROFILE%\.codex\config.toml. Antes de iniciar Codex, conviene verificar con una sola solicitud que la clave y el endpoint sean correctos; así será más fácil diagnosticar problemas después.

# Codex を疑う前に、キーとエンドポイントだけを 1 回で確かめる
curl https://api.kunavo.com/v1/responses \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5-6-sol", "input": "OK とだけ返して"}'

Si devuelve JSON, la clave y el endpoint funcionan correctamente; cualquier problema restante está del lado de config.toml. Los detalles de configuración están en la documentación de integración de Codex CLI (en inglés), y la explicación que incluye cómo llamar a modelos Claude desde Codex, en la guía de configuración de claves de API de Codex CLI (en inglés).

La primera tarea

# 1. 作業したいリポジトリに入って起動する
cd ~/work/my-app
codex

# 2. AGENTS.md の雛形を作らせる（テストの実行方法や決めごとを書くファイル）
> /init

# 3. あとは日本語で頼む。ファイル名を添えるほど速く、安く終わる
> src/utils/date.test.ts が落ちている。原因を調べて直し、テストが通るのを確認して

El /init que crea AGENTS.md es un archivo donde se escriben «decisiones que no se pueden saber leyendo el código», como cómo ejecutar las pruebas, qué bibliotecas usar y qué rutas no tocar; se carga automáticamente en las sesiones posteriores. El contenido generado es un borrador, así que corrígelo manualmente.

El consejo para formular solicitudes es el mismo que con Claude Code: incluye el nombre y la ruta del archivo y no envíes una solicitud grande de una sola vez. Al reducir los tokens usados para explorar, el resultado será más rápido y preciso, y también bajará el importe facturado. Puedes ajustar la frecuencia de los diálogos de confirmación con /permissions. La forma de trabajar con Claude Code está resumida en cómo usar Claude Code.

Elegir un modelo para cada tarea — coste real de una tarea

La principal ventaja de usar una clave de API es que puedes elegir el modelo según la dificultad del trabajo. model solo es el nombre del modelo en el endpoint, así que no necesitas añadir otra clave ni cambiar la configuración para cambiar de modelo.

# config.toml の既定（gpt-5-6-sol）はそのまま、この起動だけモデルを変える
codex -m gpt-6-astra     # 原因の見えないバグ、設計をまたぐ変更
codex -m gpt-5-6-terra   # 定型の修正、一括置換、ログの要約などの軽い作業

«1 tarea» se calcula suponiendo que arreglar una prueba fallida requiere 20 pasos. Un paso usa 25,000 tokens de entrada (prompt del sistema + historial de conversación + archivos leídos) y 1,200 tokens de salida (una edición o explicación), por lo que una tarea usa 500,000 tokens de entrada y 24,000 de salida. Con GPT-5.6 Sol, son $1.29; pagar el mismo número de tokens directamente a OpenAI cuesta actualmente $2.48 con el precio promocional (o $3.22 al precio de lista). Los modelos más baratos pueden aumentar los intercambios por retrabajo, así que en la práctica conviene subir un nivel si no termina en un intento.

Este cálculo no tiene en cuenta la caché. Codex vuelve a enviar el historial de conversación en cada paso, por lo que la entrada almacenada en caché se cobra a 0.10 veces el precio de entrada (con GPT-5.6 Sol, $0.20 por 1M de tokens), mientras que lo que se escribe por primera vez en la caché cuesta 1.25 veces el precio de entrada. Además, en las series GPT-5.6 y GPT-6 Astra, si el prompt de una solicitud supera 272K tokens, toda la solicitud se cobra al doble para la entrada y a 1.5 veces para la salida. Es más seguro no acumular demasiado trabajo en una sesión y reiniciar para cada tarea. Los tokens de razonamiento de los modelos de razonamiento se cobran como salida, por lo que las tareas difíciles también aumentan la salida. Consulta el coste real en usage de la respuesta y en el historial de uso. Las especificaciones del modelo están en la página del modelo GPT-5.6 Sol, y los precios unitarios de todos los modelos, en la tabla de precios.

Errores frecuentes

Con franqueza — cuándo sale más rentable el plan de ChatGPT

Si trabajas muchas horas cada día conversando con Codex, el plan de precio fijo suele salir más barato. La facturación por uso es directamente proporcional al número de tokens, por lo que cuanto mayor y más estable sea el uso, mayor será la ventaja del precio fijo. El punto de equilibrio es «cuota mensual ÷ precio de una tarea», y hemos calculado el equilibrio con el plan en precios de Codex.

Hay otros 2 puntos que conviene conocer. Según la documentación de OpenAI, las funciones que dependen del espacio de trabajo o la nube de ChatGPT están limitadas o no están disponibles cuando se usa una clave de API. Además, la ruta de Kunavo utiliza capacidad compartida y no ofrece una cuota dedicada ni un SLA contractual. Si necesitas una cuota o un SLA garantizados, es más adecuado contratar directamente con OpenAI.

En cambio, la clave de API conviene a quienes tienen una gran diferencia entre los días que usan el servicio y los que no, quieren elegir el modelo para cada tarea, desean separar por clave los límites y el historial de uso del equipo, o quieren seguir trabajando solo los días en que se agota la cuota del plan. Las 2 opciones pueden coexistir. Si eliminas la línea model_provider de config.toml, vuelves al inicio de sesión con ChatGPT; si quieres cambiar en cada inicio, puedes usar --profile de Codex.

El pago se realiza con tarjeta, incluida JCB, Apple Pay, Google Pay, etc., y el saldo no caduca. No se admiten pagos en tiendas de conveniencia ni PayPay. Las solicitudes fallidas no generan cargos. Si dudas entre Codex y Claude Code, consulta Comparación entre Codex y Claude Code.

Preguntas frecuentes