Codex Introducción Básica

Iniciar Codex

La interfaz de Codex tiene una estructura estándar de tres columnas: a la izquierda está la lista de tareas, en el centro la ventana de conversación y a la derecha un área multifuncional.

Al iniciar la aplicación Codex, podemos agregar proyectos en el menú de la izquierda y escribir nuestras necesidades en el campo de entrada de la columna central:

Se puede configurar el modelo o subir archivos, etc.:

Iniciar Codex CLI

Después de instalar y configurar la cuenta, abre la terminal en el directorio del proyecto y escribecodexpara iniciar la interfaz interactiva:

# 进入你的项目目录
cd ~/my-project

# 启动 Codex 交互界面
codex

# 带初始提示词直接启动
codex "帮我分析这个项目的结构"

# 启动时指定模型
codex --model gpt-5

💡 Se recomienda iniciar Codex en el directorio raíz del proyecto, para que pueda leer completamente la estructura de archivos del proyecto.
La interfaz de Codex es muy sencilla; donde está el cursor es el campo de entrada. Simplemente escribe tu necesidad.

Por ejemplo, entramos al directoriocodex-ejemplo-testy luego usamoscodexel comando para iniciar:

cd codex-ejemplo-test
# 启动 Codex 交互界面
codex

Luego podemos escribir directamente nuestra solicitud en la interfaz interactiva, por ejemplo, pedirle que explique el código del archivo test.py. El resultado es el siguiente (estos registros también se mostrarán en la aplicación Codex):

Tres modos de aprobación (Approval Mode)

Codex CLI ofrece tres modos de permisos de operación de distinto nivel; puedes elegir el modo adecuado según las necesidades de la tarea:

Modo	Descripción	Escenario de aplicación
`ask`(por defecto)	Modo de solo lectura: puede leer archivos y elaborar planes, pero requiere tu confirmación antes de ejecutar cualquier operación.	Exploración de repositorios de código desconocidos, evaluación de riesgos
`auto-edit`	Edición automática: puede leer y modificar archivos en el directorio actual, pero las operaciones de red aún requieren confirmación.	Desarrollo de código diario, tareas de refactorización
`full-auto`	Totalmente automático: se ejecuta de forma totalmente automática en un entorno sandbox con red deshabilitada, sin necesidad de confirmación.	Tareas por lotes, automatización de CI/CD

# 指定审批模式启动
codex --approval-mode ask        # 默认只读模式
codex --approval-mode auto-edit  # 自动编辑模式（缩写 -a auto-edit）
codex --approval-mode full-auto  # 完全自动模式

# 在交互界面中切换
/approvals  # 输入此命令切换审批模式

Tu primera conversación

Ejemplo 1: Analizar la estructura del proyecto

codex "分析这个项目的目录结构，告诉我主要文件的作用"

# Codex 会自动读取文件，输出类似：
# ✓ 读取 package.json
# ✓ 扫描 src/ 目录（23 个文件）
#   项目结构分析：
# - src/index.ts：应用入口，初始化 Express 服务器
# - src/routes/：API 路由定义（共 5 个端点）
# ...

Ejemplo 2: Reparar un bug

codex "我的 login 函数有 bug，用户登录后 token 没有正确保存，帮我找出问题并修复"

# Codex 会：
# 1. 读取相关文件
# 2. 分析代码逻辑
# 3. 提出修改方案
# 4. 等待你确认后执行修改

Ejemplo 3: Generar una nueva funcionalidad

codex "给我的 Express 应用添加一个用户注册接口，需要验证邮箱格式，密码至少8位，并把用户信息存入数据库"

# 传入图片上下文
codex -i design.png "按照这个设计图，实现对应的 React 组件"

Entrada de imágenes

Codex CLI admite usar imágenes como entrada de contexto, lo cual es especialmente útil en los siguientes escenarios:

Analizar capturas de pantalla de errores
Generar código frontend a partir de diseños de UI
Interpretar diagramas de arquitectura e implementar funcionalidades en consecuencia

# 方法一：命令行传入图片路径
codex -i screenshot.png "解释这个报错信息，并告诉我如何修复"

# 方法二：传入多张图片
codex --image img1.png,img2.jpg "对比这两个界面的区别，实现图一的设计"

# 方法三：在交互界面中粘贴图片（macOS）
# 复制图片后，在 Codex 输入框中直接按 Cmd+V 粘贴

# 方法四：Shift + 拖拽图片到终端窗口

Otras extensiones

Codex Cli