La guía de configuración acelerada para no programadores que quieren aprovechar la IA
¿Ya terminaste esta guía? El Manual Avanzado cubre agentes, automatización y cómo escalar tus operaciones de IA.
Leer el Manual Avanzado →| Término | Explicación simple |
|---|---|
| CLI | Interfaz de línea de comandos - escribes comandos de texto en lugar de hacer clic en botones |
| Terminal | La app donde escribes comandos. Igual que el Símbolo del sistema en Windows |
| IDE | Entorno de desarrollo integrado - un editor de código sofisticado. VS Code es uno |
| VS Code | El editor de código gratuito de Microsoft. Lo usarás para hablar con Claude Code |
| Git | Software de seguimiento de versiones que guarda cada cambio que haces en tu código |
| GitHub | Sitio web donde se almacena tu código de Git en la nube |
| Repo (Repositorio) | Una carpeta de proyecto rastreada por Git. Contiene tu código, archivos e historial completo de cambios |
| Commit | Una instantánea guardada de tus cambios (como presionar guardar con una nota) |
| Push / Pull | Enviar/recibir cambios entre tu computadora y GitHub |
| Branch | Una copia de tu código donde puedes experimentar sin afectar la versión principal |
| API | Interfaz de Programación de Aplicaciones - una forma para que los programas se comuniquen entre sí |
| API Key | Una contraseña secreta que le prueba a un servicio que eres tú |
| MCP | Protocolo de Contexto de Modelo - una forma estandarizada para que Claude Code use herramientas externas |
| .env file | Un archivo de texto que almacena tus contraseñas secretas y claves de API de forma local |
| CLAUDE.md | Tu archivo de instrucciones personal que le dice a Claude Code cómo trabajar contigo |
| Memory | Archivos de texto que Claude Code puede leer para recordar tus preferencias y proyectos |
| Context window | Cuánto texto puede "ver" y recordar Claude en una conversación |
| Token | Una unidad de texto (roughly 4 caracteres). Los modelos de IA piensan en tokens |
| Prompt | La instrucción o pregunta que le das a Claude |
| Skill | Un comando predefinido que le dice a Claude Code cómo manejar una tarea específica |
| Local LLM | Un modelo de IA que se ejecuta en tu computadora en lugar de en servidores en la nube |
| Node.js / npm | Node.js ejecuta JavaScript fuera del navegador. npm instala paquetes de software |
| Cloudflare Pages | Hosting de sitios web gratuito con CDN integrada. Deploy con un comando: wrangler pages deploy |
| GitHub Pages | Hosting de sitios web gratuito directamente desde tu repositorio de GitHub |
| Astro | Un generador de sitios web que crea HTML rápido y estático con muy poco JavaScript |
La mayoría de las personas van directo a instalar VS Code. No lo hagas. Lo más valioso que puedes hacer en tu primera semana es tener tu contexto correcto. Claude es tan bueno como lo que le das. Has usado ChatGPT durante 2-3 años, ese historial es una mina de oro. Dedica 2-3 días a extraerlo antes de escribir una línea de código.
Esto no es un pegado de una sola vez. Cada día es un ciclo iterativo: generar, leer cada palabra, editar, probar y mejorar. Las personas que obtienen respuestas de IA espectaculares son las que pasaron 2-3 días ajustando su contexto. Las que obtienen respuestas genéricas son las que saltaron esta sección.
Abre ChatGPT. Ejecuta estos tres prompts en orden. Copia el resultado en un Google Doc. Luego empieza el trabajo real: lee cada palabra. Edita de forma agresiva. Añade lo que ChatGPT omitió. Elimina lo que esté incorrecto o desactualizado. Guarda en Google Doc.
Completa 5 campos. Obtén 2 prompts personalizados - uno para exportar tu contexto de ChatGPT y otro para cargarlo en Claude. Copia y pega directamente.
Toma tu Google Doc editado del Día 1. Cárgalo en la memoria de Claude.ai y escribe tu archivo CLAUDE.md. Luego pruébalo:
Recopila documentos de cualquier lugar donde almacenes conocimiento. Incluso 2-3 archivos buenos mejoran drásticamente las respuestas de Claude.
Ahora abre Claude Code en VS Code. Prepara tu memoria usando los pasos del Módulo 5. Luego prueba con una tarea real:
Al terminar esta guía, tendrás un entorno de desarrollo con IA que te permitirá:
Pasas de "a veces uso ChatGPT" a "tengo un sistema operativo de IA que conoce mi negocio". No se trata de programar. Se trata de apalancamiento.
| Forma antigua - crear un sitio web | Forma nueva - con Claude Code |
|---|---|
| Wireframes, reuniones con diseñadores, sprints de desarrollo, semanas de trabajo | Describe lo que quieres a Claude, 10 minutos para una página activa |
| $2,000-$10,000+ por sitio | $0 (tu tiempo + créditos de API) |
| Correos de ida y vuelta con desarrolladores | Una conversación, resultado en vivo |
| El pulido toma otra semana | 15 minutos de prompts de refinamiento |
| El lanzamiento toma otra semana | Deploy a Cloudflare: 30 segundos |
| Total: 4-8 semanas | Total: 30-60 minutos si tienes buenas habilidades |
Esa tabla no es exageración. Es lo que las personas realmente experimentan una vez que tienen la base configurada. La base es para lo que sirve esta guía.
Claude Code requiere una suscripción paga de Anthropic. Estas son tus opciones:
| Plan | Precio | Qué obtienes | Mejor para |
|---|---|---|---|
| Pro | $20/mes | 5x uso, pensamiento extendido | Probar las aguas |
| Max 5x | $100/mes | 5x uso + acceso completo a Claude Code | Uso diario |
| Max 20x | $200/mes | 20x uso, Claude Code intensivo | Usuarios avanzados, agentes |
| Team | $30/asiento | Controles de administración, espacio de trabajo compartido | Equipos pequeños |
Claude Code se ejecuta dentro de un editor de código. Tienes varias opciones, pero la elección es directa - elige la que tenga la mejor integración nativa y la menor barrera de entrada.
| Editor | Precio | Soporte de Claude Code | Veredicto |
|---|---|---|---|
| VS Code | Gratis | Completo (extensión oficial) | Elige este |
| Cursor | $20/mes | Funciona vía CLI | Bueno, pero de pago y Claude Code es un complemento |
| Windsurf | $15/mes | Funciona vía CLI | Decente, ecosistema menos maduro |
| Bolt | Gratis / pago | Editor de código con IA | Bueno para prototipos rápidos, no un IDE completo |
| Zed | Gratis | Funciona vía CLI | Editor muy rápido, ecosistema en crecimiento |
| Ghostty | Gratis | Solo terminal (sin extensión) | Solo para puristas de la terminal |
Solo necesitas cinco cosas para empezar, y probablemente ya tienes la mayoría de ellas.
| Necesitas | Cómo obtenerlo | Tiempo |
|---|---|---|
| Una laptop (Mac o Windows) | Ya la tienes | - |
| Una conexión a internet | Ya la tienes | - |
| Una cuenta de Claude (Pro o Max) | claude.ai → registrarte → suscribirte | 3 min |
| Una cuenta de GitHub (gratis) | github.com → registrarte | 3 min |
| Node.js instalado | Ver Módulo 2 | 5 min |
Las herramientas de esta guía habrían tardado meses en configurarse con un equipo de desarrolladores hace cinco años. Ahora puedes hacerlo en una tarde. Pero esa velocidad crea una trampa: puedes instalar todo sin entender nada. Este módulo es tu antídoto.
VS Code, GitHub y Cloudflare deberían tomar unos 30 minutos en total, no una tarde entera. Si llevas más de una hora en cualquiera de ellos por separado, detente, escribe tu bloqueo a Claude como una pregunta y sigue avanzando. La configuración debe ser rápida. El valor está en lo que construyes sobre ella.
| Paso | Tiempo objetivo |
|---|---|
| Instalar VS Code + extensión de Claude Code | 5 min |
| Instalar CLI de Claude Code + autenticar | 5 min |
Cuenta de GitHub + gh auth login + primer repo | 10 min |
Cuenta de Cloudflare + wrangler login + primer deploy | 10 min |
| Total | ~30 min |
La mayoría de las personas empiezan a emitir comandos y revisar resultados rápidamente. Está bien una vez que sabes lo que haces. En la semana uno, desacelera y lee de verdad lo que produce Claude. Especialmente el razonamiento - si Claude explica POR QUÉ está haciendo algo, esa es una lección gratuita.
glossary.md en tu espacio de trabajo. Escríbela con tus propias palabras, esa es la prueba de si realmente lo entendiste.Crea un archivo llamado glossary.md en la raíz de tu espacio de trabajo. Cada vez que encuentres un término desconocido, agrégalo. Escribe un párrafo de 3-5 oraciones para cada uno, algo que puedas releer en 30 segundos cuando el término vuelva a aparecer. El objetivo no es memorizar. Es construir un documento de referencia que se acumule.
repo, commit, branch, deploy, CDN, DNS, API, MCP, .env, CLI, agent, orchestrator, staging. Busca cada uno en el momento en que lo encuentres. No te adelantes.
Una de las cosas más confusas al principio es entender qué servicio controla qué. Aquí está el mapa. Una vez que lo tengas, nunca te confundirás sobre "dónde ir a arreglar X".
| Capa | Servicio | Qué controla | Qué se rompe si lo pierdes |
|---|---|---|---|
| Registrador de dominio | Namecheap / GoDaddy | El nombre de dominio en sí (tusitio.com) | Muy grave. Pierdes el dominio. Protege estas credenciales por encima de todo lo demás. |
| DNS | Cloudflare | A dónde va el tráfico cuando alguien visita tu dominio | El tráfico se detiene. El sitio cae. El código sigue seguro. |
| Código | GitHub | Los archivos reales - tu fuente de verdad | El código sigue en tu máquina local. Sube a diario y siempre estarás bien. |
| Deploy | Cloudflare Pages / GitHub Pages | Lo que ven los visitantes en vivo | Vuelve al deploy anterior con un clic. |
| URL en vivo | tusitio.com | El resultado final | - |
El modelo mental: registrador → DNS → código → deploy → URL en vivo. Cada capa es independiente. Puedes cambiar una sin romper las demás, siempre que entiendas lo que hace cada una.
admins.md en tu espacio de trabajo. Escribe qué dirección de correo posee cada cuenta (registrador, Cloudflare, GitHub). Esto toma 5 minutos y le ha ahorrado a muchas personas días enteros de recuperación de cuentas.
claude --version funciona)gh auth login pasa correctamente.gitignore existe con .env incluidowrangler login completado, primer despliegue en vivoCLAUDE.md existe en tu espacio de trabajo (incluso 10 líneas son suficientes)glossary.md existe con al menos 3 términos capturadosadmins.md existe con la titularidad de cuentas documentadaVS Code es tu base de operaciones. Es donde hablarás con Claude, editarás archivos, ejecutarás comandos y administrarás tus proyectos. Es gratuito, funciona en todo y tiene la mejor integración con Claude Code.
code.visualstudio.commy-workspace en tu Escritorio → ábrelaEsta es, con diferencia, la cosa más confusa para los usuarios nuevos. Entenderla te ahorrará mucha frustración.
Cuando abres una carpeta en VS Code, Claude Code carga todo lo vinculado a esa carpeta: habilidades personalizadas, reglas, variables de entorno y memoria del proyecto. Sin una carpeta abierta, Claude funciona en un contexto en blanco. Aun así funciona, pero no tiene conocimiento específico del proyecto.
Ejemplo: imagina que tienes una carpeta llamada michaels-business en tu Escritorio. Dentro has creado habilidades personalizadas de Claude, añadido reglas y guardado notas de clientes. Cuando VS Code tiene michaels-business abierta como espacio de trabajo, Claude puede ver todo eso. Si cierras esa carpeta o abres una diferente, Claude pierde ese contexto de inmediato.
Si deseas abrir una nueva carpeta de proyecto sin perder tus pestañas actuales, siempre abre una nueva ventana primero:
| Acción | Mac | Windows |
|---|---|---|
| Abrir nueva ventana de VS Code | Cmd+Shift+N | Ctrl+Shift+N |
Luego usa Archivo → Abrir carpeta en esa nueva ventana. Tu ventana existente y todas sus pestañas permanecen intactas.
Un buen hábito: cada ventana de VS Code tiene una carpeta abierta, y esa carpeta corresponde al tipo de trabajo que estás haciendo. Si tienes tres proyectos distintos, abre tres ventanas, cada una con la carpeta correcta. Las pestañas dentro de una ventana comparten el mismo contexto de carpeta.
Piénsalo así:
michaels-business abierta → Claude sabe todo sobre el proyecto de Michaelpersonal-site abierta → Claude sabe sobre tu sitio personalSi te encuentras con muchas pestañas abiertas pero sin carpeta cargada, es una situación común. Tus opciones:
Abre Terminal (busca "Terminal" en Spotlight) y pega:
Deberías ver un número de versión como v22.x.x. Eso significa que Node está instalado.
Descarga el instalador de Windows desde nodejs.org (versión LTS). Ejecútalo y acepta los valores predeterminados. Luego abre una nueva terminal en VS Code (Ctrl+`) y escribe:
Deberías ver un número de versión. Si no, reinicia VS Code.
Abre el panel de Extensiones: Cmd+Shift+X (Mac) o Ctrl+Shift+X (Windows). Busca e instala estas:
| Extensión | Para qué sirve | Prioridad |
|---|---|---|
| Claude Code (by Anthropic) | El objetivo principal de esta guía | Obligatoria |
| GitLens | Ver quién cambió qué y cuándo | Recomendada |
| Markdown Preview Enhanced | Previsualiza tus documentos de forma elegante | Recomendada |
| Material Icon Theme | Hace que tu árbol de archivos se vea limpio | Opcional |
| Error Lens | Muestra errores en línea mientras escribes | Opcional |
Con las extensiones instaladas, VS Code se transforma de un editor en blanco en un espacio de trabajo de IA con propósito definido. A continuación, aprende los pocos atajos de teclado que más tiempo te ahorrarán.
No necesitas memorizar 200 atajos. Estos 12 cubren el 90% del uso diario:
| Acción | Mac | Windows |
|---|---|---|
| Abrir panel de Claude Code | Cmd+L | Ctrl+L |
| Abrir terminal | Ctrl+` | Ctrl+` |
| Abrir archivo por nombre | Cmd+P | Ctrl+P |
| Abrir paleta de comandos | Cmd+Shift+P | Ctrl+Shift+P |
| Buscar en todos los archivos | Cmd+Shift+F | Ctrl+Shift+F |
| Alternar barra lateral | Cmd+B | Ctrl+B |
| Guardar archivo | Cmd+S | Ctrl+S |
| Deshacer | Cmd+Z | Ctrl+Z |
| Nueva línea en Claude (sin enviar) | Shift+Enter | Shift+Enter |
| Enviar mensaje a Claude | Enter | Enter |
| Dividir editor (lado a lado) | Cmd+\ | Ctrl+\ |
| Cerrar pestaña actual | Cmd+W | Ctrl+W |
Estos no son atajos de VS Code - son atajos del sistema operativo que te hacen más rápido en todo. La mayoría de personas nunca los aprende:
| Acción | Mac | Windows |
|---|---|---|
| Captura de pantalla (pantalla completa) | Cmd+Shift+3 | Win+Shift+S |
| Captura de pantalla (área seleccionada) | Cmd+Shift+4 | Win+Shift+S |
| Dictado por voz | Fn+Fn (presiona dos veces) | Win+H |
| Historial del portapapeles | - (usa la app Maccy) | Win+V |
| Spotlight / Búsqueda | Cmd+Space | Win+S |
| Selector de emojis | Cmd+Ctrl+Space | Win+. |
| Cambiar entre apps | Cmd+Tab | Alt+Tab |
| Bloquear pantalla | Cmd+Ctrl+Q | Win+L |
Aquí está la estructura de carpetas recomendada para tu espacio de trabajo. No necesitas crearlas todas ahora - Claude las creará según las necesite. Pero entender la distribución ayuda:
Por qué importa: Claude Code lee y escribe archivos en tu espacio de trabajo. Una estructura limpia significa que Claude siempre sabe dónde encontrar las cosas y dónde guardar los resultados. También significa que tú mismo puedes encontrar las cosas sin rebuscar en el caos.
node --version funciona en la terminal)Git rastrea cada cambio que realizas. GitHub lo almacena en la nube. Juntos, significan que nunca puedes perder tu trabajo y siempre puedes deshacer un error. Piénsalo como "deshacer ilimitado para todo tu proyecto."
Git es control de versiones. Cada vez que haces un commit (guardas un punto de control), Git toma una instantánea de tu proyecto. Puedes volver a cualquier instantánea en cualquier momento. Piénsalo como un sistema de guardado para código - excepto que cada guardado es permanente, etiquetado y reversible. Nunca más pierdes trabajo.
| Método antiguo | Método nuevo |
|---|---|
| Guardar como sitio-v2-FINAL-real-FINAL.html | git commit -m 'polish homepage' |
| Enviar el archivo por correo a un compañero | git push - ellos hacen pull de lo más reciente automáticamente |
| Hacer un cambio, romper algo, no puedes deshacer | git checkout [commit anterior] - de vuelta en 10 segundos |
| La laptop muere, el trabajo se pierde | git push diario - el código vive en GitHub para siempre |
git checkout lo restaura.github.comSigue las instrucciones: elige HTTPS, autentícate vía navegador. Si no tienes Homebrew, instálalo primero desde brew.sh.
Sigue las instrucciones: elige HTTPS, autentícate vía navegador.
gh auth login autentica la terminal. VS Code también necesita su propia conexión con GitHub - no comparten credenciales.
Después de instalar VS Code, busca el ícono de Cuentas (silueta de persona) en la parte inferior de la barra lateral izquierda y haz clic en Iniciar sesión con GitHub. Alternativamente, abre el panel de Control de código fuente (Ctrl+Shift+G / Cmd+Shift+G en Mac), haz clic en Clonar repositorio y VS Code te pedirá que inicies sesión. Ambos inicios de sesión son necesarios - el CLI para comandos de terminal, VS Code para su interfaz git integrada.
my-workspace. Hazlo Privado.Inmediatamente después de git init, crea tu archivo .gitignore para que los archivos sensibles nunca sean rastreados:
Ahora haz tu primer commit y envíalo:
.gitignore antes de tu primer git add. Esto evita que las claves de API (.env), los certificados de seguridad (*.key, *.pem) y los archivos del sistema (.DS_Store) sean rastreados por git. Una vez que un archivo es incluido en un commit, eliminarlo del historial es complicado.
Un archivo .env almacena secretos: claves de API, contraseñas, URLs de bases de datos, por separado de tu código. Tu código los lee en tiempo de ejecución. El archivo nunca se envía a GitHub (tu .gitignore lo bloquea). Esto significa que tus claves de API no terminan accidentalmente en repositorios públicos. Uno de los errores más comunes de principiantes es pegar una clave de API directamente en el código y enviarlo a GitHub. Así es como se comprometen las cuentas. Usa siempre .env.
La primera línea de tu .gitignore debe ser: .env - compruébalo ahora mismo.
No necesitas aprender git complejo. Estos 3 comandos cubren el 95% del uso diario:
gh auth login. Eso es todo. Para alguien que lo ha hecho antes, esto toma unos 5 minutos. La primera vez se siente desconocido porque los menús son nuevos. Después de tu segundo repositorio ya no pensarás en ello. Cada configuración que haces es más rápida, en la quinta apenas lo notarás.
Una vez que tu código está enviado a GitHub, puedes hacerlo accesible públicamente en unos pocos clics. Esto te da una URL real con https:// que cualquiera puede visitar.
github.comhttps://TU-USUARIO.github.io/my-workspace/Esa URL es algo que realmente puedes enviarle a alguien. No es bonita - lo arreglaremos en el Módulo 5 con Cloudflare - pero funciona y es gratuita.
GitHub Pages: gratuito, integrado en GitHub, cero configuración más allá de un interruptor en Settings. Disponible en https://username.github.io/repo-name/. Ideal para proyectos personales, portfolios, demos rápidas. Limitación: la URL es fea y no puedes usar un dominio personalizado en el plan gratuito sin algunos ajustes.
Cloudflare Pages: también gratuito, despliegue en 30 segundos, soporte de dominio personalizado, más rápido globalmente, ramas de staging. Configuración ligeramente mayor (3 comandos CLI). Mejor para trabajo con clientes y todo lo que quieras mostrar con orgullo.
Nuestra elección: Cloudflare Pages para trabajo con clientes, GitHub Pages para herramientas internas y proyectos personales. Usa ambos, son gratuitos.
npm create astro@latest
gh auth status funciona).gitignore existe con .env incluidogit status se ejecuta sin errores en tu terminalhttps:// realAntes de llegar a Cloudflare, hay un concepto que debes dominar. Este confunde a casi todos los que son nuevos en el trabajo web, y una vez que lo entiendes, lo entiendes para siempre.
https:// que cualquiera puede visitar. Todo en esta guía, GitHub Pages y Cloudflare Pages, existe para cerrar esa brecha.
GitHub te da una URL en vivo gratuita (acabas de obtener una en el Módulo 3). Cloudflare te da una URL más rápida con soporte de dominio personalizado. El siguiente módulo es donde eso ocurre.
Usaste GitHub para poner tu código en línea. Cloudflare es cómo lo haces sentir como un sitio web real: dominio personalizado, rápido a nivel global, SSL incluido, gratuito. La mayoría de las agencias paga $50-200/mes por configuraciones de hosting que Cloudflare reemplaza por nada.
| Método antiguo - hosting tradicional | Método nuevo - Cloudflare Pages |
|---|---|
| Un servidor, un país | 200+ servidores perimetrales, distribuidos globalmente |
| $10-20/mes por sitio | El nivel gratuito cubre todo |
| El certificado SSL cuesta extra o es manual | SSL aprovisionado automáticamente |
| Subir archivos via FTP uno por uno | Desplegar toda la carpeta en 30 segundos desde la terminal |
| Panel cPanel del año 2003 | Panel moderno y limpio + CLI |
wrangler login. Eso es la "configuración de la API". Para alguien que lo ha hecho una vez, es un trabajo de 5 minutos. La mayoría de las herramientas SaaS siguen el mismo patrón: iniciar sesión, Configuración, sección de Desarrollador o API, generar un token, pegarlo en tu proyecto. Las APIs normales son fáciles. Si llevas más de 15 minutos atascado, el problema casi siempre es un menú equivocado o un nombre de variable equivocado, no tú.
wrangler login abrió tu navegador y conectó el CLI a tu cuenta de Cloudflare. wrangler pages deploy envió cada archivo de esa carpeta a la red global de Cloudflare. Ahora tienes una URL en vivo, algo como my-site-abc123.pages.dev. Guárdala en marcadores.
Aquí es donde se vuelve útil para trabajo real con clientes. Por eso Cloudflare importa más allá del "hosting gratuito".
En lugar de enviarles a los clientes una URL como john-doe.github.io/client-project-v2-final-REAL/, les envías graphicstudio.nyc. La mecánica: apunta el DNS de tu dominio a Cloudflare (un ajuste, unos 5 minutos), luego en el panel conecta ese dominio a tu proyecto de Pages. La primera vez toma unos 15 minutos. Cada vez después, 5 minutos.
Un dominio puede alojar múltiples proyectos. Tu agencia en graphicstudio.nyc sirve graphicstudio.nyc/client-alpha, graphicstudio.nyc/client-beta, graphicstudio.nyc/staging. Cada ruta es un proyecto de Pages separado. Los administras todos desde una cuenta de Cloudflare. Limpio, profesional, $0.
Cloudflare Pages crea automáticamente una URL de vista previa única para cada rama de git. Tu rama principal está en vivo en tu dominio personalizado. Tu rama de staging obtiene su propia URL, algo como staging-branch.project-abc.pages.dev. Se la envías a un cliente para su aprobación. Navega por ella, confirma que está bien. Haces el merge. El sitio en vivo se actualiza. Cero riesgo para lo que ya está en vivo.
Lo que le envías a un cliente señala tu profesionalismo. Compara:
https://yourname.github.io/client-project-v2-final-REAL/https://preview.graphicstudio.nyc/client-alphaDos opciones: (1) configura un subdominio de vista previa en el dominio de tu agencia, no cuesta nada; (2) configura un dominio en la cuenta del propio cliente y adminístralo por ellos, cobra más, se ve más premium.
wrangler whoami muestra tu cuenta)pages.devDominio personalizado. CDN global. Enlaces de staging. SSL. Todo ello. El Manual Avanzado es donde llevas esto más lejos: funciones serverless, bases de datos, agentes autónomos. Sigue adelante.
Ver qué hay en el Manual Avanzado →A mitad del camino. El Manual Avanzado continúa donde esto termina - agentes, automatización y cómo escalar tus operaciones de IA.
Vista previa del Manual Avanzado →Claude Code es el puente entre la inteligencia de Claude y tu espacio de trabajo. Lee tus archivos, escribe código, ejecuta comandos y recuerda el contexto, todo desde dentro de VS Code.
Verifica que funcionó:
Deberías ver un número de versión. Si el comando no se encuentra, cierra y vuelve a abrir VS Code.
Si instalaste la extensión de Claude Code en el Módulo 2, ya estás listo. Ábrela con Cmd+L (Mac) o Ctrl+L (Windows). La extensión detecta automáticamente la CLI que acabas de instalar.
Al abrirse por primera vez, Claude te pedirá que te autentiques. Haz clic en el enlace, inicia sesión con tu cuenta de Claude y aprueba la conexión.
Claude necesita permiso para leer archivos, editarlos y ejecutar comandos. Tú controlas cuánta libertad le das:
| Modo | Qué puede hacer Claude sin preguntar | Ideal para |
|---|---|---|
| Predeterminado | Solo leer archivos | Primeros usuarios, trabajo delicado |
| Aceptar ediciones (recomendado) | Leer y editar archivos | Trabajo diario - el punto ideal |
| Automático | La mayoría de cosas, con verificaciones de seguridad | Tareas largas, usuarios con experiencia |
| Bypass | Todo (modo YOLO) | Solo entornos desechables |
Cómo configurarlo: Haz clic en el indicador de modo en la parte inferior del panel de Claude. O abre la configuración de VS Code (Cmd+,), busca "Claude Code" y establece tu modo predeterminado.
En la configuración de VS Code, busca "Claude Code" y activa "Allow dangerously skip permissions". Esto hace que la opción "Bypass permissions" aparezca en el selector de modo.
Úsalo solo en entornos aislados (contenedores, máquinas virtuales, proyectos desechables). No ofrece ninguna protección contra daños accidentales.
Claude tiene tres tamaños. Cada uno tiene un punto ideal. Usar el modelo correcto para cada tarea ahorra dinero y obtiene mejores resultados:
| Qué estás haciendo | Modelo | Por qué |
|---|---|---|
| Preguntas rápidas, formato, limpieza | Haiku | Rápido y económico |
| Escritura, análisis, trabajo con clientes | Sonnet | Mejor equilibrio entre velocidad y calidad |
| Planificación compleja, arquitectura, estrategia | Opus | Razonamiento más profundo |
Claude Code es poderoso, pero resiste el impulso de darle las llaves desde el primer día. Durante la primera semana:
Esto no es ser cauteloso. Es aprender cómo funciona Claude para poder darle mejores instrucciones más adelante.
Te encontrarás con errores. Las cosas fallarán. Es normal. Este es tu manual de resolución de problemas:
En Mac: Cmd+Shift+4 para seleccionar el área. En Windows: Win+Shift+S. Esto guarda una captura en tu portapapeles o escritorio.
Claude Code puede leer imágenes. Arrastra una captura directamente al panel de chat de Claude Code y pregunta: "¿Qué está fallando aquí?" Claude leerá el mensaje de error de la imagen y te ayudará a solucionarlo.
Si Claude Code no responde o estás bloqueado de una manera que necesita una perspectiva nueva, abre claude.ai en tu navegador. La misma cuenta, sin costo adicional. Pega el texto del error o sube la captura y pide ayuda.
Al pedir ayuda, incluye tres cosas:
git push y esperaba que subiera mis archivos."claude --version devuelve un número de versiónEste es el módulo que separa "usar Claude" de "tener un socio comercial de IA". Sin esto, Claude da respuestas genéricas. Con esto, Claude conoce tu negocio, tu rol, tus objetivos y tus preferencias, en cada sesión.
Antes de configurar tu capa de identidad, es útil entender las dos superficies que usarás cada día y por qué cada una necesita una configuración de contexto separada.
| Claude.ai (navegador) | Claude Code (VS Code) | |
|---|---|---|
| Acceso | claude.ai en cualquier navegador | Extensión de VS Code |
| Lee tus archivos | No | Sí, directamente |
| Memoria | Memoria integrada y Proyectos | CLAUDE.md y archivos de memoria |
| Ideal para | Preguntas rápidas, lluvia de ideas, imágenes | Construir, codificar, proyectos de varios pasos |
| Acceso a terminal | No | Sí, ejecuta comandos |
| Suscripción | La misma cuenta de Claude | La misma cuenta de Claude |
Claude.ai tiene un sistema de memoria integrado. La mayoría de las personas nunca lo configura. Así se hace:
CLAUDE.md es un archivo de texto plano que vive en la carpeta de tu proyecto. Claude Code lo lee automáticamente cada vez que abres una sesión. Así le dices a Claude quién eres, en qué consiste el proyecto, cómo quieres que se comporte y qué nunca debe hacer. Sin él, Claude empieza cada conversación desde cero. Con él, Claude ya conoce tu stack, tu tono, tus clientes y tus reglas. Un solo archivo, memoria persistente.
Con 10 líneas es suficiente. Nombra el proyecto, describe qué hace, lista tu stack. Siempre puedes añadir más. Un CLAUDE.md imperfecto que escribiste hoy vale más que uno perfecto que nunca terminas.
CLAUDE.md es un archivo en la raíz de tu espacio de trabajo que Claude lee al inicio de cada conversación. Le dice a Claude quién eres y cómo trabajar contigo.
CLAUDE.md en la raíz de tu espacio de trabajoClaude Code tiene un sistema de memoria persistente. Los datos importantes sobre ti, tus preferencias y tus proyectos se guardan como pequeños archivos que Claude lee al inicio de cada conversación.
Cómo guardar algo en la memoria:
Cómo consultar qué recuerda Claude:
Cómo eliminar un recuerdo:
Claude Code tiene cuatro capas de memoria, de la más permanente a la más temporal:
Claude puede "ver" alrededor de 200.000 tokens a la vez, aproximadamente 150.000 palabras. Piénsalo como la memoria a corto plazo de Claude para la conversación actual. Todo lo que dices, todo lo que Claude dice y cada archivo que Claude lee durante la sesión ocupa espacio en esta ventana.
A medida que crece tu conversación, los mensajes más antiguos se resumen o comprimen para dar espacio a los nuevos. Esto es automático y generalmente fluido, pero en sesiones muy largas puedes notar:
@archivo en lugar de pegar - señalar a Claude un archivo usa menos contexto que pegar su contenido en el chatUna vez que tengas escrito tu CLAUDE.md, ejecuta este prompt. Inicializa tus archivos de memoria con el mismo contexto para que Claude lo tenga en dos lugares.
Cuando Claude tiene el contexto adecuado, las respuestas mejoran de forma espectacular. Deja de dar consejos genéricos y empieza a conectar puntos: "Dado el perfil de tus clientes y el hecho de que trabajas con restaurantes, así es exactamente como estructuraría este calendario de contenido..." Esa es la diferencia entre una herramienta inteligente y un verdadero socio de negocios.
Los 2 o 3 días que dedicas a configurar el contexto generan beneficios en cada conversación durante años.
A medida que te sientas cómodo, puedes añadir dos capas más:
.claude/rules/) - archivos de comportamiento específicos por dominio. Ejemplo: "al escribir correos para clientes, usa siempre este tono"..claude/skills/) - flujos de trabajo reutilizables de varios pasos que activas con /nombre-habilidad. Ejemplo: /monthly-report genera un informe completo para el cliente.Crea la carpeta: .claude/skills/ en la raíz de tu espacio de trabajo.
Crea un archivo llamado weekly-report.md dentro de ella:
Ahora, cuando escribas /weekly-report Sunrise Cafe, Claude ejecuta todo el flujo de trabajo.
Tienes Claude Code instalado, autenticado y tu CLAUDE.md escrito. Esta es tu primera conversación real:
Claude debería responder con detalles de tu CLAUDE.md. Si da una respuesta genérica, algo salió mal: verifica que CLAUDE.md esté en la raíz de tu carpeta de espacio de trabajo abierta.
Claude listará sus capacidades: leer archivos, escribir archivos, ejecutar comandos de terminal, buscar en la web (si MCP está configurado), etc.
test.md, estás en marcha. Tienes una IA que puede leer tus archivos, recordar tus preferencias y producir resultados a pedido. Todo lo que viene después se construye sobre esta base.
Sin APIs, Claude solo puede leer y escribir archivos en tu espacio de trabajo. Con APIs, Claude se convierte en un sistema operativo: lee tus correos, actualiza tus hojas de cálculo, publica en redes sociales, obtiene analíticas y gestiona tu calendario. Las APIs son la diferencia entre "bloc de notas inteligente" y "negocio impulsado por IA".
Notion, Slack, OpenAI, Perplexity, Firecrawl, todos siguen los mismos 3 pasos: inicia sesión, ve a Configuración o la sección para desarrolladores, genera un token y pégalo en .env. Si una herramienta tiene una API normal, instalarla es fácil. Si llevas más de 15 minutos bloqueado, el problema casi siempre es: menú equivocado, alcance de permisos incorrecto o nombre de variable incorrecto en tu .env, no tú.
.env. Para tu quinta clave de API ya no lo pensarás dos veces.
MCP son las siglas de Model Context Protocol. Es la forma en que Claude accede a herramientas reales: tu Google Drive, tus Sheets, tu Gmail, tu Notion, Slack, GitHub. Sin MCP, Claude solo puede leer y escribir archivos en tu carpeta. Con MCP, Claude puede leer tu bandeja de entrada real, actualizar una hoja de cálculo real, publicar en Slack. Cada servidor MCP que añades es un nuevo superpoder. Solo el conjunto de Google (Drive, Sheets, Gmail, Calendar) tarda unos 15 minutos en conectarse y hace que Claude sea inmediatamente 10 veces más útil.
Estas 10 conexiones funcionan para todos. Sin importar tu nicho, tipo de negocio o nivel de experiencia, estas son la base.
| # | API / Herramienta | Qué hace Claude con ella | Prioridad |
|---|---|---|---|
| 1 | Google Drive (MCP) | Lee y escribe tus documentos y archivos directamente | Empieza aquí |
| 2 | Google Sheets (MCP) | Lee y actualiza hojas de cálculo sin copiar y pegar | Empieza aquí |
| 3 | Gmail (MCP) | Lee, redacta y busca en tus correos | Empieza aquí |
| 4 | Google Calendar (MCP) | Consulta y crea eventos | Empieza aquí |
| 5 | OpenAI | Generación de imágenes (DALL-E), GPT como modelo alternativo | Sí |
| 6 | Firecrawl | Extrae contenido de cualquier página web | Sí |
| 7 | Perplexity | Investigación web en tiempo real con citas | Sí |
| 8 | Google Search Console | Datos de palabras clave, rendimiento de clics, indexación | Si haces SEO |
| 9 | Slack (MCP) | Lee y envía mensajes a canales | Si usas Slack |
| 10 | Notion u Obsidian | Tus notas y base de conocimiento | Si usas alguno |
A continuación hay 5 stacks preconfigurados. Elige el más cercano a tu trabajo y luego añade herramientas individuales de los demás según lo necesites. No necesitas los cinco: revisa las descripciones y elige el que mejor se adapte a tu flujo de trabajo diario.
Para creadores de contenido, gestores de redes sociales y constructores de marca.
| # | API / Servicio | Qué hace | Cómo conectar |
|---|---|---|---|
| 1 | Buffer | Programa publicaciones en varias plataformas | buffer.com → Settings → API |
| 2 | Canva API | Genera y edita diseños de forma programática | canva.com/developers |
| 3 | OpenAI | Generación de imágenes (DALL-E), GPT para variaciones | platform.openai.com → API Keys |
| 4 | Google Sheets | Calendarios de contenido, seguimiento de analíticas | Servidor MCP (flujo OAuth) |
| 5 | Instagram Graph API | Lee estadísticas, gestiona contenido | developers.facebook.com |
Para agencias de SEO, consultores y cualquier persona que trabaje en posicionamiento en buscadores.
| # | API / Servicio | Qué hace | Cómo conectar |
|---|---|---|---|
| 1 | Google Search Console | Datos de palabras clave, indexación, rendimiento | Servidor MCP (flujo OAuth) |
| 2 | SEMrush / DataForSEO | Investigación de palabras clave, análisis de competencia, datos SERP | Claves de API de semrush.com o dataforseo.com |
| 3 | Screaming Frog / Firecrawl | Auditorías de sitios, datos de rastreo, SEO técnico | CLI de Screaming Frog o API de firecrawl.dev |
| 4 | Google Sheets | Informes, seguimiento de palabras clave, paneles para clientes | Servidor MCP (flujo OAuth) |
| 5 | Ahrefs | Datos de backlinks, autoridad de dominio, brechas de contenido | ahrefs.com → Acceso a API |
| 6 | BrightLocal | Citas locales, monitoreo de reseñas, seguimiento de posiciones | brightlocal.com → API |
El stack de SEO es intensivo en datos por naturaleza. La ventaja es que Claude puede obtener datos de palabras clave, cruzarlos con los backlinks de la competencia y redactar un brief de contenido, todo en un solo prompt.
Para agencias y especialistas en marketing que necesitan todo conectado.
| # | API / Servicio | Qué hace | Cómo conectar |
|---|---|---|---|
| 1 | Claude / OpenAI | Generación con IA, análisis, resumen | console.anthropic.com / platform.openai.com |
| 2 | Google Workspace | Drive, Sheets, Docs, Gmail, Calendar | Servidores MCP (flujo OAuth) |
| 3 | HubSpot / GoHighLevel | CRM, pipelines, automatizaciones | Portal de desarrolladores de HubSpot / configuración de API de GHL |
| 4 | Mailchimp / Instantly | Email marketing, secuencias de contacto en frío | Claves de API de mailchimp.com o instantly.ai |
| 5 | Google Analytics 4 | Tráfico del sitio web, conversiones, comportamiento de usuarios | Servidor MCP o API de GA4 |
| 6 | Programador de redes sociales | Buffer, Hootsuite o Later, para programar publicaciones | Claves de API de la plataforma elegida |
| 7 | Firecrawl / Apify | Extracción web, monitoreo de competencia | Claves de API de firecrawl.dev o apify.com |
| 8 | Stripe | Pagos, suscripciones, seguimiento de ingresos | dashboard.stripe.com → Claves de API |
Para operadores independientes, freelancers y cualquier persona que quiera que Claude gestione su vida digital.
| # | API / Servicio | Qué hace | Cómo conectar |
|---|---|---|---|
| 1 | Google Drive | Lee y escribe documentos, busca archivos, organiza carpetas | Servidor MCP (flujo OAuth) |
| 2 | Google Sheets | Registra cualquier cosa: finanzas, hábitos, proyectos | Servidor MCP (flujo OAuth) |
| 3 | Gmail | Lee y redacta correos, gestiona la bandeja de entrada | Servidor MCP (flujo OAuth) |
| 4 | Google Calendar | Lee y crea eventos, verifica disponibilidad | Servidor MCP (flujo OAuth) |
| 5 | Notion / Obsidian | Notas, wikis, segundo cerebro | API de Notion o archivos locales de Obsidian |
El stack de operador personal es el más ligero: cinco conexiones y Claude gestiona tu correo, calendario, documentos y notas. La mayoría de los operadores independientes descubren que esto es todo lo que necesitan durante el primer mes.
Para creadores de cursos, YouTubers, educadores y cualquier persona que construya una audiencia a través de contenido.
| Herramienta | Qué hace | Caso de uso |
|---|---|---|
| OpenAI | Generación de imágenes y GPT | Imágenes y variaciones de contenido |
| ElevenLabs | Síntesis de voz | Locuciones, contenido de audio |
| HeyGen / D-ID | Generación de video con IA | Videos con presentador a escala |
| YouTube Data API | Analíticas del canal y publicación | Saber qué funciona, programar subidas |
| Canva API | Automatización de diseño | Crear gráficos de marca por lotes |
| Beehiiv / ConvertKit | Newsletter y correo electrónico | Automatizar secuencias de envío |
Las claves de API son contraseñas que permiten a Claude hablar con servicios externos. Nunca deben confirmarse en git.
Crea un archivo llamado .env en la raíz de tu espacio de trabajo:
Confirma que .env está en tu .gitignore (debería estarlo si seguiste el Módulo 3):
Deberías ver .env en la lista. Si no, agrégalo:
.env (que están ignorados por git) o variables de entorno. Si Claude te pide que pegues una clave en algún lugar visible, eso está mal, recházalo.
.env existe y está en la lista de .gitignoreYa superaste la mitad. El Manual avanzado te muestra orquestación multiagente, pipelines de implementación y flujos de trabajo autónomos.
Leer el Manual avanzado →La mayoría de las personas hacen prompts como si le enviaran un mensaje de texto a un amigo. Vagos. Incompletos. Luego se preguntan por qué el resultado es mediocre. Un buen prompt consiste en darle a Claude el contexto, las restricciones y el formato correctos, no en usar palabras mágicas.
| Malo (negativo) | Bueno (positivo) |
|---|---|
| "No lo hagas muy largo" | "Mantenlo en menos de 200 palabras" |
| "No uses jerga" | "Escribe para un empresario sin conocimientos técnicos" |
| "No seas aburrido" | "Usa oraciones cortas. Empieza con el beneficio." |
Compáralo con: "Escríbeme un correo en frío." El primer prompt le da a Claude tu nicho, la situación del cliente potencial, la brecha específica, el formato y el tono. El resultado será 10 veces mejor.
Claude Code puede leer archivos directamente. Apúntalo al archivo en lugar de pegar el contenido en el chat. Esto mantiene el contexto limpio y usa tu fuente de verdad.
Los mensajes largos con múltiples partes generan confusión. Divide el trabajo complejo en pasos:
Si tienes una habilidad o flujo de trabajo bien definido con pasos claros, SÍ puedes darle a Claude todo en un solo mensaje. La clave es: ¿tiene Claude suficiente contexto para ejecutar cada paso sin hacer preguntas? Si es así, un solo mensaje está bien. Si necesitará preguntar "¿qué quieres decir con X?" a mitad del proceso, divídelo.
Estos cuatro patrones cubren la mayoría de las técnicas de prompting útiles. Apréndelos y obtendrás mejores resultados de cualquier IA, no solo de Claude.
Dile a Claude quién debe ser. Esto enfoca su conocimiento y cambia su tono.
Obliga a Claude a pensar antes de responder. Esto mejora drásticamente la precisión en preguntas complejas.
Muéstrale a Claude cómo es un buen resultado. Es la forma más rápida de obtener resultados consistentes.
Pon límites para que Claude no se desvíe. Cuantas más restricciones, más enfocado el resultado.
Tanto Claude como ChatGPT son excelentes para extraer, estructurar y transformar datos. La clave es ser explícito sobre el formato:
| Lo que quieres | Patrón de prompt |
|---|---|
| Datos estructurados desde texto desordenado | "Extrae todos los nombres de empresas, correos y teléfonos de este texto. Muestra el resultado como CSV." |
| Resumen de un documento largo | "Lee este documento y dame: 1) resumen en 3 oraciones, 2) decisiones clave, 3) tareas con responsables." |
| Tabla comparativa | "Compara X e Y en estas dimensiones: [lista]. Muestra el resultado como una tabla en markdown." |
| Reescritura para otra audiencia | "Reescribe esto para [audiencia]. Mantén los mismos datos. Cambia el tono a [tono]. Máximo [N] palabras." |
Claude Code es tu segundo cerebro. Cuando las ideas lleguen a mitad de una sesión, captúralas al instante en lugar de perderlas:
Claude Code tiene una sintaxis especial que el Claude normal (navegador) no tiene. Aprende estos tres:
| Sintaxis | Qué hace | Ejemplo |
|---|---|---|
@nombre-archivo | Hace referencia a un archivo específico para que Claude lo lea | @knowledge/clients/acme/profile.md - Claude lee el archivo |
#símbolo | Hace referencia a un símbolo de código (función, clase, variable) | #generateReport - Claude encuentra y se enfoca en esa función |
| Shift+Enter | Nueva línea sin enviar, escribe prompts de varias líneas | Escribe un prompt de 5 líneas, luego presiona Enter para enviarlo todo de una vez |
@knowledge/clients/acme/profile.md en tu mensaje. Claude lo leerá automáticamente. Funciona con cualquier archivo en tu espacio de trabajo.
Ahora que sabes cómo referenciar archivos y escribir prompts de varias líneas, la siguiente pregunta es cuándo usar Claude Code frente a otras herramientas que ya conoces.
| Situación | Mejor herramienta | Por qué |
|---|---|---|
| Pregunta rápida / lluvia de ideas | ChatGPT (navegador) | Más rápido para respuestas puntuales |
| Trabajar con tus archivos | Claude Code | Lee y escribe tu espacio de trabajo directamente |
| Proyectos de varios pasos | Claude Code | Contexto persistente, memoria, acceso a archivos |
| Generación de imágenes | ChatGPT (DALL-E) | Claude no genera imágenes |
| Búsqueda web durante una tarea | Claude Code + MCP | Busca sin salir de tu flujo de trabajo |
| Construir un sitio web o herramienta | Claude Code | Escribe código, lo ejecuta y lo implementa |
| Escribir contenido de formato largo | Cualquiera | Ambos son excelentes; Claude Code guarda en archivo automáticamente |
| Análisis de datos en archivos locales | Claude Code | Lee CSV, JSON y hojas de cálculo directamente del disco |
Úsalo para analizar cualquier negocio en 5 minutos. Funciona para clientes potenciales, competidores o tus propios clientes. Guarda el resultado directamente en tu espacio de trabajo.
Para tutores o coaches: reemplaza "Google Ads" con "testimonios/prueba social en el sitio" y añade "busca su especialidad de enseñanza en YouTube".
Para comercio electrónico: añade verificaciones de "schema de producto" y "presencia en Google Shopping".
Para agentes inmobiliarios: añade verificaciones de "perfil en Zillow/Realtor.com" y "contenido de vecindario".
Úsalo para generar una semana de contenido en 10 minutos. Guarda el resultado directamente en tu espacio de trabajo.
Desarrolla este hábito y estarás por delante del 95% de las personas en tu industria en un mes:
| Momento | Acción | Prompt |
|---|---|---|
| Mañana 5 min | Retoma con Claude | "¿En qué estábamos trabajando en la última sesión? ¿Cuál es la próxima prioridad?" |
| Bloque de trabajo 5 min | Delega una tarea | "[Tu prompt de tarea específica aquí]" |
| Fin del día 5 min | Guarda el progreso | "Confirma todo y envía. ¿Qué logramos hoy?" |
Lo lograste. Esto es todo lo que tienes ahora:
| Tienes… | Qué significa esto |
|---|---|
| VS Code + extensión de Claude Code | Tu espacio de trabajo de IA está abierto y listo |
| Repositorio de GitHub configurado | Nada se pierde: historial de versiones completo desde el primer día |
| Documento de traspaso de ChatGPT completado | 3 años de contexto de IA traídos a Claude |
| CLAUDE.md escrito | Claude sabe quién eres antes de que digas una palabra |
| Memoria de Claude.ai entrenada | Las preguntas rápidas en el navegador también reciben respuestas contextuales |
| Memoria de Claude Code activa | Claude recuerda decisiones y preferencias entre sesiones |
| Al menos una API conectada | Claude puede llegar más allá de tus archivos |
| 5 reglas de prompting interiorizadas | Obtienes respuestas útiles, no genéricas |
| 4 patrones de prompt aprendidos | Puedes dar forma al resultado de Claude de manera confiable |
| Un flujo de trabajo real probado | Hiciste el trabajo, no solo lo leíste |
| Hábito diario de 15 minutos iniciado | Esto deja de ser una herramienta y empieza a ser un socio |
| Flujo de trabajo de implementación entendido | Puedes tomar un archivo y convertirlo en una URL activa |
curl -s -o /dev/null -w "%{http_code}" https://your-url y confirma que devuelve 200. Eso es cuando está hecho.
Hacia dónde ir a continuación:
El Manual avanzado cubre orquestación multiagente, MCPs personalizados, pipelines de implementación, flujos de trabajo autónomos y cómo convertir todo esto en dinero real. Todo lo que acabas de aprender fue la base. Aquí es donde construyes la máquina.
Abrir el Manual avanzado →¿Ya te sientes cómodo con lo básico? Salta directamente a agentes, automatización y escala de tus operaciones de IA.
Leer el Manual avanzado →