Saltar al contenido principal

Prerrequisitos de los plugins de Claude — qué instalar en la máquina

Lo que debe existir en la máquina del dev para que los plugins de Claude funcionen — en especial wiedii-dev y sus dependencias oficiales de Anthropic. La parte org-wide (managed settings, Cowork, dependencias) está en plugins-empresariales-distribucion-configuracion. La sección «Requisitos» del README.md del repo claude-wiedii-plugins es la fuente canónica para la lista de binarios por skill; esta nota no la duplica, la resume y añade el contexto de Python.

Versión mínima de Claude Code​

  • Dependencias de plugin: ≥ 2.1.110 · cascada de activación: ≥ 2.1.143 · security-guidance: ≥ 2.1.144.
  • LSP por plugin (.lsp.json de wiedii-dev): ≥ 2.1.76.

Python — global, vía mise (lo exige el proceso de seguridad)​

Requisito: cada máquina de desarrollo debe tener un Python global gestionado por mise.

mise use -g python@3.13   # escribe ~/.config/mise/config.toml; 3.12+ cubre todo (security-guidance ≥3.8)

Por qué. Dos hooks de la organización invocan python3 en cada repo:

  • security-guidance (plugin oficial, dependencia de wiedii-dev) — revisión de seguridad del código generado (avisos regex + review del diff + review en git commit). Su sg-python.sh prueba python3.13/.12/.11/.10, python3, python, py -3; si ninguno funciona, emite el aviso no-bloqueante security-guidance: no working Python 3 interpreter found y no corre (la revisión de seguridad queda apagada en ese repo, sin avisar).
  • wiedii-guardrails (hook PreToolUse de Wiedii) — fail-open si falta Python (no rompe Bash, solo no aplica el guardrail).

En las máquinas Wiedii Python es 100% de mise (cada python3* es un shim de ~/.local/share/mise/shims/; no hay Python de sistema en PATH). Sin un Python global en mise, cualquier repo que no fije el suyo se queda sin intérprete y el proceso de seguridad falla.

Matiz por repo (no lo arregla el default global): un repo que fija su propia versión ([tools] python = "3.x" en su mise.toml) necesita esa versión instalada y el config trusted:

mise trust && mise install   # en ese repo, una vez

Si no, al invocar el shim mise intenta compilar la versión fijada desde fuente (python-build) y, en el contexto de un hook, eso falla/timeoutea → mismo aviso no working Python 3 interpreter found. (Es la misma familia que el bug del colector de /audit-project con mise.toml no-trusted.)

Requisito implícito: abrir Claude Code desde la terminal, para que los shims de mise estén en PATH. Lanzarlo desde el GUI de Desktop puede no cargar ~/.zprofile/~/.zshrc → sin shims → python3 no se encuentra en ningún repo.

Binarios por capacidad (resumen — canónico en el README del repo)​

Instalar según las skills que se usen (Homebrew salvo donde se indique):

  • signed-commits → brew install gnupg pinentry-mac.
  • rust-tools → brew install bat eza fd ripgrep sd gping tlrc.
  • review-pr / new-feature / git-workflow → glab + git-flow-next (Homebrew).
  • docker-conventions → Docker/OrbStack + buildx.
  • agent-browser → brew install agent-browser y luego agent-browser install. Ver herramientas-navegador-agentes.
  • codebase-memory-mcp (per-dev) → brew tap + brew install codebase-memory-mcp + codebase-memory-mcp install (registra el MCP global). Reemplaza a graphify (deprecado, decisión 2026-07-15). Ver codebase-memory-mcp.
  • Context7 (per-dev) → bunx ctx7 setup (no va en el plugin).

MCP​

  • Playwright y Chrome DevTools van declarados y pinneados en wiedii-dev (.mcp.json) — se instalan solos vía bunx <pkg>@<ver>; requieren Node/Bun en PATH.
  • Context7 es per-dev (ver arriba); no se empaqueta en el plugin.

Relacionados​