Instalar e iniciar Claude Code en Mac y en Windows
Esta lección todavía está en pruebas: mejora con los comentarios de quienes la siguen. Si algo no está claro, hay que corregir la lección, no a ti.
Seguir esta lección con Claude Code
Con el compañero del curso instalado, abre Claude Code en tu carpeta de trabajo y escribe:
/formation-ia:suivre m04-l02 esLee esta lección actualizada en el sitio y te acompaña paso a paso, sin cambiar nada sin tu consentimiento. Instalar el compañero. Claude Code no está incluido en el plan gratuito: una suscripción de Claude compatible o una cuenta de Console facturada por uso para la terminal.
Al final de esta lección, sabrás
- instalar la app Claude en tu computadora y encontrar en ella Claude Code;
- crear una carpeta de trabajo dedicada y abrirla en Claude Code;
- elegir el modo Manual, en el que el agente pregunta antes de actuar;
- tener tu primer intercambio con Claude Code y luego volver a encontrar tu sesión.
Por qué te interesa
Es la única parte un poco técnica del módulo, y solo se hace una vez. Después, cada sesión empieza de la misma manera: abres la app, tu carpeta, y escribes.
Antes de empezar
| Necesitas | Una computadora con macOS 13 o más reciente, o Windows 10 o más reciente, y una conexión a internet. Para la opción terminal: Windows 10 versión 1809 o más reciente, y al menos 4 GB de memoria |
| Suscripción | Claude Pro como mínimo: 18 € al mes sin IVA, o 15 € al mes pagando el año (claude.com/pricing, precios mostrados en Francia el 24/10/2026). Estos precios no incluyen los impuestos aplicables, que se suman. El plan gratuito no da acceso a Claude Code |
| Duración | 45 minutos |
| Lo que no debes hacer | Abrirle a Claude Code una carpeta que contenga documentos confidenciales o los de tu empleador |
Entenderlo en 3 minutos
Dos maneras de usar Claude Code:
| La app Claude para computadora, pestaña Code | La terminal | |
|---|---|---|
| Para quién | Para empezar: todo se hace con clics | Más adelante, si ya te manejas con los comandos |
| Instalación | Descargar la app en claude.com/download | Un comando que copiar (ver el final de la lección) |
| Modo al empezar | Se elige en el selector, debajo de la zona de texto | Auto, desde la versión 2.1.283 (hay que cambiarlo para empezar) |
La carpeta de trabajo: es una carpeta normal de tu computadora, que abres en Claude Code. El agente lee y escribe en ella. En modo Manual, para leer o modificar en otro lugar, tiene que pedirte permiso.
Los modos deciden lo que el agente hace sin preguntarte. En modo Manual, puede leer y listar los archivos de tu carpeta, pero te pregunta antes de crear o modificar un archivo, o de ejecutar un comando que haga algo más que leer. Es el modo adecuado para aprender. La lección 3 presenta los demás.
Hagámoslo juntos
1Paso 1: Instalar la app Claude
En Mac
- Ve a claude.com/download y descarga la app para Mac.
- Abre el archivo descargado y sigue las indicaciones de la pantalla.
- Abre la app Claude desde tu carpeta Aplicaciones e inicia sesión con la cuenta que tiene tu suscripción.
En Windows
- Ve a claude.com/download y descarga la app para Windows: elige Windows, o Windows (arm 64) si tu PC tiene un procesador ARM.
- Abre el archivo descargado y sigue las indicaciones de la pantalla.
- Abre la app Claude desde el menú Inicio e inicia sesión con la cuenta que tiene tu suscripción.
2Paso 2: Crear tu carpeta de trabajo
En Mac
- Abre el Finder y luego tu carpeta Documentos.
- Menú Archivo y luego Nueva carpeta.
- Llámala mon-espace-ia (sin tildes ni espacios: es más sencillo para lo que sigue).
En Windows
- Abre el Explorador de archivos y luego tu carpeta Documentos.
- Haz clic derecho en un espacio vacío, luego Nuevo y luego Carpeta (etiqueta exacta no confirmada).
- Llámala mon-espace-ia (sin tildes ni espacios: es más sencillo para lo que sigue).
3Paso 3: Abrir la carpeta en Claude Code
- En la app Claude, haz clic en la pestaña Code.
- Debajo de la zona de texto, abre el primer menú (el del entorno) y elige la primera entrada del grupo Local: trabajas en tu computadora. Al lado, abre el menú de la carpeta, elige Abrir carpeta… y luego selecciona mon-espace-ia.
- Debajo de la zona de texto, en el selector de modo, elige Manual. La app recuerda esta elección para esa carpeta.
En Mac, una ventana del sistema puede preguntarte si «Claude» (o la Terminal, con la opción terminal) puede acceder a los archivos de tu carpeta Documentos: ahí está mon-espace-ia, acepta. Si lo rechazaste por error, vuelve a dar el acceso en «Configuración del Sistema» (en España: «Ajustes del Sistema»), «Privacidad y seguridad» y luego «Archivos y carpetas».
4Paso 4: Tu primer intercambio
Copia esta solicitud:
Hola. Dime en tres líneas lo que ves en esta carpeta y lo que podrías hacer en ella conmigo. No crees ni modifiques ningún archivo por ahora.
La carpeta está vacía: Claude Code debe decírtelo y proponerte ideas. Compruébalo en el Finder o en el Explorador de archivos: la carpeta sigue vacía.
5Paso 5: Cerrar y volver a encontrar tu sesión
- Cierra la app por completo (en Mac: menú Claude y luego Salir; en Windows: cierra la ventana y, si el icono de Claude se queda cerca del reloj, haz clic derecho en él y luego Salir).
- Vuelve a abrirla y ve a la pestaña Code: tu sesión aparece en la lista. Para empezar de cero, elige Nueva sesión (el botón + arriba de la lista, o Cmd + N en Mac, Ctrl + N en Windows) y luego vuelve a abrir tu carpeta.
Opción: instalar Claude Code en la terminal
Para más adelante, o si ya te manejas con los comandos.
En Mac
Abre la aplicación Terminal (Cmd + barra espaciadora, escribe Terminal y luego presiona la tecla Enter) y pega:
curl -fsSL https://claude.ai/install.sh | bash
La instalación no muestra nada durante unos instantes: deja la ventana abierta y espera el mensaje «Claude Code successfully installed!».
Comprueba la instalación: cierra la ventana de la Terminal, abre una nueva y escribe:
claude --version
Debe aparecer un número de versión. Si la Terminal responde «command not found: claude», pega la línea que el instalador mostró al final (empieza por echo 'export PATH=), luego abre una ventana nueva y vuelve a intentarlo. En un Mac nuevo, es el caso más frecuente.
Después, para iniciar Claude Code en modo Manual en tu carpeta (cd quiere decir «ir a la carpeta»):
cd ~/Documents/mon-espace-ia
claude --permission-mode manual
En Windows
Abre PowerShell (la aplicación de comandos de Windows: escribe «PowerShell» en el menú Inicio) y pega:
irm https://claude.ai/install.ps1 | iex
La instalación no muestra nada durante unos instantes: deja la ventana abierta y espera el mensaje «Claude Code successfully installed!».
Comprueba la instalación: cierra PowerShell, vuelve a abrirlo y escribe claude --version. Debe aparecer un número de versión. Si no, sigue las indicaciones que aparecen al final de la instalación y luego vuelve a abrir PowerShell. Si claude abre la app Claude en lugar de Claude Code, seguramente tu app es antigua: actualízala (lección 6) y vuelve a intentarlo.
Después, para iniciar Claude Code en modo Manual en tu carpeta (esta línea encuentra tu verdadera carpeta Documentos, incluso cuando OneDrive la ha movido):
cd "$([Environment]::GetFolderPath('MyDocuments'))\mon-espace-ia"
claude --permission-mode manual
La documentación también recomienda instalar Git para Windows (opcional: sin él, Claude Code usa PowerShell).
Tanto en Mac como en Windows, la primera vez Claude Code te pide que inicies sesión en tu cuenta y luego que confirmes que confías en la carpeta. Lee la pregunta: para mon-espace-ia, que creaste tú, puedes responder que sí. Comprueba después que la barra de estado, debajo de la zona de escritura, muestra «manual mode on».
Ahora te toca a ti
Vuelve a hacer por tu cuenta, sin mirar la lección, el recorrido de una sesión:
- abre la app, pestaña Code, Nueva sesión;
- abre mon-espace-ia y comprueba el modo Manual;
- pídele: «Explícame en 5 líneas lo que puedes hacer en esta carpeta, y lo que nunca harás sin mi aprobación.»
Compara su respuesta con la lección 1: ¿es coherente?
Comprobar
Funcionó si:
- la pestaña Code se abre en la carpeta mon-espace-ia, en modo Manual;
- Claude Code te respondió sin crear ni modificar ningún archivo;
- cerraste la app y luego volviste a encontrar tu sesión o abriste una nueva sesión.
Errores frecuentes:
- abrir toda la carpeta Documentos, o el escritorio: cierra y vuelve a abrir solo mon-espace-ia;
- no ver la palabra Code: si las pestañas se muestran solo como iconos, pasa el puntero por encima para ver su nombre; si la app te propone pasar a un plan de pago, comprueba que iniciaste sesión con la cuenta que tiene la suscripción;
- en la terminal, quedarte en modo Auto sin saberlo: vuelve a iniciarlo con
--permission-mode manual, o cambia de modo durante la sesión con las teclas Shift (Mayús) y Tab; - en la terminal, «command not found: claude» justo después de la instalación: abre una ventana nueva y sigue la indicación que mostró el instalador (ver más arriba).
Guardar y retomar
- Agrega una línea en la sección «Mi herramienta» de tu ficha de identidad (módulo 1): la carpeta de trabajo (mon-espace-ia) y el modo elegido (Manual).
- La próxima vez, una sesión siempre empieza así: la app, la pestaña Code, tu carpeta, el modo Manual.
Para ir más lejos
opcional
- El compañero Claude Code de este curso: una vez instalado Claude Code, te acompaña en las lecciones directamente desde tu carpeta. Consulta la página «Continuar en Claude Code».
- La documentación oficial, en inglés: code.claude.com/docs/en/desktop (la app) y code.claude.com/docs/en/setup (la terminal).
Palabras nuevas
6 palabras explicadas
| Palabra | Lo que significa |
|---|---|
| Pestaña Code | La parte de la app Claude donde se usa Claude Code en las propias carpetas |
| Sesión | Una conversación de trabajo con Claude Code, vinculada a una carpeta |
| Modo Manual | El agente lee sin preguntar, pero pregunta antes de crear o modificar un archivo, o de ejecutar un comando que haga algo más que leer |
| Comando | Una línea de texto que da una orden a la computadora, escrita en la terminal |
| PowerShell | La aplicación de comandos de Windows |
| PATH | La lista de carpetas donde la terminal busca los comandos: si claude no está en ella, la terminal no lo encuentra |
Comprueba lo que entendiste
3 preguntas, sin nota. Después de cada respuesta aparece una explicación.
¿Y ahora qué?
Lección 3 · Los permisos y el modo Manual: aceptar, rechazar y entender lo que el agente te pide.
Módulo 4:
✏️ Hacer los ejerciciosMi espacio: tu progreso, tus ejercicios y tu última lección.
Puntos que quedan por verificar: las capturas reales en Mac y en Windows, los pasos exactos del instalador de Windows y del comando cd en Windows, la elección del entorno local en la pestaña Code.
Fuentes y comprobaciones
6 fuentes
Fecha, versión, fuentes Redactada el 24/10/2026. Comprobaciones:
- descarga de la app: claude.com/download, el 24/10/2026;
- pestaña Code, entorno local, selector de modo recordado por carpeta: code.claude.com/docs/en/desktop y code.claude.com/docs/en/permission-modes, el 24/10/2026;
- requisitos de la app: support.claude.com (artículo «Install Claude Desktop»), el 24/10/2026;
- requisitos de la terminal, comandos de instalación, comprobación después de la instalación, Git para Windows: code.claude.com/docs/en/setup, el 24/10/2026;
- instalación en la Terminal probada en Mac el 24/10/2026 (versión 2.1.310); comandos de Windows comprobados en la documentación, sin prueba real;
- carpeta Documentos movida por OneDrive: learn.microsoft.com (página en francés, «Rediriger et déplacer les dossiers connus de Windows vers OneDrive», es decir, redirigir y mover las carpetas conocidas de Windows a OneDrive), el 24/10/2026;
- modo Auto por defecto en la terminal desde la versión 2.1.283: code.claude.com/docs/en/permission-modes, el 24/10/2026;
- etiquetas «Manual», «Abrir carpeta…» y «Nueva sesión»: leídas en francés en la app Claude para Mac, versión 3.6556.2, el 24/10/2026; la forma en español sale de los archivos de traducción de esa misma versión, sin captura.
Fuentes comprobadas: