Codex AGENTS.md: instrucciones coherentes en tu VPS

Codex AGENTS.md: instrucciones coherentes en tu VPS — Configura Codex AGENTS.md en un VPS: entiende la búsqueda de archivos, las excepciones y el directorio de trabajo antes de ejecutar tareas sin supervisión.
17 nov 20265 min de lectura
Share with

Una tarea de Codex se comporta de una forma en nuestro portátil y de otra en el VPS. El repositorio es idéntico, pero el agente arranca en otro directorio y hereda instrucciones distintas de la cuenta. Repetir el mensaje no corrige el entorno.

Tratamos Codex AGENTS.md como instrucciones operativas versionadas, no como una memoria mágica. Así hacemos reproducible su alcance antes de dejar trabajar a un agente remoto. Es un procedimiento manual de Codex, no una función nueva de configuración de Office Claws.

Codex AGENTS.md: qué carga el ejecutor

La guía oficial describe una cadena construida al inicio de cada ejecución. Importa el directorio de arranque: que un archivo exista en el repositorio no significa que entre en la cadena inicial.

CapaBúsquedaConsecuencia operativa
Directorio personal de CodexAGENTS.override.md o, en su defecto, AGENTS.md; primer archivo no vacíoLa cuenta del VPS puede añadir reglas ausentes en el portátil
Raíz del proyecto hasta el directorio de trabajoUn archivo por directorio: excepción, normal y nombres alternativos configuradosArrancar dentro de un servicio carga una cadena distinta
Instrucciones combinadasDe la raíz hacia abajo; prevalecen las instrucciones más cercanasUna excepción local puede cambiar una regla general

El límite predeterminado de documentos de proyecto combinados es 32 KiB. Conviene ser breve y revisar project_doc_max_bytes si se truncan. Un archivo de excepción sustituye al normal en el mismo directorio; no borra las capas anteriores. El directorio personal predeterminado es ~/.codex, pero CODEX_HOME puede cambiarlo.

Cadena de instrucciones desde la cuenta hasta el repositorio y el servicio

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

Escribe un contrato de trabajo, no un manual del repositorio

Mantenemos las reglas compartidas y estables en la raíz y los comandos específicos junto al servicio. No copiamos toda la wiki de arquitectura al contexto: indicamos el documento pertinente y la decisión para la que sirve.

Para un repositorio cuyo comando de pruebas realmente sea npm test, esta es una plantilla breve para la raíz. Adapta los comandos al proyecto antes de confirmarla. El ejemplo no concede permisos ni configura automatizaciones.

# AGENTS.md
 
## Scope
- Work only on the assigned branch and requested change.
- Read docs/development.md before changing build configuration.
 
## Verification
- Run npm test after code changes; report the command and result.
- If a check cannot run, report the blocker instead of claiming success.
 
## Review boundary
- Do not deploy, publish packages, or rotate credentials.
- Flag authentication and migration changes for human review.

Versiona las instrucciones como el código. Cambiar «proponer una migración» por «aplicar la migración» merece revisión aunque no cambie la aplicación. No incluyas tokens, contraseñas ni datos privados de cuentas: estas instrucciones se envían al modelo y no son un almacén de secretos.

Comprueba el mismo alcance por SSH

En el VPS usamos la misma cuenta Unix, copia del repositorio, carpeta de trabajo y perfil de Codex que en la tarea real. Una sesión de administrador no demuestra la configuración de una cuenta de servicio. Nuestra guía de SSH explica la conexión.

Ejecuta esta comprobación de solo lectura desde la raíz del repositorio de confianza. Sustituye la ruta por la tuya. Enumera archivos candidatos, no demuestra que se carguen todos; contrasta la lista con las reglas anteriores y la respuesta del agente. El último comando utiliza el modelo y puede consumir cuota del plan.

cd ~/work/product-api
pwd
git rev-parse HEAD
codex --version
printf 'CODEX_HOME=%s\n' "${CODEX_HOME:-$HOME/.codex}"
find . -type d -name .git -prune -o -type f \
  \( -name AGENTS.md -o -name AGENTS.override.md \) -print
codex exec --sandbox read-only \
  "Do not edit files or execute project commands. List the instruction sources you loaded and summarize the verification and review boundaries."

Inspecciona los archivos de la cuenta por separado sin copiar su contenido a registros compartidos. Revisa también los nombres alternativos configurados: find solo enumera los dos nombres estándar. El resumen del modelo es una comprobación orientativa, no una auditoría formal ni una garantía de seguridad.

Si la tarea corresponde a un servicio anidado, repite la comprobación desde esa carpeta. Después de editar instrucciones, inicia una ejecución nueva: la cadena documentada se construye una vez por ejecución y no se recarga en una sesión existente.

Separa las instrucciones de los controles efectivos

Una frase de AGENTS.md que diga «no desplegar» no controla el acceso. Restringe credenciales y herramientas por separado y configura el aislamiento y las aprobaciones. No entregues credenciales de producción a un ejecutor nocturno solo porque sus instrucciones desaconsejen usarlas.

Antes de una tarea desatendida registramos el commit, la versión de Codex, el directorio de trabajo y la revisión de las instrucciones. Con agentes paralelos, comprobamos cada copia en vez de suponer que una modificación llegó a todas. Ante diferencias, revisa primero el directorio personal, CODEX_HOME, las excepciones, los nombres alternativos y el directorio inicial.

Office Claws ejecuta agentes Codex en tu propio Contabo VPS y ofrece control mediante CLI y escritorio pixel art. Sigues manteniendo las instrucciones y revisando los resultados. Office Claws parte de $4.99/mes para el primer agente; el VPS y el plan ChatGPT compatible se pagan por separado, y sus límites de uso siguen vigentes. Consulta los costes de suscripción de Codex.

Recomendamos versionar un contrato pequeño, verificarlo con la cuenta real del ejecutor y mantener una revisión humana. Un servidor siempre encendido debe hacer repetible el proceso, no convertir un texto en una barrera de permisos.

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