Codex Code Review: revisión segura para agentes en VPS

Codex Code Review: revisión segura para agentes en VPS — Usa Codex Code Review en ramas de un VPS: elige --base, --uncommitted o --commit, registra la revisión y separa pruebas y aprobación humana.
19 nov 20265 min de lectura
Share with

Un agente termina un parche durante la noche. El terminal anuncia que acabó, pero la rama aún necesita revisión. Queremos otra mirada al diff real, no otro resumen de las intenciones del autor.

Codex Code Review permite una inspección específica dentro del repositorio. En un VPS no basta preguntar «¿se ejecutó la revisión?». Importa saber qué archivos y revisión inspeccionó y quién decide publicarlos. Esta guía describe un flujo manual de Codex CLI, no una función de fusión automática de Office Claws.

Codex Code Review: elige el diff correcto

La descripción de la CLI de OpenAI documenta la revisión de cambios sin confirmar, de un commit o respecto a una rama base. Su guía de revisión distingue revisar un checkout de revisar una solicitud de incorporación. Usamos el checkout de nuestro propio ejecutor.

ObjetivoComando CLIUso adecuadoError habitual
Árbol de trabajocodex review --uncommittedInspeccionar antes de confirmarOtro proceso sigue editando archivos
Ramacodex review --base origin/mainRevisar una función frente a integraciónLa referencia remota está desactualizada
Un commitcodex review --commit <SHA>Investigar un cambio concretoConfundir un commit con toda la función

Las definiciones actuales de argumentos hacen estos objetivos mutuamente excluyentes. Tampoco permiten un prompt posicional personalizado junto con estos selectores. Consulta la ayuda de la versión instalada, en vez de mezclar opciones de ejemplos distintos. La revisión sin confirmar incluye cambios preparados, no preparados y archivos sin seguimiento; busca secretos antes de enviar contexto del repositorio al modelo.

Árbol de trabajo, rama y commit definen alcances de revisión distintos

Pon en marcha tu primer agente en unos 3 minutos

Instala la CLI de Office Claws, conecta tu cuenta de Contabo y tu suscripción de Codex, y tu agente tendrá su propio VPS y un escritorio en la oficina.

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

$4.99/mes + tu propio VPS de Contabo · las claves se quedan en tu llavero

Fija la entrega antes de revisar

Terminamos las ediciones del agente constructor y confirmamos el parche previsto antes de revisar la rama. Detenemos otros procesos que escriban en ese checkout. Sustituye la ruta y la rama base del ejemplo; fetch actualiza referencias Git, pero no fusiona cambios en tu rama.

cd ~/work/product-api
codex --version
codex review --help
git fetch origin
git status --short
git rev-parse HEAD
git rev-parse origin/main
git diff --stat origin/main...HEAD
codex review --base origin/main

Guarda ambos identificadores de commit impresos junto a los hallazgos y la versión de Codex. El diff de tres puntos permite anticipar los cambios desde el ancestro común; no garantiza que toda implementación de revisión use exactamente el mismo contexto interno. Si está vacío o contiene trabajo ajeno, corrige la entrega antes de gastar una revisión.

Para constructores paralelos usamos otro checkout o worktree para el candidato. Un worktree aísla archivos, no credenciales Unix ni la red. No revises un objetivo cambiante mientras otro proceso reorganiza commits o cambia de rama. Nuestra guía de flujos paralelos trata los límites de las tareas; aquí fijamos la identidad del resultado inspeccionado.

Después de corregir algo, los hallazgos antiguos siguen describiendo el estado anterior. Repite las pruebas pertinentes y revisa el candidato actualizado. Si cambió la rama de integración, inspecciona también la nueva relación con la base: una revisión anterior sin incidencias no demuestra nada sobre una fusión posterior.

Convierte los hallazgos en evidencia, no en aprobación

Una revisión terminada no equivale a una aprobación. No interpretes su código de salida como número de defectos ni «sin hallazgos» como prueba de seguridad. Contrastamos cada advertencia con el código citado y el comportamiento esperado.

Para cada problema relevante conservamos la entrada que lo desencadena, archivo y línea, resultado esperado y real y, cuando sea viable, una prueba de regresión. Si no podemos reproducirlo, documentamos por qué en lugar de aplicar una reescritura especulativa. Si faltan dependencias o acceso a un servicio necesario, mantenemos visible esa limitación.

Una revisión fija pasa por inspección, pruebas y aprobación humana antes de fusionarse

Ejecuta por separado las comprobaciones reales del proyecto. Una entrega útil incluye las identidades de la base y el candidato revisados, comandos y resultados de pruebas, problemas pendientes y decisión humana de fusión. Los cambios de autenticación, migraciones de esquema y manejo de credenciales merecen atención aunque el agente no informe nada.

OpenAI describe la revisión dedicada como una operación que informa sin modificar el árbol de trabajo. Pedir al agente que aplique correcciones es otro paso de edición. Esa distinción no es una barrera del sistema operativo: conserva ajustes de aislamiento y aprobación adecuados y no añadas credenciales de despliegue a producción al ejecutor solo para inspeccionar un diff.

Separa revisión y despliegue en tu VPS

Office Claws ejecuta agentes basados en Codex en infraestructura VPS que controlas y proporciona la capa operativa de escritorio y CLI. No convierte estos comandos en un motor de políticas garantizado ni en aprobación automática de solicitudes. Usa SSH para inspeccionar el checkout y conserva los registros disponibles para el operador.

Una segunda revisión también consume acceso al modelo. Aportar un plan de ChatGPT no hace ilimitadas las revisiones ni elimina sus límites; la revisión local por CLI y la revisión alojada de solicitudes son flujos distintos. Comprueba tus permisos actuales y nuestra guía de suscripciones antes de aumentar la concurrencia.

Recomendamos empezar con una rama terminada, una base explícita, un par de revisiones documentado y una aprobación humana para fusionar. Automatiza solo cuando puedas explicar qué se revisa, dónde quedan las pruebas y qué impide publicar una revisión no inspeccionada.

Autor

Office Claws Team

Construyendo el futuro de la gestión de agentes de IA en Office Claws. Compartiendo conocimientos sobre infraestructura, seguridad y experiencia del desarrollador.

Pon en marcha tu primer agente en unos 3 minutos

Instala la CLI de Office Claws, conecta tu cuenta de Contabo y tu suscripción de Codex, y tu agente tendrá su propio VPS y un escritorio en la oficina.

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

$4.99/mes + tu propio VPS de Contabo · las claves se quedan en tu llavero