OpenAI Codex CLI: OpenAI lanza un asistente de programación de IA en línea de comandos de terminal

Introducción general

OpenAI Codex CLI es una herramienta de codificación de terminales de código abierto desarrollada por OpenAI para desarrolladores acostumbrados a los terminales. Genera código, edita archivos y ejecuta órdenes mediante comandos en lenguaje natural, e integra el control de versiones Git.Codex CLI utiliza los últimos modelos de OpenAI (como o3 y o4-mini), soporta programación multilingüe y proporciona un entorno sandbox seguro que restringe el acceso a la red y la manipulación de directorios para garantizar la seguridad. El proyecto es totalmente de código abierto, fomenta las contribuciones de la comunidad y es adecuado para el desarrollo rápido, la automatización de tareas y el aprendizaje de la programación.

Lista de funciones

• Generación de código: Genere código Python, JavaScript y otros multilenguajes a partir del lenguaje natural.
• Operaciones con archivos: creación y edición de archivos, soporte de commits y versionado Git.
• Ejecución de comandos: ejecute código o comandos en el sandbox y muestre los resultados en tiempo real.
• Entrada multimodal: admite la entrada de capturas de pantalla y gráficos para generar el código correspondiente.
• Security Sandbox: Deshabilita la red por defecto y sólo opera el directorio actual por seguridad.
• Aprobación automatizada: Ofrece tres modos: manual, edición automática y totalmente automatizado.
• Desarrollo de código abierto: permite a los usuarios ver el código, enviar características de contribución PR.
• Documentación del proyecto: compatibilidad con comandos Markdown globales y a nivel de proyecto, comportamiento personalizado.

Utilizar la ayuda

Proceso de instalación

Para utilizar Codex CLI, siga los siguientes pasos de instalación:

1. requisitos del sistema::
   • SO: macOS 12+, Ubuntu 20.04+/Debian 10+, o Windows 11 (mediante WSL2).
   • Node.js: versión >= 22 (se recomienda la versión LTS).
   • Git: versión >= 2.23 (recomendada, para el control de versiones).
   • RAM: Al menos 4 GB, se recomiendan 8 GB.
   • Clave API de OpenAI: consíguela en el sitio web de OpenAI.
2. Pasos de la instalación::
   • Instalar globalmente a través de npm (recomendado):

     npm install -g @openai/codex
     

   • o construir a partir del código fuente:

     git clone https://github.com/openai/codex.git
     cd codex/codex-cli
     npm install
     npm run build
     

   • Establezca la clave API:

     export OPENAI_API_KEY="your-api-key-here"
     

     Para un ajuste permanente, añádalo al archivo de configuración del intérprete de órdenes (por ejemplo ~/.zshrc tal vez ~/.bashrc):

     echo 'export OPENAI_API_KEY="your-api-key-here"' >> ~/.zshrc
     source ~/.zshrc
     

   • Verifica la instalación:

     codex --help
     

     Si aparece el mensaje de ayuda, la instalación se ha realizado correctamente.

3. Configuración de Docker en Linux::
   • Se recomienda Docker para mejorar la seguridad:

     ./run_in_container.sh
     

   • Asegúrate de que Docker está instalado, el script montará automáticamente el directorio actual y configurará el firewall para permitir sólo el acceso a la API de OpenAI.
4. advertencia::
   • No utilizar sudo npm install -gdebería arreglar los permisos npm:

     sudo chown -R $(whoami) ~/.npm
     

   • Asegúrese de que la clave API es válida para evitar 401 tal vez 429 Error.

Utilización

Codex CLI proporciona una experiencia de codificación eficiente mediante la combinación de lenguaje natural y entorno sandbox a través de operaciones de comandos de terminal. A continuación se muestra cómo utilizar las funciones principales:

1. Generación de códigos

• flujo de trabajo::
  • Patrones de interacción:

    codex
    

    Introduzca un prompt como "Crear una función Python para calcular una serie Fibonacci".

  • Modo de comando único:

    codex "生成 JavaScript 过滤数组函数"
    

  • Codex CLI genera código y muestra una vista previa.
  • importación y Aceptar y guardar, introduzca n Rechazo.
• Opciones avanzadas::
  • Especifica el modelo:

    codex --model o4-mini "生成 Go HTTP 服务器"
    

  • Modo no interactivo:

    codex -q "生成 SQL 查询" > output.sql
    

• Funciones destacadas::
  • Soporte para Python, JavaScript, TypeScript, Go, SQL y más.
  • Puede manejar tareas complejas como "Generar una aplicación Flask con autenticación de usuario".

2. Manipulación de archivos e integración con Git

• flujo de trabajo::
  • Editar archivo:

    codex "在 src/app.js 中添加登录功能"
    

  • El Codex CLI muestra las diferencias de código, las confirma y las guarda.
  • Comprometido con Git:

    codex "提交更改，消息为 '添加登录功能'"
    

• Funciones destacadas::
  • Manejar automáticamente los comandos Git (addycommit).
  • Admite operaciones por lotes como:

    codex "重命名所有 *.jpeg 为 *.jpg 并更新引用"
    

  • Se ofrecen tres modos de aprobación:
    • suggestPor defecto, todos los cambios deben confirmarse manualmente.
    • auto-edit: Los cambios en los archivos se aplican automáticamente y es necesario confirmar el comando.
    • full-auto: Totalmente automático y debe utilizarse con precaución:

      codex --approval-mode full-auto "更新 README"
      

