Antes de comenzar
Asegúrate de tener:- Una terminal o prompt de comandos abiertos
- Un proyecto de código con el que trabajar
- Una suscripción a Claude (Pro, Max, Team o Enterprise), una cuenta de Claude Console, o acceso a través de un proveedor de nube compatible
Estos casos se tratan en otras páginas:
- Nunca has usado una terminal: comienza con la guía de terminal
- Quieres usar Claude Code en otro lugar que no sea la terminal: Claude Code también está disponible en la web, como una aplicación de escritorio, en VS Code e IDEs de JetBrains, en Slack, y en CI/CD con GitHub Actions y GitLab. Consulta todas las interfaces.
Paso 1: Instalar Claude Code
Para instalar Claude Code, abra una terminal y ejecute el comando para su sistema. Si nunca ha utilizado una terminal antes, la guía de terminal muestra cómo abrir una y pegar el comando.- Instalación nativa (recomendado)
- Homebrew
- WinGet
macOS, Linux, WSL:En Windows, tu prompt muestra Windows CMD:El comando de instalación no muestra ningún progreso mientras descarga Claude Code. Cuando el instalador termine, abre una nueva ventana de terminal y ejecuta
PS C:\ cuando estás en PowerShell y C:\ sin el PS cuando estás en CMD.Windows PowerShell:claude --version. Una instalación que funciona correctamente imprime un número de versión. Si tu shell dice que claude no se encuentra o no se reconoce, el directorio de instalación aún no está en tu PATH: consulta Corrige tu PATH.Si ves The token '&&' is not a valid statement separator, estás en PowerShell, no en CMD. Si ves 'irm' is not recognized as an internal or external command, estás en CMD, no en PowerShell.Si el comando de instalación falla con syntax error near unexpected token '<', un 403 o cualquier otro error, consulta Solucionar problemas de instalación para hacer coincidir el error con una solución y para conocer métodos de instalación alternativos.Se recomienda Git for Windows en Windows nativo para que Claude Code pueda utilizar la herramienta Bash. Si Git for Windows no está instalado, Claude Code utiliza PowerShell como herramienta de shell en su lugar. Las configuraciones de WSL no necesitan Git for Windows.Las instalaciones nativas se actualizan automáticamente en segundo plano para mantenerlo en la versión más reciente.
(Claude Code).
Paso 2: Inicia tu primera sesión
Abre tu terminal en cualquier directorio de proyecto e inicia Claude Code:/path/to/your/project con la ruta al proyecto en el que quieres trabajar.
Claude Code te pide iniciar sesión la primera vez que lo usas. Para suscripciones de Claude o cuentas de Console, sigue las instrucciones para completar la autenticación en tu navegador. Si configuraste la variable de entorno ANTHROPIC_API_KEY y apruebas la clave cuando Claude Code te pregunta si quieres usarla, Claude Code omite la solicitud de inicio de sesión.
Puedes iniciar sesión con cualquiera de estos tipos de cuenta:
- Claude Pro, Max, Team o Enterprise (recomendado)
- Claude Console (acceso a la API con créditos prepagados). En el primer inicio de sesión, se crea automáticamente un espacio de trabajo “Claude Code” en Console para el seguimiento centralizado de costos.
- Amazon Bedrock, Agent Platform de Google Cloud o Microsoft Foundry (proveedores de nube empresariales)
- Un gateway de aplicaciones de Claude autoalojado, si tu organización ejecuta uno: tu administrador preconfigura la URL del gateway, y
/loginse abre directamente en la pantalla Cloud gateway para que inicies sesión con el SSO corporativo
/help para ver los comandos disponibles o /resume para continuar una conversación anterior. Para cambiar de cuenta más adelante o volver a autenticarte, escribe /login dentro de la sesión en ejecución.
Paso 3: Haz tu primera pregunta
Prueba uno de estos comandos:Claude Code lee los archivos de tu proyecto según sea necesario. No tienes que agregar contexto manualmente.
Paso 4: Haz tu primer cambio de código
Prueba una tarea pequeña:Shift+Tab en cualquier momento para cambiar el modo de permisos de la sesión en la que te encuentras.
Paso 5: Usa Git con Claude Code
Claude Code convierte las operaciones de Git en una conversación:Paso 6: Corrige un error o agrega una función
Describe lo que quieres en lenguaje natural:Paso 7: Prueba otros flujos de trabajo comunes
Prueba algunos prompts más. Puedes pedirle a Claude que refactorice código, escriba pruebas, actualice la documentación o revise tus cambios:Comandos esenciales
Aquí están los comandos más importantes para el uso diario, agrupados según dónde los ejecutas.Comandos de shell
Ejecuta estos desde tu terminal para iniciar o reanudar Claude Code.
Consulta la referencia de CLI para ver la lista completa de comandos de shell.
Comandos de sesión
Ejecuta estos dentro de Claude Code después de que se inicia.
Consulta la referencia de comandos para ver la lista completa de comandos de sesión.
Consejos profesionales para principiantes
Para más información, consulte mejores prácticas y flujos de trabajo comunes.Sea específico con sus solicitudes
Sea específico con sus solicitudes
En lugar de: “corrige el error”Intente: “corrige el error de inicio de sesión donde los usuarios ven una pantalla en blanco después de ingresar credenciales incorrectas”
Utilice instrucciones paso a paso
Utilice instrucciones paso a paso
Divida tareas complejas en pasos:
Deje que Claude explore primero
Deje que Claude explore primero
Antes de hacer cambios, deje que Claude entienda su código:
Ahorre tiempo con atajos de teclado
Ahorre tiempo con atajos de teclado
- Escriba
/para ver todos los comandos y skills disponibles - Utilice Tab para completar comandos
- Presione ↑ para el historial de comandos
- Presione
Shift+Tabpara ciclar a través de los modos de permisos
¿Qué sigue?
Ahora que aprendiste lo básico, explora funciones más avanzadas:- Cómo funciona Claude Code: comprende el bucle agéntico, las herramientas integradas y cómo Claude Code interactúa con tu proyecto
- Buenas prácticas: obtén mejores resultados con indicaciones efectivas y una buena configuración del proyecto
- Flujos de trabajo comunes: guías paso a paso para tareas comunes
- Extiende Claude Code: personaliza con CLAUDE.md, skills, hooks, MCP y más
Obtener ayuda
- En Claude Code: escribe
/helpo haz una pregunta del tipo “¿cómo hago…?” - Documentación: explora las otras guías de este sitio
- Cursos: toma Claude Code 101 y otros cursos gratuitos a tu propio ritmo en Claude Academy
- Comunidad: únete al servidor de Discord para obtener consejos y soporte