Saltar al contenido principal

​
Descripción general

OpenAI Codex es una herramienta de línea de comandos (CLI) de código abierto que sirve como un agente de programación ligero, capaz de leer, modificar y ejecutar código en la terminal. Está construido sobre modelos GPT y optimizado para la generación de código.

​
Requisitos del sistema

  • SO: macOS, Linux (soporte oficial), Windows a través de WSL
  • Node.js: Versión 18+
  • npm: Versión 10.x.x o superior

​
Instalación

sudo npm install -g @openai/codex@latest
Verificar la instalación: 
codex --version

​
Configuración

​
Paso 1: Configurar la API Key

Temporal (sesión actual): 
export OPENAI_API_KEY="sk-your-lemondata-key"
Configuración permanente: Añadir a ~/.bashrc, ~/.zshrc o ~/.bash_profile: 
export OPENAI_API_KEY="sk-your-lemondata-key"
Luego recargar: 
source ~/.zshrc  # o source ~/.bashrc

​
Paso 2: Configurar config.toml

Editar ~/.codex/config.toml: 
model = "gpt-4o"
model_provider = "lemondata"

[model_providers.lemondata]
name = "LemonData"
base_url = "https://api.lemondata.cc/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"
Si el archivo de configuración no existe, ejecute codex una vez para generarlo y luego edite el archivo.

​
Uso básico

Iniciar modo interactivo: 
codex
Comando directo: 
codex "Fix the bug in main.py line 42"
Especificar modelo: 
codex -m gpt-4o "Build a REST API server"

​
Modelos disponibles

ModeloIdeal para
gpt-4oTareas de programación complejas, arquitectura
gpt-4o-miniCorrecciones rápidas, tareas simples
claude-sonnet-4-5Revisión de código, documentación
deepseek-r1Diseño de algoritmos, razonamiento

​
Comandos interactivos

ComandoDescripción
/helpMostrar ayuda
/exit o Ctrl+CSalir
/clearLimpiar conversación
/configVer configuración
/model <name>Cambiar modelo
/tokensVer uso de tokens

​
Verificar configuración

# Comprobar variable de entorno
echo $OPENAI_API_KEY

# Probar conexión de la API
codex "Hello, Codex!"

# Ver configuración
cat ~/.codex/config.toml

​
Casos de uso comunes

Revisión de código: 
git diff | codex "Review these code changes"
Generar mensajes de commit: 
git diff --staged | codex "Generate a commit message for these changes"
Corregir errores: 
codex "Fix the TypeScript errors in src/components/"
Explicar código: 
cat main.py | codex "Explain what this code does"

​
Solución de problemas

  • Verifique que base_url en config.toml sea exactamente https://api.lemondata.cc/v1
  • Compruebe la conectividad de red
  • Asegúrese de que no haya interferencia de proxy
  • Verifique que la variable de entorno OPENAI_API_KEY esté configurada
  • Compruebe que la clave comience con sk-
  • Asegúrese de que la clave esté activa en el panel de LemonData
  • Compruebe que el nombre del modelo coincida exactamente
  • Verifique la disponibilidad del modelo en lemondata.cc/en/models