Inicio rápido

Instala Claude Code en tu terminal, inicia sesión y usa la CLI para explorar tu base de código y hacer tu primer cambio de código.

Esta guía de inicio rápido cubre Claude Code en tu terminal: cómo instalar la CLI, iniciar sesión desde tu primera sesión y usarlo para tareas comunes de desarrollo en tu propio proyecto.

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

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.

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

En Windows, tu prompt muestra PS C:\ cuando estás en PowerShell y C:\ sin el PS cuando estás en CMD.

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

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 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.

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: Inicia tu primera sesión

Abre tu terminal en cualquier directorio de proyecto e inicia Claude Code:

cd /path/to/your/project
claude

Reemplaza /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 /login se abre directamente en la pantalla Cloud gateway para que inicies sesión con el SSO corporativo

Una vez que inicies sesión, tus credenciales se almacenan y no necesitarás volver a iniciar sesión. Obtén más información en Gestión de credenciales.

El prompt de Claude Code aparece con la versión, el modelo actual y el directorio de trabajo mostrados encima. Escribe /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:

what does this project do?

Claude analizará tus archivos y te dará un resumen. También puedes hacer preguntas más específicas:

what technologies does this project use?

where is the main entry point?

explain the folder structure

También puedes preguntarle a Claude sobre sus propias capacidades:

what can Claude Code do?

how do I create custom skills in Claude Code?

can Claude Code work with Docker?

Paso 4: Haz tu primer cambio de código

Prueba una tarea pequeña:

add a hello world function to the main file

Claude Code encuentra el archivo adecuado y te muestra el cambio. Si te pregunta antes de hacer el cambio, selecciona Yes para aprobarlo.

El modo de permisos de la sesión define qué acciones puede realizar Claude sin preguntarte primero. Presiona 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:

what files have I changed?

commit my changes with a descriptive message

También puedes pedir operaciones de Git más complejas:

create a new branch called feature/quickstart

show me the last 5 commits

help me resolve merge conflicts

Paso 6: Corrige un error o agrega una función

Describe lo que quieres en lenguaje natural:

add input validation to the user registration form

O corrige problemas existentes:

there's a bug where users can submit empty forms - fix it

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:

refactor the authentication module to use async/await instead of callbacks

write unit tests for the calculator functions

update the README with installation instructions

review my changes and suggest improvements

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.

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`

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.

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`

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.

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 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

Consulta la configuración avanzada para ver opciones de instalación, actualizaciones manuales o instrucciones de desinstalación.

Obtener ayuda

En Claude Code: escribe /help o 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

quickstart.md +16 −14

53 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd53 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

54 ```54 ```

55 55

56 Cuando el instalador termine, abra una nueva ventana de terminal y ejecute `claude --version`. Una instalación que funciona correctamente imprime un número de versión. Si su shell dice que `claude` no se encuentra o no se reconoce, el directorio de instalación aún no está en su PATH: consulte [Corrija su PATH](/docs/es/troubleshoot-install#command-not-found-claude-after-installation).56 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 `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](/docs/es/troubleshoot-install#command-not-found-claude-after-installation).

57 57

58 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.58 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.

59 59

229 Paso 7: Prueba otros flujos de trabajo comunes229 Paso 7: Prueba otros flujos de trabajo comunes

230</h2>230</h2>

231 231

232Hay varias formas de trabajar con Claude:232Prueba algunos prompts más. Puedes pedirle a Claude que refactorice código, escriba pruebas, actualice la documentación o revise tus cambios:

~~233~~

234**Refactorizar código**

235 233

236```text wrap theme={null}234```text wrap theme={null}

237refactor the authentication module to use async/await instead of callbacks235refactor the authentication module to use async/await instead of callbacks

238```236```

239 237

240**Escribir pruebas**

~~241~~

242```text wrap theme={null}238```text wrap theme={null}

243write unit tests for the calculator functions239write unit tests for the calculator functions

244```240```

245 241

246**Actualizar la documentación**

~~247~~

248```text wrap theme={null}242```text wrap theme={null}

249update the README with installation instructions243update the README with installation instructions

250```244```

251 245

252**Revisión de código**

~~253~~

254```text wrap theme={null}246```text wrap theme={null}

255review my changes and suggest improvements247review my changes and suggest improvements

256```248```

263 Comandos esenciales255 Comandos esenciales

264</h2>256</h2>

265 257

266Aquí 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.258Aquí están los comandos más importantes para el uso diario, agrupados según dónde los ejecutas.

267 259

268**Comandos de shell**260<h3 id="shell-commands">

261 Comandos de shell

262</h3>

263

264Ejecuta estos desde tu terminal para iniciar o reanudar Claude Code.

269 265

271| - | - | - |267| - | - | - |

277 273

278**Comandos de sesión**274Consulta la [referencia de CLI](/docs/es/cli-reference) para ver la lista completa de comandos de shell.

275

276<h3 id="session-commands">

277 Comandos de sesión

278</h3>

279

280Ejecuta estos dentro de Claude Code después de que se inicia.

279 281

281| - | - | - |283| - | - | - |

285 287

286Consulte la [referencia de CLI](/docs/es/cli-reference) para obtener una lista completa de comandos de shell y la [referencia de comandos](/docs/es/commands) para obtener una lista completa de comandos de sesión.288Consulta la [referencia de comandos](/docs/es/commands) para ver la lista completa de comandos de sesión.

287 289

288<h2 id="pro-tips-for-beginners">290<h2 id="pro-tips-for-beginners">

289 Consejos profesionales para principiantes291 Consejos profesionales para principiantes

quickstart.md 2026-10-07 23:59 UTC to 2026-10-08 04:58 UTC

Inicio rápido

Antes de comenzar

Paso 1: Instalar Claude Code

Paso 2: Inicia tu primera sesión

Paso 3: Haz tu primera pregunta

Paso 4: Haz tu primer cambio de código

Paso 5: Usa Git con Claude Code

Paso 6: Corrige un error o agrega una función

Paso 7: Prueba otros flujos de trabajo comunes

Comandos esenciales

Comandos de shell

Comandos de sesión

Consejos profesionales para principiantes

¿Qué sigue?

Obtener ayuda