Objetivo: En aproximadamente 15 minutos, instalarás Claude Code, iniciarás sesión y completarás tu primer cambio asistido por IA. Esta guía cubre solo lo necesario el primer día; los enlaces a material más profundo aparecen al final.
Paso 1: Instalar Claude Code (2 minutos)
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: Iniciar sesión (2 minutos)
La forma en que te autenticas depende de cómo tu organización haya aprovisionado el acceso. Elige una de las siguientes opciones:
Si tu organización utiliza… | Haz esto |
Licencias de Claude Enterprise | 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: Abrir un proyecto (1 minuto)
cd path/to/your/project claude
Claude Code lee tus archivos bajo demanda, por lo que no hay nada que cargar o adjuntar. Simplemente inicia desde dentro del repositorio en el que deseas trabajar.
Paso 4: Entender 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í — aplicar 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, por lo 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. Orientarse
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 dirigido a rutas específicas.
2. Encontrar 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 o nombre de archivo exacto.
3. Hacer 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 la revisión y aprobación de un diff en un cambio de bajo riesgo.
4. Arreglar 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. Dejar que maneje 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, por lo que las respuestas futuras ya estarán adaptadas a tu proyecto. Es el paso de configuración de mayor valor que puedes realizar.
Próximos pasos
Ahora has instalado Claude Code, te has autenticado, has hecho una edición y has configurado la memoria del proyecto. Cuando estés listo para ir más allá, la documentación oficial cubre memoria y CLAUDE.md, comandos de barra e 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.