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.
| Objetivo | Comando CLI | Uso adecuado | Error habitual |
|---|---|---|---|
| Árbol de trabajo | codex review --uncommitted | Inspeccionar antes de confirmar | Otro proceso sigue editando archivos |
| Rama | codex review --base origin/main | Revisar una función frente a integración | La referencia remota está desactualizada |
| Un commit | codex review --commit <SHA> | Investigar un cambio concreto | Confundir 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.
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/mainGuarda 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.
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.