Tutorial completo de Claude Code para principiantes: Instalación en 3 minutos sin saber programar

@Graceruansu
CHINOhace 4 meses · 05 mar 2026
374K
750
165
70
1.6K

TL;DR

Un tutorial integral para usuarios sin conocimientos técnicos sobre cómo instalar la CLI de Claude Code, que incluye configuración paso a paso para Mac y Windows, solución de problemas de proxy y consejos para la automatización de archivos locales.

Primero, seamos claros: ¿Qué es exactamente Claude Code?

Dedica 2 minutos a leer esto y entenderás por qué necesitas instalarlo.

Muchas personas se suscriben a Claude Pro y su uso diario se ve así:

软苏格拉底 - inline image

Una diferencia clave: La versión web de Claude vive en un servidor y no tiene conexión con tu entorno local. Claude Code vive en tu computadora, puede leer tus archivos y te ayuda a completar tareas del mundo real.

No necesitas conocimientos de programación: todas las operaciones siguientes solo requieren que sepas copiar y pegar. ¡En serio!

【01】 Preparación antes de la instalación

Antes de empezar, debes resolver dos cosas. La mayoría de los fallos de instalación y errores repetidos vienen de aquí.

⚠️ Crítico: Problemas de red. Los servidores de Claude Code están en EE. UU. Sin un proxy estable, todas las operaciones posteriores serán en vano. Asegúrate de poder acceder a claude.ai con normalidad, y se recomienda usar un nodo estadounidense en modo global. A menudo la página web se abre, pero la instalación falla porque el nodo proxy es incorrecto o el modo global no está activado.

Cuentas necesarias:

✅ Suscripción a Claude Pro ($20/mes) — Si ya estás suscrito, puedes empezar directamente sin costo adicional

✅ Un entorno de red que pueda acceder a claude.ai

Una vez confirmado, ¡continúa con la guía de instalación para tu sistema!

【02】 Tutorial de instalación para Mac / Linux

Un comando, 3 minutos para terminar

  1. Abre "Terminal": Presiona Command + Space, busca "Terminal" y presiona Enter. Verás una ventana negra (o blanca) con un cursor parpadeante. No tengas miedo, es la "caja negra".
  1. Pega el comando de instalación y presiona Enter: Copia la línea de abajo, pégala en la terminal y presiona Enter. Luego espera en silencio; verás texto en inglés desplazándose, es normal. Espera a que se detenga solo.
  1. Escribe claude y presiona Enter: Después de la instalación, escribe claude en la terminal y presiona Enter.
  1. Elige el método de inicio de sesión y autoriza a través del navegador: Usa las teclas de flecha para seleccionar "1. Claude account with subscription" y presiona Enter. Tu navegador se abrirá; haz clic en el botón negro "Authorize".
  1. Éxito: Si aparece "Welcome back!" o la interfaz interactiva de Claude en la terminal, ¡la instalación fue exitosa!

✓ Señal de éxito: El logotipo ASCII de Claude aparece en la terminal, o muestra "Welcome back, [Tu Nombre]".

【03】 Tutorial de instalación para Windows

Igual de simple, también 3 minutos

  1. Abre PowerShell: Presiona Win + S, busca "PowerShell", haz clic derecho y selecciona "Ejecutar como administrador". Esta también es una ventana negra.
  1. Pega el comando de instalación y presiona Enter:
  1. Espera la instalación: Observa la barra de progreso o el texto desplazándose y espera con paciencia. No cierres la ventana durante este tiempo.
  1. Escribe claude, presiona Enter e inicia sesión a través del navegador: Igual que los pasos para Mac: escribe claude, presiona Enter, el navegador se abre, haz clic en "Authorize", y listo.

⚠️ Nota especial para Windows: Si dice "scripts are disabled", ejecuta primero este comando para desbloquearlo y luego reintenta la instalación:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

【04】 ¿Falló la instalación? El 90% de los problemas están aquí

No te asustes si encuentras errores. Aquí están los tres problemas más comunes y sus soluciones:

🪤 Problema #1: Barra de progreso atascada / Error ETIMEDOUT. Este es el problema más común.

La razón es que la terminal (caja negra) no está usando el proxy, incluso si tu navegador puede abrir Claude. Usuarios de Mac: Ejecuta este comando en la terminal para verificar tu puerto proxy: networksetup -getwebproxy "Wi-Fi"

