Saltar al contenido principal
Blog
Volver al blog

Secretos en settings.local.json de Claude Code: comprobar, rotar y prevenir

Cuando Claude Code pide ejecutar un comando de shell y eliges "Yes, and don't ask again" ("Sí, y no volver a preguntar"), guarda ese comando exacto como regla de permiso en .claude/settings.local.json. Si el comando contenía una contraseña, un token o una cadena de conexión, el archivo ahora la guarda en texto plano. El 5 de noviembre de 2026, la empresa de seguridad Apiiro informó de 1.122 copias públicas de este archivo en GitHub que contenían un secreto real, y el responsable de Claude Code en Anthropic dijo que el equipo está estudiando soluciones. Si desarrollas con Claude Code y subes código a GitHub, esta guía te ofrece una comprobación de cinco minutos, el orden para rotar credenciales, cómo hacer limpieza, cómo mantener los secretos fuera de las aprobaciones y qué otros archivos de agentes revisar. Es útil sin una cuenta de Soloop y no es una auditoría de seguridad.

La respuesta breve

Cada comando de Bash que apruebas de forma permanente se guarda literalmente en .claude/settings.local.json, en la raíz del repositorio. Claude Code añade ese archivo a tu lista global de exclusiones de git la primera vez que lo escribe en un repositorio, lo que cubre el caso habitual en la máquina donde trabajas. No cubre un archivo que se confirmó antes de que se aplicara la exclusión, una carpeta que se convirtió en repositorio más tarde, un clon en otra máquina ni un archivo que alguien añadió a propósito, y la regla de exclusión nunca viaja con el repositorio.

Comprueba si el archivo está bajo seguimiento o aparece en tu historial de git. Si alguna vez contuvo un secreto que llegó a un remoto, rota primero el secreto; borrar el archivo no lo elimina del historial, de las bifurcaciones ni de los clones. Después deja de hacer seguimiento del archivo, añádelo al .gitignore del propio repositorio, elimina de tus copias locales las reglas que contengan secretos y deja de escribir secretos en los comandos.

Cómo acaba un secreto en el archivo

Pide a Claude Code que averigüe por qué falla un inicio de sesión en staging o que ejecute una migración, y es posible que el comando que proponga necesite una credencial de tus archivos de configuración, como una contraseña de base de datos después de PGPASSWORD= o un token bearer en una llamada con curl. Claude Code pregunta antes de ejecutar comandos de shell. Después de muchas solicitudes, es fácil aprobar una línea larga sin fijarse en el secreto que contiene. "Yes, and don't ask again" ejecuta el comando y lo guarda, secreto incluido, como regla de permiso para que no se te vuelva a preguntar.

Apiiro lo reprodujo con los modelos actuales de Anthropic, Opus 5.5 y Fable 5.1, y lo describe como un comportamiento de Claude Code y no del modelo. En 539 de los 1.105 repositorios con un secreto real que rastreó, un commit en el que Claude figuraba como coautor había modificado el archivo. Los usuarios de Claude Code han descrito este mecanismo en issues de GitHub desde agosto de 2025.

Dónde van las aprobaciones

Elegir "Yes, and don't ask again" para un comando de Bash guarda una regla de permiso en .claude/settings.local.json, que Claude Code mantiene en la raíz del repositorio. Claude Code añade **/.claude/settings.local.json a tu archivo global de exclusiones de git la primera vez que escribe el archivo en un repositorio; si creas el archivo a mano, tienes que excluirlo tú.

Documentación de Claude Code: Settings
Duración de la regla

Una aprobación "don't ask again" de Bash es permanente por repositorio y comando. /permissions enumera todas las reglas y el archivo de configuración del que procede cada una.

Documentación de Claude Code: Permissions
Escala

104.185 copias públicas en 103.617 repositorios; 1.122 (1,1 %) contienen un secreto real, 1.379 distintos; 2.539 secretos en 1.994 repositorios si se incluyen el historial, los archivos de configuración compartidos y las transcripciones de agentes. Un secreto real significa un formato de clave conocido o una contraseña junto a un host público, no una credencial probada.

