
AI Prompt Secret Scanner: proxy local y hook de Claude Code que bloquea secretos antes de que lleguen a las APIs de IA
Higiene de secretos para código generado por IA. Detecta credenciales codificadas en prompts, entradas de herramientas, código generado y archivos existentes.
pip install aigate && aigate setup-all
Eso es todo. Esto instala un proxy en segundo plano (modo redact), un hook PostToolUse para escaneo de archivos y registra el servidor MCP con Claude Code. Reinicia tu terminal para que las variables de entorno surtan efecto.
Requiere Python 3.11+ y jq.
Tres capas, un motor de detección:
| Capa | Alcance | Cómo |
|---|---|---|
| Proxy | Nivel de red | Intercepta solicitudes HTTPS a APIs de IA. Redacta secretos antes de que salgan de tu máquina. |
| Hooks | Claude Code | PostToolUse escanea archivos después de Write/Edit. PreToolUse redacta entradas de herramientas. |
| Servidor MCP | Cualquier agente | Tres herramientas que los agentes llaman para escanear código, almacenar secretos y auditar archivos. |
setup-all instala los tres. O elige lo que necesites:
aigate install-hook # hooks only (no proxy)
claude mcp add aigate aigate-mcp # MCP server only
aigate setup && aigate start # proxy only
aigate scan-dir . # find secrets in a directory
aigate scan-dir . --fix --dry-run # preview what would change
aigate scan-dir . --fix # replace with env var refs, save to .env
Claves AWS, tokens de API (OpenAI, Anthropic, GitHub, GitLab, Slack, SendGrid, Square), URLs de bases de datos, claves privadas, cuentas de servicio de GCP, claves de Tailscale, secretos de archivos env y campos de contraseñas/tokens de alta entropía.
Los secretos detectados se asignan a nombres convencionales de variables de entorno:
aigate start -m block # reject requests (default)
aigate start -m redact # replace secrets with env var placeholders
aigate start -m warn # forward + log warning
aigate start -m audit # forward + silent log
aigate stop-proxy && aigate uninstall-hook && claude mcp remove aigate
pip uninstall aigate && rm -rf ~/.aigate ~/.mitmproxy
Elimina las líneas después de # aigate: proxy env vars y # aigate: trust mitmproxy CA de tu perfil de shell.
Eliminación del certificado CA — macOS: sudo security delete-certificate -c mitmproxy /Library/Keychains/System.keychain | Debian: sudo rm /usr/local/share/ca-certificates/mitmproxy-aigate.crt && sudo update-ca-certificates --fresh | RHEL: sudo rm /etc/pki/ca-trust/source/anchors/mitmproxy-aigate.pem && sudo update-ca-trust
| Token | Variable de entorno |
|---|
sk-ant-* | ANTHROPIC_API_KEY |
sk-*, sk-proj-* | OPENAI_API_KEY |
ghp_*, github_pat_* | GITHUB_TOKEN |
glpat-* | GITLAB_TOKEN |
xoxb-* | SLACK_BOT_TOKEN |
SG.* | SENDGRID_API_KEY |
AKIA* | AWS_ACCESS_KEY_ID |