codex-image — imágenes gratis en Claude Code vía OpenAI Codex

Skill de Claude Code que genera y edita imágenes sin API key y sin coste por imagen, aprovechando la herramienta interna image_gen de la app OpenAI Codex (Microsoft Store) y el login de una suscripción ChatGPT de pago que ya tengas.

Claude describe la imagen, el motor PowerShell la genera vía codex exec, y el PNG aterriza en la ruta que le pidas. ~30–60 s por imagen.

Solo Windows. El motor depende del codex.exe que instala la app de la Microsoft Store.

Requisitos

• Windows 10/11
• App OpenAI Codex (Microsoft Store)
• codex login hecho con una cuenta ChatGPT Plus o superior
• Claude Code

Instalación

git clone https://github.com/davidrscout/codex-image-skill.git
cd codex-image-skill
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

O a mano: copia SKILL.md y gen-image.ps1 a %USERPROFILE%\.claude\skills\codex-image\.

Reinicia Claude Code y comprueba con /skills que aparece codex-image.

Uso

Basta con pedírselo a Claude en lenguaje natural:

Genera un icono minimalista de un rayo azul sobre fondo blanco, 1024x1024

Coge C:\fotos\producto.png y cámbiale el fondo a un degradado gris cálido

Claude invoca el motor y luego lee el PNG resultante para enseñártelo.

Invocación directa del motor

powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.claude\skills\codex-image\gen-image.ps1" `
  -Prompt "un faro en un acantilado al atardecer, estilo acuarela" `
  -Out "C:\salida\faro.png" `
  -Size "1536x1024"

Salida en la última línea de stdout: RESULT_OK <ruta> <bytes> o RESULT_FAIL <motivo>.

Parámetro	Obligatorio	Descripción
-Prompt	sí	Descripción de la imagen, o del cambio si editas
-Out	sí	Ruta absoluta del PNG de salida
-Ref	no	Imágenes de referencia/base (para editar)
-Size	no	1024x1024, 1536x1024, 1024x1536
-Model	no	Modelo de Codex (por defecto gpt-5.6-luna)
-Reasoning	no	low (por defecto), medium, high

Cómo funciona

1. Localiza el codex.exe más reciente bajo %LOCALAPPDATA%\OpenAI\Codex\bin.
2. Lanza codex exec pidiéndole que use image_gen y guarde el PNG en la ruta exacta.
3. Si Codex genera la imagen pero no la copia al destino, hace fallback al PNG más reciente de %USERPROFILE%\.codex\generated_images.

Dos gotchas ya resueltos (no los reintroduzcas)

• El prompt va por stdin, nunca como argumento posicional: el flag -i es variadic y se lo comería, y además stdin aporta el EOF que codex exec necesita para no quedarse colgado.
• Nada de --approve-for-me: en un Windows con sandbox="elevated" dispara UAC y cuelga el proceso. Se usa --dangerously-bypass-approvals-and-sandbox, que asume máquina propia y de confianza — revísalo antes de usarlo en un equipo compartido.

Límites

• Consume cuota de tu suscripción ChatGPT: los lotes grandes pueden topar límites.
• El look es el de los modelos de imagen de OpenAI; si necesitas otro estilo, usa otro proveedor.
• No hace vídeo ni audio.

Licencia

MIT — ver LICENSE.