¿Claude Code guarda contraseñas en settings.local.json? Auditoría, rotación y permisos

Revoca primero las credenciales expuestas y revisa permisos locales e historial Git. Incluye script de solo lectura, demostración ficticia y comparación con Codex/Cursor.

6 分钟阅读
¿Claude Code guarda contraseñas en settings.local.json? Auditoría, rotación y permisos

Según The Hacker News del 7 de noviembre, investigadores de Apiiro informaron de que una aprobación permanente puede guardar un comando con credenciales en .claude/settings.local.json. Si se confirma ese archivo en Git, el secreto puede quedar expuesto. No toda aprobación guarda el comando completo, ni Claude Code publica el archivo de forma predeterminada.

Crear clave API / Create API Key →

Revocar antes de limpiar archivos

Si una credencial propia llegó a un repositorio público, revócala o rótala primero en el emisor. Revisa los registros de acceso y los permisos. Borrar archivos, ignorarlos o reescribir el historial no invalida una credencial filtrada. Pueden quedar copias en clones, bifurcaciones y artefactos. Coordina la limpieza del historial con el equipo; aquí no se ejecuta.

Revisión de solo lectura de tu repositorio

Ejecuta el script siguiente solo en un repositorio local propio o autorizado. Lee dos rutas fijas y su historial accesible desde las referencias actuales, sin red y sin imprimir valores coincidentes ni líneas originales. Las heurísticas pueden omitir secretos o producir falsos positivos; no encontrar nada no demuestra seguridad. El límite predeterminado es de 1000 blobs históricos distintos, cada uno de hasta 2 MiB. Los resultados omitidos o truncados requieren seguimiento. No cubre conversaciones, otras rutas ni objetos inalcanzables.

python
#!/usr/bin/env python3
"""Read-only heuristic check of exactly two files in one explicitly selected own repo.
Never prints matched values, source lines, remote URLs, or file contents.
Not a complete secret scanner. Do not use on other people's repositories.
"""
import argparse, json, os, re, subprocess
from pathlib import Path
ap=argparse.ArgumentParser(); ap.add_argument('repo'); ap.add_argument('--max-versions',type=int,default=1000)
a=ap.parse_args(); root=Path(a.repo).resolve()
env=os.environ.copy(); env.update(GIT_CONFIG_NOSYSTEM='1',GIT_CONFIG_GLOBAL=os.devnull,GIT_PAGER='cat',GIT_TERMINAL_PROMPT='0')
def git(*args):
    p=subprocess.run(['git','--no-pager','-c','core.fsmonitor=false','-c','core.hooksPath=/dev/null','-C',str(root),*args],env=env,stdout=subprocess.PIPE,stderr=subprocess.DEVNULL)
    return p.stdout if p.returncode==0 else None
top=git('rev-parse','--show-toplevel')
if top is None or Path(os.fsdecode(top).strip()).resolve()!=root:
    raise SystemExit('Select the exact root of your own local repository; no contents printed.')
paths=['.claude/settings.local.json','.claude/settings.json']
rx=re.compile(r"""(?ix)(?:postgres(?:ql)?|mysql|mongodb(?:\+srv)?):\/\/[^\s"'/:]+:[^\s"'@]+@|(?:PGPASSWORD|MYSQL_PWD|password|passwd|api[_-]?key|token)\s*[=:]\s*(?!\$|\\?"?\$)[^\s,;}{]{4,}|\b(?:ghp_|github_pat_|sk-ant-|AKIA)[A-Za-z0-9_-]{8,}""")
limit=2*1024*1024
work=[]
for name in paths:
    p=root/name
    if p.is_symlink() or p.parent.is_symlink():
        work.append({'file':name,'status':'symlink_skipped'}); continue
    if not p.is_file(): work.append({'file':name,'status':'absent'}); continue
    if p.stat().st_size>limit: work.append({'file':name,'status':'size_limit_skipped'}); continue
    work.append({'file':name,'suspected_secret':bool(rx.search(p.read_text(errors='replace')))})
commits=git('log','--all','--format=%H','--',*paths) or b''
seen=set(); checked=0; hits=0; skipped=0; truncated=False
for rev in commits.decode().splitlines():
    for name in paths:
        oid=git('rev-parse',rev+':'+name)
        if oid is None: continue
        oid=oid.strip().decode()
        if oid in seen: continue
        seen.add(oid)
        if checked>=a.max_versions: truncated=True; break
        size=git('cat-file','-s',oid)
        if size is None or int(size)>limit: skipped+=1; continue
        blob=git('cat-file','blob',oid)
        if blob is None: skipped+=1; continue
        checked+=1; hits+=int(bool(rx.search(blob.decode(errors='replace'))))
    if truncated: break
