Cómo instalar Claude Code y Claude Cowork en español: requisitos, planes y verificación

Claude Code y Claude Cowork no son lo mismo, aunque ambos sean de Anthropic. Code vive en tu terminal y trabaja sobre tu repo. Cowork vive en Claude Desktop y trabaja sobre tus apps, archivos y navegador. Si instalas el equivocado, pierdes una tarde. Esta guía solo cubre instalación y verificación: qué instalar, requisitos, autenticación y cómo dejar ambos funcionando.

Para uso avanzado de Code —comandos diarios, skills, MCP, subagentes y modo headless— sigue en Claude Code desde cero. Aquí no duplicamos eso.

Code vs Cowork: qué instalar

	Claude Code	Claude Cowork
Dónde corre	Terminal, dentro de tu repo	Claude Desktop, sobre tu escritorio
Qué toca	Archivos, git, tests, comandos	Archivos locales, conectores, navegador, pantalla
Ideal para	Refactors, tests, docs, CI	Briefings, hojas de cálculo, dashboards sin API, organización
Requiere	Node.js + cuenta Claude o API key	Claude Desktop + plan Pro o Max
No es	Un chatbot del editor	Una automatización cloud 24/7

Regla práctica: si el trabajo está en un repo con git, instala Code. Si está en apps de escritorio sin API cómoda, instala Cowork. Muchos builders terminan con ambos.

Requisitos antes de tocar nada

Para Claude Code:

• Node.js 18 o superior. Verifica con node --version.
• npm activo. Verifica con npm --version.
• macOS, Linux o Windows con WSL. En Windows nativo sin WSL da más fricción con permisos y paths.
• Una de dos: cuenta de Claude con plan Pro o Max, o una API key de Anthropic con crédito para equipo/CI.

Para Claude Cowork:

• macOS o Windows con Claude Desktop instalado.
• Plan Pro o Max. Computer use entra como research preview en esos planes.
• Tu computadora despierta y la app abierta: las tareas de Cowork no corren en cloud si cierras el equipo.
• Permisos por aplicación concedidos a mano. No des acceso a finanzas, salud o datos sensibles en la primera prueba.

Si partes de cero con agentes, el curso gratuito de instalación te deja el primer agente funcionando antes de meterte a Code o Cowork.

Instalar Claude Code paso a paso

1. Instala el CLI global:

npm install -g @anthropic-ai/claude-code
claude --version

Si npm install -g falla por permisos, no uses sudo por costumbre. Configura el prefix de npm en tu home o usa el gestor de versiones de Node que ya tengas. En WSL, instala Node dentro de WSL, no desde Windows.

2. Entra a tu proyecto y arranca:

cd tu-proyecto
claude

3. Autentícate en el primer arranque. Con cuenta personal elige login con tu cuenta de Claude. Para equipo o CI usa API key para no depender de una sesión interactiva.

4. Verifica que el agente ve el repo:

/init
/cost
claude mcp list

/init genera el CLAUDE.md con la estructura del proyecto. /cost confirma que la sesión mide gasto. claude mcp list debe mostrar solo lo que necesitas, vacío al inicio está bien.

Instalar Claude Cowork paso a paso

1. Descarga Claude Desktop desde el sitio oficial de Anthropic e inicia sesión con tu cuenta Pro o Max.
2. Abre Cowork dentro de la app. En el primer uso te pide permisos por aplicación: concede solo las que vas a probar.
3. Activa computer use solo si lo necesitas. La documentación oficial lo pone al final de la jerarquía: primero conectores, luego navegador, al final interacción por pantalla. Si Slack o Drive ya tienen conector, esa es la ruta buena.
4. Haz una prueba reversible: pide organizar archivos de una carpeta de prueba o sintetizar un documento local. No empieces con documentos legales ni cuentas.

Cowork toma screenshots para orientarse y no tiene sandbox entre Claude y tus apps. Puede ver lo visible en pantalla, no solo el archivo objetivo. Por eso los permisos por app y las apps sensibles bloqueadas por defecto importan. El detalle completo está en la ayuda oficial de computer use.

Verificación de primer arranque

Corre esta lista en orden antes de dar por terminada la instalación:

1. claude --version responde sin error.
2. claude abre sesión dentro de tu repo y se autentica.
3. /init crea CLAUDE.md y refleja tu proyecto.
4. Pides una tarea pequeña —"agrega validación de email vacío y un test"— y revisas el diff completo antes de aprobar.
5. Cowork abre, lista tus conectores y ejecuta una tarea de prueba con la app abierta.
6. Sabes dónde revocar permisos en ambos: API key en consola y permisos por app en Desktop.

Si algo de esto falla, no sigas instalando plugins. Arregla la base primero.

Problemas comunes y cómo resolverlos

• node --version muy vieja: actualiza Node a 18+ antes de reinstalar el CLI. Code no se arregla reinstalando sobre Node viejo.
• EACCES en npm install -g: es permisos del prefix de npm, no de Code. Cambia el prefix a tu home o usa nvm/fnm.
• Auth que no avanza: verifica plan activo o crédito de API key. En equipo, cambia a API key en vez de pelear con login interactivo.
• Cowork no ejecuta tareas programadas: tu equipo estaba dormido o la app cerrada. No es cron cloud; es rutina asistida por tu desktop.
• Code no ve servidores MCP: claude mcp list indica si es transporte, URL o auth. Agrega pocos servidores y con permisos mínimos.
• Sesión lenta o confusa: /compact resume contexto, /clear reinicia la tarea. Cambiar de tarea sin limpiar es el error más común.

Para operación segura con permisos mínimos, lee sandboxing y permisos antes de darle a Code acceso a tu repo real.

Primer uso mínimo sin romper nada

En Code, dentro de un repo de prueba:

claude
# > Agrega un test para email vacío en el formulario de login
# revisa el plan, aprueba, corre tests, cierra con /clear

En Cowork, con archivos de prueba:

1. Una síntesis diaria de un documento local.
2. Una organización de una carpeta de descargas de prueba.
3. Una revisión visual de una app sin conector.

Si esas tres salen bien, ya tienes el entorno listo. El siguiente paso es el hub de construcción de agentes para tool calling, memoria y evals, y la guía de Claude Code desde cero para el flujo diario real.