Apiiro, 5 de noviembre de 2026

Qué se encontró

Más de un tercio de los secretos distintos dan acceso directo a una base de datos: 379 contraseñas de bases de datos y 122 claves service-role de Supabase, además de 103 tokens de cuenta de Supabase. El resto incluye claves de API y de modelos de IA, 43 inicios de sesión SSH, 42 tokens de GitHub, GitLab y npm, 23 claves de AWS y 6 claves privadas. La mayoría pertenecen a desarrolladores individuales; se vieron afectadas 63 organizaciones, desde grupos de estudiantes hasta startups y agencias.

Los archivos más grandes filtran más: uno de cada diez archivos de más de 8 KB contenía un secreto real, frente a menos de uno de cada 500 por debajo de 500 bytes. En el repositorio afectado mediano, el archivo llevaba 217 días público. Versiones anteriores contenían 734 secretos en 509 repositorios que ninguna copia actual muestra, normalmente porque el archivo se borró sin rotar lo que contenía.

¿settings.local.json o settings.json?

.claude/settings.json es el archivo compartido del proyecto: lo confirmas a propósito para que los colaboradores tengan los mismos permisos y hooks. .claude/settings.local.json es tuyo para un solo proyecto y nunca debería confirmarse. Ambos pueden contener reglas de permiso, así que mantén los secretos fuera de los dos; Apiiro encontró secretos reales en 298 de 76.011 archivos de configuración compartidos públicos.

Comprobación de cinco minutos

Ejecútalos desde la raíz de cada repositorio que hayas subido. Solo leen; no se cambia nada. Los comandos se probaron con git en macOS.

  1. ¿El archivo está bajo seguimiento ahora? git ls-files -- '*settings.local.json' muestra cualquier copia bajo seguimiento a cualquier profundidad. Si no hay salida, no hay ninguna bajo seguimiento.
  2. ¿Se confirmó alguna vez? git log --all --oneline -- '*settings.local.json' enumera cada commit que lo tocó, incluidos los que después lo borraron. Cualquier salida significa que el contenido está en el historial.
  3. ¿Llegó un secreto al historial? git log --all -p -- '*settings.local.json' | grep -nE 'PGPASSWORD=|sshpass -p|mysql .*-p[^ ]|[Bb]earer |://[^:/ ]+:[^@ ]+@' muestra líneas con una contraseña en un comando, una cabecera bearer o una contraseña en una cadena de conexión. Es un filtro aproximado: lee también tú mismo las reglas en busca de claves de API.
  4. ¿Qué lo excluye? git check-ignore -v .claude/settings.local.json indica el archivo y la línea que lo excluyen. Si apunta a tu archivo global de exclusiones y no al .gitignore del repositorio, la protección solo existe en esta máquina.
  5. ¿Qué contienen tus copias locales? find ~ -path '*/.claude/settings*.json' -not -path '*/node_modules/*' 2>/dev/null enumera todas las copias de tu ordenador. Abre cada una y lee su lista de permisos, o ejecuta /permissions dentro de Claude Code.
  6. En GitHub, busca settings.local.json en el código de tu cuenta u organización y revisa las bifurcaciones de los repositorios afectados.

Qué rotar primero

Considera expuesto todo lo que haya llegado a un remoto, aunque el repositorio sea privado ahora o el archivo ya no exista. Empieza por las credenciales que funcionan desde cualquier lugar contra un host público. Para cada una: emite una credencial nueva, actualiza los lugares que la usan, revoca la antigua y revisa los registros de acceso del proveedor en busca de usos que no reconozcas.