3. Ejecutar el código

• flujo de trabajo::
  • Ejecuta el código:

    codex "运行 src/main.py"
    

  • La CLI del Codex se ejecuta en el sandbox y muestra los resultados.
  • Si falta alguna dependencia, pida que se instale:

    codex "安装 numpy 并运行 script.py"
    

• Funciones destacadas::
  • macOS utiliza el sandbox Seatbelt de Apple y Linux utiliza Docker.
  • Las redes están desactivadas por defecto para evitar accesos accidentales.
  • Admite salida de depuración para mostrar detalles de los errores.

4. Entradas multimodales

• flujo de trabajo::
  • Introduzca la ruta de la imagen:

    codex "根据 ui.png 实现界面代码"
    

  • Codex CLI analiza imágenes para generar código HTML/CSS o front-end.
• Funciones destacadas::
  • Soporte para la conversión de diseño de interfaz de usuario a código.
  • Los diagramas o organigramas pueden procesarse para generar código lógico.

5. Configuración y personalización

• archivo de configuración::
  • Configuración global:~/.codex/config.yaml::

    model: o4-mini
    fullAutoErrorMode: ask-user
    

  • Archivo de instrucciones:~/.codex/instructions.md::

    - 使用 Python 3.9
    - 禁止自动提交 Git
    

  • Configuración a nivel de proyecto: el codex.md::

    - 优先使用 TypeScript
    - 运行测试前执行 npm run lint
    

• Desactivar la documentación del proyecto::

  codex --no-project-doc

• Conmutación del modo de aprobación::

  codex --approval-mode auto-edit
  

6. Integración CI/CD

• flujo de trabajo::
  • Ejecútalo en Acciones GitHub:

    - name: 更新文档
    run: |
    npm install -g @openai/codex
    export OPENAI_API_KEY="${{ secrets.OPENAI_KEY }}"
    codex -a auto-edit -q "更新 CHANGELOG"
    

  • Configura el modo silencioso:

    export CODEX_QUIET_MODE=1
    

• Funciones destacadas::
  • Admite el modo no interactivo, adecuado para procesos automatizados.
  • Salida en formato JSON para facilitar la programación:

    codex -q --json "生成配置"
    

advertencia

• Asegúrese de que el directorio es rastreado por Git.full-auto le avisará en directorios que no sean Git.
• Compruebe la cuota de la clave API, las llamadas frecuentes pueden disparar los límites.
• El proyecto es experimental y puede tener características inestables, por lo que recomendamos seguir GitHub para las actualizaciones.

escenario de aplicación

1. Creación rápida de prototipos
   Los desarrolladores pueden generar rápidamente marcos de código en lenguaje natural. Por ejemplo, escriba "Crear una aplicación Express con una base de datos" y la CLI de Codex genera rutas, modelos y archivos de configuración adecuados para validar ideas.
2. Tareas automatizadas
   Codex CLI simplifica tareas repetitivas como "actualizar los avisos de copyright en todos los archivos y enviarlos". Edita archivos automáticamente, ejecuta scripts y los envía a Git para operaciones por lotes.
3. Aprendizaje de programación
   Los principiantes pueden escribir "Quick Sort in Python", Codex CLI genera el código y explica la lógica, adecuado para el auto-estudio o la enseñanza en el aula.
4. Colaboración de código abierto
   Los desarrolladores pueden participar en el desarrollo de Codex CLI a través de GitHub, enviar correcciones de errores o nuevas funciones, y la transparencia del código base facilita la colaboración.
5. Canalización CI/CD
   En entornos CI, Codex CLI actualiza automáticamente la documentación, genera casos de prueba o corrige errores de lint, mejorando la eficiencia del desarrollo.

CONTROL DE CALIDAD

1. ¿En qué se diferencia el Codex CLI del modelo Codex 2021?
   La CLI de Codex es una herramienta de punto final más potente y de código abierto basada en los últimos modelos de OpenAI (o3, o4-mini), independiente de los modelos de Codex que dejarán de utilizarse en 2021.
2. ¿Cómo puedo garantizar un funcionamiento seguro?
   El Codex CLI se ejecuta por defecto en un sandbox, utiliza Apple Seatbelt para macOS y Docker para Linux, desactiva la conexión en red y restringe el acceso a directorios para evitar riesgos en el sistema.
3. ¿Qué lenguajes de programación son compatibles?
   Se admiten Python, JavaScript, TypeScript, Go, SQL, etc., según determine el modelo de OpenAI utilizado, y el lenguaje puede especificarse mediante un comando.
4. ¿Es gratuito el Codex CLI?
   La propia CLI de Codex es gratuita, pero requiere una clave de API de OpenAI y puede incurrir en costes por llamadas a la API; consulte OpenAI Pricing para obtener más detalles.
5. ¿Cómo impedir que la CLI del Codex modifique archivos?
   utilizar suggest todos los cambios deben confirmarse manualmente:

   codex --approval-mode suggest