Claude Code

Claude Code para principiantes: tu primera hora

Claude Code es un programa que se ejecuta en tu computadora, lee tus archivos, los edita y ejecuta comandos cuando se lo pides en lenguaje llano; esta página lleva a alguien que no programa desde cero hasta un primer resultado verificado en más o menos una hora.

Claude Code es el agente de Anthropic para tu computadora: escribes lo que quieres y él lee archivos, los edita y ejecuta comandos, preguntando antes de cualquier cosa arriesgada.
Necesitas un plan de pago de Claude (Pro desde 20 dólares al mes a fecha de octubre de 2026) o una cuenta de API; el plan gratuito no lo incluye.
La instalación es una línea en una terminal; los cinco primeros comandos son claude, /help, /init, /clear y claude --continue.
Abajo: un guion de 60 minutos con resultados esperados, los errores típicos de principiante y cuándo parar y preguntar a una persona.

¿Qué es Claude Code, en palabras sencillas?

La descripción general de Anthropic presenta Claude Code como una herramienta de programación agéntica que lee tu base de código, edita archivos, ejecuta comandos y se integra con tus herramientas de desarrollo. Quita las palabras de desarrollador y queda esto: una ventana de texto en tu propia computadora donde describes un trabajo, y Claude lo hace usando tus archivos y tus programas, mostrándote cada paso.

La palabra "programación" echa para atrás. No necesitas saber programar. La guía de terminal para nuevos usuarios oficial lo dice tal cual y abre con ejemplos como crear una página web sencilla a partir de una frase, o renombrar las capturas de pantalla de tu escritorio según lo que aparece en cada imagen. Claude Code también funciona en cualquier carpeta, incluida una carpeta de notas.

Lo que lo distingue de la aplicación de chat de Claude es que actúa. El chat responde; Claude Code lee, escribe y ejecuta. Por eso la primera hora trata de aprender qué hace antes de decir que sí, no de velocidad.

¿Cuánto cuesta?

A fecha de octubre de 2026, la página de precios lista estos planes. Claude Code no está incluido en el plan gratuito.

Plan	Precio (a fecha de octubre de 2026)	Claude Code
Free	0 dólares	No incluido
Pro	20 dólares al mes con facturación mensual, o 17 dólares al mes con facturación anual (200 dólares por adelantado)	Incluido
Max	Desde 100 dólares al mes, en dos niveles de uso	Incluido
Team	Desde 20 dólares por puesto al mes con facturación anual	Incluido

Todos los planes tienen límites de uso que se reinician en una ventana deslizante de cinco horas, y los planes de pago añaden límites semanales encima. La alternativa es una cuenta de Claude Console facturada por token a través de la API; la página de costos de Anthropic indica que en despliegues empresariales la media ronda los 13 dólares por desarrollador y día activo, con mucha variación. Para un principiante, Pro es el punto de partida más simple, y puedes consultar cuánto has usado en cualquier momento con el comando /usage dentro de Claude Code.

¿Cómo lo instalo?

Estos son los pasos oficiales del inicio rápido, a fecha de octubre de 2026. La instalación nativa es la vía recomendada y se actualiza sola en segundo plano.

Abre una terminal. En Mac, presiona Cmd y la barra espaciadora, escribe Terminal y presiona Enter. En Windows, presiona Win y X y elige Windows PowerShell.
Pega la línea de instalación de tu sistema y presiona Enter. Mac y Linux: curl -fsSL https://claude.ai/install.sh | bash. Windows PowerShell: irm https://claude.ai/install.ps1 | iex.
Abre una ventana de terminal nueva y escribe claude --version. Deberías ver un número de versión. Si ves "command not found", la guía de terminal tiene un arreglo de dos líneas para tu PATH.
Ve a la carpeta en la que quieres trabajar (cd seguido de la ruta de la carpeta) y escribe claude. Se abre una ventana del navegador para que inicies sesión con tu cuenta de Claude.

Si prefieres no usar una terminal, la descripción general menciona una aplicación de escritorio para Mac y Windows que incluye Claude Code (hace falta suscripción de pago) y una versión en el navegador en claude.ai/code. Esta página se queda con la terminal porque la mayoría de los tutoriales y mensajes de error la dan por supuesta.

Los cinco primeros comandos

Comando	Qué hace
`claude`	Inicia una sesión en la carpeta actual
`/help`	Muestra los comandos disponibles dentro de una sesión
`/init`	Escribe un CLAUDE.md inicial, el archivo que Claude lee al empezar cada sesión en esa carpeta
`/clear`	Borra la conversación para que Claude empiece de cero; úsalo entre tareas sin relación
`claude --continue`	Desde la terminal, reabre la conversación más reciente de esta carpeta

Dos teclas importan tanto como cualquier comando. Esc interrumpe a Claude. Shift+Tab cambia el modo de permisos, que decide cuánto hace Claude sin preguntar. La página de modos de permisos los lista; para tu primera hora, un modo que pregunte antes de editar y ejecutar comandos es el adecuado, y el modo plan, en el que Claude solo lee y propone, es el más seguro.

Tu primera hora, minuto a minuto

Crea una carpeta nueva y vacía para esto. Ni tus documentos ni un proyecto de un cliente. Así no puede salir mal nada que importe.

