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.

Guía paso a paso4 min de lecturaPor Rafael Schwart

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

  1. Abre la terminal y pega el comando de tu sistema. En Mac:
    curl -fsSL https://claude.ai/install.sh | bash
    En Windows, desde PowerShell (la línea empieza con PS):
    irm https://claude.ai/install.ps1 | iex
    No necesitas abrirla como administrador. El instalador no muestra avance mientras descarga: espera a que termine.
  2. Abre una terminal nueva y comprueba. Escribe claude --version. Si aparece un número de versión, quedó instalado. Si la terminal no reconoce claude, 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.

Primero el proceso. Antes de escribir el pedido, define en una frase qué tiene que cambiar y cómo vas a saber que quedó bien. Si no puedes decirlo, Claude tampoco lo va a adivinar.

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.

ModoQué hace sin preguntarteCuándo usarlo
ManualSolo leerTus primeros días y todo lo sensible
Accept editsLeer y editar archivosCuando revisas los cambios al final
PlanLeer y proponerte un plan, sin editarAntes de una tarea grande
AutoCasi todo, con un segundo modelo que revisa cada acciónTareas 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

ComandoQué hace
/helpMuestra la ayuda y los comandos disponibles.
/initCrea un CLAUDE.md con lo que encuentra en el proyecto.
/clearEmpieza una conversación nueva, sin el contexto anterior. Úsalo al cambiar de tarea.
/compactResume la conversación para liberar espacio en sesiones largas.
/modelCambia el modelo, por ejemplo entre Opus y Sonnet.
/mcpMuestra y administra tus conectores.
/resumeRetoma una conversación anterior.
/rewindVuelve a un punto anterior.
/usageMuestra el consumo y los límites de tu plan.
/exitCierra 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.

Sigue leyendo

Más guías.

Cada una se lee en menos de cinco minutos.

Todas las guías
Guía paso a paso · 4 min

CLAUDE.md: el manual de tu proyecto

Qué es el archivo CLAUDE.md, dónde va, cómo crearlo con /init y qué escribir para que Claude no te pregunte lo mismo en cada sesión.

  Arqentia

¿Prefieres que lo armemos contigo?

Treinta minutos para ver tu operación: cómo entra el dinero, dónde se pierde tiempo y qué conviene automatizar primero. Gratis para negocios y sin compromiso.

Agendar consulta