Claude Code puede trabajar sobre un repositorio: inspeccionar archivos, editarlos y ejecutar comandos disponibles en el entorno. Eso amplía lo que puede hacer una herramienta de asistencia, pero no convierte sus cambios en correctos por defecto.
La documentación de Anthropic describe un ciclo que reúne contexto, toma acciones y verifica resultados. Esas fases pueden repetirse mientras Claude investiga el proyecto, modifica archivos y ejecuta comprobaciones. Son capacidades de la herramienta, no una garantía de que encuentre todo el contexto necesario o resuelva bien cada tarea (cómo funciona Claude Code).
Qué contexto recibe: CLAUDE.md e instrucciones del proyecto
CLAUDE.md permite dejar instrucciones persistentes para Claude Code: convenciones, decisiones de arquitectura o comandos propios del proyecto. Según Anthropic, puede ubicarse en la raíz del proyecto, dentro de .claude/ o en directorios superiores, con distintos alcances. Los archivos de instrucciones en subdirectorios pueden cargarse cuando Claude trabaja con archivos de esas áreas (memoria e instrucciones de proyecto).
Estas instrucciones se incorporan como contexto; no son controles técnicos que obliguen al modelo a obedecer. Anthropic recomienda que sean concretas, breves y coherentes: las instrucciones vagas o contradictorias pueden seguirse de forma inconsistente. Los permisos y las reglas de acceso se configuran por otros mecanismos (límites de CLAUDE.md, permisos).
Claude Code también documenta la lectura de AGENTS.md, pero no conviene asumir que siempre lo cargará. En la configuración predeterminada descrita por Anthropic, lo lee cuando no encuentra un CLAUDE.md o CLAUDE.local.md en el directorio de trabajo ni en sus directorios superiores. La lectura directa requiere una versión compatible y las preferencias del proyecto pueden cambiar qué archivos se cargan. Por tanto, AGENTS.md y CLAUDE.md no son formatos intercambiables por definición: hay que considerar la configuración y la versión en uso (compatibilidad con AGENTS.md).
Permisos y aprobación de acciones
Que Claude Code pueda leer archivos, editarlos o ejecutar comandos no significa que todas esas acciones estén permitidas sin aprobación. El comportamiento depende del modo de permisos, las reglas configuradas, la interfaz y otros aspectos del entorno. En el modo predeterminado, por ejemplo, muchas acciones de escritura y ejecución requieren aprobación; otros modos pueden permitir algunas acciones sin preguntar. La documentación detalla esas diferencias y sus excepciones (permisos, modos de permiso).
El modo Auto reduce los avisos mediante un clasificador que revisa acciones, pero Anthropic advierte que no garantiza seguridad. El modo que omite permisos, por su parte, está pensado para entornos aislados como contenedores o máquinas virtuales, no como una recomendación general. La configuración concreta determina qué controles se aplican; las instrucciones escritas en CLAUDE.md no los sustituyen (modos de permiso y sus límites, seguridad).
Revisar los cambios y comprobar los resultados
Una respuesta que dice «listo» no demuestra que el cambio funcione. Conviene revisar el diff y comprobar que los archivos modificados corresponden al alcance acordado. Después, hay que elegir verificaciones apropiadas para el proyecto —por ejemplo, pruebas o análisis disponibles— y leer sus salidas.
Hay una diferencia entre que Claude afirme haber ejecutado una comprobación, observar la salida de un comando y confirmar que el comportamiento esperado se cumple. Una salida satisfactoria aporta evidencia sobre esa comprobación concreta; no demuestra por sí sola que se hayan cubierto todos los requisitos. Anthropic recomienda definir verificaciones y examinar evidencia, en lugar de tomar la apariencia de estar terminado como señal suficiente (buenas prácticas).
Claude Code también tiene checkpoints para recuperar ciertos cambios de archivos hechos durante una sesión. Anthropic aclara que no son un reemplazo de Git: cubren cambios realizados mediante las herramientas de edición de archivos, no necesariamente los efectos de comandos de shell o procesos externos (funcionamiento y checkpoints).
Un flujo de trabajo recomendado
Como recomendación editorial derivada de la documentación —no como una prueba práctica ni un procedimiento obligatorio de Anthropic—, un flujo acotado podría ser:
- Delimitar el objetivo, el alcance y lo que no debe cambiar.
- Revisar las instrucciones del proyecto y qué contexto está disponible.
- Examinar la propuesta y el diff antes de dar por aceptados los cambios.
- Elegir las comprobaciones pertinentes y revisar sus resultados.
- Anotar qué quedó confirmado y qué sigue pendiente.
El nivel de supervisión durante esos pasos depende de los permisos configurados. Revisar el trabajo, en cambio, sigue siendo necesario para decidir si satisface lo que el proyecto requiere.
Qué no conviene asumir
La presencia de instrucciones no garantiza que se sigan; las capacidades disponibles no garantizan que el resultado sea correcto; y la aprobación de una acción no equivale a validar sus efectos. Conviene comprobar qué contexto y permisos aplican en cada entorno, y evaluar los cambios con evidencia.
Para el marco general de delegar trabajo a un agente y revisar cambios, consulta el artículo sobre Codex CLI. Para las diferencias conceptuales entre agente, herramientas, skills y harness, está el artículo sobre esas capas. Aquí el foco es cómo la documentación de Anthropic describe el contexto, las instrucciones y los controles de Claude Code en un repositorio.