Puede usar Claude Code incluso si nunca ha usado una terminal antes. Esta guía le explica cómo abrir una terminal, instalar Claude Code e interactuar por primera vez.Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
macOS y Linux
Siga estos pasos para instalar e iniciar Claude Code desde una terminal de macOS o Linux. Claude Code requiere macOS 13.0 o posterior. Consulte los requisitos del sistema para las distribuciones de Linux compatibles.Abrir una terminal
Cmd + Space para abrir Spotlight Search, escriba Terminal y presione Enter.Linux: Abra su aplicación de terminal. En la mayoría de las distribuciones, presione Ctrl + Alt + T o busque “Terminal” en su menú de aplicaciones.Aparecerá una ventana con un cursor parpadeante. Esta es su terminal, donde escribe comandos.Instalar Claude Code
Cmd + V en macOS, Ctrl + Shift + V en Linux) y presione Enter:Iniciar Claude Code
claude y presione Enter:Comenzar a usar Claude Code
Enter para enviarlos. Algunas cosas que debe saber:- No puede hacer clic en cosas en la terminal. Use las teclas de flecha para moverse.
- Presione
Escpara interrumpir a Claude si se está ejecutando. - Escriba
exito presioneCtrl + Dpara salir de Claude Code. - Escriba
/helppara ver los comandos disponibles.
Windows
Siga estos pasos para instalar Git, configurar PowerShell e iniciar Claude Code en Windows. Claude Code requiere Windows 10 versión 1809 o posterior. Consulte los requisitos del sistema para obtener detalles completos.Instalar Git para Windows
- Vaya a git-scm.com/downloads/win y descargue el instalador
- Ejecute el instalador. Haga clic en Siguiente en cada pantalla para aceptar los valores predeterminados. El instalador tiene muchas pantallas, pero no necesita cambiar nada.
- Si le pide que elija un editor, mantenga el predeterminado y haga clic en Siguiente.
- Cuando vea “Ajustando su entorno PATH”, mantenga la opción recomendada seleccionada.
Abrir PowerShell
Win + X y seleccione Windows PowerShell (o Terminal) del menú. Aparecerá una ventana con un cursor parpadeante. Aquí es donde escribirá comandos.- PowerShell: muestra
PS C:\Users\YourName>al inicio de cada línea - CMD: muestra
C:\Users\YourName>sin elPS
Instalar Claude Code
Ctrl + V o haga clic derecho, y presione Enter:irm obtiene el archivo e iex lo ejecuta. Verá texto desplazándose mientras funciona. Cuando termine, verá “¡Claude Code instalado correctamente!” Si ve un error en su lugar, consulte la sección de solución de problemas a continuación.Iniciar Claude Code
claude recién instalado. Luego escriba:Comenzar a usar Claude Code
Enter para enviarlos. Algunas cosas que debe saber:- No puede hacer clic en cosas en la terminal. Use las teclas de flecha para moverse.
- Presione
Escpara interrumpir a Claude si se está ejecutando. - Escriba
exito presioneCtrl + Dpara salir de Claude Code. - Escriba
/helppara ver los comandos disponibles.
¿Qué sigue?
Una vez que vea la pantalla de bienvenida de Claude Code, está listo para comenzar. No necesita saber cómo codificar. Describa lo que desea en inglés simple, y Claude escribe el código por usted.Construir algo
Claude puede crear proyectos a partir de una descripción:Trabajar con archivos en su computadora
Claude puede leer y organizar archivos que ya tiene:Hacer preguntas
Claude puede explicar cosas, ayudarle a aprender o planificar un proyecto:Otras formas de usar Claude Code
No tiene que usar la terminal. Claude Code también está disponible en:- VS Code y JetBrains IDEs como extensiones de editor
- La aplicación de escritorio, sin terminal requerida
- La web en claude.ai/code para sesiones remotas
- GitHub Actions y GitLab CI/CD para automatización
Obtener más información
- Inicio rápido: un recorrido guiado de su primer proyecto con Claude Code
- Cómo funciona Claude Code: comprenda cómo Claude lee sus archivos, ejecuta comandos y realiza ediciones
- Mejores prácticas: obtenga mejores resultados con indicaciones efectivas y configuración de proyectos
- Flujos de trabajo comunes: guías paso a paso para depuración, pruebas, refactorización y más
- Configuración de terminal: personalice su terminal para la mejor experiencia de Claude Code
Solución de problemas
Solución de problemas de macOS y Linux
Si tiene problemas al instalar en macOS o Linux, consulte estos problemas comunes:'command not found: claude'
'command not found: claude'
command not found: claude después de instalar, su terminal necesita recargar su configuración. Cierre la ventana de Terminal y abra una nueva, luego intente claude de nuevo.Si aún no funciona, agregue el directorio de instalación a su PATH. Ejecute el comando para su shell:claude de nuevo. Para más detalles, consulte arregle su PATH.Error con código HTML o 'syntax error near unexpected token'
Error con código HTML o 'syntax error near unexpected token'
bash: line 1: syntax error near unexpected token '<' o código HTML como <!DOCTYPE html> en su terminal, la URL de instalación devolvió una página web en lugar del script del instalador.Si la página dice “App unavailable in region”, Claude Code no está disponible en su país. Consulte países compatibles.De lo contrario, intente ejecutar el comando de nuevo. Si sigue sucediendo, instale con Homebrew en su lugar:Error 'dyld' o 'built for Mac OS X 13.0'
Error 'dyld' o 'built for Mac OS X 13.0'
dyld: cannot load, dyld: Symbol not found, o built for Mac OS X 13.0, su versión de macOS probablemente sea más antigua de lo que Claude Code admite.Abra el menú de Apple y seleccione Acerca de esta Mac para verificar su versión. Si es anterior a 13.0, actualice macOS a través de Software Update. Consulte la guía de solución de problemas de macOS para más detalles.Solución de problemas de Windows
Si tiene problemas al instalar en Windows, consulte estos problemas comunes:'irm is not recognized'
'irm is not recognized'
Win + X luego seleccione Windows PowerShell).Alternativamente, use el comando de instalación de CMD:Error SSL/TLS o 'Could not create SSL/TLS secure channel'
Error SSL/TLS o 'Could not create SSL/TLS secure channel'
'Claude Code on Windows requires either Git for Windows (for bash) or PowerShell'
'Claude Code on Windows requires either Git for Windows (for bash) or PowerShell'
- Si aún no ha instalado Git, vuelva al primer paso en la sección de Windows. Alternativamente, instale PowerShell 7.
- Si Git está instalado pero Claude Code no puede encontrarlo, dígale dónde buscar:
Luego ejecute
claudede nuevo. Si su Git está instalado en otro lugar, encuentre la ruta ejecutando:Busque la carpetaGit\binen esa ruta y úsela en su lugar.
'claude is not recognized'
'claude is not recognized'
claude de nuevo. Consulte verifique su PATH para más detalles.