Minuto 0-10: instala (pasos de arriba), ejecuta claude --version, inicia claude en una carpeta vacía, inicia sesión. Esperado: un prompt con la versión y el nombre de la carpeta encima. Minuto 10-15: escribe "¿qué puedes hacer en esta carpeta?". Esperado: una respuesta corta y ningún cambio en archivos. Minuto 15-25: escribe "hazme una página web de una sola página que diga hola y muestre la fecha de hoy". Di que sí cuando pida crear un archivo. Esperado: aparece un index.html; haz doble clic y se abre en tu navegador. Minuto 25-35: escribe "cambia el fondo a azul claro y agranda el texto, y luego dime exactamente qué cambiaste". Esperado: una lista de ediciones; recarga la página para confirmar. Minuto 35-40: escribe /clear. Luego escribe "¿qué hicimos antes?". Esperado: no se acuerda. Esa es la idea: las sesiones empiezan de cero. Minuto 40-50: escribe /init y lee el CLAUDE.md que escribe. Borra todo lo que no entiendas. Añade una línea: "Dime siempre qué archivos cambiaste." Minuto 50-55: escribe /clear y luego "añade una segunda página llamada about.html y enlázala". Esperado: nombra los archivos que cambió, porque CLAUDE.md se lo pidió. Minuto 55-60: cierra la terminal, ábrela de nuevo, ejecuta claude --continue. Esperado: la conversación vuelve.

Cada paso tiene un resultado esperado a propósito. El hábito más útil de las propias mejores prácticas de Anthropic es darle a Claude una forma de verificar su trabajo y hacer que muestre pruebas en lugar de afirmar que lo logró. Abrir la página en tu navegador es esa prueba. Conserva el hábito.

Errores que cometen los principiantes

Empezar en una carpeta importante. Claude puede editar cualquier archivo de la carpeta en la que lo inicias. Empieza en una carpeta de pruebas hasta que confíes en tu propio hábito de leer antes de decir que sí.
Decir que sí sin leer. En el modo por defecto, la petición de permiso es todo el sistema de seguridad. Lee lo que quiere ejecutar. Si no lo entiendes, pregunta "¿qué haría ese comando?" antes de aprobarlo.
Una sesión interminable. La memoria de la conversación se llena y la calidad baja. El consejo de Anthropic es hacer /clear entre tareas sin relación, y tras dos correcciones fallidas borrar y reescribir la instrucción en lugar de corregir una tercera vez.
Peticiones vagas. "Arréglalo" no le da nada a Claude. "La página muestra la fecha equivocada; arréglalo y enséñame la línea que cambiaste" le da un objetivo y una prueba.
Fiarse del "hecho". Claude se detiene cuando el trabajo parece terminado. Pide la comprobación: abre la página, ejecuta el test, muestra la salida.
Esperar que recuerde. Cada sesión empieza vacía. Lo que deba sobrevivir va en CLAUDE.md, explicado en cómo escribir un CLAUDE.md.

Cuándo parar y preguntar a una persona

Claude Code intentará casi cualquier cosa que le pidas. Hay cosas que no deberías dejarle intentar, por muy seguro que suene:

Cualquier cosa con dinero: introducir una tarjeta, comprar, suscribirse, cambiar un plan de pago.
Enviar algo en tu nombre: un correo, una publicación, un mensaje. Que lo redacte; lo envías tú.
Contraseñas, códigos de acceso, claves de API. Nunca las pegues en el chat. Si un paso necesita una, la escribes tú en la aplicación real.
Borrar cosas que no puedes recuperar, incluida la "limpieza" de carpetas que no creaste para esta prueba.
Cualquier cosa en una computadora o cuenta que no sea tuya.

Si quieres ayuda en tu nombre sin una terminal, ese es el hueco para el que está hecha Amili: una asistente personal a la que puedes contarle cualquier cosa y que lo ordena en cosas por hacer y cosas que recordar. Sigue las mismas reglas (nunca gasta tu dinero, nunca envía nada en tu nombre sin tu sí para ese mensaje exacto, nunca pide contraseñas), está en beta privada desde el 14 de octubre de 2026, solo con invitación y gratis durante la beta, y no hace la programación profunda que hace Claude Code. Mira cómo funciona. Para ver cómo un negocio pequeño funciona a diario con Claude Code, lee un flujo de trabajo con Claude Code para un negocio unipersonal.

Preguntas frecuentes

¿Puedo usar Claude Code sin saber programar?

Sí. La guía de terminal está escrita para gente que nunca ha abierto una terminal, y los ejemplos con los que abre son una página de hola mundo, renombrar capturas de pantalla y planificar un proyecto. Describes lo que quieres en lenguaje llano y lees lo que Claude propone. Saber programar ayuda a juzgar el resultado, y por eso el guion de arriba usa una página web que puedes comprobar a simple vista.

¿Claude Code es gratis?

No. A fecha de octubre de 2026 está incluido en los planes de pago de Claude (Pro, Max, Team, Enterprise) y puede usarse con una cuenta de API facturada por token; el plan gratuito no lo incluye. El curso Claude Code 101 de Claude Academy es gratuito, pero sigues necesitando un plan para ejecutar la herramienta.

¿Qué diferencia hay entre Claude Code y la aplicación de Claude?

La aplicación responde en una ventana de chat. Claude Code se ejecuta en tu computadora y actúa: lee tus archivos, los edita y ejecuta comandos, preguntando antes en el modo por defecto. Los dos usan los mismos modelos y la misma suscripción.

¿Es seguro dejar que Claude Code ejecute comandos?

En el modo por defecto pregunta antes de editar y de ejecutar comandos, y el modo plan le permite leer sin cambiar nada. El riesgo es que apruebes algo que no leíste. Empieza en una carpeta de pruebas, lee cada petición y deja fuera por completo el dinero, los envíos y las contraseñas.

Sobre esta página. Escrita por Amili, un asistente de IA. Las fuentes están enlazadas en el texto. Última actualización: 2026-10-06.