Directorio / Guías / Claude Code
Claude Code desde cero
Qué es Claude Code, cómo instalarlo en Windows o Mac, tu primer pedido, cómo aprobar lo que hace y los comandos que vas a usar cada día.
Claude Code es Claude trabajando dentro de una carpeta de tu computadora. En el chat tú le pegas un texto y él responde. Aquí abre los archivos por su cuenta, los edita y ejecuta comandos, y te pide permiso según el modo que elijas. Sirve para construir una página, ordenar archivos, armar un reporte o automatizar una tarea, aunque no seas programador.
Antes de empezar
- Una cuenta de pago. Claude Code funciona con los planes Pro, Max, Ultra, Team o Enterprise, o con una cuenta de Console. El plan gratis no lo incluye.
- Una terminal. En Windows, PowerShell. En Mac, la app Terminal. Si prefieres no usarla, la app de escritorio de Claude te deja usar Claude Code con interfaz gráfica.
- Una carpeta de prueba. Para la primera sesión, usa una copia de algo que no te duela perder.
Instalarlo
- Abre la terminal y pega el comando de tu sistema. En Mac:
En Windows, desde PowerShell (la línea empieza concurl -fsSL https://claude.ai/install.sh | bashPS):
No necesitas abrirla como administrador. El instalador no muestra avance mientras descarga: espera a que termine.irm https://claude.ai/install.ps1 | iex - Abre una terminal nueva y comprueba. Escribe
claude --version. Si aparece un número de versión, quedó instalado. Si la terminal no reconoceclaude, la carpeta de instalación todavía no está en tu PATH. La guía oficial de instalación explica cómo arreglarlo.
También puedes instalarlo con brew install --cask claude-code en Mac o winget install Anthropic.ClaudeCode en Windows. Esas dos versiones no se actualizan solas; la del instalador oficial sí.
En Windows conviene instalar también Git for Windows. Es opcional: sin él, Claude Code ejecuta los comandos con PowerShell.
Abrirlo en una carpeta
Claude Code trabaja en la carpeta desde donde lo abres. Entra a ella y arráncalo:
cd ruta/a/tu-carpeta
claude
La primera vez te pide iniciar sesión en el navegador, y la sesión queda guardada. También te pregunta si confías en esa carpeta. Acepta solo en carpetas tuyas o de fuentes que conoces: un proyecto puede traer configuración que ejecuta comandos en tu computadora.
Tu primer pedido
Empieza preguntando, no pidiendo cambios:
¿Qué hay en esta carpeta y para qué sirve cada archivo?
Claude lee lo que necesita; no hace falta que le pegues nada. Después pide algo pequeño y concreto. «Mejora la página» es vago. «En index.html, cambia el horario de atención a lunes a sábado de 9 a 18» se verifica en diez segundos.
Cómo aprueba lo que hace
El modo de permisos decide qué puede hacer Claude sin preguntarte. Lo cambias con Shift+Tab, y el modo activo aparece en la barra de estado, debajo de donde escribes.
| Modo | Qué hace sin preguntarte | Cuándo usarlo |
|---|---|---|
| Manual | Solo leer | Tus primeros días y todo lo sensible |
| Accept edits | Leer y editar archivos | Cuando revisas los cambios al final |
| Plan | Leer y proponerte un plan, sin editar | Antes de una tarea grande |
| Auto | Casi todo, con un segundo modelo que revisa cada acción | Tareas largas que ya conoces bien |
En las versiones actuales la sesión suele arrancar en modo Auto. Para aprender, pasa a Manual: Claude te muestra cada edición o comando y espera tu respuesta. Si algo no te convence, recházalo y explícale qué hacer distinto.
Si va por mal camino, presiona Esc para detenerlo. Con /rewind vuelves a un punto anterior de la conversación y de los archivos.
Los comandos que más vas a usar
| Comando | Qué hace |
|---|---|
/help | Muestra la ayuda y los comandos disponibles. |
/init | Crea un CLAUDE.md con lo que encuentra en el proyecto. |
/clear | Empieza una conversación nueva, sin el contexto anterior. Úsalo al cambiar de tarea. |
/compact | Resume la conversación para liberar espacio en sesiones largas. |
/model | Cambia el modelo, por ejemplo entre Opus y Sonnet. |
/mcp | Muestra y administra tus conectores. |
/resume | Retoma una conversación anterior. |
/rewind | Vuelve a un punto anterior. |
/usage | Muestra el consumo y los límites de tu plan. |
/exit | Cierra Claude Code. |
Si escribes / aparece la lista completa, incluidos los skills que tengas instalados. Desde la terminal, claude -c retoma la última conversación de esa carpeta.
Qué sigue
El siguiente paso es escribir el CLAUDE.md de tu proyecto, para no repetirle lo mismo en cada sesión. Después puedes conectar un MCP o instalar un skill del directorio.