Recuerda ese número de puerto (ej. 15236), luego ejecuta lo siguiente (reemplaza el número con el tuyo): export https_proxy=http://127.0.0.1:15236 http_proxy=http://127.0.0.1:15236 all_proxy=socks5://127.0.0.1:15236

✓ Solución: Después de ejecutar la línea anterior, pega el comando de instalación de nuevo.

🪤 Problema #2: "command not found"

Si al escribir claude después de la instalación obtienes un error "command not found", generalmente el PATH no ha surtido efecto.

✓ Solución: Cierra la ventana de terminal, abre una nueva e intenta escribir claude de nuevo.

🪤 Problema #3: El navegador se abre pero la autorización falla

Al hacer clic en "Authorize" no pasa nada o te redirige a una página de error. Generalmente, la cuenta de Claude con la que iniciaste sesión no es Pro, o la red se cayó durante la redirección.

✓ Solución: Confirma que la cuenta de claude.ai es Pro, configura el proxy en modo global, cierra el navegador e inténtalo de nuevo.

💡 Consejo universal para solucionar problemas:

Si te encuentras con algún error, copia el texto rojo del error y pégalo en la versión web de Claude, diciendo "Estoy instalando Claude Code y encontré este error, ayúdame a analizar la causa" — te dirá la solución.

【05】 ¡Instalado! ¿Cómo empiezo?

Claude Code se usa dentro de la "terminal". Cada vez que lo uses, primero debes ingresar a tu carpeta de trabajo y luego iniciarlo.

1. Abre la terminal e ingresa a tu carpeta de trabajo

Por ejemplo, si tus archivos están en una carpeta llamada "Trabajo" en tu escritorio:

cd ~/Desktop/Trabajo

💡 ¿Qué significa cd? cd = Change Directory, es decir "entrar a esta carpeta". Solo reemplaza la ruta con la de tu propia carpeta.

2. Escribe `claude` para iniciar:

Una vez que aparezca la interfaz de Claude, puedes hablarle directamente en español. Es como enviar un mensaje de WhatsApp, dile lo que quieres que haga.

Para la primera vez, prueba este comando simple para verificar que realmente está operando tu computadora:

📋 Instrucción de ejemplo

Ayúdame a crear una carpeta llamada "Claude Works" en mi escritorio, y dentro de ella, crea un nuevo archivo de texto llamado "Primer Archivo.txt" con la fecha de hoy y "¡Instalación de Claude Code exitosa!" escrito adentro.

Verás que la carpeta y el archivo aparecen en tu escritorio de inmediato. Esta es la diferencia esencial entre CC y la versión web: realmente trabaja para ti, en lugar de solo generar texto.

【06】 El paso más importante: Crear un perfil de memoria

Si instalas Claude Code pero no haces esto, todavía estás usando un "trabajador temporal con amnesia".

Después de este paso, puede recordar quién eres, qué estás haciendo y qué estilo te gusta — nunca tendrás que presentarte una segunda vez.

En la interfaz de Claude Code, copia y pega lo siguiente (reemplaza el contenido entre corchetes con el tuyo):

📋 Instrucción de ejemplo

Mi nombre es [Tu Nombre], y trabajo como [Tu dirección de trabajo, ej. Operador de Redes Sociales / Gerente de Producto / Consultor Independiente].

Mis tareas diarias principales incluyen:

  • [Tarea 1, ej. Escribir artículos para el blog de la empresa]
  • [Tarea 2, ej. Gestionar proyectos de clientes]
  • [Tarea 3]

Mi preferencia de estilo de trabajo: [ej. Conciso y directo, sin rodeos / Necesito explicaciones detalladas para cada paso]

Herramientas que uso comúnmente: [ej. Notion, Feishu, WhatsApp]

Por favor, ayúdame a crear un archivo CLAUDE.md para registrar la información anterior como base para nuestra cooperación a largo plazo. Cada vez que abra Claude Code en el futuro, debes leer este archivo primero para entender mi contexto antes de comenzar a trabajar.

Generará un archivo CLAUDE.md en tu carpeta de trabajo. Este es su "perfil de memoria".

✓ La función de este archivo: Cada vez que inicies Claude Code, leerá automáticamente CLAUDE.md para entender quién eres, qué estás haciendo y tus preferencias de estilo antes de comenzar a trabajar. Nunca tendrás que volver a presentarte.

