Codex CLI: el agente de IA local para programación de OpenAI 126

小编 ·

Codex CLI: el agente de IA local para programación de OpenAI

Codex CLI es una herramienta de línea de comandos ligera lanzada por OpenAI que ofrece a los usuarios del terminal capacidades de razonamiento similares a las de ChatGPT. Puede ejecutar código realmente, manipular archivos e iterar, todo bajo control de versiones. Admite entrada multimodal, lo que permite a los usuarios completar tareas de generación, edición y ejecución de código mediante instrucciones en lenguaje natural.

Codex CLI: el agente de IA local para programación de OpenAI

¿Qué es Codex CLI?

Codex CLI es una herramienta ligera de línea de comandos lanzada por Openai que ofrece a los usuarios de terminal capacidades de razonamiento similares a las de ChatGPT, y que puede ejecutar código, manipular archivos e iterar, todo bajo control de versiones. Admite entradas multimodales, lo que permite a los usuarios realizar tareas de generación, edición y ejecución de código mediante instrucciones en lenguaje natural.

Codex CLI:OpenAI推出的本地编码AI智能体.jpg

Principales funciones de Codex CLI

  • Generación y edición de código: los usuarios pueden pedir a Codex CLI que genere código mediante sencillas instrucciones en inglés, por ejemplo, "crea un script en Python que lea un archivo CSV e imprima la media de una columna".

  • Gestión de archivos: admite la ejecución de operaciones con archivos, como "mover todos los archivos .txt a una carpeta llamada notes".

  • Ayuda para la depuración: los usuarios pueden pegar mensajes de error y Codex CLI ofrecerá sugerencias para corregirlos.

  • Creación de proyectos: puede generar rápidamente plantillas de proyectos, por ejemplo, "crea un servidor básico en Node.js".

  • Soporte multimodal: admite la entrada mediante capturas de pantalla o diagramas para implementar funcionalidades.

  • Ejecución local: Codex CLI se ejecuta en local; todas las operaciones de lectura, escritura y ejecución de comandos se realizan localmente, y salvo que el usuario decida compartirlos, el código fuente no abandona el entorno local.

Características de Codex CLI

  • Open source y gratuito: Codex CLI es completamente de código abierto; los usuarios pueden consultar y modificar el código libremente, así como contribuir a su desarrollo.

  • Ejecución local: la herramienta se ejecuta en la terminal local, asegurando que la ejecución de código y las operaciones con archivos se realicen dentro del sistema del usuario, garantizando la privacidad de los datos.

  • Independencia del modelo: utiliza por defecto el modelo GPT-4-turbo de OpenAI, pero los usuarios pueden cambiar a otros puntos de conexión de API compatibles, como o3 y o4-mini.

  • Configuración flexible: se configura mediante el archivo .codex en formato YAML, y admite variables y plantillas personalizadas.

Modelo de seguridad y permisos

Codex CLI ofrece tres modos de aprobación que el usuario puede seleccionar mediante el parámetro --approval-mode:

  • Modo de sugerencia (predeterminado): puede leer cualquier archivo del repositorio, pero requiere la aprobación del usuario para todas las escrituras de archivos y comandos de Shell.

  • Modo de edición automática: puede leer y aplicar parches para escribir en archivos, pero requiere la aprobación del usuario para todos los comandos de Shell.

  • Modo totalmente automático: puede leer y escribir archivos y ejecutar comandos de Shell sin necesidad de aprobación del usuario.

Casos de uso de Codex CLI

Codex CLI está orientado principalmente a desarrolladores que trabajan en entornos de terminal, ayudándoles a completar sus tareas de desarrollo diarias con mayor eficiencia. No es un asistente de codificación totalmente automatizado, sino una herramienta para apoyar y acelerar las tareas rutinarias.

Cómo instalar Codex CLI

Instalación mediante npm (recomendada):

npm install -g @openai/codex

Compilar desde el código fuente:

  • Clona el repositorio y entra en el directorio del paquete CLI:

git clone https://github.com/openai/codex.git
cd codex/codex-cli
  • Instala las dependencias y compila:

npm install
npm run build
  • Ejecuta el CLI compilado en local o enlázalo globalmente mediante npm link.

Configuración

  • Codex CLI buscará los archivos de configuración en el directorio ~/.codex/:

  • config.yaml: permite establecer opciones como el modelo predeterminado.

  • instructions.md: permite definir instrucciones personalizadas.

Uso

  • Ejecución interactiva:

codex
  • Ejecutar un comando específico:

codex "explain this codebase to me"
  • Modo totalmente automático:

codex --approval-mode full-auto "create the fanciest todo-list app"

Modo no interactivo / Modo CI

Es posible ejecutar Codex CLI en modo headless dentro de un pipeline de CI/CD. Por ejemplo:

- name: Update changelog via Codex
run: |
npm install -g @openai/codex
export OPENAI_API_KEY="${{ secrets.OPENAI_KEY }}"
codex -a auto-edit --quiet "update CHANGELOG for next release"

Dirección en GitHub:https://github.com/openai/codex

Información detallada:https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started