Orden para rotar las credenciales encontradas en settings.local.json
DimensiónPor qué va primeroQué hacer
Contraseñas de bases de datos y claves service-role de SupabaseAcceso directo de lectura y escritura a tus datos; la categoría más común que encontró Apiiro.Cambia la contraseña o renueva la clave, actualiza el entorno de tu app y después revisa las conexiones recientes.
Claves de la nube (AWS y similares)Pueden crear recursos y generar facturas, además de leer datos.Desactiva la clave, crea una nueva con el mínimo acceso que necesite y revisa la facturación y los registros de actividad.
Inicios de sesión SSH y claves privadasUn inicio de sesión en un servidor, a veces como root, en un host público.Cambia la contraseña o elimina la clave de authorized_keys, prefiere el inicio de sesión con clave y revisa los inicios de sesión recientes.
Tokens de GitHub, GitLab y npmPueden subir código o publicar paquetes en tu nombre.Revoca el token, crea uno más restringido y revisa los pushes y las versiones de paquetes recientes.
Claves de API y de modelos de IANormalmente, uso facturable y acceso a lo que contenga el servicio.Renueva la clave en el panel del proveedor y fija un límite de uso si el proveedor lo ofrece.

Limpia el repositorio y tu máquina

  1. Deja de hacer seguimiento del archivo sin borrar tu copia: git rm --cached .claude/settings.local.json y después haz commit.
  2. Añade **/.claude/settings.local.json al .gitignore del propio repositorio para que la regla viaje con cada clon y haz commit también de eso.
  3. Abre cada copia local y elimina todas las reglas que contengan un secreto, o quítalas en /permissions. Una regla aprobada una vez se mantiene hasta que alguien la elimina.
  4. Decide si reescribir el historial. Rotar es lo que hace inútil un secreto expuesto; reescribir el historial elimina los valores antiguos de tu repositorio, pero no de las bifurcaciones ni de los clones que ya existen.
  5. Revisa otras vías por las que el archivo puede salir sin git: un paquete de npm publicado, una imagen de Docker creada con una copia de toda la carpeta, un archivo zip o una carpeta sincronizada.

Evita la próxima fuga

La solución duradera es mantener los secretos fuera de los comandos que apruebas. Pon las credenciales en variables de entorno o en un gestor de secretos y haz referencia a ellas por su nombre, para que una regla guardada registre $DATABASE_URL en lugar de la contraseña. Envuelve las tareas rutinarias en un script y aprueba el script, o aprueba un patrón como Bash(npm run *), en lugar de aprobar un comando literal largo.

Ejemplo ilustrativo, no una credencial real. Antes: "Bash(PGPASSWORD=example-not-real psql -h db.example.com -U app -c \"select 1\")" se guarda con la contraseña dentro. Después: un script de paquete llamado db:check ejecuta psql "$DATABASE_URL" -c "select 1", la variable vive en tu .env sin seguimiento y la regla guardada es "Bash(npm run db:check)".

  • Añade **/.claude/settings.local.json al .gitignore de cada repositorio y a cualquier plantilla de proyecto que reutilices.
  • Añade reglas de denegación como Read(./.env) y Read(./.env.*) para que las herramientas de archivos de Claude Code no lean tus archivos de secretos.
  • Lee el comando completo antes de elegir "Yes, and don't ask again"; aprueba una sola vez cuando un comando contenga una credencial.
  • Instala un hook de pre-commit que rechace un settings.local.json preparado para commit (cópialo más abajo).
  • Mantén activado el escaneo de secretos que ofrezca tu plataforma de código; los repositorios públicos de GitHub se escanean automáticamente.
  • Usa un escáner en pre-commit o en CI que también detecte contraseñas dentro de comandos, no solo formatos de clave conocidos.

Copia el hook de pre-commit

Guárdalo como .git/hooks/pre-commit en cada repositorio y hazlo ejecutable. Bloquea cualquier commit que prepare el archivo, esté donde esté dentro del repositorio. Los hooks son locales de tu clon, así que la línea de .gitignore anterior sigue siendo necesaria.

Descargar Markdown

