Objetivo: En aproximadamente 15 minutos, abrirás Claude Code, iniciarás sesión y completarás tu primer cambio asistido por IA. Esta guía cubre solo lo que necesitas el primer día; los enlaces a material más profundo aparecen al final.
Paso 1: Abre Claude Code (2 minutos)
Recomendado: Descarga Claude Desktop, inicia sesión con tu plan de pago y abre la pestaña "Code". Claude Desktop incluye Claude Code, así que no hay nada más que instalar. Sigue el inicio rápido de escritorio en la documentación de Claude Code para tu primera sesión, luego salta al Paso 3.
Para usar la terminal en su lugar, elige el comando que coincida con tu máquina y pégalo en una terminal.
Tu configuración | Comando |
macOS / Linux / WSL | `curl -fsSL https://claude.ai/install.sh |
Windows (PowerShell) | |
Homebrew |
|
npm (Node 18+) |
|
Consejo: No ejecutes la instalación de npm con sudo, ya que esto causa problemas de permisos de archivo más adelante.
Verifica la instalación:
claude --version
Paso 2: Inicia sesión (2 minutos)
Si estás usando Claude Desktop, ya has iniciado sesión y Claude Code usa la misma cuenta. Salta al Paso 3.
En la terminal, la forma en que te autenticas depende de cómo tu organización haya aprovisionado el acceso. Elige una de las siguientes:
Si tu organización usa… | Haz esto |
Un plan de Claude de pago | Ejecuta |
Una clave de API de Anthropic Console | Ejecuta |
Amazon Bedrock | Ejecuta |
Google Vertex AI | Ejecuta |
Si no estás seguro de qué método se aplica, consulta con tu administrador o intenta /login primero, que es el predeterminado para la mayoría de las organizaciones.
Paso 3: Abre un proyecto (1 minuto)
En Claude Desktop, inicia una nueva sesión en la pestaña "Code" y elige la carpeta del repositorio en el que deseas trabajar. En la terminal, inicia Claude Code desde dentro del repositorio:
cd path/to/your/project
claude
Claude Code lee tus archivos bajo demanda, así que no hay nada que cargar o adjuntar.
Paso 4: Comprende la única regla de seguridad (1 minuto)
Claude siempre preguntará antes de cambiar un archivo o ejecutar un comando. Cuando propone un cambio, verás un diff y tres opciones:
Sí — aplica este cambio único.
Sí, y no preguntes de nuevo por ediciones — aprueba automáticamente las ediciones de archivos para el resto de la sesión.
No — rechaza el cambio y explica por qué.
Puedes presionar Shift+Tab en cualquier momento para alternar entre modos (Plan → Aceptar Ediciones → predeterminado). Si un cambio produce un resultado inesperado, tu historial de git permanece intacto hasta que hagas commit, así que git checkout lo deshará.
Paso 5: Cinco cosas para probar primero
Copia y pega estos en el prompt uno a la vez. Cada ejemplo demuestra una capacidad central diferente.
1. Oriéntate
Give me a 5-bullet summary of what this codebase does and where the entry point is.
Por qué esto es útil: Muestra cómo Claude explora archivos por su cuenta, sin ser señalado a rutas específicas.
2. Encuentra algo
Where is user authentication handled? Show me the file and the key function.
Por qué esto es útil: A menudo es más rápido que grep cuando no conoces el símbolo exacto o el nombre del archivo.
3. Haz una edición segura
Add a docstring to the function <name> in <file>. Keep it to 2 lines.
Por qué esto es útil: Te permite practicar revisando y aprobando un diff en un cambio de bajo riesgo.
4. Arregla algo real
This test is failing: <paste the error>. Find the cause and fix it.
Por qué esto es útil: Este es el flujo de trabajo principal: describes el síntoma y Claude investiga y propone una solución.
5. Déjalo manejar git
Stage my changes and write a commit message that follows our existing style.
Por qué esto es útil: Claude puede ejecutar git en tu nombre (con aprobación) y coincidirá con las convenciones de commit existentes de tu repositorio.
Paso 6: Antes de terminar por el día
Ejecuta esto una vez por proyecto:
/init
Esto genera un archivo CLAUDE.md en la raíz de tu proyecto que captura las convenciones de tu base de código. Claude lo lee automáticamente al inicio de cada sesión, así que las respuestas futuras ya estarán adaptadas a tu proyecto. Es el paso de configuración de mayor valor que puedes tomar.
Próximos pasos
Ahora has abierto Claude Code, iniciado sesión, hecho una edición y configurado la memoria del proyecto. Cuando estés listo para ir más allá, la documentación oficial cubre memoria y CLAUDE.md, comandos integrados y atajos del modo interactivo en profundidad.
Si encontraste problemas durante la instalación o el inicio de sesión, consulta la guía de solución de problemas.
