Instalar Claude (Desktop y Code) con Homebrew — equipo de Desarrollo

En Wiedii toda app se instala por Homebrew, nunca por descarga manual (principio en herramientas-por-rol). Claude no es la excepción. Esta guía es corta a propósito: el proceso ya está documentado en el vault, aquí solo se resume y se enlaza (fuente única de verdad).

👋 ¿No eres del equipo de Desarrollo / no usas la terminal? Sigue la guía visual paso a paso (sin comandos): instalar-claude-desktop.

Instalar

claude (Desktop) y claude-code (terminal) ya están en la lista estándar de herramientas de Wiedii — Nivel 9, "Productividad y diseño" de herramientas-por-rol:

brew install claude        # Claude Desktop (Chat + Cowork)
brew install claude-code   # Claude Code (terminal) — si lo necesitas

Sin --cask. En Wiedii se usa brew install <nombre> sin el flag --cask: Homebrew moderno resuelve solo si es formula o cask, y fijar el flag acopla innecesariamente con la estructura interna de Homebrew. Ver gestion-herramientas-brew-mise.

Si es tu primera máquina en Wiedii, sigue antes guia-nuevo-dev (Homebrew, mise, herramientas esenciales) — Claude entra en el mismo flujo que VS Code o Warp, no requiere pasos aparte.

Requisitos

• macOS 12 o superior (requisito del cask; el instalador manual acepta macOS 11+, pero Homebrew exige 12+).
• Homebrew instalado (brew --version; si falta, está en el Paso 1.1 de guia-nuevo-dev).

Abrir la app

open -a Claude

o con Spotlight (Cmd + Espacio → "Claude").

Iniciar sesión y unirte al espacio de Wiedii

Antes de iniciar sesión: si tu navegador predeterminado ya tenía una sesión de Claude abierta (por ejemplo con una cuenta personal), ciérrala primero en claude.ai para que no se mezcle con tu cuenta de Wiedii.

El flujo de login (correo @wiedii.co → verificación → aceptar invitación al espacio Team) es idéntico para todos en Wiedii, técnicos o no. Capturas paso a paso: Parte 1 y Parte 3 de instalar-claude-desktop.

Después de instalar: plugins de Wiedii

• wiedii-core llega solo por managed settings del TL — no haces nada.
• wiedii-dev es opcional, lo instalas tú si trabajas en desarrollo: /plugin install wiedii-dev@claude-wiedii-plugins.
• Prerrequisitos de la máquina para que los plugins funcionen (Python global vía mise, binarios por skill): prerequisitos-plugins-claude.
• Uso día a día: uso-plugins-claude-para-usuarios (general) · uso-plugins-claude-desarrollo (comandos y capacidades de Desarrollo) · plugins-claude-problemas-comunes (troubleshooting).

Si usas Claude Code, ábrelo desde la terminal (no desde el Dock/GUI): así los shims de mise quedan en el PATH. Abrirlo desde el GUI puede no cargar ~/.zprofile/~/.zshrc, y entonces python3 no se encuentra en ningún repo (detalle en prerequisitos-plugins-claude).

Mantener actualizado

Homebrew no actualiza la app sola:

brew upgrade claude claude-code

Desinstalar (si hace falta)

brew uninstall claude

---

Relacionado

• instalar-claude-desktop — guía visual sin terminal (cualquier persona de Wiedii)
• instalar-claude-code — punto de entrada de onboarding para Claude Code
• herramientas-por-rol — lista completa de herramientas por rol (Claude está en Nivel 9)
• gestion-herramientas-brew-mise — por qué Homebrew y no descargas manuales
• guia-nuevo-dev — setup completo de una máquina nueva
• prerequisitos-plugins-claude · uso-plugins-claude-para-usuarios · uso-plugins-claude-desarrollo — plugins de Wiedii en Claude

Fuente oficial: Homebrew — cask claude