Revisa los otros archivos que escriben los agentes

El mismo hábito, un secreto escrito en un comando que después registra un agente, se filtra a través de otros archivos. Apiiro revisó estos archivos públicos en GitHub; trata las carpetas de agentes como .claude/, .cursor/, .gemini/ y .specstory/, y los archivos de memoria de los agentes, como portadores de secretos, igual que .env.

.claude/settings.json compartido

298 de 76.011 archivos contenían un secreto real, sobre todo en reglas de permiso como líneas de comando exactas.

Transcripciones de chat de agentes

120 archivos en 87 repositorios, de exportaciones de .specstory, aider y Cursor (2.523 revisados).

Archivos de memoria de agentes

9 repositorios, en archivos como MEMORY.md (1.200 revisados).

Notas de traspaso y despliegue

33 archivos (2.095 revisados); un tercio de los que tenían un secreto los había escrito el agente.

Qué ha dicho Anthropic

El 7 de noviembre de 2026, Boris Cherny, responsable de Claude Code en Anthropic, respondió en Hacker News que históricamente Claude Code no ha eliminado secretos, pero que el equipo está estudiando cómo prevenirlo, y mencionó como opciones para prototipar que el auto mode detecte esto y un escaneo de secretos básico integrado. Según el resumen de Apiiro, también dijo que Claude Code añade el archivo a gitignore cuando lo crea, por lo que cree que las copias expuestas se crearon a mano y se confirmaron, y recomendó el escaneo de secretos que ofrecen las plataformas de código.

A 10 de noviembre de 2026 no habíamos visto ninguna corrección publicada. Hasta que se publique una y hayas actualizado, da por hecho que el comportamiento descrito aquí sigue aplicándose.

Copia la lista de comprobación

Usa una copia por repositorio. Anota lo que encontraste y lo que rotaste para poder responder más adelante a un cliente o colaborador que pregunte.

Dónde encaja Soloop

Soloop no escanea repositorios en busca de secretos, no lee tu configuración de Claude Code ni rota credenciales. Para eso, usa los comandos anteriores, el escaneo de secretos de tu plataforma de código y los paneles de tus proveedores.

Soloop sirve para lo que viene después de construir: según el manual de Soloop, puede investigar un mercado con fuentes, escribir y publicar publicaciones y respuestas en X a través de una cuenta conectada, enviar mensajes de contacto a través de una cuenta de Gmail conectada y preparar campañas de búsqueda de Google Ads después de la configuración y el pago; por defecto, las acciones esperan tu aprobación. No pegues secretos en la petición de ninguna herramienta de IA, tampoco en la de Soloop.

Fuentes, limitaciones y actualización

La documentación de Settings y Permissions de Claude Code y el informe de Apiiro se leyeron el 10 de noviembre de 2026. Las cifras de Apiiro proceden de búsquedas de solo lectura en GitHub del 1 al 3 de noviembre de 2026; no comprobó si alguna credencial funcionaba. La respuesta de Anthropic se cita a partir del resumen que hizo Apiiro del hilo de Hacker News. Los comandos, el orden de rotación, el ejemplo y el hook son orientación editorial probada en un repositorio de muestra, no una auditoría de seguridad ni una declaración de Anthropic.

Esta guía se revisará antes del 10 de febrero de 2027, o antes si Claude Code incorpora escaneo de secretos o cambia dónde se guardan las aprobaciones.

Escaneo de secretos en GitHub

Los repositorios públicos se escanean en busca de secretos automáticamente y sin coste; los secretos que coinciden con el formato de un socio se notifican a ese proveedor.

GitHub Docs: About secret scanning
Capacidad del producto

El manual de Soloop describe investigación con fuentes, publicación en X a través de una cuenta conectada, mensajes de contacto por Gmail y campañas de búsqueda de Google Ads después de la configuración y el pago; por defecto, primero se pide la aprobación. No escanea repositorios.

Manual de producto de Soloop