Cómo usar Codex y Claude Code en solo lectura: investigar y recibir consejos sin editar

Quieres investigar la estructura o los fallos de un proyecto existente, sin que se edite el código, se cambie la configuración ni se instale software. Prepara tanto una instrucción de investigación como permisos que limiten los cambios. El entorno de solo lectura de Codex y el modo Plan de Claude Code tienen fines relacionados, pero funcionan de forma distinta.

Contrastado con la documentación oficial de OpenAI y Anthropic el 9 de octubre de 2026. Los ejemplos de inicio de este artículo no se han ejecutado en un equipo real. Distinguimos el comportamiento documentado del producto de las condiciones que debes comprobar en tu entorno.

1. Instrucciones y restricciones de permisos

Una petición como «Investiga los problemas del inicio de sesión» deja una duda: ¿el agente debe corregir lo que encuentre o detenerse tras informar? Decir «No hagas cambios» comunica tu intención, pero no elimina las herramientas de edición ni la capacidad de escritura de la consola.

La documentación de Claude Code explica que las instrucciones y CLAUDE.md influyen en lo que el modelo intenta hacer, mientras que el sistema de permisos determina las acciones permitidas. Si escribes prohibiciones en AGENTS.md de Codex, distingue igualmente las instrucciones de los permisos efectivos. Fuente: permisos de Claude Code.

2. Codex: ajustes de la aplicación, el IDE y la CLI

Escritorio: revisa las restricciones de escritura en Settings

En la aplicación de escritorio, abre Settings → Configuration desde el menú de la aplicación. El atajo de ajustes es Ctrl+, en Windows y Cmd+, en macOS. La pantalla oficial Configuration muestra Approval policy y Sandbox settings por separado. Los nombres pueden variar según el idioma y la versión.

Fuentes: pantalla oficial Configuration, abrir los ajustes, control de permisos bajo el cuadro de entrada.

Si la interfaz no es clara: usa Open config.toml

Abre el archivo mediante Settings → Configuration → Open config.toml. Los ajustes de usuario suelen estar en ~/.codex/config.toml. En la configuración tradicional del entorno aislado, estos valores seleccionan solo lectura y una política que no solicita aprobación adicional. Es un ejemplo de configuración; leer el artículo no cambia los ajustes.

sandbox_mode = "read-only"
approval_policy = "never"

Los ajustes de usuario también afectan a la aplicación, la extensión del IDE y la CLI que lean la misma configuración. Pueden intervenir los ajustes de proyectos de confianza en .codex/config.toml, las opciones de inicio y las políticas administradas. Encontrar esas dos líneas no basta para confirmar que están activas. En la CLI, /status y /debug-config muestran las condiciones de ejecución y el origen de los ajustes. Para investigar durante una sola sesión sin cambiar ajustes permanentes, usa el ejemplo de CLI de abajo.

La función más reciente Permission profiles está en beta y ofrece otra forma de configuración, incluido el perfil integrado :read-only. Al combinarla con sandbox_mode o --sandbox tradicionales, estos pueden tener prioridad; también hay excepciones por políticas administradas. Revisa el método que ya usas antes de añadir ambos. Fuente: abrir el archivo de configuración, prioridad de configuración, Permission profiles.

Codex también ofrece /plan para pedir un plan antes de implementar. Sin embargo, comprueba por separado la petición de planificación y las restricciones de escritura. No supongas que las restricciones o excepciones de Plan de Claude Code se aplican a Codex por compartir el nombre. Fuente: /plan de Codex.

Extensión del IDE: abre Codex Settings desde el engranaje

Usa el engranaje → Codex Settings, arriba en la barra lateral de Codex, para revisar los ajustes compartidos, y Open config.toml para los detalles. Revisa también el control de permisos bajo el cuadro de entrada. Los ajustes de la extensión en el editor son distintos del config.toml que lee el agente. Desactivar IDE context, que aporta archivos abiertos, no revoca el permiso del agente para leer archivos. Fuente: Developer settings por cliente.

CLI: especifica opciones para esta sesión

Si ya tienes Codex CLI, abre una terminal en la carpeta que quieres investigar e inicia la herramienta así. No hace falta reescribir permanentemente el archivo de configuración. Siguen prevaleciendo las políticas administradas de la organización y las capacidades de tu versión de la CLI.

