Seguridad en Claude Code: 1.122 de 104.185 archivos settings.local.json públicos guardaban un secreto. Revisa los tuyos y pregunta a tu proveedor
Servicio relacionado: App hecha con IA a producción
La seguridad de Claude Code tiene un punto nuevo en la lista: un archivo de configuración. Cuando respondes «Yes, and don't ask again» a un comando de shell, Claude Code guarda ese comando como regla de permiso en .claude/settings.local.json. Si el comando llevaba una contraseña, ahora también la lleva el archivo. El 5 de noviembre, Apiiro publicó que 1.122 de las 104.185 copias públicas de ese archivo en GitHub contenían un secreto real: más o menos una de cada 93.
El archivo está pensado para quedarse en tu equipo, y Claude Code hace lo posible para que así sea. Yo me dedico a DevOps; los ingenieros de Conectia trabajan dentro de los repositorios de los clientes con Conect AI Dev, nuestra plataforma interna de ingeniería, y con agentes de programación como Claude Code; y llevar a producción apps hechas con IA es un servicio que vendemos. Lee lo que sigue sabiendo desde qué lado de la mesa escribo. Lo que sostengo es que la configuración del agente de programación de tu proveedor forma parte de tu superficie de ataque, y que revisar la tuya lleva unos diez minutos.
La respuesta corta. ¿Hay que versionar
.claude? Versiona.claude/settings.json(los permisos compartidos, los hooks y las variables de entorno que necesita el proyecto) y.mcp.json, los dos revisados como código y con referencias${VAR}en lugar de valores. No versiones nunca.claude/settings.local.json: añádelo al.gitignorey al.dockerignoredel propio repositorio, no solo a los de tu equipo. Si el archivo llegó a subirse alguna vez, rota todas las credenciales que contuvo antes de plantearte reescribir el historial.
Un clic en «don't ask again» guarda el comando, secreto incluido
Bastan cuatro pasos normales para que una contraseña acabe en el archivo:
- Le preguntas al agente por qué falla el login en staging. El comando que propone necesita la contraseña de la base de datos, así que la lleva dentro:
PGPASSWORD=… psql -h …. - Claude Code pide permiso antes de ejecutarlo y eliges «Yes, and don't ask again».
- Claude Code escribe el propio texto del comando como regla
allowen.claude/settings.local.json, en la raíz del repositorio (documentación de settings). - La primera vez que escribe ese archivo en un repositorio git que todavía no lo ignora, añade
**/.claude/settings.local.jsona tu archivo global de exclusiones de git.
El cuarto paso protege tu equipo. No protege un clon en el que Claude Code nunca escribió el archivo, ni una carpeta que se convirtió en repositorio después, ni una copia que alguien ya había subido, porque las reglas de ignore no afectan a los archivos que git ya rastrea. Tampoco protege una imagen de Docker: GitGuardian encontró 613 secretos distintos de estos archivos en imágenes públicas de Docker Hub, porque COPY . . copia el directorio de trabajo, no el índice de git.
Los investigadores de Apiiro, Shmulik Cohen y Matan Giladi, recogieron los datos entre el 1 y el 3 de noviembre y contaron 1.379 secretos distintos en esos 1.122 archivos: contraseñas de bases de datos, claves de nube, tokens de API y accesos SSH, y más de un tercio abre directamente una base de datos. Si se suman el historial del archivo, el settings.json compartido y las transcripciones de agentes subidas a los repositorios, el total llega a 2.539 secretos distintos en 1.994 repositorios. GitGuardian publicó su propio recuento el 9 de noviembre, a partir de todos los push públicos desde enero de 2025: 31.088 secretos distintos en settings.local.json repartidos en 23.276 repositorios, 5.343 de ellos válidos en el momento de detectarlos.
Uno de cada 93 es poco, y es el número sobre el que conviene actuar
El dato se lee en los dos sentidos. El 98,9 % de los archivos públicos que leyó Apiiro no contenía ningún secreto. La proporción sube con el uso: uno de cada diez archivos de más de 8 KB tenía alguno, frente a menos de uno de cada 500 entre los de menos de 500 bytes. La exposición se acumula aprobación tras aprobación, así que hay tanto un hábito que cambiar como un valor por defecto que corregir.
Los números vienen con cuatro límites. Apiiro no probó las credenciales, de modo que su estudio demuestra exposición y no intrusión; las comprobaciones de solo lectura de GitGuardian encontraron que el 17 % de sus secretos funcionaba. Los dos recuentos se limitan a repositorios públicos, aunque el archivo también está en el equipo de cada persona que aprobó un comando. Las dos empresas venden productos de seguridad, así que se trata de investigación de proveedor. Y la propia curva de GitGuardian matiza la alarma: las apariciones mensuales tocaron techo en abril de 2026, con 12.535, y bajaron a 959 en octubre, una caída del 92 % que la empresa todavía no sabe explicar.
Anthropic merece el reconocimiento que se gana su valor por defecto: la exclusión global cubre el caso habitual y la documentación explica para qué sirve el archivo. El 7 de noviembre, Boris Cherny, responsable de Claude Code, respondió en Hacker News: «Históricamente, Claude Code no ha hecho limpieza de secretos (hay muchas herramientas buenas para eso), pero estamos estudiando qué podemos hacer para evitarlo». Su lectura fue que los archivos expuestos se habían creado a mano; GitGuardian respondió que, en las unas 3.000 apariciones que revisó, todos los secretos estaban en una regla allow con la forma exacta que escribe el aviso de permiso. Un valor por defecto que vive en un solo equipo protege un solo equipo.
settings.json y settings.local.json son archivos distintos con funciones distintas
La documentación describe cuatro ámbitos, y la diferencia entre ellos responde a la pregunta de qué se versiona:
~/.claude/settings.jsones tuyo y se aplica en todos los proyectos de tu equipo..claude/settings.jsones el archivo compartido del proyecto. La documentación indica que se versione para que todo el equipo tenga los mismos permisos, hooks, plugins y variables de entorno. Los hooks ejecutan comandos automáticamente durante el ciclo de vida del agente, así que sus cambios se revisan como los de un pipeline de CI. GitGuardian contó 8.271 secretos distintos en este archivo, y en la extensión de VS Code la tarjeta de aprobación permite guardar una regla aquí, para todo el equipo..claude/settings.local.jsones personal, de un solo proyecto, y es donde se acumulan tus aprobaciones.- La configuración gestionada (managed settings) contiene la política de seguridad de la organización y tiene prioridad sobre los demás archivos, con algunas excepciones documentadas.
Hay dos archivos más que entran en la misma revisión. .mcp.json define los servidores MCP del proyecto, está pensado para versionarse y admite la expansión ${VAR}, de modo que un archivo compartido puede hacer referencia a una clave de API sin contenerla (documentación de MCP). Y en CLAUDE.md GitGuardian contó 6.155 secretos distintos, porque hay quien pega cadenas de conexión en las instrucciones que le da al agente.
En sus propios repositorios, Conectia deja toda la carpeta .claude/ fuera del control de versiones, porque contiene herramientas internas que no forman parte de ningún producto. A la mayoría de los equipos, en cambio, les conviene versionar el settings.json compartido.
La revisión de diez minutos en tus propios repositorios
Ejecuta estos comandos desde la raíz de cada repositorio que sea tuyo; solo leen tu árbol de trabajo, tu historial y tu equipo.
-
¿Qué archivos de agentes rastrea git hoy? El archivo local no debería aparecer en la lista.
git ls-files | grep -E '(^|/)\.(claude|cursor|gemini|codex)/|(^|/)\.mcp\.json$' -
¿Se subió alguna vez el archivo local, en cualquier rama? Si sale alguna línea, todos los valores que contuvo están en cada clon.
git log --all --format='%h %ad %an %s' --date=short -- ':(glob)**/.claude/settings.local.json' -
¿Quién lo ignora, el repositorio o solo tú? Si la regla que aparece viene de tu archivo global de exclusiones, el clon de un compañero no tiene ninguna protección; si no aparece nada, no lo ignora nadie.
git check-ignore -v --no-index .claude/settings.local.json -
¿Qué contienen tus copias locales? Este comando solo muestra nombres de archivo. Abre cada uno, borra las reglas que contengan un secreto (o usa
/permissions) y no pegues el contenido en ningún sitio.find ~ -path '*/.claude/settings*.json' -not -path '*/node_modules/*' 2>/dev/null \ | xargs grep -l -E -i 'PASSWORD=|sshpass|bearer|token|secret|api[_-]?key|://[^/ ]+:[^@ ]+@|mysql .*-p' -
¿Tu build de imágenes copia la carpeta? Con
COPY . .y sin una línea.claudeen.dockerignore, el archivo viaja en la imagen.grep -n '\.claude' .dockerignore -
¿Tu escáner ve una contraseña dentro de un comando? Apiiro pasó gitleaks y TruffleHog por los 104.185 archivos: de los 1.122 con un secreto real, gitleaks marcó 564, TruffleHog 643, y 215 no los detectó ninguno de los dos. Una contraseña después de
PGPASSWORD=no tiene ningún formato de clave que reconocer. Escanea las carpetas de agentes y el historial en pre-commit y en CI, y activa el escaneo de secretos de tu plataforma de código. -
Deja de escribir secretos en los comandos. Usa
$DATABASE_URLdesde el entorno o un gestor de secretos, para que la regla guardada registre el nombre y no el valor; unPGPASSWORD=valorescrito en línea sigue dejando el valor en el texto. Aprueba prefijos acotados, noBash(curl *).
Si los pasos 1 a 3 han encontrado algo, la parte del repositorio se arregla con tres líneas:
git rm --cached .claude/settings.local.json
printf '%s\n' '**/.claude/settings.local.json' >> .gitignore
printf '%s\n' '**/.claude/' >> .dockerignore
Si un secreto pasó por el archivo, rótalo antes de tocar el historial
Borrar el archivo no arregla nada de lo que ya salió: Apiiro encontró 734 secretos reales que solo sobreviven en versiones anteriores del archivo. La guía de GitHub pone la revocación en primer lugar, porque un secreto rotado ya no abre nada, y advierte del riesgo de recontaminación después de reescribir el historial: basta con que un compañero con un clon antiguo haga git pull y git push para que los datos vuelvan. Los forks y las imágenes publicadas conservan sus copias aunque reescribas lo que quieras.
El orden, por tanto, es rotar, dejar de rastrear e ignorar, y después decidir si la reescritura compensa.
Esto ya lo vivimos con .env, y se resolvió cuando la línea de ignore pasó a la plantilla. La plantilla de .gitignore para Node.js del propio GitHub ignora .env y .env.*, y hoy no tiene ninguna línea para .claude. Añádela a las plantillas de tu organización y cada repositorio nuevo la heredará.
Una extensión con puerta trasera muestra la misma superficie una capa más abajo
El propio agente llega a través de una cadena de suministro. El 30 de octubre, Phorion publicó un análisis de una versión con puerta trasera de la extensión Claude Code for VS Code en el Cursor Marketplace, las versiones 2.1.312 y 2.1.313, que intentaba instalar una puerta trasera SSH persistente y enviaba datos del equipo. El aviso de Cursor indica que esas versiones no las desarrolló Anthropic y que estuvieron disponibles unas once horas el 29 de octubre. Qué marketplace, qué versión, quién la instaló: es la cadena de suministro de herramientas de la que escribí en julio, ahora en los equipos de los desarrolladores.
Qué exigir a un proveedor cuyos ingenieros usan agentes en tu código
El conflicto de intereses lo declaro yo: Conectia es uno de esos proveedores, y esta lista nos la puedes pasar a nosotros. Dicho llanamente, el contrato o su anexo de seguridad debería recoger esto:
- Los archivos personales de los agentes nunca entran en tus repositorios.
settings.local.json, las transcripciones y los archivos de memoria se ignoran en el propio repositorio. - Nadie escribe una credencial en el prompt ni en un comando del agente. Los secretos salen del entorno o de un gestor de secretos que controlas tú.
- La configuración compartida de los agentes se revisa como código. Los cambios en
.claude/settings.json,.mcp.json,CLAUDE.mdo los hooks pasan por tu revisión habitual y no llevan valores secretos. - Los agentes trabajan con el mínimo privilegio. Ninguna aprobación permanente para credenciales de producción y ningún agente con permiso de escritura en producción.
- El escaneo de secretos cubre las carpetas de agentes y el historial, en pre-commit y en CI, incluidas las contraseñas dentro de comandos.
- El proveedor declara sus agentes: qué herramientas, extensiones y versiones tocan tu código, de qué fuente salen, y te avisa en 24 horas si se conoce un compromiso de alguna.
- Toda exposición se notifica y se limpia: aviso en 24 horas si aparece una credencial tuya en un archivo de agente y, al terminar el trabajo, borrado de los archivos locales de agentes con datos tuyos, confirmado por escrito.
La parte de confidencialidad, desde la cláusula que prohíbe entrenar modelos hasta la devolución de las copias, va en el acuerdo que firmas antes de que nadie lea el código, y la expliqué en qué debe decir el NDA antes de enseñar tu código a un proveedor. Rotar todas las claves que pudo ver alguien de fuera es también lo primero de la lista de arreglos de cualquier MVP hecho con IA.
El agente recordó lo que le pediste que recordara
En esta historia no atacó nadie, y aun así se filtraron secretos a través de los archivos de un agente de programación. Un ingeniero aprobó un comando razonable, la herramienta cumplió su promesa de no volver a preguntar y el registro de esa aprobación se convirtió en una segunda copia de la contraseña. Los agentes de programación hacen más rápidos a los buenos ingenieros, y además lo apuntan todo; lo que apuntan es configuración que te pertenece. Si quieres que alguien revise contigo lo que han ido apuntando los agentes de tus repositorios, habla con un CTO.
Fuentes:
- Apiiro, Shmulik Cohen y Matan Giladi. Coding Agents Are Leaking Your Secrets to GitHub (5 de noviembre de 2026, actualizado el 8 de noviembre). apiiro.com
- GitGuardian, Guillaume Valadon. Claude Code settings.local.json Secrets: GitHub, Docker Hub (9 de noviembre de 2026). blog.gitguardian.com
- iTWire, David M Williams. Claude Code approval files found exposing company secrets on GitHub (7 de noviembre de 2026). itwire.com
- CSO Online, Shweta Sharma. Claude Code's 'don't ask again' button has a secrets-spilling problem (11 de noviembre de 2026). csoonline.com
- Boris Cherny en Hacker News (7 de noviembre de 2026). news.ycombinator.com
- Anthropic. Documentación de Claude Code: settings, permisos, MCP.
- Phorion. Official Claude Code Extension Compromise: Security Advisory (30 de octubre de 2026). phorion.io
- Cursor. Security notice: malicious version of Anthropic.claude-code (2.1.312 and 2.1.313) (29 de octubre de 2026). cursor.com
- GitHub Docs. Removing sensitive data from a repository. docs.github.com