【07】 Avanzado: Construyendo un sistema que se vuelve más fuerte con el uso

La mayoría de las personas usan la IA de forma "consumible": la abren, obtienen un resultado, la cierran, la borran, y después de tres meses, no se ha acumulado nada.

El uso verdaderamente valioso es "acumulativo": cada vez que trabajas, los resultados se guardan y la experiencia se asienta en el sistema, haciendo que la próxima vez sea más rápida y mejor.

No necesitas crear carpetas una por una. Copia esto y deja que Claude Code las cree por ti:

📋 Instrucción de ejemplo

Por favor, ayúdame a construir una estructura de carpetas para un sistema de trabajo.

Mi situación es:

  • Las cosas que hago son: [Enumera 2-4 líneas de negocio, ej. Escribir contenido para redes sociales, hacer proyectos de consultoría, aprender inglés]
  • Mi mayor dolor de cabeza actualmente es: [ej. Las ideas siempre se pierden / No encuentro los materiales / La IA no recuerda mi contexto]

Por favor, ayúdame a:

  1. Diseñar una estructura de directorios adecuada para mí
  2. Crear todas las carpetas en el directorio actual
  3. Crear un README.md para cada carpeta explicando su propósito
  4. Actualizar CLAUDE.md para que puedas entender rápidamente todo el sistema cuando entres en el futuro

【08】 Lo que la gente que no sabe programar está haciendo con esto

Aquí hay escenarios reales; cada instrucción se puede copiar y pegar directamente en Claude Code:

📝 Redes Sociales / Creación de Contenido "Tengo 3 meses de borradores de tweets; ayúdame a organizarlos por tema, encuentra qué ángulos no he cubierto aún y genera un informe de sugerencias de temas." → Lee archivos → Clasifica → Analiza vacíos → Sale el informe

📊 Ventas / Gestión de Clientes "Escanea estos 6 meses de registros de chat con clientes, resume las necesidades principales y puntos débiles de cada cliente, y ayúdame a generar un informe de perfiles de cliente." → Lee archivos en lote → Analiza → Informe estructurado

📋 Gestión de Proyectos "Organiza esta transcripción de reunión en elementos de acción, clasifícalos por responsable, marca las fechas límite y genera una lista de seguimiento." → 10 segundos, lista estructurada

🗂️ Gestión de Conocimiento / Archivos "Hay 300 archivos en el escritorio; ayúdame a categorizarlos en trabajo, estudio y vida personal, renombra los nombres de archivo desordenados y enumera los archivos que no se han abierto en más de un año para que decida si eliminarlos." → 3 minutos, todo organizado

📈 Análisis de Datos "Ayúdame a analizar esta hoja de Excel, encuentra qué tipo de contenido tuvo la mayor interacción en los últimos 6 meses, resume los patrones y escribe las conclusiones en un archivo de informe de análisis." → Lee tabla → Calcula → Conclusión generada

🎯 Marca Personal / PPT "Ayúdame a hacer un material de presentación sobre [Tu Dirección] con un marco claro, que incluya problema, solución, diferenciación y plan de acción." → El marco sale directamente, listo para iterar

🔑 Secreto de uso: Al dar instrucciones a Claude Code, cuanto más específico, mejor. Dile: qué archivos operar, qué hacer, en qué formato generar la salida y dónde guardarlo. Cuanto más claro seas, más preciso será el resultado.

Instala CC, configura CLAUDE.md y úsalo durante una semana.

Después de una semana, entenderás realmente lo que significa "dejar que la IA viva en tu computadora". Usa la IA web durante tres meses y no se acumula nada. Usa CC durante tres meses y tendrás un sistema que te entiende cada vez mejor.

Después de leer esto, no digas que no puedes instalarlo. Si yo, una mamá de letras, pude hacerlo, ¡tú definitivamente también puedes!

Recrear en YouMind

Turn one viral article into a full content workflow

Collect the source, decode the pattern, create assets, draft the story, and distribute from one AI workspace.

Explore YouMind
Para creadores

Convierte tu Markdown en un artículo de 𝕏 impecable

Cuando publicas tus propios textos largos, dar formato en 𝕏 a imágenes, tablas y bloques de código es un fastidio. YouMind convierte un borrador completo en Markdown en un artículo de 𝕏 impecable y listo para publicar.

Prueba Markdown a 𝕏

Más patrones por descifrar

Artículos virales recientes

Explorar más artículos virales