codex --sandbox read-only --ask-for-approval never

never no significa acceso total. El tipo de entorno aislado y la política de aprobación son ajustes independientes. La tabla oficial de OpenAI incluye read-only junto con never para leer archivos y ejecutar comandos dentro de esas restricciones. Fuente: Agent approvals & security.

En qué se diferencia on-request

Con --ask-for-approval on-request, el agente puede pedir aprobación para una operación que deba ejecutarse fuera del entorno aislado. Aunque empieces en solo lectura, aprobar esa ejecución cambia el límite inicial. «Pregunta antes de hacer cambios si son necesarios» y «No hagas cambios esta vez» son políticas distintas.

Web, Cloud y Remote: distingue el dispositivo de visualización del entorno de ejecución

Work en la web usa un entorno de ejecución administrado y no lee el archivo local de configuración de Codex. Añadir las dos líneas anteriores al PC no convierte por sí solo la ejecución en Cloud en solo lectura. Revisa los controles de la interfaz y el espacio de trabajo de Cloud. No hemos confirmado un procedimiento de inicio equivalente que convierta todo Cloud en solo lectura.

Al usar Remote para ver desde otra interfaz el trabajo que se ejecuta en un PC, importan los ajustes del equipo que realmente ejecuta los comandos. No te bases solo en las restricciones del dispositivo desde el que miras. Consulta cuándo usar Codex localmente, mediante Remote o en Cloud. Fuente: ajustes web y locales.

3. Usar Claude Code solo para investigar y planificar

Claude Desktop: selecciona Plan junto al botón de envío en la pestaña Code

Estas instrucciones se aplican a la pestaña Code de Claude Desktop. Los ajustes de Chat y Cowork no equivalen a los modos de permisos de Claude Code. Usamos los nombres de modos de la documentación oficial en inglés; el texto mostrado puede variar según el idioma y la versión.

Plan elegido en el selector solo se aplica a esa sesión. Los demás modos se recuerdan por carpeta y prevalecen sobre permissions.defaultMode del archivo de ajustes. Si la conversación nueva también debe ser de investigación, comprueba Plan cada vez. Leer el mismo archivo que la CLI no significa que el modo elegido en una conversación se conserve en la siguiente sesión. Fuente: modos y persistencia en Desktop.

VS Code: selecciona Plan en el indicador bajo el cuadro de entrada

Abre el panel de chat de Claude Code y selecciona el indicador de modo bajo el cuadro de entrada → Plan. A partir de v2.1.280 también puedes enviar /plan en el panel. Si el plan se abre como documento Markdown, léelo como resultado de investigación sin aprobar la implementación.

Según la especificación oficial actual, se ignora el ajuste del espacio de trabajo de claudeCode.initialPermissionMode. Esto difiere del comportamiento anterior a v2.1.225. Seleccionar Plan en el chat también afecta solo a esa conversación. No supongas que añadir permissions.defaultMode a .claude/settings.json del proyecto cambia necesariamente el modo inicial de VS Code. Revisa la prioridad entre el ajuste inicial de la extensión, el último modo normal seleccionado, los ajustes administrados, los de usuario y las demás configuraciones aplicables.

Ten cuidado también con los archivos sin guardar. El ajuste claudeCode.autosave guarda los cambios del editor antes de que Claude lea o escriba. Distingue la edición del código por la IA del guardado realizado por el editor. Adjuntar automáticamente archivos abiertos también es distinto de limitar su acceso. Fuente: modos, ajustes de extensión y prioridad en VS Code.

Controles en web, móvil y JetBrains

Las ediciones habituales de archivos están preaprobadas en Cloud, así que no lo trates como Manual. Selecciona Plan explícitamente para investigar e indica al agente que termine tras informar, sin implementar. El comportamiento de aprobación de Cloud no implica que se pueda reescribir el código sin condiciones estando en Plan. Fuente: cambiar de modo según la interfaz, modos de Cloud.

CLI: inicia en Plan y no apruebes la implementación

Inicia Claude Code CLI en Plan con la siguiente opción. Plan normalmente lee archivos, investiga la estructura y los problemas y planifica cambios propuestos. Los cambios mediante herramientas de edición del código suelen bloquearse, pero se crean archivos de planificación.

claude --permission-mode plan

