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

Paso 1: Instalar Claude Code

Para instalar Claude Code, utilice uno de los siguientes métodos:

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

Si ve The token '&&' is not a valid statement separator, está en PowerShell, no en CMD. Si ve 'irm' is not recognized as an internal or external command, está en CMD, no en PowerShell. Su símbolo del sistema muestra PS C:\ cuando está en PowerShell y C:\ sin el PS cuando está en CMD.

Si el comando de instalación falla con syntax error near unexpected token '<', un 403, u otro error de curl, consulte 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.

brew install --cask claude-code

Homebrew ofrece dos casks. claude-code rastrea el canal de versión estable, que típicamente está aproximadamente una semana atrás y omite versiones con regresiones importantes. claude-code@latest rastrea el canal más reciente y recibe nuevas versiones tan pronto como se lanzan.

winget install Anthropic.ClaudeCode

También puede instalar con apt, dnf, o apk en Debian, Fedora, RHEL y Alpine.

Para confirmar que la instalación funcionó, ejecute:

claude --version

El comando imprime un número de versión seguido de (Claude Code).

Paso 2: Inicie sesión en su cuenta

Claude Code requiere una cuenta para usarse. Inicie una sesión interactiva con el comando claude y se le pedirá que inicie sesión en el primer uso:

claude

Para cuentas de suscripción de Claude o Console, siga las indicaciones para completar la autenticación en su navegador. Si ha establecido la variable de entorno ANTHROPIC_API_KEY, Claude Code omite la solicitud de inicio de sesión y le pide que apruebe la clave en su lugar. Para cambiar de cuenta más tarde o volver a autenticarse, escriba /login dentro de la sesión en ejecución:

/login

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 Cloud's Agent Platform o Microsoft Foundry (proveedores de nube empresariales)
Una puerta de enlace Claude apps gateway autohospedada, si su organización ejecuta una: su administrador preconfiguración la URL de la puerta de enlace, y /login abre directamente en la pantalla Cloud gateway para que inicie sesión con SSO corporativo

Una vez que haya iniciado sesión, sus credenciales se almacenan y no necesitará iniciar sesión nuevamente. Obtenga más información en Gestión de credenciales.

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

Reemplace /path/to/your/project con la ruta del proyecto en el que desea trabajar.

Verá la pantalla de Claude Code con la versión, el modelo actual y el directorio de trabajo mostrados arriba. Escriba /help para ver los comandos disponibles o /resume para continuar una conversación anterior.

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?

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 encuentra el archivo apropiado y le muestra el cambio. Si pregunta antes de realizar el cambio, seleccione Sí para aprobar.

El modo Auto es el modo de permiso de inicio integrado para sesiones de terminal interactivas en planes Pro, Max y Team: un clasificador revisa las acciones en lugar de usted, y Claude edita la mayoría de los archivos y ejecuta la mayoría de los comandos sin preguntar. En otros planes, el modo Manual es el modo de permiso de inicio integrado. Para la sesión que inicia justo después de instalar, consulte Primera sesión después de una instalación o actualizació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

Comandos esenciales

Aquí están los comandos más importantes para el uso diario. Los comandos de shell se ejecutan desde su terminal para iniciar o reanudar Claude Code. Los comandos de sesión se ejecutan dentro de Claude Code después de que se inicia.

Comandos de shell

Comando	Qué hace	Ejemplo
`claude`	Inicia el modo interactivo	`claude`
`claude "task"`	Inicia el modo interactivo con un mensaje inicial	`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`

Comandos de sesión

Comando	Qué hace	Ejemplo
`/clear`	Borra el historial de conversación	`/clear`
`/help`	Muestra los comandos disponibles	`/help`
`/exit` o Ctrl+D dos veces	Salir de Claude Code	`/exit`

Consulte la referencia de CLI para obtener una lista completa de comandos de shell y la referencia de comandos para obtener una 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.

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

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 disponibles
Utilice Tab para completar comandos
Presione ↑ para el historial de comandos
Presione Shift+Tab para ciclar a través de los modos de permisos

¿Qué sigue?

Ahora que ha aprendido lo básico, explore funciones más avanzadas:

microchip Cómo funciona Claude Code

Comprenda el bucle de agente, las herramientas integradas y cómo Claude Code interactúa con su proyecto

star Mejores prácticas

Obtenga mejores resultados con indicaciones efectivas y configuración de proyecto

graduation-cap Flujos de trabajo comunes

Guías paso a paso para tareas comunes

puzzle-piece Extiende Claude Code

Personalice con CLAUDE.md, skills, hooks, MCP y más

