Inicio rápido
¡Bienvenido a Claude Code!
Esta guía de inicio rápido le permitirá usar asistencia de codificación impulsada por IA en pocos minutos. Al final, comprenderá cómo usar Claude Code para tareas comunes de desarrollo.
Antes de comenzar
Asegúrese de tener:
- Una terminal o símbolo del sistema abiertos
- Si nunca ha usado la terminal antes, consulte la guía de terminal
- 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
Esta guía cubre la CLI de 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. Consulte todas las interfaces.
Paso 1: Instalar Claude Code
To install Claude Code, use one of the following methods:
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
If you see The token '&&' is not a valid statement separator, you're in PowerShell, not CMD. If you see 'irm' is not recognized as an internal or external command, you're in CMD, not PowerShell. Your prompt shows PS C:\ when you're in PowerShell and C:\ without the PS when you're in CMD.
Git for Windows is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.
Native installations automatically update in the background to keep you on the latest version.
brew install --cask claude-code
Homebrew offers two casks. claude-code tracks the stable release channel, which is typically about a week behind and skips releases with major regressions. claude-code@latest tracks the latest channel and receives new versions as soon as they ship.
Homebrew installations do not auto-update. Run brew upgrade claude-code or brew upgrade claude-code@latest, depending on which cask you installed, to get the latest features and security fixes.
winget install Anthropic.ClaudeCode
WinGet installations do not auto-update. Run winget upgrade Anthropic.ClaudeCode periodically to get the latest features and security fixes.
You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine.
Paso 2: Inicie sesión en su cuenta
Claude Code requiere una cuenta para usarse. Cuando inicie una sesión interactiva con el comando claude, deberá iniciar sesión:
claude
# Se le pedirá que inicie sesión en el primer uso
/login
# Siga las indicaciones para iniciar sesión con su cuenta
Puede iniciar sesión usando cualquiera de estos tipos de cuenta:
- Claude Pro, Max, Team o Enterprise (recomendado)
- Claude Console (acceso a API con créditos prepagados). En el primer inicio de sesión, se crea automáticamente un espacio de trabajo "Claude Code" en la Console para el seguimiento centralizado de costos.
- Amazon Bedrock, Google Vertex AI o Microsoft Foundry (proveedores de nube empresariales)
Una vez que haya iniciado sesión, sus credenciales se almacenan y no necesitará iniciar sesión nuevamente. Para cambiar de cuenta más tarde, use el comando /login.
Paso 3: Inicie su primera sesión
Abra su terminal en cualquier directorio de proyecto e inicie Claude Code:
cd /path/to/your/project
claude
Verá la pantalla de bienvenida de Claude Code con la información de su sesión, conversaciones recientes y las últimas actualizaciones. Escriba /help para ver los comandos disponibles o /resume para continuar una conversación anterior.
Después de iniciar sesión (Paso 2), sus credenciales se almacenan en su sistema. Obtenga más información en Gestión de credenciales.
Paso 4: Haga su primera pregunta
Comencemos por entender su base de código. Intente uno de estos comandos:
¿qué hace este proyecto?
Claude analizará sus archivos y proporcionará un resumen. También puede hacer preguntas más específicas:
¿qué tecnologías usa este proyecto?
¿dónde está el punto de entrada principal?
explique la estructura de carpetas
También puede preguntarle a Claude sobre sus propias capacidades:
¿qué puede hacer Claude Code?
¿cómo creo skills personalizados en Claude Code?
¿puede Claude Code trabajar con Docker?
Claude Code lee los archivos de su proyecto según sea necesario. No tiene que agregar contexto manualmente.
Paso 5: Realice su primer cambio de código
Ahora hagamos que Claude Code haga algo de codificación real. Intente una tarea simple:
agrega una función hello world al archivo principal
Claude Code hará lo siguiente:
- Encontrará el archivo apropiado
- Le mostrará los cambios propuestos
- Le pedirá su aprobación
- Realizará la edición
Claude Code siempre pide permiso antes de modificar archivos. Puede aprobar cambios individuales o habilitar el modo "Aceptar todo" para una sesión.
Paso 6: Use Git con Claude Code
Claude Code hace que las operaciones de Git sean conversacionales:
¿qué archivos he cambiado?
confirma mis cambios con un mensaje descriptivo
También puede solicitar operaciones de Git más complejas:
crea una nueva rama llamada feature/quickstart
muéstrame los últimos 5 commits
ayúdame a resolver conflictos de fusión
Paso 7: Corrija un error o agregue una función
Claude es competente en depuración e implementación de funciones.
Describa lo que desea en lenguaje natural:
agrega validación de entrada al formulario de registro de usuarios
O corrija problemas existentes:
hay un error donde los usuarios pueden enviar formularios vacíos - corrígelo
Claude Code hará lo siguiente:
- Localizará el código relevante
- Comprenderá el contexto
- Implementará una solución
- Ejecutará pruebas si están disponibles
Paso 8: Pruebe otros flujos de trabajo comunes
Hay varias formas de trabajar con Claude:
Refactorizar código
refactoriza el módulo de autenticación para usar async/await en lugar de callbacks
Escribir pruebas
escribe pruebas unitarias para las funciones de calculadora
Actualizar documentación
actualiza el README con instrucciones de instalación
Revisión de código
revisa mis cambios y sugiere mejoras
Hable con Claude como lo haría con un colega útil. Describa lo que desea lograr y le ayudará a llegar allí.
Comandos esenciales
Aquí están los comandos más importantes para el uso diario:
| Comando | Qué hace | Ejemplo |
|---|---|---|
claude |
Inicia el modo interactivo | claude |
claude "task" |
Ejecuta una tarea única | claude "fix the build error" |
claude -p "query" |
Ejecuta una consulta única y luego sale | claude -p "explain this function" |
claude -c |
Continúa la conversación más reciente en el directorio actual | claude -c |
claude -r |
Reanuda una conversación anterior | claude -r |
/clear |
Borra el historial de conversación | /clear |
/help |
Muestra los comandos disponibles | /help |
exit o Ctrl+D |
Salir de Claude Code | exit |
Consulte la referencia de CLI para obtener una lista completa de comandos.
Consejos profesionales para principiantes
Para más información, consulte mejores prácticas y flujos de trabajo comunes.
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
Divida tareas complejas en pasos:
1. crea una nueva tabla de base de datos para perfiles de usuario
2. crea un endpoint de API para obtener y actualizar perfiles de usuario
3. construye una página web que permita a los usuarios ver y editar su información
Deje que Claude explore primero
Antes de hacer cambios, deje que Claude entienda su código:
analiza el esquema de la base de datos
construye un panel que muestre los productos que nuestros clientes del Reino Unido devuelven con más frecuencia
Ahorre tiempo con atajos de teclado
- Escriba
/para ver todos los comandos y skills - 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 ha aprendido lo básico, explore funciones más avanzadas:
Comprenda el bucle de agente, las herramientas integradas y cómo Claude Code interactúa con su proyecto
Obtenga mejores resultados con indicaciones efectivas y configuración de proyecto
Guías paso a paso para tareas comunes
Personalice con CLAUDE.md, skills, hooks, MCP y más
Obtener ayuda
- En Claude Code: Escriba
/helpo pregunte "¿cómo..." - Documentación: ¡Está aquí! Explore otras guías
- Comunidad: Únase a nuestro Discord para consejos y soporte