Los comandos de consola en Plan no se limitan siempre a comandos de solo lectura. Si auto está disponible y useAutoModeDuringPlan está activado, un clasificador puede revisarlos y permitirlos. Cuando auto no está disponible, entre otros casos, los comandos fuera del conjunto integrado de solo lectura requieren aprobación. Fuente: Plan en Permission modes.

Si no quieres permitir consola ni herramientas de edición

Si basta con leer código e investigar la estructura, usa --tools para limitar las herramientas integradas. Este ejemplo reduce las herramientas de investigación de archivos a Read, Glob y Grep y también deniega las de MCP. EndConversation sigue disponible para terminar la conversación. La capacidad de investigación se reduce respecto a Plan normal: no podrás realizar comprobaciones que requieran ejecutar comandos.

claude --permission-mode plan --tools "Read,Glob,Grep" --disallowedTools "mcp__*"

No lo sustituyas aquí por --allowedTools. Esa opción indica herramientas permitidas sin confirmación, pero no limita las disponibles a esa lista. Además, --tools por sí solo no restringe MCP; hace falta una opción separada. Fuente: CLI reference.

Desktop no tiene controles de interfaz por sesión equivalentes a --allowedTools o --disallowedTools de la CLI. Se aplican las reglas de permisos de los archivos de ajustes, pero el botón Plan por sí solo no produce las restricciones de este ejemplo. Fuente: capacidades de Desktop y CLI.

Este ejemplo tampoco convierte todo el PC en solo lectura, incluidos los datos guardados por la aplicación y los ajustes o hooks cargados. Al abrir un proyecto desconocido, revisa por separado los hooks, plugins y conexiones externas existentes. Para un funcionamiento más estricto, --restricted, disponible desde v2.1.248, cambia más que las herramientas: también modifica qué ajustes se cargan, entre otras cosas. No es otro nombre de Plan con el entorno habitual intacto.

Para gestionar permisos de herramientas de forma continua, consulta los ajustes allow, ask y deny de Claude Code. Para aislar Bash, consulta configuración y límites del entorno aislado. El aislamiento que permite escribir en el espacio de trabajo por defecto tiene una finalidad distinta de investigar únicamente.

4. Una instrucción de investigación lista para usar

Una vez preparados los permisos, pide al agente que termine tras informar. Definir qué investigar y qué resultado completa la tarea con más precisión que «Corrige esto» o «Mejora esto» reduce los malentendidos que llevan a implementar.

En esta tarea, investiga el estado actual y ofrece asesoramiento únicamente. No implementes.

Alcance: El inicio de sesión y los límites de autorización de este proyecto.
Permitido: Leer el código accesible y explicar la estructura y los problemas.
Prohibido: Crear, editar o eliminar archivos; cambiar ajustes; añadir dependencias;
           compilar, ejecutar pruebas, operar en la base de datos, hacer commits,
           pushes o despliegues, y cambiar servicios externos.
           No amplíes permisos para ejecutar hooks o scripts.

Entregables:
1. El flujo de procesamiento, con archivos investigados y números de línea
2. Pruebas, impacto y prioridad de cada posible problema
3. Mejoras propuestas, sin ejecutarlas, y comprobaciones necesarias antes de implementar
4. Dudas que no se resuelven solo leyendo y comprobaciones no realizadas

Aunque haga falta un cambio, detente en la recomendación y no lo ejecutes.
Termina la tarea cuando hayas presentado el informe de investigación.

Aunque estés de acuerdo con una mejora propuesta, puedes responder en la conversación de investigación: «Conserva esto como opción candidata. No lo implementes». Para continuar, abre una conversación de desarrollo separada y define de nuevo el alcance de cambios, pruebas y publicación. Así mantienes las restricciones de investigación alineadas con el objetivo.

5. Qué comprobar antes y después

No termines la verificación en «El modelo dice que no cambió nada». Tampoco necesitas intentar escribir en el código que quieres proteger para comprobar que sigue igual. Empieza por la interfaz, las explicaciones de configuración y las diferencias existentes, y registra lo que siga siendo incierto.

Si el proyecto usa Git, compara las diferencias

Estos comandos, por ejemplo, muestran los archivos modificados y resúmenes de las diferencias preparadas y sin preparar. Compruébalos antes y después para no confundir tus cambios previos con cambios de la IA. El ejemplo presupone que el repositorio ya usa Git.

