Codex CLI: Sandbox y seguridad

Codex CLI incluye mecanismos de sandbox y políticas de seguridad para garantizar la protección del sistema y de los datos mientras te ayuda a programar. Esta sección detalla estos mecanismos de seguridad y cómo configurarlos.


Mecanismo de sandbox

Codex ejecuta comandos y opera archivos en un entorno de sandbox aislado. Este diseño garantiza:

  • Las modificaciones a los archivos de tu proyecto son controlables
  • Los comandos potencialmente peligrosos requieren tu confirmación
  • Los datos sensibles no se filtran accidentalmente

El sandbox es la primera línea de defensa de la política de seguridad de Codex; garantiza que las operaciones de la IA no excedan el alcance que esperas.


Política de ejecución

Codex utiliza una política de ejecución (Execution Policy) para controlar el comportamiento de diferentes tipos de operaciones:

Tipos de política

PolíticaComportamientoEscenario aplicable
askPreguntar confirmación antes de cada ejecuciónDesarrollo diario (predeterminado)
approveAprobar ejecución automáticamenteEntorno de total confianza
denyRechazar todas las operaciones que puedan causar efectos secundariosModo de solo lectura

Operaciones que requieren confirmación

Los siguientes tipos de operaciones activarán solicitudes de confirmación:

  • Ejecutar comandos de Shell (especialmenterm、killetc.)
  • Modificar o eliminar archivos
  • Crear nuevos archivos
  • Acceder a directorios sensibles (como~/.ssh/、/etc/)
  • Solicitudes de red (en ciertos casos)

Configurar la política de ejecución

Establecer la política de ejecución en la configuración

[exec]
default_policy = "ask"

Por razones de seguridad, no se recomienda establecer la política predeterminada comoapprove, a menos que comprendas completamente los riesgos potenciales.


Diálogo de confirmación

Cuando Codex necesita realizar una operación sensible, se muestra un diálogo de confirmación:

══════════════════════════════════════════════════════
  确认执行
══════════════════════════════════════════════════════

  Codex 计划执行以下操作:

  命令: rm -rf node_modules/
  目录: /path/to/project

  这将永久删除目录及其所有内容

  [Y] 确认执行  [N] 取消  [A] 始终允许此类操作
══════════════════════════════════════════════════════

Descripción de opciones

OpciónDescripción
YEjecutar solo esta vez
NCancelar la operación
AAgregar regla y aprobar automáticamente en el futuro

Ten cuidado al elegir "Permitir siempre"; asegúrate de que la operación sea realmente segura.


Control de acceso a archivos

Directorios protegidos

Ciertos directorios del sistema están protegidos por defecto; Codex solicitará confirmación adicional al acceder a ellos:

DirectorioDescripción
~/.ssh/Claves y configuración SSH
~/.aws/Credenciales de AWS
/etc/Configuración del sistema
~/.git-credentialsAlmacenamiento de credenciales de Git

Reglas de protección personalizadas

Puedes agregar reglas de protección personalizadas en la configuración:

Configurar reglas de acceso a archivos

[sandbox]
# Directorios a los que se permite el acceso
allowed_paths = [
    "~/projects/*",
    "/workspace/*"
]

# Directorios protegidos (requieren confirmación adicional)
protected_paths = [
    "~/.ssh/*",
    "~/secrets/*"
]

Control de acceso a la red

Codex puede restringir el alcance de las solicitudes de red:

Configurar el acceso a la red

[network]
# Dominios permitidos
allowed_domains = [
    "github.com",
    "api.openai.com"
]

# Si se permite el acceso a la red local
allow_localhost = false

# Si se permite la red privada
allow_private_network = false
Restringir el acceso a la red evita que Codex se conecte accidentalmente a servicios no confiables.

Restricción del directorio de trabajo

Puedes limitar Codex para que solo opere en directorios específicos:

Limitar el directorio de trabajo

