Workbranch › Guías

Cómo empezar con Claude Code

Claude Code es el asistente de programación de Anthropic que lee tu proyecto, edita archivos y ejecuta comandos desde tu terminal. Esta guía te lleva desde la instalación hasta una primera sesión que funciona, además del archivo que mejora todas las sesiones posteriores.

Actualizado 30 de octubre de 2026

Los comandos de abajo se comprobaron con la documentación de Claude Code de Anthropic en octubre de 2026.

Qué planes incluyen Claude Code

Paso 1: instalar

1. Abre una terminal. En Windows, PowerShell muestra PS C:\ en el indicador; CMD muestra solo C:\.
2. Ejecuta el comando de tu sistema:
   • macOS, Linux, WSL: curl -fsSL https://claude.ai/install.sh | bash
   • Windows PowerShell: irm https://claude.ai/install.ps1 | iex
   • Windows CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
3. Espera. El instalador no muestra ninguna barra de progreso mientras descarga.
4. Abre una ventana de terminal nueva y ejecuta claude --version. Deberías ver un número de versión seguido de (Claude Code).

¿Prefieres un gestor de paquetes? También funcionan brew install --cask claude-code en Mac o winget install Anthropic.ClaudeCode en Windows. En Windows nativo se recomienda instalar Git for Windows para que Claude Code pueda usar Bash; sin él, recurre a PowerShell.

Paso 2: inicia tu primera sesión en un proyecto

1. Entra en tu proyecto: cd /path/to/your/project.
2. Escribe claude y pulsa Enter.
3. La primera vez, sigue las indicaciones para iniciar sesión en el navegador. Tus credenciales se guardan, así que solo lo haces una vez. Más adelante, usa /login para cambiar de cuenta.
4. Haz una pregunta para orientarte, como ¿qué hace este proyecto? o ¿dónde está el punto de entrada principal?. Claude lee los archivos que necesita; no tienes que pegar código.
5. Prueba un cambio pequeño, por ejemplo añade validación de datos al formulario de registro. Claude muestra la edición y pregunta antes de aplicarla; elige Yes (Sí) para aprobarla.

Claude Code también maneja Git con lenguaje normal: ¿qué archivos he cambiado? o haz commit de mis cambios con un mensaje descriptivo.

Paso 3: dale a Claude las reglas de tu proyecto con CLAUDE.md

Cada sesión empieza con un contexto vacío. Un archivo CLAUDE.md se carga al principio de cada una, así que es donde pones lo que Claude siempre debe saber: comandos de compilación y de tests, convenciones, cosas que evitar.

1. En una sesión, ejecuta /init. Claude revisa tu base de código y escribe un CLAUDE.md inicial con los comandos y convenciones que encuentra. Si el archivo ya existe, sugiere mejoras en lugar de sobrescribirlo.
2. Abre el archivo y añade lo que Claude no ha podido descubrir por sí mismo, como "ejecuta el linter antes de hacer commit".
3. Haz commit del archivo para que las sesiones de tus compañeros reciban las mismas instrucciones.

Anthropic sugiere que cada archivo tenga menos de unas 200 líneas: los archivos más largos consumen más contexto y se siguen con menos fiabilidad. Puedes incluir otros archivos con @path/to/file.

Comandos que conviene aprender primero

• claude "task" inicia una sesión con tu primera instrucción ya escrita.
• claude -p "query" responde una vez y termina.
• claude -c continúa la última sesión de esta carpeta; claude -r te deja elegir una anterior. Más información en cómo retomar una sesión de Claude Code.
• /help muestra los comandos, /clear empieza de cero, /exit (o Ctrl+D dos veces) sale.
• Escribe / para ver los comandos y skills disponibles.

Conviene saber

• Uso: en Pro y Max, Claude Code y el chat de Claude comparten los mismos límites de cinco horas y semanales. Si hay una variable de entorno ANTHROPIC_API_KEY definida y aprobada, Claude Code usa esa clave y factura con tarifas de API; ejecuta /login para pasar a tu suscripción.
• Permisos: el modo de permisos decide qué puede hacer Claude sin preguntar. Pulsa Shift+Tab para pasar de un modo a otro.
• CLAUDE.md es una guía, no un candado: Claude lo trata como contexto. Las instrucciones concretas y breves son las que se siguen con más constancia.

Si no funciona

• No se encuentra claude después de instalarlo: abre una terminal nueva. Si sigue fallando, la carpeta de instalación aún no está en tu PATH; la página de solución de problemas de Anthropic explica cómo arreglarlo.
• The token '&&' is not a valid statement separator: estás en PowerShell; usa el comando de PowerShell. 'irm' is not recognized significa que estás en CMD.
• El comando de instalación falla con un 403 o un error de sintaxis: consulta la página de solución de problemas de instalación de Anthropic para ver métodos de instalación alternativos.
• El inicio de sesión entra en bucle o usa la cuenta equivocada: ejecuta /login dentro de una sesión para volver a iniciar sesión.

Workbranch para Claude Code

Si llevas el trabajo de tus proyectos en Workbranch, su plugin para Claude Code muestra lo que sigue abierto cuando una sesión empieza en una carpeta vinculada a un proyecto, y puedes decir "save this to Workbranch" (guarda esto en Workbranch) para archivar por tema las tareas, decisiones y preguntas abiertas de la sesión. Tienes los detalles en la página Workbranch para Claude.

Fuentes

• Use Claude Code with your Pro or Max plan (Centro de ayuda de Claude, consultado el 30 de octubre de 2026)
• Quickstart (Claude Code Docs, consultado el 30 de octubre de 2026)
• How Claude remembers your project (Claude Code Docs, consultado el 30 de octubre de 2026)

Preguntas frecuentes