4 4
5# Inicio rápido5# Inicio rápido
6 6
7> ¡Bienvenido a Claude Code!7> 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.
8 8
9Esta 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.9Esta 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.
10 10
11<h2 id="before-you-begin">11<h2 id="before-you-begin">
12 Antes de comenzar12 Antes de comenzar
13</h2>13</h2>
14 14
15Asegúrese de tener:15Asegúrate de tener:
16 16
17* Una terminal o símbolo del sistema abiertos17* Una terminal o prompt de comandos abiertos
18 * Si nunca ha usado la terminal antes, consulte la [guía de terminal](/docs/es/terminal-guide)
19* Un proyecto de código con el que trabajar18* Un proyecto de código con el que trabajar
20* Una [suscripción a Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_prereq) (Pro, Max, Team o Enterprise), una cuenta de [Claude Console](https://platform.claude.com/), o acceso a través de un [proveedor de nube compatible](/docs/es/third-party-integrations)19* Una [suscripción a Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_prereq) (Pro, Max, Team o Enterprise), una cuenta de [Claude Console](https://platform.claude.com/), o acceso a través de un [proveedor de nube compatible](/docs/es/third-party-integrations)
21 20
22<Note>21<Note>
23 Esta guía cubre la CLI de terminal. Claude Code también está disponible en la [web](https://claude.ai/code), como una [aplicación de escritorio](/docs/es/desktop), en [VS Code](/docs/es/vs-code) e [IDEs de JetBrains](/docs/es/jetbrains), en [Slack](/docs/es/slack), y en CI/CD con [GitHub Actions](/docs/es/github-actions) y [GitLab](/docs/es/gitlab-ci-cd). Consulte [todas las interfaces](/docs/es/overview#use-claude-code-everywhere).22 Estos casos se tratan en otras páginas:
23
24 * **Nunca has usado una terminal**: comienza con la [guía de terminal](/docs/es/terminal-guide)
25 * **Quieres usar Claude Code en otro lugar que no sea la terminal**: Claude Code también está disponible en la [web](https://claude.ai/code), como una [aplicación de escritorio](/docs/es/desktop), en [VS Code](/docs/es/vs-code) e [IDEs de JetBrains](/docs/es/jetbrains), en [Slack](/docs/es/slack), y en CI/CD con [GitHub Actions](/docs/es/github-actions) y [GitLab](/docs/es/gitlab-ci-cd). Consulta [todas las interfaces](/docs/es/overview#use-claude-code-everywhere).
24</Note>26</Note>
25 27
26<h2 id="step-1-install-claude-code">28<h2 id="step-1-install-claude-code">
33 <Tab title="Instalación nativa (recomendado)">35 <Tab title="Instalación nativa (recomendado)">
34 **macOS, Linux, WSL:**36 **macOS, Linux, WSL:**
35 37
36 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}38 ```bash theme={null}
37 curl -fsSL https://claude.ai/install.sh | bash39 curl -fsSL https://claude.ai/install.sh | bash
38 ```40 ```
39 41
42 En Windows, tu prompt muestra `PS C:\` cuando estás en PowerShell y `C:\` sin el `PS` cuando estás en CMD.
43
40 **Windows PowerShell:**44 **Windows PowerShell:**
41 45
42 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}46 ```powershell theme={null}
43 irm https://claude.ai/install.ps1 | iex47 irm https://claude.ai/install.ps1 | iex
44 ```48 ```
45 49
46 **Windows CMD:**50 **Windows CMD:**
47 51
48 ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}52 ```batch theme={null}
49 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
50 ```54 ```
51 55
52 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 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).
53 57
54 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.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.
55 59
56 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.60 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](/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.
57 61
58 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.62 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.
59 63
63 </Tab>67 </Tab>
64 68
65 <Tab title="Homebrew">69 <Tab title="Homebrew">
66 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}70 ```bash theme={null}
67 brew install --cask claude-code71 brew install --cask claude-code
68 ```72 ```
69 73
75 </Tab>79 </Tab>
76 80
77 <Tab title="WinGet">81 <Tab title="WinGet">
78 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}82 ```powershell theme={null}
79 winget install Anthropic.ClaudeCode83 winget install Anthropic.ClaudeCode
80 ```84 ```
81 85
95 99
96El comando imprime un número de versión seguido de `(Claude Code)`.100El comando imprime un número de versión seguido de `(Claude Code)`.
97 101
98<h2 id="step-2-log-in-to-your-account">102<h2 id="step-2-start-your-first-session">
99 Paso 2: Inicie sesión en su cuenta103 Paso 2: Inicia tu primera sesión
100</h2>104</h2>
101 105
102Claude 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:106Abre tu terminal en cualquier directorio de proyecto e inicia Claude Code:
103 107
104```bash theme={null}108```bash theme={null}
109cd /path/to/your/project
105claude110claude
106```111```
107 112
108Para 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:113Reemplaza `/path/to/your/project` con la ruta al proyecto en el que quieres trabajar.
109 114
110```text wrap theme={null}115Claude 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.
111/login
112```
113 116
114Puede iniciar sesión usando cualquiera de estos tipos de cuenta:117Puedes iniciar sesión con cualquiera de estos tipos de cuenta:
115 118
116* [Claude Pro, Max, Team o Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (recomendado)119* [Claude Pro, Max, Team o Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (recomendado)
117* [Claude Console](https://platform.claude.com/) (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.120* [Claude Console](https://platform.claude.com/) (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.
118* [Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry](/docs/es/third-party-integrations) (proveedores de nube empresariales)121* [Amazon Bedrock, Agent Platform de Google Cloud o Microsoft Foundry](/docs/es/third-party-integrations) (proveedores de nube empresariales)
119* Una puerta de enlace [Claude apps gateway](/docs/es/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 corporativo122* Un [gateway de aplicaciones de Claude](/docs/es/claude-apps-gateway) 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
120
121Una 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](/docs/es/authentication#credential-management).
122
123<h2 id="step-3-start-your-first-session">
124 Paso 3: Inicie su primera sesión
125</h2>
126
127Abra su terminal en cualquier directorio de proyecto e inicie Claude Code:
128
129```bash theme={null}
130cd /path/to/your/project
131claude
132```
133 123
134Reemplace `/path/to/your/project` con la ruta del proyecto en el que desea trabajar.124Una 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](/docs/es/authentication#credential-management).
135 125
136Verá 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.126El 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.
137 127
138<h2 id="step-4-ask-your-first-question">128<h2 id="step-3-ask-your-first-question">
139 Paso 4: Haga su primera pregunta129 Paso 3: Haz tu primera pregunta
140</h2>130</h2>
141 131
142Comienza por entender tu base de código. Prueba uno de estos comandos:132Prueba uno de estos comandos:
143 133
144```text wrap theme={null}134```text wrap theme={null}
145¿qué hace este proyecto?135what does this project do?
146```136```
147 137
148Claude analizará sus archivos y proporcionará un resumen. También puede hacer preguntas más específicas:138Claude analizará tus archivos y te dará un resumen. También puedes hacer preguntas más específicas:
149 139
150```text wrap theme={null}140```text wrap theme={null}
151¿qué tecnologías usa este proyecto?141what technologies does this project use?
152```142```
153 143
154```text wrap theme={null}144```text wrap theme={null}
155¿dónde está el punto de entrada principal?145where is the main entry point?
156```146```
157 147
158```text wrap theme={null}148```text wrap theme={null}
159explique la estructura de carpetas149explain the folder structure
160```150```
161 151
162También puede preguntarle a Claude sobre sus propias capacidades:152También puedes preguntarle a Claude sobre sus propias capacidades:
163 153
164```text wrap theme={null}154```text wrap theme={null}
165¿qué puede hacer Claude Code?155what can Claude Code do?
166```156```
167 157
168```text wrap theme={null}158```text wrap theme={null}
169¿cómo creo skills personalizados en Claude Code?159how do I create custom skills in Claude Code?
170```160```
171 161
172```text wrap theme={null}162```text wrap theme={null}
173¿puede Claude Code trabajar con Docker?163can Claude Code work with Docker?
174```164```
175 165
176<Note>166<Note>
177 Claude Code lee los archivos de su proyecto según sea necesario. No tiene que agregar contexto manualmente.167 Claude Code lee los archivos de tu proyecto según sea necesario. No tienes que agregar contexto manualmente.
178</Note>168</Note>
179 169
180<h2 id="step-5-make-your-first-code-change">170<h2 id="step-4-make-your-first-code-change">
181 Paso 5: Realice su primer cambio de código171 Paso 4: Haz tu primer cambio de código
182</h2>172</h2>
183 173
184Ahora haz que Claude Code escriba código real. Prueba una tarea simple:174Prueba una tarea pequeña:
185 175
186```text wrap theme={null}176```text wrap theme={null}
187agrega una función hello world al archivo principal177add a hello world function to the main file
188```178```
189 179
190Claude Code encuentra el archivo apropiado y le muestra el cambio. Si pregunta antes de realizar el cambio, seleccione **Sí** para aprobar.180Claude Code encuentra el archivo adecuado y te muestra el cambio. Si te pregunta antes de hacer el cambio, selecciona **Yes** para aprobarlo.
191 181
192Con Claude Code v2.1.283 o posterior, el modo auto es el [modo de permiso de inicio integrado](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) para sesiones de terminal interactivas: 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 versiones anteriores, el modo auto es el modo de permiso de inicio integrado solo en planes Pro, Max y Team. Para la sesión que inicia justo después de instalar, consulte [Primera sesión después de una instalación o actualización](/docs/es/env-vars#first-session-after-an-install-or-upgrade).182El [modo de permisos](/docs/es/permission-modes) 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.
193
194<Note>
195 Su configuración u organización puede establecer un modo de permiso de inicio diferente. [Qué modo de permiso inicia una sesión](/docs/es/permission-modes#which-mode-a-session-starts-in) enumera lo que hace. Presione `Shift+Tab` en cualquier momento para cambiar el modo de permiso de la sesión en la que se encuentra.
196</Note>
197 183
198<h2 id="step-6-use-git-with-claude-code">184<h2 id="step-5-use-git-with-claude-code">
199 Paso 6: Use Git con Claude Code185 Paso 5: Usa Git con Claude Code
200</h2>186</h2>
201 187
202Claude Code hace que las operaciones de Git sean conversacionales:188Claude Code convierte las operaciones de Git en una conversación:
203 189
204```text wrap theme={null}190```text wrap theme={null}
205¿qué archivos he cambiado?191what files have I changed?
206```192```
207 193
208```text wrap theme={null}194```text wrap theme={null}
209confirma mis cambios con un mensaje descriptivo195commit my changes with a descriptive message
210```196```
211 197
212También puede solicitar operaciones de Git más complejas:198También puedes pedir operaciones de Git más complejas:
213 199
214```text wrap theme={null}200```text wrap theme={null}
215crea una nueva rama llamada feature/quickstart201create a new branch called feature/quickstart
216```202```
217 203
218```text wrap theme={null}204```text wrap theme={null}
219muéstrame los últimos 5 commits205show me the last 5 commits
220```206```
221 207
222```text wrap theme={null}208```text wrap theme={null}
223ayúdame a resolver conflictos de fusión209help me resolve merge conflicts
224```210```
225 211
226<h2 id="step-7-fix-a-bug-or-add-a-feature">212<h2 id="step-6-fix-a-bug-or-add-a-feature">
227 Paso 7: Corrija un error o agregue una función213 Paso 6: Corrige un error o agrega una función
228</h2>214</h2>
229 215
230Claude es competente en depuración e implementación de funciones.216Describe lo que quieres en lenguaje natural:
231
232Describa lo que desea en lenguaje natural:
233 217
234```text wrap theme={null}218```text wrap theme={null}
235agrega validación de entrada al formulario de registro de usuarios219add input validation to the user registration form
236```220```
237 221
238O corrija problemas existentes:222O corrige problemas existentes:
239 223
240```text wrap theme={null}224```text wrap theme={null}
241hay un error donde los usuarios pueden enviar formularios vacíos - corrígelo225there's a bug where users can submit empty forms - fix it
242```226```
243 227
244Claude Code hará lo siguiente:228<h2 id="step-7-test-out-other-common-workflows">
245 229 Paso 7: Prueba otros flujos de trabajo comunes
246* Localizará el código relevante
247* Comprenderá el contexto
248* Implementará una solución
249* Ejecutará pruebas si están disponibles
250
251<h2 id="step-8-test-out-other-common-workflows">
252 Paso 8: Pruebe otros flujos de trabajo comunes
253</h2>230</h2>
254 231
255Hay varias formas de trabajar con Claude:232Hay varias formas de trabajar con Claude:
257**Refactorizar código**234**Refactorizar código**
258 235
259```text wrap theme={null}236```text wrap theme={null}
260refactoriza el módulo de autenticación para usar async/await en lugar de callbacks237refactor the authentication module to use async/await instead of callbacks
261```238```
262 239
263**Escribir pruebas**240**Escribir pruebas**
264 241
265```text wrap theme={null}242```text wrap theme={null}
266escribe pruebas unitarias para las funciones de calculadora243write unit tests for the calculator functions
267```244```
268 245
269**Actualizar documentación**246**Actualizar la documentación**
270 247
271```text wrap theme={null}248```text wrap theme={null}
272actualiza el README con instrucciones de instalación249update the README with installation instructions
273```250```
274 251
275**Revisión de código**252**Revisión de código**
276 253
277```text wrap theme={null}254```text wrap theme={null}
278revisa mis cambios y sugiere mejoras255review my changes and suggest improvements
279```256```
280 257
281<Tip>258<Tip>
282 Hable con Claude como lo haría con un colega útil. Describa lo que desea lograr y le ayudará a llegar allí.259 Habla con Claude como lo harías con un colega servicial. Describe lo que quieres lograr y te ayudará a conseguirlo.
283</Tip>260</Tip>
284 261
285<h2 id="essential-commands">262<h2 id="essential-commands">
355 ¿Qué sigue?332 ¿Qué sigue?
356</h2>333</h2>
357 334
358Ahora que ha aprendido lo básico, explore funciones más avanzadas:335Ahora que aprendiste lo básico, explora funciones más avanzadas:
359
360<CardGroup cols={2}>
361 <Card title="Cómo funciona Claude Code" icon="microchip" href="/docs/es/how-claude-code-works">
362 Comprenda el bucle de agente, las herramientas integradas y cómo Claude Code interactúa con su proyecto
363 </Card>
364
365 <Card title="Mejores prácticas" icon="star" href="/docs/es/best-practices">
366 Obtenga mejores resultados con indicaciones efectivas y configuración de proyecto
367 </Card>
368 336
369 <Card title="Flujos de trabajo comunes" icon="graduation-cap" href="/docs/es/common-workflows">337* [Cómo funciona Claude Code](/docs/es/how-claude-code-works): comprende el bucle agéntico, las herramientas integradas y cómo Claude Code interactúa con tu proyecto
370 Guías paso a paso para tareas comunes338* [Buenas prácticas](/docs/es/best-practices): obtén mejores resultados con indicaciones efectivas y una buena configuración del proyecto
371 </Card>339* [Flujos de trabajo comunes](/docs/es/common-workflows): guías paso a paso para tareas comunes
340* [Extiende Claude Code](/docs/es/features-overview): personaliza con CLAUDE.md, skills, hooks, MCP y más
372 341
373 <Card title="Extiende Claude Code" icon="puzzle-piece" href="/docs/es/features-overview">342Consulta la [configuración avanzada](/docs/es/setup) para ver opciones de instalación, actualizaciones manuales o instrucciones de desinstalación.
374 Personalice con CLAUDE.md, skills, hooks, MCP y más
375 </Card>
376</CardGroup>
377 343
378<h2 id="getting-help">344<h2 id="getting-help">
379 Obtener ayuda345 Obtener ayuda
380</h2>346</h2>
381 347
382* **En Claude Code**: Escriba `/help` o pregunte "¿cómo..."348* **En Claude Code**: escribe `/help` o haz una pregunta del tipo "¿cómo hago...?"
383* **Documentación**: ¡Está aquí! Explore otras guías349* **Documentación**: explora las otras guías de este sitio
384* **Cursos**: Tome [Claude Code 101](https://academy.claude.com/courses/claude-code-101) y otros cursos gratuitos a su propio ritmo en [Claude Academy](https://academy.claude.com/)350* **Cursos**: toma [Claude Code 101](https://academy.claude.com/courses/claude-code-101) y otros cursos gratuitos a tu propio ritmo en [Claude Academy](https://academy.claude.com/)
385* **Comunidad**: Únete al [servidor de Discord](https://www.anthropic.com/discord) para obtener consejos y soporte351* **Comunidad**: únete al [servidor de Discord](https://www.anthropic.com/discord) para obtener consejos y soporte