print(json.dumps({'working_tree':work,'history':{'distinct_blobs_checked':checked,'suspected_blobs':hits,'skipped_blobs':skipped,'truncated':truncated},'warning':'heuristic_only; no hit does not prove clean; reachable refs only'},ensure_ascii=False))
bash
python3 selfcheck.py /absolute/path/to/your-own-repository

Borrar el archivo no borra el historial

Tras rotar las credenciales, revisa y elimina las reglas allow que contengan secretos. Añade el patrón inferior al .gitignore del repositorio. El comando de ejemplo deja de rastrear un archivo para futuros commits, conserva la copia de trabajo y no borra commits antiguos. Solo se muestra; no se ejecuta aquí. No ignores ciegamente todo .claude/: la configuración compartida también necesita revisión.

gitignore
**/.claude/settings.local.json
bash
git rm --cached .claude/settings.local.json

Límites de variables y patrones de aprobación

La documentación oficial de permisos define Bash(npm run lint) como comando exacto y Bash(npm run *) como patrón con comodín; también admite :* al final. Una regla exacta suele ser más limitada, pero el propio script puede ejecutar acciones sensibles. Lee el alcance real en vez de conceder Bash(*) para evitar avisos. El JSON de ejemplo va en ~/.claude/settings.json, combinado con la configuración existente, no sustituyéndola.

json
{
  "permissions": {
    "allow": [
      "Bash(npm run lint)"
    ]
  }
}

psql "$DB_URL" ilustra una variable del shell, no garantiza seguridad. Inyecta variables en la sesión local mediante gestión controlada de secretos en lugar de incrustar contraseñas. Los valores expandidos pueden aparecer en argumentos de procesos, trazas o salidas, y el modelo podría generar otro comando con el valor. No actives trazas del shell ni imprimas la variable. No se intentó conectar con ninguna base de datos.

Claude Code, Codex y Cursor

La documentación de configuración Claude Code distingue ~/.claude/settings.json global, .claude/settings.local.json local y .claude/settings.json compartido. En la primera escritura que cumpla las condiciones, el cliente añade una exclusión global de Git. Esta protección no viaja con el repositorio ni deja de rastrear archivos existentes. La configuración del proveedor de Codex va en ~/.codex/config.toml global. El ejemplo solo muestra metadatos y omite deliberadamente los valores de autenticación; no es una configuración de autenticación completa y ejecutable. Gestiona el valor real de experimental_bearer_token únicamente en tu configuración local privada, nunca en el artículo ni en un commit.

La referencia oficial de Codex y los fundamentos de configuración definen model_provider como selector, name como nombre visible, base_url como base API y wire_api = "responses" como protocolo. La referencia sigue incluyendo experimental_bearer_token, pero desaconseja expresamente guardar el token directamente en la configuración. Este ejemplo sigue la convención del sitio, no una recomendación oficial de almacenamiento de secretos. Al rellenarlo, el archivo global contiene un secreto: exclúyelo de repositorios, capturas, paquetes sincronizados y archivos compartidos. Se comprobaron los campos documentados y su ubicación, sin solicitudes autenticadas.

toml
model_provider = "aicodewith"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"

Según la documentación de seguridad de Cursor, los comandos de terminal requieren aprobación de forma predeterminada. Run Modes y listas de permitidos son medidas de mejor esfuerzo, no límites estrictos de seguridad. No demuestran un formato de persistencia idéntico ni inmunidad a filtraciones. Revisa configuración, registros, historial y diferencias en los tres clientes.

Qué demuestra la prueba local

Versiones presentes: Claude Code 2.1.319 y Codex 0.167.0. Se confirmó un fixture escrito a mano con una contraseña claramente ficticia solo en un repositorio Git local temporal aislado. El script detectó el archivo actual; al sustituir la regla, desapareció ese resultado pero permaneció el del historial. Añadir .gitignore no desactivó el seguimiento. La demostración tardó 0.115 segundos, sin incluir la investigación. No se pulsó aprobación permanente en la interfaz del cliente: no es una reproducción de su persistencia. No se usaron modelos, claves reales, pushes ni credenciales públicas expuestas.

Crear clave API / Create API Key →

Guías relacionadas

Revisar el secuestro AGENTS.md

Revisar el correo en User-Agent

Configurar hooks de los tres clientes