Seguretat a Claude Code: 1.122 de 104.185 fitxers settings.local.json públics guardaven un secret. Revisa els teus i pregunta al teu proveïdor
Servei relacionat: App feta amb IA a producció
La seguretat de Claude Code té un punt nou a la llista: un fitxer de configuració. Quan respons «Yes, and don't ask again» a una ordre de shell, Claude Code desa aquella ordre com a regla de permís a .claude/settings.local.json. Si l'ordre duia una contrasenya, ara també la duu el fitxer. El 5 de novembre, Apiiro va publicar que 1.122 de les 104.185 còpies públiques d'aquest fitxer a GitHub contenien un secret real: més o menys una de cada 93.
El fitxer està pensat per quedar-se al teu ordinador, i Claude Code fa el que pot perquè hi quedi. Jo em dedico al DevOps; els enginyers de Conectia treballen dins dels repositoris dels clients amb Conect AI Dev, la nostra plataforma interna d'enginyeria, i amb agents de programació com Claude Code; i portar a producció apps fetes amb IA és un servei que venem. Llegeix el que ve a continuació sabent des de quin costat de la taula escric. El que defenso és que la configuració de l'agent de programació del teu proveïdor forma part de la teva superfície d'atac, i que revisar la teva costa uns deu minuts.
La resposta curta. Cal versionar
.claude? Versiona.claude/settings.json(els permisos compartits, els hooks i les variables d'entorn que necessita el projecte) i.mcp.json, tots dos revisats com si fossin codi i amb referències${VAR}en lloc de valors. No versionis mai.claude/settings.local.json: afegeix-lo al.gitignorei al.dockerignoredel mateix repositori, no només als del teu ordinador. Si el fitxer s'ha arribat a pujar mai, rota totes les credencials que hi hagi hagut abans de plantejar-te reescriure l'historial.
Un clic a «don't ask again» desa l'ordre, amb el secret inclòs
N'hi ha prou amb quatre passos normals perquè una contrasenya acabi al fitxer:
- Preguntes a l'agent per què falla el login a staging. L'ordre que proposa necessita la contrasenya de la base de dades, i per tant la porta a dins:
PGPASSWORD=… psql -h …. - Claude Code demana permís abans d'executar-la i tries «Yes, and don't ask again».
- Claude Code escriu el text de l'ordre tal qual com a regla
allowa.claude/settings.local.json, a l'arrel del repositori (documentació de settings). - La primera vegada que escriu aquest fitxer en un repositori git que encara no l'ignora, afegeix
**/.claude/settings.local.jsonal teu fitxer global d'exclusions de git.
El quart pas protegeix el teu ordinador. No protegeix un clon on Claude Code no ha escrit mai el fitxer, ni una carpeta que es va convertir en repositori més tard, ni una còpia que algú ja havia pujat, perquè les regles d'ignore no afecten els fitxers que git ja segueix. Tampoc no protegeix una imatge de Docker: GitGuardian va trobar 613 secrets diferents d'aquests fitxers en imatges públiques de Docker Hub, perquè COPY . . copia el directori de treball i no l'índex de git.
Els investigadors d'Apiiro, Shmulik Cohen i Matan Giladi, van recollir les dades entre l'1 i el 3 de novembre i van comptar 1.379 secrets diferents en aquells 1.122 fitxers: contrasenyes de bases de dades, claus de núvol, tokens d'API i accessos SSH, i més d'un terç obren directament una base de dades. Si s'hi sumen l'historial del fitxer, el settings.json compartit i les transcripcions d'agents pujades als repositoris, el total arriba a 2.539 secrets diferents en 1.994 repositoris. GitGuardian va publicar el seu propi recompte el 9 de novembre, a partir de tots els push públics des del gener del 2025: 31.088 secrets diferents a settings.local.json repartits en 23.276 repositoris, 5.343 dels quals eren vàlids quan els van detectar.
Un de cada 93 és poc, i és el número sobre el qual val la pena actuar
La xifra es llegeix en els dos sentits. El 98,9 % dels fitxers públics que va llegir Apiiro no contenia cap secret. La proporció puja amb l'ús: un de cada deu fitxers de més de 8 KB en tenia algun, davant de menys d'un de cada 500 entre els de menys de 500 bytes. L'exposició s'acumula aprovació rere aprovació, i per això hi ha tant un hàbit per canviar com un valor per defecte per corregir.
Els números porten quatre límits. Apiiro no va provar les credencials, de manera que el seu estudi demostra exposició i no intrusió; les comprovacions de només lectura de GitGuardian van trobar que el 17 % dels seus secrets funcionava. Tots dos recomptes es limiten a repositoris públics, tot i que el fitxer també és a l'ordinador de cada persona que ha aprovat una ordre. Totes dues empreses venen productes de seguretat, de manera que és recerca de proveïdor. I la mateixa corba de GitGuardian matisa l'alarma: les aparicions mensuals van tocar sostre a l'abril del 2026, amb 12.535, i van baixar a 959 a l'octubre, una caiguda del 92 % que l'empresa encara no sap explicar.
Anthropic es mereix el reconeixement que es guanya el seu valor per defecte: l'exclusió global cobreix el cas habitual i la documentació explica per a què serveix el fitxer. El 7 de novembre, Boris Cherny, responsable de Claude Code, va respondre a Hacker News: «Històricament, Claude Code no ha fet neteja de secrets (hi ha moltes eines bones per fer-ho), però estem estudiant què podem fer per evitar-ho». La seva lectura va ser que els fitxers exposats s'havien creat a mà; GitGuardian va respondre que, en les 3.000 aparicions aproximades que va revisar, tots els secrets eren en una regla allow amb la forma exacta que escriu l'avís de permís. Un valor per defecte que viu en un sol ordinador protegeix un sol ordinador.
settings.json i settings.local.json són fitxers diferents amb funcions diferents
La documentació descriu quatre àmbits, i la diferència entre ells respon la pregunta de què es versiona:
~/.claude/settings.jsonés teu i s'aplica a tots els projectes de l'ordinador..claude/settings.jsonés el fitxer compartit del projecte. La documentació diu que s'ha de versionar perquè tot l'equip tingui els mateixos permisos, hooks, plugins i variables d'entorn. Els hooks executen ordres automàticament durant el cicle de vida de l'agent, així que els seus canvis es revisen com els d'un pipeline de CI. GitGuardian hi va comptar 8.271 secrets diferents, i a l'extensió de VS Code la targeta d'aprovació permet desar-hi una regla, per a tot l'equip..claude/settings.local.jsonés personal, d'un sol projecte, i és on s'acumulen les teves aprovacions.- La configuració gestionada (managed settings) conté la política de seguretat de l'organització i té prioritat sobre la resta de fitxers, amb algunes excepcions documentades.
Dos fitxers més entren en la mateixa revisió. .mcp.json defineix els servidors MCP del projecte, està pensat per versionar-se i admet l'expansió ${VAR}, de manera que un fitxer compartit pot fer referència a una clau d'API sense contenir-la (documentació de MCP). I a CLAUDE.md GitGuardian hi va comptar 6.155 secrets diferents, perquè hi ha qui enganxa cadenes de connexió a les instruccions que dona a l'agent.
Als seus propis repositoris, Conectia deixa tota la carpeta .claude/ fora del control de versions, perquè conté eines internes que no formen part de cap producte. A la majoria d'equips, en canvi, els convé versionar el settings.json compartit.
La revisió de deu minuts als teus propis repositoris
Executa aquestes ordres des de l'arrel de cada repositori que sigui teu; només llegeixen el teu arbre de treball, el teu historial i el teu ordinador.
-
Quins fitxers d'agents segueix git avui? El fitxer local no hauria de sortir a la llista.
git ls-files | grep -E '(^|/)\.(claude|cursor|gemini|codex)/|(^|/)\.mcp\.json$' -
S'ha pujat mai el fitxer local, en qualsevol branca? Si surt alguna línia, tots els valors que ha contingut són a cada clon.
git log --all --format='%h %ad %an %s' --date=short -- ':(glob)**/.claude/settings.local.json' -
Qui l'ignora, el repositori o només tu? Si la regla que surt ve del teu fitxer global d'exclusions, el clon d'un company no té cap protecció; si no surt res, no l'ignora ningú.
git check-ignore -v --no-index .claude/settings.local.json -
Què contenen les teves còpies locals? Aquesta ordre només mostra noms de fitxer. Obre'ls un per un, esborra les regles que continguin un secret (o fes servir
/permissions) i no n'enganxis el contingut enlloc.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' -
El build de les imatges copia la carpeta? Amb
COPY . .i sense cap línia.claudeal.dockerignore, el fitxer viatja dins la imatge.grep -n '\.claude' .dockerignore -
El teu escàner veu una contrasenya dins d'una ordre? Apiiro va passar gitleaks i TruffleHog pels 104.185 fitxers: dels 1.122 amb un secret real, gitleaks en va marcar 564, TruffleHog 643, i 215 no els va detectar cap dels dos. Una contrasenya després de
PGPASSWORD=no té cap format de clau que es pugui reconèixer. Escaneja les carpetes d'agents i l'historial al pre-commit i a la CI, i activa l'escaneig de secrets de la teva plataforma de codi. -
Deixa d'escriure secrets a les ordres. Fes servir
$DATABASE_URLdes de l'entorn o d'un gestor de secrets, perquè la regla desada registri el nom i no el valor; unPGPASSWORD=valorescrit en línia continua deixant el valor al text. Aprova prefixos acotats, noBash(curl *).
Si els passos 1 a 3 han trobat alguna cosa, la part del repositori s'arregla amb tres línies:
git rm --cached .claude/settings.local.json
printf '%s\n' '**/.claude/settings.local.json' >> .gitignore
printf '%s\n' '**/.claude/' >> .dockerignore
Si un secret ha passat pel fitxer, rota'l abans de tocar l'historial
Esborrar el fitxer no arregla res del que ja ha sortit: Apiiro va trobar 734 secrets reals que només sobreviuen en versions anteriors del fitxer. La guia de GitHub posa la revocació en primer lloc, perquè un secret rotat ja no obre res, i avisa del risc de recontaminació després de reescriure l'historial: n'hi ha prou que un company amb un clon antic faci git pull i git push perquè les dades tornin. Els forks i les imatges publicades conserven les seves còpies, reescriguis el que reescriguis.
L'ordre, doncs, és rotar, deixar de seguir el fitxer i ignorar-lo, i després decidir si la reescriptura val la pena.
Això ja ho vam viure amb .env, i es va resoldre quan la línia d'ignore va passar a la plantilla. La plantilla de .gitignore per a Node.js del mateix GitHub ignora .env i .env.*, i avui no té cap línia per a .claude. Afegeix-la a les plantilles de la teva organització i cada repositori nou l'heretarà.
Una extensió amb porta del darrere mostra la mateixa superfície una capa més avall
L'agent mateix arriba per una cadena de subministrament. El 30 d'octubre, Phorion va publicar una anàlisi d'una versió amb porta del darrere de l'extensió Claude Code for VS Code al Cursor Marketplace, les versions 2.1.312 i 2.1.313, que intentava instal·lar una porta del darrere SSH persistent i enviava dades de l'ordinador. L'avís de Cursor diu que aquestes versions no les va desenvolupar Anthropic i que van estar disponibles unes onze hores el 29 d'octubre. Quin marketplace, quina versió, qui la va instal·lar: és la cadena de subministrament d'eines de què vaig escriure al juliol, ara als ordinadors dels desenvolupadors.
Què cal exigir a un proveïdor amb enginyers que fan servir agents al teu codi
El conflicte d'interessos l'he de declarar jo: Conectia és un d'aquests proveïdors, i aquesta llista ens la pots passar a nosaltres. Dit planerament, el contracte o el seu annex de seguretat hauria de recollir això:
- Els fitxers personals dels agents no entren mai als teus repositoris.
settings.local.json, les transcripcions i els fitxers de memòria s'ignoren al mateix repositori. - Ningú no escriu una credencial al prompt ni a una ordre de l'agent. Els secrets surten de l'entorn o d'un gestor de secrets que controles tu.
- La configuració compartida dels agents es revisa com si fos codi. Els canvis a
.claude/settings.json,.mcp.json,CLAUDE.mdo als hooks passen per la teva revisió habitual i no porten valors secrets. - Els agents treballen amb el privilegi mínim. Cap aprovació permanent per a credencials de producció i cap agent amb permís d'escriptura a producció.
- L'escaneig de secrets cobreix les carpetes d'agents i l'historial, al pre-commit i a la CI, incloses les contrasenyes dins de les ordres.
- El proveïdor declara els seus agents: quines eines, extensions i versions toquen el teu codi, de quina font surten, i t'avisa en 24 hores si se'n coneix cap compromís.
- Qualsevol exposició es notifica i es neteja: avís en 24 hores si apareix una credencial teva en un fitxer d'agent i, en acabar la feina, esborrat dels fitxers locals d'agents amb dades teves, confirmat per escrit.
La part de confidencialitat, des de la clàusula que prohibeix entrenar models fins a la devolució de les còpies, va a l'acord que signes abans que ningú llegeixi el codi, i la vaig explicar a què ha de dir l'NDA abans d'ensenyar el codi a un proveïdor. Rotar totes les claus que hagi pogut veure algú de fora és també el primer punt de la llista d'arranjaments de qualsevol MVP fet amb IA.
L'agent va recordar el que li vas demanar que recordés
En aquesta història no hi ha atacat ningú, i tot i així s'han filtrat secrets a través dels fitxers d'un agent de programació. Un enginyer va aprovar una ordre raonable, l'eina va complir la promesa de no tornar a preguntar i el registre d'aquella aprovació es va convertir en una segona còpia de la contrasenya. Els agents de programació fan més ràpids els bons enginyers, i a més ho apunten tot; el que apunten és configuració que és teva. Si vols que algú revisi amb tu el que han anat apuntant els agents dels teus repositoris, parla amb un CTO.
Fonts:
- Apiiro, Shmulik Cohen i Matan Giladi. Coding Agents Are Leaking Your Secrets to GitHub (5 de novembre del 2026, actualitzat el 8 de novembre). apiiro.com
- GitGuardian, Guillaume Valadon. Claude Code settings.local.json Secrets: GitHub, Docker Hub (9 de novembre del 2026). blog.gitguardian.com
- iTWire, David M Williams. Claude Code approval files found exposing company secrets on GitHub (7 de novembre del 2026). itwire.com
- CSO Online, Shweta Sharma. Claude Code's 'don't ask again' button has a secrets-spilling problem (11 de novembre del 2026). csoonline.com
- Boris Cherny a Hacker News (7 de novembre del 2026). news.ycombinator.com
- Anthropic. Documentació de Claude Code: settings, permisos, MCP.
- Phorion. Official Claude Code Extension Compromise: Security Advisory (30 d'octubre del 2026). phorion.io
- Cursor. Security notice: malicious version of Anthropic.claude-code (2.1.312 and 2.1.313) (29 d'octubre del 2026). cursor.com
- GitHub Docs. Removing sensitive data from a repository. docs.github.com