git status --short
git diff --stat
git diff --cached --stat

Estos comandos no prueban que no haya cambiado nada en ningún lugar. git diff no muestra archivos sin seguimiento, y las comprobaciones no abarcan todos los archivos ignorados, ubicaciones fuera del espacio de trabajo, bases de datos ni servicios externos. Las diferencias finales tampoco revelan una operación que cambió algo y luego lo restauró. Distingue en el informe lo comprobado de lo no comprobado. Documentación oficial de Git: git status, git diff.

6. Comprobaciones que no puedes ejecutar y riesgos restantes

Las pruebas y compilaciones también pueden escribir archivos

Incluso sin editar código, las pruebas pueden escribir archivos temporales o instantáneas; las compilaciones, generar resultados; y los gestores de paquetes, escribir cachés o dependencias. No supongas que «solo ejecutar pruebas» no cambia nada. Un fallo bajo restricciones de solo lectura puede ser su resultado previsto, no un defecto.

Si el informe concluye que podría eludirse la autorización bajo ciertas condiciones, el siguiente paso puede ser planificar la reproducción en un entorno de verificación separado. Mejorar la investigación no exige permitir inmediatamente escritura en una base de datos de producción o un equipo con secretos. Separar lo que establece la inspección estática de lo que requiere ejecución hace el informe más útil para decidir.

Las restricciones de red de Codex también distinguen la comunicación de comandos aislados del tráfico de servicios para modelos, autenticación y otros fines. Iniciar en solo lectura no garantiza que la información leída no se envíe al modelo ni se use para entrenamiento. Fuente: alcance de Permissions. Para bloquear la lectura de secretos, consulta archivos secretos y permisos de Codex. Para ajustes de entrenamiento y conservación, consulta uso para entrenamiento y privacidad en ChatGPT y Codex.

Resumen

En Codex, especifica read-only y una política de aprobación. En Claude Code, revisa las condiciones de inicio de Plan y limita las herramientas si hace falta. Después, aporta una instrucción que termine la tarea al entregar el informe. Ambas herramientas permiten separar investigación y ejecución de cambios.

Si las restricciones estrictas dejan dudas sin resolver, recibe la lista de comprobaciones no realizadas y una propuesta de verificación posterior, en vez de pasar sin más a acceso total. Controlar la información legible, las herramientas externas y los datos guardados por la aplicación requiere un diseño separado de prohibir ediciones del código.

Preguntas frecuentes

¿Pedir «Solo investiga» convierte al agente en solo lectura?

Comunica el objetivo, pero no cambia la capacidad real de edición ni los permisos de comandos. Además de la instrucción, usa el entorno aislado de Codex o Plan y las restricciones de herramientas de Claude Code, y comprueba qué limitan exactamente.

¿Plan de Claude Code garantiza que no cambie ningún archivo?

No. Normalmente bloquea la edición del código, pero crea archivos de planificación. La documentación oficial también indica que las restricciones de Plan no se imponen en sesiones de terminal interactiva donde se permite omitir controles. No prohíbe toda escritura en el PC.

¿La política de aprobación «never» de Codex significa acceso sin restricciones?

Significa que no se solicita aprobación; no desactiva el entorno aislado. Combinada con read-only, el agente investiga dentro de esas restricciones. Distingue esto de iniciar con acceso total.

¿Una investigación de solo lectura completa una revisión de seguridad?

No. Los posibles problemas encontrados al leer el código son distintos de los resultados reproducidos mediante ejecución. Las conclusiones siguen limitadas si no se pueden comprobar la configuración, el entorno de ejecución o los servicios dependientes. Informa de las pruebas y dudas, y planifica las demostraciones necesarias en otro entorno de verificación.

¿Ask for approval en la aplicación Codex impide editar?

No por sí solo. La política de aprobación y las restricciones de escritura son independientes. Revisa Configuration y los permisos activos, y usa restricciones equivalentes a read-only para investigar únicamente.

¿Si selecciono Plan una vez en Claude Desktop o VS Code, se aplicará la próxima vez?

Plan seleccionado en el selector solo se aplica a esa conversación o sesión. Comprueba el indicador cada vez. En VS Code puedes usar el ajuste de usuario claudeCode.initialPermissionMode para especificar el modo inicial.