Obtener ayuda

En Claude Code: Escriba /help o pregunte "¿cómo..."
Documentación: ¡Está aquí! Explore otras guías
Comunidad: Únase a nuestro Discord para consejos y soporte

quickstart.md +10 −10

27 Paso 1: Instalar Claude Code27 Paso 1: Instalar Claude Code

28</h2>28</h2>

29 29

~~30To install Claude Code, use one of the following methods:~~30Para instalar Claude Code, utilice uno de los siguientes métodos:

31 31

32<Tabs>32<Tabs>

~~33 <Tab title="Native Install (Recommended)">~~33 <Tab title="Instalación nativa (recomendado)">

34 **macOS, Linux, WSL:**34 **macOS, Linux, WSL:**

35 35

36 ```bash theme={null}36 ```bash theme={null}

49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50 ```50 ```

51 51

52 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.52 Si ve `The token '&&' is not a valid statement separator`, está en PowerShell, no en CMD. Si ve `'irm' is not recognized as an internal or external command`, está en CMD, no en PowerShell. Su símbolo del sistema muestra `PS C:\` cuando está en PowerShell y `C:\` sin el `PS` cuando está en CMD.

53 53

54 If the install command fails with `syntax error near unexpected token '<'`, a `403`, or another curl error, see [Troubleshoot installation](/docs/en/troubleshoot-install#find-your-error) to match the error to a fix and for alternative install methods.54 Si el comando de instalación falla con `syntax error near unexpected token '<'`, un `403`, u otro error de curl, consulte [Solucionar problemas de instalación](/docs/es/troubleshoot-install#find-your-error) para hacer coincidir el error con una solución y para conocer métodos de instalación alternativos.

55 55

56 [Git for Windows](https://git-scm.com/downloads/win) 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.56 Se recomienda [Git for Windows](https://git-scm.com/downloads/win) 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.

57 57

58 <Info>58 <Info>

~~59 Native installations automatically update in the background to keep you on the latest version.~~59 Las instalaciones nativas se actualizan automáticamente en segundo plano para mantenerlo en la versión más reciente.

60 </Info>60 </Info>

61 </Tab>61 </Tab>

62 62

65 brew install --cask claude-code65 brew install --cask claude-code

66 ```66 ```

67 67

68 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.68 Homebrew ofrece dos casks. `claude-code` rastrea el canal de versión estable, que típicamente está aproximadamente una semana atrás y omite versiones con regresiones importantes. `claude-code@latest` rastrea el canal más reciente y recibe nuevas versiones tan pronto como se lanzan.

69 69

70 <Info>70 <Info>

71 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.71 Las instalaciones de Homebrew no se actualizan automáticamente. Ejecute `brew upgrade claude-code` o `brew upgrade claude-code@latest`, dependiendo de cuál cask haya instalado, para obtener las características más recientes y correcciones de seguridad.

72 </Info>72 </Info>

73 </Tab>73 </Tab>

74 74

78 ```78 ```

79 79

80 <Info>80 <Info>

~~81 WinGet installations do not auto-update. Run `winget upgrade Anthropic.ClaudeCode` periodically to get the latest features and security fixes.~~81 Las instalaciones de WinGet no se actualizan automáticamente. Ejecute `winget upgrade Anthropic.ClaudeCode` periódicamente para obtener las características más recientes y correcciones de seguridad.

82 </Info>82 </Info>

83 </Tab>83 </Tab>

84</Tabs>84</Tabs>

85 85

~~86You can also install with [apt, dnf, or apk](/docs/en/setup#install-with-linux-package-managers) on Debian, Fedora, RHEL, and Alpine.~~86También puede instalar con [apt, dnf, o apk](/docs/es/setup#install-with-linux-package-managers) en Debian, Fedora, RHEL y Alpine.

87 87

88Para confirmar que la instalación funcionó, ejecute:88Para confirmar que la instalación funcionó, ejecute:

89 89

quickstart.md 2026-09-11 23:01 UTC to 2026-09-12 03:02 UTC

Inicio rápido

Antes de comenzar

Paso 1: Instalar Claude Code

Paso 2: Inicie sesión en su cuenta

Paso 3: Inicie su primera sesión

Paso 4: Haga su primera pregunta

Paso 5: Realice su primer cambio de código

Paso 6: Use Git con Claude Code

Paso 7: Corrija un error o agregue una función

Paso 8: Pruebe otros flujos de trabajo comunes

Comandos esenciales

Consejos profesionales para principiantes

¿Qué sigue?

Obtener ayuda