[sandbox]
# Codex solo puede operar en estos directorios
working_directories = [
    "~/projects/*",
    "/workspace/*"
]

# Comportamiento al salir del directorio: warn (advertencia) o deny (denegar)
out_of_bounds = "deny"

Lista blanca/negra de comandos

Modo de lista blanca (recomendado)

Solo permite ejecutar los comandos explícitamente listados:

Lista blanca de comandos

[commands]
# Modo de lista blanca
whitelist_enabled = true
allowed_commands = [
    "git",
    "npm",
    "node",
    "python",
    "cargo"
]

Modo de lista negra

Prohíbe ejecutar comandos específicos:

Lista negra de comandos

[commands]
# Modo de lista negra
blacklist_enabled = true
blocked_commands = [
    "rm -rf /",
    "dd",
    "mkfs"
]
El modo de lista blanca es más seguro; se recomienda usarlo en entornos de producción o al manejar proyectos sensibles.

Manejo de datos sensibles

Enmascaramiento automático

Codex detecta y enmascara automáticamente la información sensible:

  • Claves de API y contraseñas
  • Tokens e información de autenticación
  • Información de identificación personal (PII)

Protección de variables de entorno

Algunas variables de entorno se ocultan automáticamente:

AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
OPENAI_API_KEY
DATABASE_URL

Especificar manualmente datos sensibles

Puedes marcar manualmente en la configuración el contenido que necesita protección:

Personalizar patrones de datos sensibles

[sensitive]
# Patrones de expresión regular que deben enmascararse
patterns = [
    "password\\s*=\\s*[^\\s]+",
    "api_key\\s*=\\s*[^\\s]+",
    "secret\\s*=\\s*[^\\s]+"
]

Registro de auditoría

Codex puede registrar un registro de auditoría de todas las operaciones:

Habilitar el registro de auditoría

[audit]
enabled = true
log_file = "~/.codex/log/audit.log"

Contenido del registro

El registro de auditoría registra la siguiente información:

  • Marca de tiempo
  • Tipo de operación
  • Archivos o comandos involucrados
  • Resultado de la operación (éxito/fracaso)
  • Estado de confirmación del usuario

Ver el registro de auditoría

# Ver los registros de auditoría recientes
tail -f ~/.codex/log/audit.log
El registro de auditoría es muy importante para la auditoría de seguridad y la resolución de problemas, especialmente en entornos de equipo.

Mejores prácticas de seguridad

Entorno de desarrollo

  • Usar la política de ejecución predeterminada (ask)
  • Habilitar el registro de auditoría
  • Configurar la lista blanca de comandos

Entorno de producción

  • Limitar el directorio de trabajo
  • Usar el modo de lista blanca
  • Deshabilitar el acceso a la red innecesario
  • Habilitar el registro de auditoría completo

Proyectos sensibles

  • Usar las reglas de protección más estrictas
  • Revisar cuidadosamente cada solicitud de confirmación
  • Revisar periódicamente los registros de auditoría

Preguntas frecuentes

P: ¿Dónde se configura la política de ejecución?

La política de ejecución se configura principalmente a través de~/.codex/config.tomlel archivo de configuración. Algunas opciones también se pueden configurar mediante variables de entorno.

P: ¿Qué hago si hice clic por error en "Permitir siempre"?

Elimina la regla correspondiente en el archivo de configuración, o elimina todo el archivo de configuración y reinicia Codex; las reglas se restablecerán.

P: ¿Puede Codex acceder a mi token de GitHub?

Codex solicitará los permisos necesarios de acceso a GitHub para ejecutar operaciones. Puedes revocar estos permisos en cualquier momento desde la configuración de GitHub.

P: ¿Cómo deshabilitar completamente la modificación de archivos?

Establece la política de ejecución comodeny, esto evitará que Codex ejecute cualquier operación que pueda modificar el sistema de archivos.

Otras extensiones