0%

📖 Glosario de términos

Cheat SheetGuía de Claude

¿Qué es Claude?

Todo lo que tu equipo necesita saber para empezar, sin conocimientos previos de IA.

Claude es un asistente de inteligencia artificial creado por Anthropic. Funciona mediante un modelo de lenguaje (LLM): un programa entrenado con enormes cantidades de texto que aprendió a entender y generar lenguaje humano. No busca información en internet en tiempo real por defecto, sino que aprendió patrones del lenguaje durante su entrenamiento, aunque tiene capacidad de búsqueda web cuando la necesita.

Piénsalo así: Claude es como un colega extraordinariamente bien leído que puede redactar, analizar, programar, resumir y organizar información — pero que necesita que le des instrucciones claras para hacer su mejor trabajo.

👤 Tú Escribes un prompt Instrucción Claude Procesa el contexto Razona sobre la tarea Genera la respuesta Resultado 📄 Salida Texto, código, análisis

¿Qué NO es Claude?

No es un buscador como Google (aunque puede buscar en la web). No almacena tus datos para entrenar modelos futuros en planes de pago. No es infalible: puede equivocarse, especialmente con datos numéricos o hechos muy recientes. Siempre verifica la información crítica.

Ruta de aprendizaje

Esta guía tiene mucho contenido. No intentes leerla toda de una. Sigue esta ruta progresiva — cada nivel se construye sobre el anterior.

Tu ruta: de cero a experto 🟢 NIVEL 1 — Principiante (Día 1-2) Vocabulario → Configurar Claude → Primeros pasos → Escribir buenos prompts → Etiquetas XML 🔵 NIVEL 2 — Intermedio (Semana 1) Proyectos → Instrucciones → Gestión del contexto → Archivos y formatos → MCP 🟣 NIVEL 3 — Avanzado (Semana 2-3) Extended Thinking → Deep Research → Cowork → Plugins → Skills desde GitHub 💡 Cada sección tiene ejercicios prácticos marcados con 🎯
Cómo usar esta guía en equipo: Pide a cada miembro que complete el Nivel 1 por su cuenta (toma ~1 hora). Luego hagan una sesión grupal de 30 minutos donde cada uno comparta un prompt que le funcionó bien. Repitan con Nivel 2 la semana siguiente.

Vocabulario esencial

Antes de seguir, familiarízate con estos términos. Los usarás todo el tiempo.

Cómo se conectan los conceptos Claude (un LLM) Prompt lo que escribes Contexto archivos + historial System Prompt instrucciones previas Artefacto resultado visual Tokens unidad que cobra/mide Alucinación riesgo: dato falso MCP Skills RAG
💡 Analogías para entender cada término (para principiantes)
TérminoAnalogía cotidiana
LLMUn estudiante que leyó millones de libros y puede hablar sobre cualquier tema, pero a veces inventa citas.
PromptLa pregunta que le haces a un experto. Cuanto más específica, mejor la respuesta.
TokenLas "monedas" con las que pagas. Cada palabra cuesta ~1.3 monedas. Más texto = más costo.
ContextoEl escritorio del experto. Todo lo que tiene a la vista para ayudarte. Si le llenas el escritorio de papeles, se confunde.
AlucinaciónCuando alguien no sabe la respuesta pero te contesta con total seguridad en vez de decir "no sé".
System PromptEl brief que le das a un empleado nuevo: "Eres el asistente de ventas, siempre responde en español".
MCPLos cables que conectan a Claude con tus apps (Gmail, Drive, Slack). Sin cable, no hay conexión.
AgenteUn asistente que toma decisiones solo: en vez de preguntarte cada paso, planifica y ejecuta.
ArtefactoEl documento terminado que Claude te entrega en un panel aparte: un archivo Word, una página web, un gráfico.
SkillUn manual de instrucciones que le das a Claude para que sepa hacer algo nuevo (como crear PowerPoints).
RAGEn vez de responder de memoria, Claude primero busca en tus documentos y luego te contesta con datos reales.
LLM (Large Language Model)
Modelo de lenguaje grande. Programa de IA entrenado con texto masivo para entender y generar lenguaje. Claude es un LLM.
Prompt
La instrucción o pregunta que le das a Claude. Es el "input" — lo que escribes en el chat.
Token
Unidad mínima de texto que procesa el modelo. 1 token ≈ ¾ de palabra en español. Una página ≈ 400 tokens. Las imágenes, PDFs y audio también consumen tokens. → Ver sección completa
Contexto (Context Window)
La "memoria de trabajo" de Claude para una conversación. Todo lo que puede "ver" a la vez: prompt + archivos + historial del chat.
Alucinación (Hallucination)
Cuando el modelo genera información falsa pero presentada con confianza. Ocurre especialmente con datos específicos.
System Prompt
Instrucciones previas que definen el comportamiento de Claude antes de que el usuario escriba. En Proyectos se llama "Instrucciones".
MCP (Model Context Protocol)
Protocolo que conecta a Claude con servicios externos (Google Drive, Slack, GitHub, etc.).
Agente / Agentic
Cuando Claude toma decisiones autónomas paso a paso para completar tareas complejas, sin que le digas cada acción.
Artefacto (Artifact)
Contenido que Claude genera en un panel separado: código, documentos, gráficos. Se puede editar, copiar o descargar.
Skill / Habilidad
Paquete de instrucciones especializadas que amplía lo que Claude puede hacer (crear PDFs, PPTX, XLSX, etc.).
Ingeniería de Contexto
El arte de estructurar todo lo que Claude recibe (instrucciones, archivos, ejemplos) para obtener mejores resultados. Evolución del "prompt engineering".
RAG
Retrieval Augmented Generation. Técnica donde el modelo consulta documentos externos antes de responder, para dar respuestas más precisas.

Tokens en profundidad

Un token es la unidad mínima que Claude procesa y con la que se mide todo: el costo, el límite de memoria, la velocidad de respuesta. Entender cómo se consumen tokens según el tipo de contenido te permite tomar decisiones que ahorran dinero y mejoran los resultados.

¿Qué es exactamente un token?

Cómo el texto se divide en tokens "Hola, ¿cómo puedo ayudarte hoy?" ↓ Claude divide esto en tokens ↓ Hola , ¿ cómo pue do ayud arte hoy ? " ≈ 10 tokens
Referencia rápidaTokens aproximados
1 palabra en español~1.3 tokens
1 párrafo (100 palabras)~130 tokens
1 página A4 de texto~400–500 tokens
1 libro de 300 páginas~120,000–150,000 tokens
Ventana máxima Haiku 4.5200,000 tokens (~500 págs)
Ventana máxima Sonnet / Opus1,000,000 tokens (~2,500 págs)
Nuevo tokenizador en Opus 4.7+ y Sonnet 5: Claude Opus 4.7 y modelos posteriores (incluyendo Fable 5, Mythos 5 y Sonnet 5) usan un tokenizador nuevo que produce aproximadamente un 30% más de tokens para el mismo texto. Esto mejora el rendimiento pero aumenta el costo si migras desde modelos más antiguos.

Consumo de tokens por tipo de contenido

No solo el texto consume tokens. Imágenes, PDFs y archivos tienen sus propias reglas. Esta tabla, basada en la documentación oficial de Anthropic, te permite comparar el costo real de cada tipo de entrada.

Tokens consumidos por tipo de contenido TIPO DE ENTRADA TOKENS APROX. COSTO Sonnet (MTok $3) EFICIENCIA 📝 Texto corto (email, prompt) ~200 palabras ~260 $0.00078 📄 Texto enriquecido (Word, MD) 1 página A4 ~500 palabras ~650 $0.00195 📕 PDF nativo (texto seleccionable) 10 páginas, ~5,000 palabras ~20,000–45,000 $0.06–$0.135 📗 PDF convertido a Markdown Mismo contenido, formato .md ~3,000–5,000 $0.009–$0.015 🖼️ Imagen pequeña (200×200 px) Fórmula: (ancho × alto) / 750 ~54 $0.00016 🖼️ Imagen grande (1092×1092 px) Máximo sin redimensionar (1:1) ~1,590 $0.0048

Tabla comparativa completa por tipo de contenido y modelo

Fuente: platform.claude.com/docs/en/about-claude/pricing y docs.anthropic.com/en/docs/build-with-claude/vision — precios actualizados julio 2026.

Tipo de contenido Tokens típicos Haiku 4.5
$1/$5 MTok
Sonnet 5*
$2/$10 MTok
Opus 4.8
$5/$25 MTok
Texto — email (200 palabras) ~260 in / ~150 out $0.00101 $0.00202 $0.00505
Texto — informe 10 págs (5K palabras) ~6,500 in / ~1,000 out $0.0115 $0.0230 $0.0575
PDF nativo — 10 páginas ~20,000–45,000 in $0.020–$0.045 $0.040–$0.090 $0.100–$0.225
PDF como Markdown — 10 páginas ~3,000–5,000 in $0.003–$0.005 $0.006–$0.010 $0.015–$0.025
Imagen pequeña (200×200 px) ~54 in $0.000054 $0.000108 $0.00027
Imagen media (1000×1000 px) ~1,334 in $0.0013 $0.0027 $0.0067
Imagen grande (1092×1092 px, max 1:1) ~1,590 in $0.0016 $0.0032 $0.0080
CSV — 1,000 filas × 10 columnas ~8,000–15,000 in $0.008–$0.015 $0.016–$0.030 $0.040–$0.075
Código fuente — 500 líneas ~2,500–4,000 in $0.0025–$0.004 $0.005–$0.008 $0.0125–$0.020
Sesión agéntica típica (1h) ~50K in / ~15K out $0.125 $0.250 $0.625

* Sonnet 5 en precio introductorio hasta agosto 31, 2026. Desde sep 1 sube a $3/$15 MTok. Audio no disponible en API directa de Claude — se procesa mediante transcripción previa. Los valores son estimados; el consumo real varía según el contenido.

Precios de suscripción vs. API

PlanCosto mensualAccesoLímite
Free$0Sonnet 4.6 limitadoCuota diaria baja
Pro$20 USDTodos los modelos~45 mensajes/5h con Opus
Max$100 USDTodos los modelos + prioridad5× más que Pro
Team$30 por usuarioTodo Pro + colaboraciónPor usuario
EnterpriseContratoTodo + seguridad avanzadaPersonalizado
APIPay-as-you-goTodos los modelosSin límite de mensajes

En planes de suscripción (Free/Pro/Max) no pagas por token directamente — pagas una cuota mensual fija. Pero el consumo de tokens sí afecta cuántos mensajes puedes enviar antes de llegar al límite de la ventana de 5 horas.

Descuentos y estrategias de ahorro (API)

EstrategiaAhorroCuándo usarla
Batch API50% en todos los modelosTareas que no necesitan respuesta inmediata (reportes nocturnos, clasificación masiva)
Prompt caching (5 min)90% en tokens de entrada cacheadosCuando repites el mismo system prompt o documentos largos en múltiples llamadas
Convertir PDF a Markdownhasta 90% por documentoSiempre que el PDF sea de texto, no de imagen
Usar Haiku para tareas simples5× vs Sonnet, 25× vs OpusClasificación, extracción, respuestas cortas y repetitivas
Redimensionar imágeneshasta 10× vs imagen grandeCuando solo necesitas análisis conceptual, no detalle de alta resolución
🎯 Ejercicio: Calcula el costo de tu caso de uso real

Usa esta fórmula para estimar tu gasto mensual:

Costo = ((tokens_entrada / 1,000,000) × precio_entrada)
      + ((tokens_salida / 1,000,000) × precio_salida)

Ejemplo: 100 análisis de PDF de 10 págs con Sonnet 5:
- Entrada: 100 × 25,000 tokens = 2,500,000 tokens → $5.00
- Salida:  100 × 1,000 tokens  =   100,000 tokens → $1.00
- Total: ~$6.00 por 100 análisis

Con caching del system prompt (90% descuento en entrada repetida): el costo bajaría a ~$1.50. Con Batch API encima (50% descuento): ~$0.75. Estas estrategias combinadas pueden reducir el costo hasta 95%.

Modelos: Opus, Sonnet, Haiku

Anthropic ofrece tres niveles de modelo. Piensa en ellos como tres empleados con diferentes perfiles: uno brillante pero costoso, uno excelente equilibrio, y uno rápido y económico. Además, existe un cuarto nivel premium (Fable) para tareas de máxima exigencia.

Opus

Opus 4.8

El más capaz · $5/$25 MTok
  • Razonamiento complejo
  • Pensamiento adaptativo
  • Tareas autónomas largas
  • Codificación avanzada
  • Contexto: 1M tokens
Úsalo para: decisiones críticas, código complejo, documentos extensos
Sonnet

Sonnet 5 / 4.6

Equilibrio perfecto · $3/$15 MTok
  • Escritura excelente
  • Código confiable
  • Rápido y preciso
  • Mejor costo-beneficio
  • Contexto: 1M tokens
Úsalo para: el 80% de las tareas diarias, desarrollo, análisis, escritura
Haiku

Haiku 4.5

Rápido y ligero · $1/$5 MTok
  • Respuestas instantáneas
  • Tareas simples y repetitivas
  • Clasificación de datos
  • Bajo costo por token
  • Contexto: 200K tokens
Úsalo para: preguntas rápidas, clasificación, tareas en lote
Regla práctica: Empieza siempre con Sonnet (es el modelo predeterminado en claude.ai). Sonnet 5 es la versión más reciente (junio 2026), con pensamiento adaptativo incluido. Solo sube a Opus si Sonnet no logra el resultado que necesitas — por ejemplo en razonamiento multi-paso complejo o tareas autónomas de larga duración. Para tareas que necesitan la máxima capacidad, existe Claude Fable 5 ($10/$50 MTok), ideal para agentes de larga duración.
Comparación visual de los modelos Inteligencia Velocidad Costo Contexto Opus Sonnet Haiku → Más largo = más Opus: el más inteligente y caro Sonnet: mejor equilibrio ⭐ Haiku: el más rápido y barato
🎯 ¿Qué modelo elijo? Guía rápida por tarea

Si no sabes cuál elegir, sigue esta regla: empieza con Sonnet. Si el resultado no es suficiente, sube a Opus. Si la tarea es repetitiva y simple, baja a Haiku.

TareaModelo
Email, resumen, pregunta rápidaSonnet
Análisis de contrato legalOpus
Clasificar 500 correosHaiku
Código con testsSonnet o Opus
Traducción simpleHaiku
Diseñar arquitectura complejaOpus
Blog post, contenidoSonnet

¿Cuánto cuesta cada modelo? Comparación de tokens

Si usas Claude vía API o te interesa entender por qué algunas conversaciones "cuestan" más que otras, esta tabla te ayudará. En los planes de suscripción (Pro, Max) no pagas por token directamente, pero el consumo de tokens sí afecta cuántos mensajes puedes enviar antes de alcanzar el límite.

Costo por tarea típica (estimado en USD vía API) TAREA Haiku $1/$5 Sonnet $3/$15 Opus $5/$25 Redactar un email ~500 in / ~300 out tokens $0.002 $0.006 $0.010 Resumir doc de 10 págs ~4K in / ~500 out tokens $0.007 $0.020 $0.033 Generar función + tests ~2K in / ~2K out tokens $0.012 $0.036 $0.060 Analizar PDF de 50 págs ~20K in / ~2K out tokens $0.030 $0.090 $0.150 Sesión agéntica (1 hora) ~50K in / ~15K out tokens $0.125 $0.375 $0.625 💡 Haiku es 5x más barato que Sonnet, y Sonnet es ~2x más barato que Opus Precios API (pago por token). En planes Pro/Max pagas suscripción fija con límite de mensajes.

Guía detallada: para qué usar cada modelo

🟣 Opus 4.6 / 4.7 / 4.8 — El cerebro senior

Opus es el modelo más inteligente de Anthropic. Piénsalo como contratar al consultor senior más caro: lo usas para las decisiones que importan, no para tareas rutinarias.

Cuándo usar Opus

Caso de usoPor qué Opus
Diseño de arquitectura de softwareEvalúa trade-offs complejos entre múltiples restricciones
Análisis legal de contratosComprende matices jurídicos que Sonnet puede pasar por alto
Codificación autónoma (agente multi-archivo)Mantiene coherencia en sesiones largas de código
Razonamiento matemático multi-pasoMenos errores en cadenas de 5+ pasos
Documentos de 100+ páginasVentana de 1M tokens + mayor capacidad de síntesis
Decisiones estratégicas complejasAnálisis más matizado de múltiples variables
No usar para: emails, resúmenes, traducciones, contenido estándar. Pagarías 2x más sin beneficio real.

Versiones: Opus 4.8 (mayo 2026) tiene pensamiento adaptativo. Opus 4.7 mejor codificación. Opus 4.6 estable y probado. Los tres cuestan lo mismo ($5/$25 por millón de tokens).

🔵 Sonnet 4.6 — El todoterreno ⭐ (recomendado para empezar)

Sonnet cubre el 80% de las tareas con calidad excelente. Es como un profesional senior que hace todo bien: no es el genio del equipo, pero rara vez te falla.

Cuándo usar Sonnet

Caso de usoPor qué Sonnet
Escritura profesionalCalidad casi idéntica a Opus, a la mitad del costo
Desarrollo de software generalCódigo confiable con tests. 128K tokens de salida
Análisis de datos y gráficosProcesa CSV/Excel, genera visualizaciones
Creación de documentos (Word, Excel, PDF, PPT)Sigue instrucciones de formato con precisión
Investigación y resúmenesSintetiza información de múltiples fuentes
Asistencia diariaRespuestas rápidas, contextuales, bien escritas
Es el predeterminado en claude.ai por una razón. Si no sabes cuál elegir, elige Sonnet.
🟢 Haiku 4.5 — El velocista económico

Haiku es el más rápido y barato. Perfecto para volumen y velocidad. Es como un asistente junior eficiente: no analiza contratos, pero clasifica 10,000 emails en minutos.

Cuándo usar Haiku

Caso de usoPor qué Haiku
Clasificación masiva5x más barato que Sonnet para sentimientos, categorías, prioridades
Extracción de datosSaca nombres, fechas, montos de documentos rápido
Traducción simpleTraduce bien textos estándar a fracción del costo
Enrutamiento de solicitudes"Guardián" que decide si una pregunta va a Sonnet o Opus
Chatbot de atención (nivel 1)Respuestas rápidas para preguntas frecuentes
Procesamiento por lotesCon Batch API: $0.50/$2.50 por millón de tokens
Limitaciones: Contexto de 200K tokens (vs 1M en Sonnet/Opus). Sin Extended Thinking. Puede fallar en razonamiento complejo.

Estrategia inteligente: escalar hacia arriba

No elijas un solo modelo. Empieza abajo y escala solo cuando sea necesario:

1. Prueba con Sonnet ¿El resultado es bueno? Sí → listo ✅ No ↓ 2. Sube a Opus ¿El resultado es bueno? Sí → listo ✅ No ↓ 3. Opus + Thinking Extended Thinking activado Máxima potencia 🚀

Y para tareas masivas o simples, baja a Haiku: clasificar, extraer, traducir, enrutar. No pagues precio Sonnet por trabajo que Haiku hace igual de bien.

Dónde usar Claude

InterfazPara quiénCaracterísticas clave
claude.ai (web/móvil)TodosChat, Proyectos, archivos, artefactos, búsqueda web, memoria
Cowork (escritorio)No-programadoresAcceso a archivos locales, tareas multi-paso, plugins, MCP, tareas programadas
Claude Code (terminal)DesarrolladoresCodificación agéntica desde el terminal, edición de código autónoma
Claude en ChromeTodosAgente de navegación, automatización web, formularios
Claude en ExcelAnalistasAgente para hojas de cálculo, fórmulas, análisis
APIDesarrolladoresIntegración programática, automatización a escala
Claude Modelo central claude.ai Web & Móvil Claude Code Terminal Cowork Escritorio API Integración Chrome Navegador Excel Hojas de cálculo

Primeros pasos en claude.ai

Tus primeros 15 minutos con Claude 1 Crear cuenta claude.ai 2 Preferencias Idioma, tono, rol 3 Activar tools Web, código, archivos 4 Primera pregunta Algo concreto 5 Crear Proyecto Agrupar trabajo
  1. Crea una cuenta en claude.ai. El plan gratuito da acceso limitado a Sonnet. El plan Pro ($20/mes) desbloquea Opus, Cowork, más mensajes y funciones avanzadas.
  2. Configura tus preferencias: ve a Ajustes → Preferencias de usuario. Aquí defines tu idioma preferido, tono y cómo quieres que Claude se comunique contigo. Estas preferencias se aplican a TODAS tus conversaciones.
  3. Activa las funciones: en el menú de herramientas del chat, activa Búsqueda web, Artefactos, Ejecución de código y Creación de archivos según las necesites.
  4. Haz tu primera pregunta: escribe algo concreto y observa la respuesta. Luego itera: pide ajustes, más detalle, otro enfoque.
  5. Crea tu primer Proyecto: agrupa conversaciones sobre un mismo tema con instrucciones y archivos compartidos. (Sección detallada más abajo.)
📋 Ejemplo de preferencias de usuario listas para copiar y pegar
## Sobre mí
- Idioma: Español (Colombia)
- Rol: [Tu cargo] en [Tu empresa]
- Nivel técnico: [Principiante / Intermedio / Avanzado]

## Cómo quiero que respondas
- Siempre en español
- Sé conciso, sin preámbulos largos
- Prefiero tablas sobre listas largas
- Incluye ejemplos prácticos
- Si no estás seguro de algo, dilo

## Herramientas que uso
- [Lista tus herramientas: Excel, Python, etc.]

Copia esto, personalízalo y pégalo en Ajustes → Preferencias de usuario. Cada conversación nueva lo leerá automáticamente.

Consejo clave: Configura las "Preferencias de usuario" primero. Estas viajan con cada conversación y evitan que repitas las mismas instrucciones. Ejemplo: Responde siempre en español. Soy analista de datos con conocimiento intermedio de Python. Prefiero explicaciones prácticas con ejemplos.

Configurar Claude paso a paso

Cuando abres Claude por primera vez, te hace dos preguntas que muchos usuarios ignoran. Configurarlas bien marca la diferencia entre un asistente genérico y uno que trabaja exactamente como tú necesitas.

Pantalla 1: "¿Qué describe mejor su trabajo?"

Lo que ves al configurar Claude ¿Qué describe mejor su trabajo? Selecciona una opción Ingeniería Marketing Ventas / Comercial ✓ Administración También: Diseño, Legal, RRHH, Educación, Finanzas, Otro... Puedes cambiarlo después en Ajustes

¿Qué hace esta selección?

Calibra el tono y las sugerencias de Claude. Si eliges "Marketing", Claude usará terminología de marketing y sugerirá KPIs. Si eliges "Ingeniería", hablará de código y arquitectura. No limita lo que puedes preguntar — solo ajusta el estilo predeterminado.

Si tu trabajo es una mezcla (como comercial + análisis de datos), elige la que más peso tenga en tu día a día. Puedes cambiarlo en cualquier momento en Ajustes → Perfil.

Pantalla 2: "Instrucciones para Claude"

Esta es la configuración más poderosa y la que más gente ignora. Es un bloque de texto libre donde le dices a Claude quién eres y cómo quieres que trabaje. Se aplica a TODAS tus conversaciones automáticamente.

Instrucciones para Claude (Custom Instructions) Instrucciones para Claude ## Sobre mí - Me llamo Juan, soy Director Comercial - Trabajo en construcción en Cali, Colombia - Nivel técnico: intermedio en Excel, básico en Python ## Cómo quiero que respondas - Siempre en español - Sé directo, sin preámbulos largos - Prefiero tablas sobre listas largas - Si no estás seguro de algo, dilo 📍 Ubicación: Ajustes → Preferencias de usuario → Instrucciones para Claude Se aplica a TODOS tus chats automáticamente — no lo repites nunca

Las 4 capas de configuración (de más global a más específica)

Las 4 capas: cada una se suma a la anterior 1. Perfil de trabajo "Ventas / Comercial" — calibra el tono general Todo Claude 2. Instrucciones para Claude "Soy Juan, responde en español, sé conciso" — tu identidad Todo Claude 3. Instrucciones de proyecto "Este proyecto usa React 18, TypeScript strict" — contexto técnico Solo ese proyecto 4. Tu prompt (mensaje del chat) "Crea un componente de login con validación" — la tarea específica Solo ese chat
La regla simple: Lo que aplica a TODO va en las Instrucciones para Claude (capa 2). Lo que aplica a UN proyecto va en instrucciones de proyecto (capa 3). Lo que aplica a UNA tarea va en el chat (capa 4).
🎯 Ejercicio: Configura tus instrucciones ahora (5 minutos)
  1. Abre claude.ai e inicia sesión.
  2. Haz clic en tu avatar/ícono (esquina inferior izquierda) → Ajustes.
  3. Ve a Perfil o Preferencias de usuario.
  4. Busca el campo "Instrucciones para Claude" (Custom Instructions).
  5. Copia y pega esta plantilla, personalizándola:
    ## Sobre mí
    - Nombre: [tu nombre]
    - Rol: [tu cargo] en [tu empresa/área]
    - Ubicación: [tu ciudad]
    - Nivel técnico: [principiante/intermedio/avanzado] en [herramientas que usas]
    
    ## Cómo quiero que respondas
    - Siempre en español
    - Sé directo y conciso, sin rodeos
    - Prefiero tablas sobre listas largas
    - Incluye ejemplos prácticos cuando expliques algo
    - Si no estás seguro de un dato, dímelo
  6. Guarda. Abre un chat nuevo y nota cómo Claude ya sabe tu nombre y contexto sin que le digas nada.
🎯 Ejercicio: Prueba las capas en acción (10 minutos)
  1. Con tus instrucciones configuradas, abre un chat nuevo y escribe: "¿Quién soy?" — Claude debería responder con tu nombre y rol.
  2. Ahora crea un Proyecto nuevo llamado "Prueba" y en las instrucciones pon: "En este proyecto, responde como si fueras un chef profesional."
  3. Abre un chat DENTRO del proyecto y escribe: "¿Quién soy?" — Claude debería saber tu nombre (capa 2) Y responder como chef (capa 3).
  4. Las capas se suman. Así funciona todo en Claude.

Cómo escribir buenos prompts

La calidad de la respuesta de Claude depende directamente de la calidad de tu instrucción. Aquí van las 6 técnicas fundamentales según la documentación oficial de Anthropic:

Anatomía de un buen prompt ❌ Prompt débil "Ayúdame con marketing" Sin contexto Sin formato esperado Sin rol ni audiencia → Respuesta genérica e inútil ✅ Prompt fuerte 🎭 Rol: "Actúa como experto en..." 📋 Tarea: "Crea un plan de..." 📎 Contexto: "Para una tienda en Cali..." 📐 Formato: "En tabla con 3 columnas..." 📏 Restricciones: "Máximo 500 palabras..." → Respuesta precisa y accionable

1. Sé claro y específico

❌ Prompt débil
Háblame de marketing
✅ Prompt fuerte
Crea un plan de marketing digital para una tienda de café artesanal en Cali, Colombia. Incluye 3 estrategias para Instagram con presupuesto mensual de $500 USD. Formato: tabla con columna de estrategia, acción concreta, costo estimado y KPI.

2. Usa etiquetas XML para estructurar

Las etiquetas XML son la herramienta más poderosa para organizar información. Claude las entiende mejor que cualquier otro formato.

<rol>Eres un experto en urbanismo con 20 años de experiencia</rol>

<tarea>Analiza el siguiente plan de desarrollo urbano</tarea>

<documento>
[Aquí pegas el contenido del plan]
</documento>

<formato_salida>
- Resumen ejecutivo (3 párrafos)
- Fortalezas y debilidades (tabla)
- Recomendaciones priorizadas (lista numerada)
</formato_salida>

3. Da ejemplos (Few-shot prompting)

Mostrar ejemplos del resultado que esperas es más efectivo que describirlo con palabras.

Clasifica estos correos como "urgente", "normal" o "spam".

Ejemplo:
Correo: "Tu cuenta será suspendida. Haz clic aquí"
Clasificación: spam

Correo: "Reunión de equipo mañana a las 9am"
Clasificación: urgente

Ahora clasifica:
Correo: "Newsletter semanal de diseño"
Clasificación:

4. Pide razonamiento paso a paso

Analiza si deberíamos expandir la oficina a Bogotá.
Piensa paso a paso:
1. Lista los factores a favor
2. Lista los factores en contra
3. Evalúa cada factor del 1 al 5
4. Concluye con tu recomendación

5. Asigna un rol

Actúa como un consultor financiero senior especializado en startups latinoamericanas. Tu cliente es una empresa de 15 empleados con revenue de $200K anuales...

6. Define el formato de salida

Responde SOLO en formato JSON con esta estructura:
{
  "resumen": "...",
  "riesgo": "alto|medio|bajo",
  "accion_sugerida": "..."
}
🎯 Ejercicio: Mejora este prompt (5 minutos)

Copia este prompt débil en Claude y observa el resultado:

Ayúdame con una presentación

Ahora copia esta versión mejorada y compara:

<rol>Eres un diseñador de presentaciones ejecutivas</rol>
<tarea>Crea un outline de 8 slides para presentar los
resultados del primer semestre de 2026</tarea>
<contexto>Audiencia: junta directiva de una empresa
de construcción. Tono: profesional, basado en datos</contexto>
<formato>Para cada slide: título + 3 bullet points
+ sugerencia de gráfico/visual</formato>

Nota la diferencia. El segundo prompt produce un resultado que puedes usar directamente.

Etiquetas XML desde cero

Si nunca has visto código, los símbolos < > pueden parecer intimidantes. Esta sección te explica desde cero qué son, por qué funcionan, y cómo usarlas sin ser programador.

¿Qué es una etiqueta?

Una etiqueta es un separador con nombre. Funciona exactamente como las pestañas de un archivador: le dice a Claude "esta información es de este tipo, y esta otra es de otro tipo".

Anatomía de una etiqueta XML <contexto> Etiqueta de apertura Tu texto aquí El contenido </contexto> Etiqueta de cierre (con /) ✅ Reglas simples: Siempre van en pares: <nombre> abre, </nombre> cierra · El nombre lo inventas TÚ · Puede llamarse como quieras

¿Por qué Claude las entiende mejor que texto normal?

❌ Sin etiquetas (confuso)
Eres un experto en ventas.
Analiza este reporte de ventas.
Las ventas de enero fueron $50K,
febrero $42K, marzo $61K.
Dame un resumen ejecutivo
en 3 párrafos.

Claude no sabe dónde termina la instrucción y dónde empiezan los datos. Puede mezclar todo.

✅ Con etiquetas (claro)
<rol>Experto en ventas B2B</rol>

<datos>
Enero: $50K
Febrero: $42K
Marzo: $61K
</datos>

<tarea>Resumen ejecutivo,
3 párrafos</tarea>

Claude sabe exactamente qué es instrucción, qué son datos, y qué debe hacer. Cero ambigüedad.

Las 8 etiquetas más útiles

EtiquetaPara quéEjemplo
<rol>Definir quién es Claude<rol>Consultor financiero senior</rol>
<tarea>Qué debe hacer<tarea>Analiza y recomienda</tarea>
<contexto>Información de fondo<contexto>Empresa PYME, 15 empleados</contexto>
<datos>Números, tablas, hechos<datos>Ventas Q1: $150K</datos>
<documento>Texto largo para analizar<documento>[pegar texto]</documento>
<formato>Cómo quieres la respuesta<formato>Tabla con 3 columnas</formato>
<ejemplo>Muestra del resultado esperado<ejemplo>Producto: X → Acción: Y</ejemplo>
<restricciones>Qué NO debe hacer<restricciones>No inventes datos</restricciones>
Puedes inventar cualquier etiqueta. <mi_empresa>, <reglas_del_equipo>, <competencia> — Claude entiende el nombre como contexto semántico. No hay etiquetas "oficiales". Las 8 de arriba son las más comunes, no las únicas.
🎯 Ejercicio: Tu primer prompt con etiquetas (3 minutos)

Copia esto en Claude, cambiando lo que está entre corchetes:

<rol>Eres un asistente experto en [tu área de trabajo]</rol>

<contexto>
Trabajo en [tu empresa/sector] en [tu ciudad].
Mi equipo tiene [X] personas.
</contexto>

<tarea>
Sugiere 3 formas de mejorar [un proceso de tu trabajo]
</tarea>

<formato>
Para cada sugerencia:
- Nombre de la mejora
- Qué cambiar concretamente
- Impacto esperado (alto/medio/bajo)
- Tiempo de implementación
</formato>

Compara el resultado con pedirle lo mismo sin etiquetas. La diferencia es inmediata.

Los 7 errores de prompting que todos cometen

Estos errores son los más frecuentes entre usuarios nuevos. Cada uno tiene una solución simple.

Los 7 pecados del prompting Vaguedad "Ayúdame" Sin formato No pide tabla Todo junto 5 tareas a la vez No iterar Espera 1 tiro Sin contexto No dice quién Confiar ciego No verifica No configurar Sin prefs.
#ErrorEjemplo del errorCómo corregirlo
1Prompt vago"Hazme un reporte" — ¿de qué? ¿para quién? ¿qué formato?Especifica tema, audiencia, formato y extensión. Usa etiquetas XML para separar cada parte.
2No pedir formato"Analiza estos datos" → Claude responde con 15 párrafosAgrega: <formato>Tabla con columnas: métrica, valor, tendencia</formato>
3Pedir 5 cosas a la vez"Analiza, resume, traduce, crea un gráfico y envía por email"Una tarea por mensaje. Resultados mejores, más controlables.
4No iterarEl primer resultado no es perfecto → abandona y empieza de ceroDile qué ajustar: "Bien, pero hazlo más conciso" o "Cambia el tono a más formal". Claude mejora con feedback.
5No dar contexto"Escribe un email de seguimiento" — ¿a quién? ¿sobre qué?Incluye: quién eres, a quién escribes, contexto de la conversación previa, objetivo del email.
6Confiar sin verificarClaude dice que la población de Cali es 2.8M → lo usas sin verificarVerifica datos numéricos, fechas, nombres propios. Pide: "Si no estás seguro, dilo explícitamente".
7No configurar instruccionesCada chat empieza diciendo "Responde en español, soy gerente..."Configura "Instrucciones para Claude" UNA VEZ y nunca más lo repitas. (Sección anterior.)

Refinamiento iterativo: cómo mejorar un resultado en 3 rondas

El error #4 (no iterar) es tan común que merece su propia sección. El primer resultado de Claude casi nunca es el resultado final — pero el segundo o tercero suele ser excelente. La clave es saber QUÉ pedir en cada ronda.

Ejemplo real: de resultado mediocre a excelente Ronda 1: Prompt inicial "Haz un plan de marketing para mi negocio" → Resultado: genérico 5 párrafos de consejos vagos que aplican a cualquier negocio Ronda 2: Agrega contexto "Bien, pero es para una tienda de café en Cali. Presupuesto $500/mes" → Resultado: mejor Estrategias específicas para café, pero aún falta estructura Ronda 3: Pide formato preciso "Ponlo en tabla: estrategia, acción semanal, costo, KPI. Solo Instagram" → Resultado: excelente ⭐ Tabla accionable con costos reales para Cali. Lista para implementar.

Las 5 instrucciones mágicas para iterar

Cuando el resultado...Dile a Claude...
Es demasiado largo"Reduce a la mitad. Solo lo esencial."
Es muy genérico"Hazlo específico para [tu contexto]. Incluye números concretos."
Le falta estructura"Reorganiza en tabla/formato [X]. Agrega columna de [Y]."
El tono está mal"Cambia el tono a [profesional/casual/técnico]. Audiencia: [quién]."
Le falta algo"Bueno, pero agrega [lo que falta]. Mantén todo lo demás igual."
🎯 Ejercicio: Practica las 3 rondas (10 minutos)
  1. Abre Claude y escribe un prompt vago sobre tu trabajo real: "Ayúdame a mejorar [algo de tu trabajo]"
  2. Lee el resultado. Identifica qué le falta: ¿contexto? ¿formato? ¿especificidad?
  3. Escribe tu segunda ronda agregando lo que faltó.
  4. Lee el nuevo resultado. Ahora pide formato preciso: tabla, lista numerada, o JSON.
  5. Compara el resultado de la ronda 3 con el de la ronda 1. La diferencia es lo que produces cuando iteras en vez de aceptar el primer resultado.

Biblioteca de prompts por caso de uso

Prompts listos para copiar y personalizar. Cada uno usa las técnicas de las secciones anteriores: etiquetas XML, contexto, formato definido.

📊 Ventas y comercial

Preparar una reunión con cliente

<rol>Consultor de ventas B2B con 15 años de experiencia</rol>

<contexto>
Tengo reunión mañana con [nombre de empresa].
Son una empresa de [sector], ~[X] empleados.
Ya nos compraron [producto/servicio anterior] en [fecha].
Quiero venderles [nuevo producto/servicio].
</contexto>

<tarea>
1. Investiga esta empresa brevemente
2. Sugiere 3 puntos de dolor probables
3. Propón 3 preguntas de descubrimiento
4. Sugiere cómo conectar sus necesidades con mi oferta
</tarea>

<formato>Tabla con columnas: tema, pregunta, conexión con mi oferta</formato>

Email de seguimiento post-reunión

<contexto>
Tuve reunión con [nombre] de [empresa].
Hablamos de: [temas principales].
Quedamos en: [compromisos].
Próximo paso: [qué sigue].
</contexto>

<tarea>Redacta un email de seguimiento profesional pero cálido.
Máximo 150 palabras. Incluye los compromisos y próximos pasos.</tarea>
📈 Marketing y contenido

Plan de contenido semanal

<rol>Estratega de contenido digital para LATAM</rol>

<contexto>
Marca: [nombre]. Sector: [sector].
Plataforma principal: Instagram.
Audiencia: [descripción del público].
Objetivo del mes: [aumentar seguidores/generar leads/awareness].
</contexto>

<tarea>Crea un calendario de contenido para 1 semana (lunes a viernes)</tarea>

<formato>
Tabla con columnas:
- Día
- Tipo de contenido (reel/carrusel/historia)
- Tema y gancho
- Copy sugerido (máximo 2 líneas)
- Hashtags (5)
- Mejor hora de publicación
</formato>
📋 Análisis de datos

Analizar un archivo de datos

<tarea>Analiza el archivo adjunto</tarea>

<instrucciones>
1. Primero describe las columnas y muestra las primeras 5 filas
2. Calcula estadísticas básicas (promedio, mediana, min, max)
3. Identifica los 3 hallazgos más interesantes
4. Genera un gráfico de barras del hallazgo principal
</instrucciones>

<formato>
- Resumen en 3 párrafos para un directivo no-técnico
- Tabla de estadísticas
- Gráfico
- Lista de "próximos análisis sugeridos"
</formato>

<restricciones>No inventes datos. Si algo no es claro, pregunta.</restricciones>
💻 Desarrollo y código

Generar una función con tests

<contexto>
Stack: Python 3.12 / FastAPI / PostgreSQL
Convenciones: snake_case, docstrings en español, type hints
</contexto>

<tarea>
Crea una función que [descripción de lo que debe hacer].
Incluye:
- Validación de inputs
- Manejo de errores con try/except
- 3 tests unitarios con pytest
- Docstring con ejemplo de uso
</tarea>

<restricciones>
- No uses librerías que no estén en el stack
- Sigue PEP 8
</restricciones>
📝 Escritura y documentos

Informe ejecutivo

<rol>Redactor ejecutivo para alta dirección</rol>

<contexto>
Tema: [tema del informe]
Audiencia: Junta directiva, perfil no-técnico
Datos clave: [lista de datos/cifras relevantes]
</contexto>

<tarea>Escribe un informe ejecutivo</tarea>

<formato>
1. Resumen ejecutivo (1 párrafo, máximo 5 líneas)
2. Hallazgos clave (3, con dato numérico cada uno)
3. Riesgos identificados (2-3)
4. Recomendaciones (3, priorizadas)
5. Próximos pasos con responsable y fecha
Extensión total: máximo 2 páginas
</formato>
👥 Recursos humanos

Descripción de puesto

<rol>Especialista en talento humano</rol>

<contexto>
Empresa: [nombre], sector [sector], [ciudad]
Tamaño: [X] empleados
Cultura: [formal/startup/híbrida]
</contexto>

<tarea>Crea la descripción del puesto para: [título del cargo]</tarea>

<formato>
- Título y área
- Objetivo del rol (2 líneas)
- Responsabilidades principales (5-7)
- Requisitos obligatorios vs. deseables
- Oferta de valor para el candidato
- Rango salarial sugerido para [ciudad/país]
</formato>

Ingeniería de contexto

En 2026, el campo evolucionó de "prompt engineering" (diseñar la pregunta correcta) a "context engineering" (diseñar todo lo que Claude recibe). La estructura alrededor de una tarea importa más que la redacción exacta de la pregunta.

Capas de contexto (se apilan automáticamente) Capa 1: Preferencias de usuario (Globales) "Responde en español. Soy analista. Prefiero tablas sobre listas." Capa 2: Instrucciones de proyecto "Este proyecto usa Python 3.12, Django 5. La DB es PostgreSQL..." Capa 3: Archivos del proyecto PDFs, datos, documentos de referencia subidos al proyecto Capa 4: Tu prompt (la conversación actual) "Analiza las ventas del Q3 vs el presupuesto..."

Regla de oro

Las Preferencias de usuario son para "quién soy y cómo quiero que Claude trabaje siempre conmigo" (reglas universales). Las Instrucciones de proyecto son para "contexto sobre este trabajo específico" (stack tecnológico, reglas del proyecto, convenciones). Se apilan: al abrir un chat dentro de un Proyecto, ambas se cargan automáticamente.

Proyectos en Claude.ai

Un Proyecto es un espacio de trabajo dedicado que agrupa conversaciones, archivos e instrucciones sobre un mismo tema. Piénsalo como contratar a un empleado que, en vez de olvidar todo cada día, llega con su briefing leído, los documentos de referencia en la mano, y sabe exactamente cómo quieres que trabaje contigo.

¿Por qué usar Proyectos?

Sin Proyecto vs. Con Proyecto ❌ Sin Proyecto Chat 1: "Soy Juan, trabajo en construcción..." Chat 2: "Soy Juan, trabajo en construcción..." Chat 3: "Soy Juan, trabajo en construcción..." → Subes los mismos archivos cada vez → Re-explicas el contexto en cada sesión ✅ Con Proyecto Chat 1: "Analiza las ventas de enero" Chat 2: "Redacta el informe del trimestre" Chat 3: "Prepara la presentación" → Archivos disponibles siempre → Claude ya sabe quién eres y cómo trabajar

Los tres bloques de un Proyecto

Al abrir o crear un proyecto verás exactamente lo que muestra la imagen: tres secciones. Cada una tiene un rol muy distinto y es igual de importante.

Los 3 bloques de un Proyecto — lo que ves en la imagen 📋 INSTRUCCIONES (+) "Agregar instrucciones para personalizar las respuestas de Claude" → Reglas de comportamiento permanentes · Le dice CÓMO trabajar · Se lee en cada chat 🧠 MEMORIA 🔒 Solo tú "La memoria del proyecto se mostrará aquí después de algunos chats" → Se genera automáticamente · Claude extrae patrones de tus chats · Solo tú la puedes ver 📂 CONTEXTO (+) "Agrega PDF, documentos u otro texto para consultar en este proyecto" → Tus documentos de referencia · Claude los consulta en cada chat · Usa tokens de contexto

Cómo crear un Proyecto

  1. En claude.ai, haz clic en "Proyectos" en la barra lateral izquierda, luego en "Nuevo Proyecto".
  2. Dale un nombre descriptivo y específico. No "Trabajo" — sí "Análisis Ventas Plock Q3 2026".
  3. Completa las Instrucciones (sección detallada más abajo).
  4. Sube documentos en Contexto — los archivos de referencia que Claude necesita.
  5. Crea conversaciones dentro del proyecto. Cada una hereda automáticamente todo lo anterior.
¿Cuántos proyectos necesito? Un proyecto por área de trabajo estable. Ejemplos: "Ventas Green Solutions", "Guía Claude equipo", "Análisis datos GIS", "Agencia Marketing". No crees uno por tarea — crea uno por contexto que se repite.

Qué poner en cada bloque — resumen rápido

BloqueQué va ahíQué NO va ahí
InstruccionesQuién eres, cómo quieres que trabaje Claude, reglas del proyecto, qué NO hacer, ejemplos de salidaLos documentos de referencia ni los datos del proyecto
MemoriaSe llena automáticamente — no necesitas hacer nadaNo puedes escribir aquí directamente
ContextoPDFs, documentos Word, hojas de cálculo, textos que Claude necesita consultarLas instrucciones de comportamiento ni el historial de chats

Instrucciones del Proyecto — el bloque más importante

Las Instrucciones son el "briefing permanente" de Claude para este proyecto. Se leen automáticamente al inicio de cada conversación nueva dentro del proyecto. Son la diferencia entre un asistente que entiende tu trabajo desde el minuto uno y uno que tienes que entrenar de cero cada vez.

Las instrucciones se cargan automáticamente en cada chat del proyecto 📋 Instrucciones Escritas UNA vez en el proyecto Chat lunes Chat miércoles Chat viernes Cada chat las hereda automáticamente — Claude ya sabe cómo trabajar desde el primer mensaje

¿Qué tan importantes son? Muy.

Las instrucciones vacías o mal escritas son la causa #1 de resultados mediocres en proyectos. Si Claude da respuestas genéricas, usa el formato equivocado, o repite errores — la solución casi siempre está en mejorar las instrucciones, no en escribir prompts más largos en cada chat.

Qué incluir — los 6 componentes clave

Los 6 componentes de unas buenas instrucciones 1. QUIÉN ERES Tu nombre, rol, empresa, sector. El contexto humano. 2. QUÉ ES EL PROYECTO Objetivo, audiencia final, para qué sirve el trabajo. 3. CÓMO TRABAJAR Idioma, tono, formato preferido, nivel de detalle. 4. HERRAMIENTAS / STACK Software, versiones, APIs, convenciones técnicas. 5. LO QUE NO DEBES HACER Errores a evitar, anti-patrones, restricciones específicas. 6. EJEMPLO DE SALIDA Un ejemplo real del resultado que esperas. Vale mil palabras.

Plantilla lista para usar

## Quién soy
[Tu nombre], [cargo] en [empresa/área].
Sector: [sector]. Ciudad: [ciudad].

## Qué es este proyecto
[Describe en 2-3 líneas qué hace este proyecto y para qué sirve.
Incluye la audiencia final si aplica.]

## Cómo quiero que trabajes
- Idioma: siempre español
- Tono: [profesional / directo / técnico / accesible]
- Formato preferido: [tablas / listas / párrafos / código]
- Nivel de detalle: [conciso / completo / con ejemplos]
- Si no estás seguro de algo, pregúntame

## Herramientas y stack (si aplica)
- [Software o tecnologías del proyecto]
- [Versiones relevantes]
- [Convenciones de nomenclatura]

## NO hacer en este proyecto
- [Error frecuente 1]
- [Error frecuente 2]
- [Restricción específica]

## Ejemplo de salida esperada
[Pega aquí un ejemplo real del tipo de resultado que quieres]

Actualizado: [mes año]

Instrucciones para roles no técnicos

La plantilla anterior tiene sección de "Stack" pensada para desarrollo. Si tu proyecto es comercial, de marketing o de gestión, adapta así:

Ejemplo: Proyecto "Ventas Green Solutions"
## Quién soy
Juan, Director Comercial y de Marketing en Green Solutions.
Fabricamos bloques Plock para construcción. Base en Cali, Colombia.
Clientes: constructoras, ferreterías, distribuidores en el suroccidente.

## Qué es este proyecto
Todo lo relacionado con ventas, propuestas comerciales, seguimiento
de clientes y estrategia comercial de Green Solutions.
Audiencia de mis documentos: clientes constructores y gerentes.

## Cómo quiero que trabajes
- Siempre en español colombiano, formal pero cercano
- Formato preferido: tablas cuando hay datos, bullet points para listas
- Cifras siempre en pesos colombianos (COP) o USD según el contexto
- Documentos comerciales: incluye siempre propuesta de valor concreta
- Sé directo, sin rodeos ni frases de relleno

## Términos del negocio que debes conocer
- Plock: nuestro producto principal (bloques de construcción)
- VIS: Vivienda de Interés Social, segmento importante
- m²: unidad de medida clave en nuestras cotizaciones
- Nuestros competidores principales: Eternit, Corona, Ladrillera del Valle

## NO hacer
- No inventes precios ni especificaciones técnicas de Plock
- No uses lenguaje muy técnico de ingeniería con clientes no-técnicos
- No hagas promesas de entrega sin que yo confirme disponibilidad

## Ejemplo de salida esperada
Cuando pida una propuesta comercial, debe tener:
- Saludo personalizado con nombre del cliente
- Resumen del problema que resolvemos
- Tabla de productos con cantidades, precio unitario y total
- Beneficios específicos para su proyecto
- Llamado a la acción claro

Actualizado: julio 2026
Ejemplo: Proyecto "Guía Claude — Equipo"
## Qué es este proyecto
Creación y mantenimiento de la guía interna de Claude para el equipo
de Green Solutions. Incluye documentación, tutoriales y actualizaciones.

## Cómo quiero que trabajes
- Español claro, sin tecnicismos innecesarios
- Audiencia: compañeros sin experiencia previa en IA
- Usa analogías cotidianas para explicar conceptos técnicos
- Formato: HTML con SVGs para los diagramas
- Cada sección debe tener al menos un ejemplo práctico

## NO hacer
- No uses jerga de programación sin explicarla
- No asumas conocimiento previo de IA o LLMs
- No generes código sin comentarios en español

Actualizado: julio 2026
Ejemplo: Proyecto "Análisis de datos y reportes"
## Quién soy
Analista en área comercial. Trabajo con datos de ventas, inventarios
y desempeño de distribuidores.

## Qué es este proyecto
Análisis de datos del negocio: ventas por región, rotación de inventario,
desempeño de vendedores, comparativos mensuales.

## Cómo quiero que trabajes
- Prioriza visualizaciones: gráficos y tablas antes que párrafos
- Siempre incluye el período analizado y la fuente de los datos
- Redondea cifras a 2 decimales en tablas, sin decimales en titulares
- Los colores de los gráficos: naranja (#d4915e) para positivo, rojo para negativo

## Herramientas
- Excel / Google Sheets para tablas
- Python con pandas y matplotlib para análisis complejos
- Los archivos de datos están en formato CSV con separador punto y coma (;)

## NO hacer
- No inventes tendencias que no estén en los datos
- No uses promedios cuando la mediana es más representativa (outliers)
- No generes gráficos de pie para más de 5 categorías

Actualizado: julio 2026

El bloque Memoria — qué es y cómo funciona

La Memoria del proyecto aparece debajo de las Instrucciones. No puedes escribir en ella directamente — Claude la llena automáticamente después de varios chats, extrayendo patrones de tus conversaciones: preferencias que repites, decisiones que tomas, correcciones que haces.

El candado "🔒 Solo tú" significa que la memoria es privada — ni otros miembros del equipo que compartas el proyecto ni nadie más la ve. Es tu capa de personalización invisible.

La memoria extrae automáticamente...Ejemplo
Correcciones que repites"Varias veces has pedido formato tabla — Claude lo aplica de ahora en adelante"
Preferencias de estilo"Prefieres resúmenes en 3 puntos, no párrafos"
Decisiones del proyecto"Acordaste usar Python 3.12 en este proyecto"
Contexto que das frecuentemente"Mencionas a menudo que el cliente principal es constructora XYZ"
La memoria complementa las instrucciones, no las reemplaza. Las instrucciones son lo que escribes conscientemente desde el inicio. La memoria es lo que Claude aprende observando cómo trabajas. Las dos funcionan juntas. No esperes a que la memoria "aprenda" algo importante — si es crítico, ponlo en las instrucciones desde el principio.

El bloque Contexto — tus documentos de referencia

El Contexto es donde subes los archivos que Claude debe poder consultar en cualquier momento dentro del proyecto. Aparece como "Agrega PDF, documentos u otro texto para consultar en este proyecto."

Tipo de documentoEjemploFormato recomendado
Documentos de referencia fijosCatálogo de productos, lista de precios, brochurePDF o Markdown
Datos del negocioHistórico de ventas, inventario actualCSV o Markdown
Guías de estiloManual de marca, guía de comunicaciónPDF o Markdown
Contratos o plantillasContrato estándar de venta, propuesta tipoPDF o Word
Documentación técnicaEspecificaciones del producto, fichas técnicasPDF o Markdown
Los archivos del Contexto consumen tokens. Cada archivo que subes ocupa espacio en la ventana de contexto de cada chat. Sube solo lo que Claude necesita consultar activamente — no un archivo de 200 páginas cuando solo usa 10. Si tienes muchos documentos, conviértelos a Markdown primero (sección "PDF vs Markdown" en esta guía) para ahorrar hasta 90% de tokens.

Qué subir y qué no subir al Contexto

✅ Subir al Contexto❌ No subir
Documentos que Claude debe consultar en cada chatArchivos que solo usas una vez — súbelos al chat directamente
Referencias estables (catálogo, precios, specs)Documentos que cambian frecuentemente — mejor referenciarlos
Ejemplos del resultado esperadoArchivos enormes con poco contenido útil (PDFs escaneados)
Glosario de términos del proyectoDatos confidenciales que no quieres que ninguna IA procese
🎯 Ejercicio: Crea tu primer Proyecto completo (20 minutos)
  1. Elige un área de trabajo real donde uses Claude frecuentemente.
  2. Ve a claude.ai → Proyectos → Nuevo Proyecto.
  3. Nómbralo específicamente: "Ventas [Tu empresa]" o "Análisis [Área]".
  4. Haz clic en Instrucciones (+) y usa la plantilla de esta sección. Tarda 10 minutos hacerlo bien.
  5. Busca 1-2 documentos de referencia que usas constantemente. Conviértelos a Markdown si son PDFs largos y súbelos en Contexto (+).
  6. Abre un chat dentro del proyecto y escribe solo: "¿Qué sabes sobre este proyecto?" — Claude debería responder con todo el contexto que configuraste.
  7. Si algo falta o está mal, vuelve a las Instrucciones y corrígelo antes de seguir.
Señal de que lo hiciste bien: Puedes abrir un chat nuevo al día siguiente y Claude ya sabe quién eres, qué estás haciendo y cómo quieres que trabaje — sin que digas nada.
🎯 Ejercicio: Prueba la calidad de tus instrucciones

Después de escribir las instrucciones, usa este checklist en un chat nuevo:

  1. Escribe: "¿Quién soy y qué hace este proyecto?" — debe responder correctamente.
  2. Escribe: "Redacta un email de prueba" — debe usar el tono y formato que pediste.
  3. Escribe algo que pusiste en "NO hacer" — debe negarse o advertirte.
  4. Pide algo en el formato de tu ejemplo de salida — debe parecerse.

Si alguno falla, actualiza las instrucciones hasta que pase los cuatro. Ese es el estándar mínimo de unas buenas instrucciones de proyecto.

Iterar es clave: Después de 3-5 conversaciones en el proyecto, notarás patrones: Claude comete el mismo error, o pide contexto que podrías haber incluido. Cada vez que pase, actualiza las instrucciones con una regla nueva. Este hábito se acumula: después de un mes, Claude casi no comete errores en tu proyecto.

Gestión del contexto en proyectos

El contexto es el recurso más valioso y más limitado al trabajar con Claude. La ventana de contexto es como una mesa de trabajo: todo lo que Claude puede "ver" en un momento dado. Saber gestionarla es la diferencia entre resultados mediocres y resultados excepcionales.

Cómo funciona la ventana de contexto

Anatomía de la ventana de contexto Ventana total: 200K tokens (Sonnet/Opus hasta 1M) Instrucciones Archivos del proyecto Historial del chat Espacio disponible ⚠ Zona de degradación (últimos 20%) Cuando el contexto supera el 80%, la calidad de las respuestas baja ✅ HACER • Un tema por conversación • Subir solo archivos necesarios • Resumir antes de cambiar de tema • Nuevo chat cuando cambia la tarea • Referir info previa: "Como dijimos" ❌ EVITAR • Subir 20 PDFs "por si acaso" • Mezclar tareas en un solo chat • Repetir la misma info varias veces • Ignorar el aviso de compactación • Chats de +50 mensajes sin resumir

Estrategia: conversaciones vinculadas

En vez de una mega-conversación para todo el proyecto, usa conversaciones separadas por tema dentro del mismo proyecto. Cada una empieza fresca pero hereda instrucciones y archivos.

📁 Proyecto: Sistema de Inventario
├── 💬 Chat 1: Diseño de base de datos
├── 💬 Chat 2: API endpoints
├── 💬 Chat 3: Frontend de formularios
├── 💬 Chat 4: Tests y validación
└── 💬 Chat 5: Deployment y CI/CD
Transición entre chats: Cuando terminas un chat y necesitas que el siguiente sepa lo que hiciste, pide un resumen al final: "Resume las decisiones clave y el estado actual del trabajo en un formato que pueda pegar al inicio de un nuevo chat." Luego pega ese resumen al inicio del nuevo chat.

El patrón Checkpoint

Un checkpoint es una captura del estado actual del trabajo. Es tu seguro contra la pérdida de contexto por compactación o chats largos. Hazlo proactivamente, no cuando ya es tarde.

"Crea un checkpoint del estado actual. Incluye:
1. Decisiones tomadas hasta ahora
2. Estado actual de cada componente
3. Problemas pendientes
4. Próximos pasos acordados

Formato: documento conciso que pueda pegar en un nuevo chat."

¿Cuándo hacer un checkpoint?

MomentoPor qué
Después de completar una tarea lógicaCaptura las decisiones antes de pasar a la siguiente
Cuando ves "Compactando la conversación..."Ya era tarde, pero captura lo que quede
Al 70% de una sesión largaHazlo ANTES de llegar al límite, no después
Antes de cambiar de tema radicalmenteEl resumen sirve de puente al siguiente chat
Al final del día de trabajoPara retomar al día siguiente sin perder contexto

Cómo actualizar el contexto de un proyecto

Las instrucciones de un proyecto no son estáticas. Son un documento vivo que debe evolucionar con el trabajo. Aquí está la estrategia para mantenerlas actualizadas:

Ciclo de actualización de instrucciones 1. Trabajar Usar el proyecto 2. Detectar Claude repite un error 3. Actualizar Añadir regla "NO" 4. Mejorar No se repite Ejemplo de evolución de instrucciones: Semana 1: "Usa Python 3.12" Semana 2: "Usa Python 3.12. NO uses f-strings anidados. Los errores van a logging, no a print()."

Qué actualizar y cuándo

Qué cambióDónde actualizarEjemplo
Claude repite un errorSección "NO hacer" en instruccionesNO usar var en JavaScript. Usa const/let.
Cambió una tecnologíaSección Stack/HerramientasMigrado de REST a GraphQL en abril 2026
Nuevas convenciones de equipoSección Reglas de estiloNombres de funciones en camelCase
Nuevo archivo de referenciaBase de conocimiento del proyectoSubir schema actualizado, eliminar el viejo
Completaste una faseContexto del proyectoFase 1 (DB) completada. Fase 2: API
Pasan 2 semanas sin cambiosRevisión general de instruccionesBuscar info obsoleta, agregar lecciones aprendidas

RAG automático: proyectos con muchos archivos

Cuando la base de conocimiento de tu proyecto excede los límites del contexto, Claude activa automáticamente RAG (Retrieval Augmented Generation) en planes de pago. Esto significa que en vez de cargar todos los archivos a la vez, Claude busca y recupera solo las secciones relevantes para tu pregunta. La capacidad se expande hasta 10x sin perder calidad. No necesitas hacer nada: se activa solo.

Para aprovechar RAG: Usa nombres de archivo descriptivos (no "doc1.pdf"). Incluye encabezados claros en tus documentos. Cuando preguntes algo, referencia el archivo por nombre: "Según el archivo api-schema-v2.json, genera los tipos de TypeScript." Esto ayuda a Claude a encontrar la sección correcta.

Compactación y limpieza de conversaciones

A medida que una conversación crece, el contexto se satura. Claude empieza a olvidar decisiones tempranas, repetir sugerencias, o perder precisión. La compactación es el mecanismo para manejar esto — comprime el historial en un resumen preservando lo esencial.

Compactación automática (claude.ai)

En claude.ai, cuando una conversación se acerca al límite de la ventana de contexto, verás el mensaje: "Compactando nuestra conversación para poder seguir chateando...". Esto es automático — Claude resume el historial anterior para dejar espacio. Tus mensajes no se borran; simplemente se comprimen.

Problema: Cada compresión pierde detalle. Es como fotocopiar una fotocopia: funciona, pero se degrada. Por eso es mejor hacer checkpoints proactivos al 70% de capacidad, en vez de esperar la compactación automática al 95%.

Compactación manual (Claude Code)

En Claude Code (terminal), tienes control directo con comandos. La compactación aquí es más poderosa porque puedes indicar QUÉ preservar.

/compact
Comprime el historial en un resumen. Mantiene las decisiones
clave, borra lo redundante. Ejemplo con foco:

/compact preserva la arquitectura de la DB y los
endpoints definidos, descarta las discusiones de debugging

¿Cuándo compactar vs. empezar un chat nuevo?

SituaciónAcciónPor qué
Misma tarea, sesión largaCompactarPreservas el hilo de trabajo sin empezar de cero
Tarea completada, nueva tareaNuevo chatContexto limpio, sin "ruido" de la tarea anterior
Claude empieza a dar respuestas repetitivasCompactar + reforzarEl contexto está saturado; compacta y repite la instrucción clave
Cambio radical de temaNuevo chatCompactar mezclaría contextos incompatibles
Bug persistente que no se resuelveNuevo chat + checkpointA veces empezar fresco con un resumen resuelve bucles
Estrategia de gestión del contexto Zona productiva (0-70%) Hacer checkpoint (70-85%) Peligro (85-95%) Auto-compact Trabaja normal ⬆ Haz checkpoint aquí Pide resumen de decisiones ⬆ Nuevo chat Pega checkpoint y continúa Prompt para checkpoint proactivo "Resume las decisiones, estado actual y próximos pasos en un formato conciso que pueda pegar al inicio de un nuevo chat para retomar sin perder contexto."

Caching: el ahorro invisible

El contenido de los Proyectos (instrucciones + archivos) se cachea automáticamente. Esto significa que cuando inicias un nuevo chat en el mismo proyecto, ese contenido no cuenta contra tu límite de mensajes — ya está en caché. Aprovéchalo: pon la información más reutilizada en los archivos del proyecto, no en los mensajes del chat.

Regla práctica: Información que usarás en múltiples chats → archivos del proyecto (se cachea). Información específica de esta tarea → mensajes del chat (se consume).

Comandos y optimización de recursos

Dependiendo de la interfaz que uses (claude.ai, Cowork o Claude Code), tienes diferentes herramientas para optimizar el uso de recursos. Aquí está la referencia completa.

Comandos en Claude Code (terminal)

Claude Code ofrece comandos slash (/) que son la herramienta principal de control. Los más importantes para gestión de proyectos:

ComandoQué haceCuándo usarlo
/compactComprime el historial en un resumen inteligente. Acepta instrucciones opcionales sobre qué preservar.Al terminar una tarea dentro de una sesión larga. Al 70% de capacidad. Antes de cambiar de subtarea.
/clearBorra TODO el historial de la conversación. Los archivos editados se mantienen en disco.Cuando cambias a una tarea completamente diferente. Para un inicio limpio.
/contextMuestra una visualización del uso actual del contexto con sugerencias de optimización.Periódicamente durante sesiones largas. Antes de decidir si compactar o limpiar.
/costMuestra el gasto de tokens y costo acumulado de la sesión.Para controlar presupuesto. Antes de tareas costosas.
/modelCambia el modelo (Opus ↔ Sonnet ↔ Haiku) durante la sesión.Baja a Sonnet para tareas rutinarias; sube a Opus para razonamiento complejo.
/effortAjusta el nivel de razonamiento (low, medium, high)./effort low para tareas simples ahorra tokens. /effort high para problemas complejos.
/initGenera un archivo CLAUDE.md analizando tu proyecto automáticamente.Al empezar un proyecto nuevo. Claude lee la estructura y crea las instrucciones iniciales.
/planActiva el modo planificación: Claude propone un plan sin ejecutar nada.Antes de cambios grandes. Revisas el plan, apruebas, y luego ejecuta.
/reviewRevisa el código actual buscando bugs, mejoras de estilo y seguridad.Antes de commitear. Después de una sesión larga de cambios.
/memoryGestiona la memoria persistente del proyecto (se guarda en disco).Para almacenar decisiones que deben sobrevivir entre sesiones.
/branchCrea una bifurcación de la conversación actual. El original se preserva.Para probar un enfoque arriesgado sin perder el estado actual.
/diffMuestra las diferencias de archivos modificados en la sesión.Para revisar qué cambió antes de commitear.
/helpLista todos los comandos disponibles con descripción.Cuando no recuerdes un comando. Es la fuente de verdad.

Flujos de trabajo optimizados con comandos

🚀 Inicio de proyecto nuevo
$ cd mi-proyecto
$ claude
/init           → Claude analiza el proyecto y genera CLAUDE.md
                   → Revisar y refinar el archivo generado
/model sonnet   → Sonnet para la configuración inicial (ahorra tokens)
                   → Configurar MCP servers si es necesario
/cost           → Verificar consumo inicial
🔧 Sesión de desarrollo típica
/plan            → Claude propone el enfoque, tú apruebas
                    → Claude ejecuta los cambios
/diff            → Revisar qué archivos cambió
/review          → Revisión de calidad automática
/context         → ¿Cuánto contexto queda?
/compact         → Comprimir si estás al 70%+
                    → Continuar con la siguiente tarea
/cost            → Verificar gasto antes de cerrar
💰 Control de costos durante una sesión
/cost            → Ver gasto acumulado
/model sonnet    → Bajar a Sonnet para tareas simples
/effort low      → Reducir razonamiento para preguntas directas
/compact         → Comprimir contexto = menos tokens por mensaje
                    → Hacer la tarea costosa
/model opus      → Subir a Opus solo para lo complejo
/effort high     → Máximo razonamiento para el problema difícil

Técnicas de optimización en claude.ai (web)

En claude.ai no hay comandos slash, pero puedes aplicar las mismas estrategias con prompts:

ObjetivoTécnica en claude.ai
Equivalente a /compactPide: "Resume las decisiones y estado actual de esta conversación en un formato conciso." Luego pega el resumen en un chat nuevo.
Equivalente a /planPide: "Antes de ejecutar, propón un plan paso a paso. Espera mi aprobación antes de generar código/contenido."
Equivalente a /contextObserva si Claude empieza a dar respuestas genéricas o repite sugerencias. Es señal de contexto saturado.
Cambiar de modeloUsa el selector de modelo en la parte inferior del chat.
Equivalente a /branchAbre un segundo chat en el mismo proyecto con un resumen del estado actual.
Reducir verbosidadEn preferencias de usuario: "Sé conciso. Sin preámbulos. Ve directo al resultado."

CLAUDE.md: el archivo más importante de tu proyecto

Para usuarios de Claude Code y Cowork, CLAUDE.md es un archivo en la raíz de tu proyecto que Claude lee automáticamente al inicio de cada sesión. Es el equivalente a las "Instrucciones de proyecto" de claude.ai, pero vive en tu sistema de archivos y se versiona con Git.

## CLAUDE.md — Ejemplo

# Mi Proyecto Web

## Qué es esto
Aplicación web de gestión de inventario para una PYME en Cali.

## Stack
- Backend: Python 3.12 + FastAPI
- Frontend: React 18 + TypeScript
- DB: PostgreSQL 16
- Deploy: Docker + Railway

## Convenciones
- Endpoints REST en /api/v1/
- Nombres de tabla en snake_case singular (producto, orden)
- Commits en español con formato: "tipo: descripción"
- Tests obligatorios para lógica de negocio

## NO hacer
- No usar ORM raw queries (usar SQLAlchemy)
- No crear endpoints sin validación Pydantic
- No commitear secretos (usar .env)

## Estado actual
- [x] Fase 1: Modelo de datos
- [x] Fase 2: CRUD de productos
- [ ] Fase 3: Sistema de órdenes ← AQUÍ ESTAMOS
- [ ] Fase 4: Dashboard de reportes
Mantén CLAUDE.md bajo 200 líneas. Es tentador poner todo ahí, pero Claude lo lee en cada sesión — instrucciones excesivamente largas consumen contexto y diluyen lo importante. Si necesitas documentación extensa, ponla en archivos separados y referéncialos desde CLAUDE.md.

Ciclo de vida completo de un proyecto

Este es el flujo completo desde que inicias un proyecto hasta que lo completas, con las acciones de mantenimiento en cada etapa.

Ciclo de vida del proyecto con gestión de contexto FASE 1 · SETUP (Día 1) ✦ Crear proyecto con nombre descriptivo ✦ Escribir instrucciones iniciales ✦ Subir archivos de referencia base FASE 2 · PRIMERAS TAREAS (Semana 1) ✦ Un chat por tarea concreta ✦ Iterar resultados (no esperar perfección) ✦ Anotar qué falló para actualizar FASE 3 · PRIMERA REVISIÓN (Semana 2) ✦ Actualizar instrucciones con lecciones ✦ Agregar reglas "NO hacer" por cada error ✦ Reorganizar archivos (quitar los no usados) ✦ Agregar ejemplos de salida esperada FASE 4 · TRABAJO CONTINUO ✦ Checkpoints cada tarea completada ✦ Conversaciones vinculadas por tema ✦ Compactar al 70% del contexto ✦ Nuevo chat por cada tarea diferente FASE 5 · REVISIONES PERIÓDICAS ✦ Cada 2 semanas: revisar instrucciones ✦ Eliminar archivos obsoletos ✦ Actualizar estado del proyecto ciclo FASE 6 · CIERRE ✦ Checkpoint final con todo el estado ✦ Documentar lecciones aprendidas ✦ Las instrucciones son tu plantilla futura 💡 Las instrucciones finales de un proyecto son la mejor plantilla para el siguiente proyecto similar. Reutilízalas como punto de partida.

Checklist de mantenimiento de proyecto

📋 Cada sesión de trabajo

AcciónCómo
Verificar que estás en el proyecto correctoMira el nombre del proyecto en la barra superior
Un chat por tareaNo reutilices un chat viejo para un tema nuevo
Si el chat se alarga (+30 mensajes)Pide checkpoint, abre chat nuevo, pega resumen
Si Claude repite algo que corregisteActualiza instrucciones del proyecto con la regla

📋 Cada semana

AcciónCómo
Revisar instrucciones del proyecto¿Sigue siendo preciso? ¿Falta algo que siempre explicas?
Limpiar archivos del proyectoQuita versiones viejas, agrega documentos actualizados
Actualizar sección "Estado actual"Refleja en qué fase estás y qué se completó

📋 Cada cambio importante

AcciónCómo
Cambio de stack o herramientasActualiza inmediatamente la sección de Stack
Nueva convención del equipoAgrega a Reglas de estilo
Nuevo miembro del equipoRevisa que las instrucciones sean autoexplicativas
Fase del proyecto completadaActualiza estado + checkpoint final de la fase
El efecto compuesto: Un proyecto que lleva 2 meses con instrucciones actualizadas semanalmente produce resultados dramáticamente mejores que uno con instrucciones del día 1. Cada regla añadida previene un error futuro. Después de 8 semanas, Claude casi no comete errores para ese proyecto específico.

¿Qué es Cowork?

Claude Cowork es la herramienta de escritorio de Anthropic que convierte a Claude en un agente que trabaja directamente con los archivos y carpetas de tu computadora. No necesitas terminal ni saber programar — le describes lo que necesitas en lenguaje natural y Claude lo ejecuta.

Cowork vs. claude.ai — ¿Cuál usar?

Criterioclaude.ai (web)Cowork (escritorio)
Acceso a archivos localesSolo los que subes manualmenteAcceso directo a carpetas
Tareas multi-pasoLimitado al chatEjecución autónoma completa
Plugins y conectoresMCPs básicosEcosistema completo de plugins
Tareas programadasNoSí — tareas recurrentes
Dispatch (desde móvil)NoSí — envía tareas desde el celular
RequiereNavegadorApp de escritorio (Mac/Windows)
Plan mínimoGratis (limitado)Pro ($20/mes)
Flujo de trabajo en Cowork 📂 Carpeta Seleccionas carpeta 💬 Instrucción Describes la tarea 🤖 Claude Cowork Planifica → Ejecuta → Verifica ✅ Resultado Archivos modificados EJEMPLOS DE TAREAS "Organiza las fotos de esta carpeta por fecha" "Crea un informe Excel con los recibos de gastos" "Renombra todos los PDF con formato AAAA-MM-titulo"

Configurar Cowork

  1. Descarga la app Claude Desktop desde claude.ai/download (disponible para macOS y Windows).
  2. Inicia sesión con tu cuenta de Claude (plan Pro o superior).
  3. Selecciona una carpeta para dar acceso a Claude. Cowork opera en un entorno controlado (sandboxed) por seguridad.
  4. Configura instrucciones globales: en Ajustes de Cowork, puedes definir instrucciones que Claude seguirá en CADA sesión (equivalente a las preferencias de usuario en claude.ai).
  5. Configura instrucciones por carpeta: puedes crear archivos de instrucciones específicas para cada carpeta de trabajo.
Dispatch (control remoto): Una vez configurado, puedes enviar tareas desde tu celular con la app Claude móvil. Tu computadora ejecuta la tarea en segundo plano mientras estás fuera. Te llega una notificación cuando termine.

Conectar terminal e instalar plugins en Cowork

Los plugins convierten a Cowork en un especialista para tu rol: ventas, marketing, productividad, desarrollo, legal, finanzas. Son paquetes completos con skills, comandos slash, conectores y sub-agentes. Pero para instalar ciertos plugins, Cowork necesita conectarse a Claude Code corriendo en tu terminal — y este paso es donde muchos usuarios se atascan.

Pantalla "Conecta tu terminal": Si estás viendo esta pantalla al intentar instalar un plugin, significa que Cowork necesita Claude Code instalado y corriendo en tu computadora. Esta guía te lleva paso a paso desde cero.

Panorama completo: la cadena de requisitos

Cadena de requisitos para instalar plugins en Cowork PASO 1 Instalar Node.js 18+ O usar instalador nativo PASO 2 Instalar Claude Code npm install -g @anthropic-ai/... PASO 3 Ejecutar claude Abrir terminal → escribir claude PASO 4 Ejecutar /login Autenticarse con cuenta Claude ⭐ PASO 5 — CLAVE Ejecutar /web-setup Conecta tu terminal con la app de escritorio / web PASO 6 Instalar plugin claude.com/plugins → Install 📌 ¿Por qué se necesita todo esto? Cowork ejecuta tareas en una máquina virtual segura en la nube. Los plugins necesitan Claude Code como "puente" entre la nube y tu computadora local. El comando /web-setup establece esa conexión. Solo necesitas hacerlo UNA VEZ — después funciona automáticamente en futuras sesiones.

Paso 1: Instalar Node.js (solo si no lo tienes)

Claude Code necesita Node.js versión 18 o superior. Es el motor que lo hace funcionar.

🪟 Windows — instrucciones
  1. Ve a nodejs.org y descarga la versión LTS (Long Term Support).
  2. Ejecuta el instalador. Acepta todas las opciones predeterminadas.
  3. Reinicia tu computadora después de la instalación.
  4. Abre PowerShell (tecla Windows → escribe "PowerShell") y verifica:
    node --version
    # Debe mostrar v18.x.x o superior
Alternativa sin Node.js: Anthropic ahora ofrece un instalador nativo que no requiere Node.js. En PowerShell ejecuta: irm https://cli.anthropic.com/install.ps1 | iex
🍎 macOS — instrucciones
  1. Abre Terminal (Cmd + Espacio → escribe "Terminal").
  2. Si tienes Homebrew: brew install node@22
  3. Si no tienes Homebrew: descarga desde nodejs.org (versión LTS).
  4. Verifica: node --version
Alternativa sin Node.js (macOS): curl -fsSL https://cli.anthropic.com/install.sh | sh

Paso 2: Instalar Claude Code

# Opción A: Con npm (si instalaste Node.js)
npm install -g @anthropic-ai/claude-code

# Opción B: Con instalador nativo (si NO tienes Node.js)
# Windows (PowerShell):
irm https://cli.anthropic.com/install.ps1 | iex
# macOS/Linux:
curl -fsSL https://cli.anthropic.com/install.sh | sh
Error común en Windows: Si ves "The token '&&' is not a valid statement separator", estás en PowerShell — usa la sintaxis de PowerShell, no la de CMD. Si ves "'irm' is not recognized", estás en CMD — abre PowerShell en su lugar.

Paso 3: Iniciar Claude Code por primera vez

# Abre tu terminal (PowerShell en Windows, Terminal en Mac)
claude

# Verás algo como:
╭──────────────────────────────────────────╮
│  Te damos la bienvenida a Claude Code    │
│  cwd: ~/projects                         │
╰──────────────────────────────────────────╯

Paso 4: Autenticarse

> /login

Esto abrirá tu navegador para autenticarte con tu cuenta de Claude (plan Pro o superior). Sigue las instrucciones en pantalla. Cuando termine, verás un mensaje de confirmación en el terminal.

Paso 5: Ejecutar /web-setup — ⭐ EL PASO CLAVE

Este es el comando que resuelve la pantalla "Conecta tu terminal". Conecta tu instancia local de Claude Code con la interfaz web y la app de escritorio.

> /web-setup

¿Qué hace este comando?

AcciónQué pasa
Conecta GitHubSincroniza tu token de GitHub con tu cuenta Claude (si usas repos)
Crea un entorno cloudConfigura un entorno de ejecución con acceso de red confiable
Vincula terminal ↔ webPermite que la app de escritorio y claude.ai envíen tareas a tu terminal

Solo necesitas hacer esto UNA VEZ. Después de la primera conexión, futuras sesiones se conectan automáticamente.

Paso 6: Instalar el plugin

Con la conexión establecida, tienes dos formas de instalar plugins:

Opción A: Desde la web (visual)

  1. Ve a claude.com/plugins en tu navegador.
  2. Busca el plugin que necesitas (ej: "Build with WordPress", "Sales", "Marketing").
  3. Haz clic en "Install". Si la conexión del Paso 5 está activa, se instala automáticamente.
  4. Abre Cowork en la app de escritorio — el plugin ya estará disponible con sus comandos slash.

Opción B: Desde el terminal (rápida)

# Ver plugins disponibles
> /plugin

# Instalar un plugin específico
> /plugin install nombre-del-plugin

# Agregar un marketplace de terceros
> /plugin marketplace add anthropics/knowledge-work-plugins

# Actualizar el marketplace oficial
> /plugin marketplace update claude-plugins-official

Ejemplo real: instalar "Build with WordPress"

# 1. Abres tu terminal
$ claude

# 2. Si es la primera vez, autentícate
> /login
✓ Autenticado como juan@ejemplo.com

# 3. Conecta el terminal (solo la primera vez)
> /web-setup
✓ GitHub conectado
✓ Entorno cloud creado
✓ Terminal vinculado con la web

# 4. Ahora ve a claude.com/plugins en el navegador
# 5. Busca "Build with WordPress" y haz clic en Install
# 6. El plugin se descarga e instala automáticamente

# 7. Verifica que funciona
> /plugin
Plugins instalados:
  ✓ build-with-wordpress (v1.2.0)
  ✓ frontend-design (built-in)
  ✓ code-review (built-in)

Errores comunes en este paso

ErrorCausaSolución
"Conecta tu terminal" sigue apareciendo Claude Code no está corriendo o no ejecutaste /web-setup Abre un terminal, escribe claude, luego /web-setup. Deja el terminal abierto.
"node: command not found" Node.js no está instalado o no está en el PATH Instala Node.js desde nodejs.org. Reinicia el terminal después de instalar. O usa el instalador nativo que no requiere Node.js.
"npm ERR! permission denied" npm necesita permisos para instalar globalmente En Mac/Linux: configura npm para usar tu directorio home. Nunca uses sudo con npm. En Windows: abre PowerShell como administrador.
Plugin no aparece después de instalar La conexión entre terminal y web se perdió Ejecuta /web-setup de nuevo en Claude Code. Cierra y reabre la app de escritorio.
"MCP error -32000: Connection closed" Plugin de Node.js falla porque Cowork no encuentra Node.js del sistema Instala Node.js 18+ a nivel del sistema (no solo nvm). Reinicia la app de escritorio completamente.

Plugins oficiales más populares

PluginFunciónTipo de usuario
Frontend DesignDiseño de UI con tokens de diseño profesionalesDesarrolladores, diseñadores
SalesResearch de cuentas, prep de llamadas, battlecardsComerciales, BDR
MarketingCampañas, SEO, contenido, análisis competitivoMarketing
ProductivityGestión de tareas, memoria, dashboardTodos
Brand VoiceMantiene consistencia de marca en todo el contenidoMarketing, comunicaciones
Code ReviewRevisión automática de códigoDesarrolladores
Security GuidanceAuditoría de seguridad en códigoDevSecOps
Los plugins de Cowork también funcionan en Claude Code. Los 11 plugins oficiales de Anthropic (etiquetados como "Cowork-only" en claude.com/plugins) también se pueden instalar y usar directamente en Claude Code via el marketplace knowledge-work-plugins.

Proyectos en Cowork

Desde marzo de 2026, Cowork incluye su propio sistema de Proyectos. A diferencia de claude.ai, los proyectos en Cowork viven en tu computadora: archivos e instrucciones permanecen en tu disco local.

Crear un Proyecto en Cowork

  1. Abre Cowork y haz clic en "Nuevo Proyecto".
  2. Selecciona la carpeta raíz del proyecto en tu computadora.
  3. Escribe las instrucciones del proyecto (misma lógica que en claude.ai).
  4. También puedes importar proyectos existentes con un clic si ya tienes carpetas organizadas.

Instrucciones globales vs. por carpeta vs. de proyecto

TipoAlcanceEjemplo
GlobalesToda sesión de Cowork"Siempre responde en español. Confirma antes de eliminar archivos."
Por carpetaCuando trabajas en esa carpeta"Los archivos CSV aquí usan ; como separador."
De proyectoDentro de ese proyecto específico"Este proyecto es un sitio web en Next.js 14."

Extended Thinking (Pensamiento profundo)

Extended Thinking es una función que le permite a Claude "pensar más tiempo" antes de responder. En vez de generar una respuesta inmediata, Claude razona internamente paso a paso, considera múltiples ángulos y luego entrega una respuesta más elaborada y precisa.

Analogía simple

Imagina que le preguntas algo a un colega. En modo normal, te responde rápido con lo primero que se le ocurre. Con Extended Thinking, se toma un minuto, lo piensa, revisa su razonamiento, y luego te da una respuesta mucho más sólida. La respuesta toma más tiempo, pero la calidad sube dramáticamente.

Modo normal vs. Extended Thinking Pregunta Respuesta rápida Resultado OK ~2 seg Pregunta 🧠 Piensa: Analiza → Evalúa → Verifica → Refina (visible para ti) Excelente ⭐ ~15-60 seg

¿Cuándo activarlo?

Situación¿Activar?Por qué
Problemas de lógica multi-paso✅ SíClaude necesita razonar secuencialmente
Diseño de arquitectura de software✅ SíMúltiples restricciones y trade-offs
Análisis de pros/contras complejos✅ SíRequiere sopesar múltiples factores
Matemáticas o cálculos✅ SíReduce errores en cadenas de cálculo
Preguntas simples de hecho❌ NoAgrega latencia sin beneficio
Conversación casual❌ NoNo requiere razonamiento profundo
Generación de texto directo❌ NoLa escritura no mejora con más "pensamiento"

Cómo activarlo

En claude.ai, busca el ícono de bombilla o "Pensamiento extendido" en la barra de herramientas del chat. Actívalo antes de enviar tu mensaje. Claude mostrará un resumen de su proceso de razonamiento antes de la respuesta final.

Combinación poderosa: Extended Thinking + Deep Research juntos son la combinación más potente de Claude. Research busca información de múltiples fuentes, y Extended Thinking la analiza con razonamiento profundo antes de sintetizar la respuesta.

Sistema de memoria

Desde marzo de 2026, Claude tiene memoria persistente — recuerda información tuya entre conversaciones. No es un log de tus chats, sino notas inteligentes que Claude extrae automáticamente: tu profesión, preferencias, proyectos recurrentes, herramientas que usas.

Cómo funciona la memoria de Claude Chat lunes "Soy analista en Cali" Chat miércoles "Uso Python y React" Chat viernes "Prefiero tablas" 🧠 Memoria de Claude Analista · Cali · Python · React · Prefiere tablas Chat siguiente Ya sabe quién eres ✅ Sin repetir contexto

Cómo activarla

  1. Ve a Ajustes → Memoria (o Settings → Memory)
  2. Activa "Generar memoria del historial de chats" — permite a Claude aprender de tus conversaciones y guardar contexto.
  3. Activa "Buscar y referenciar chats" (planes de pago) — permite a Claude buscar en tus conversaciones pasadas cuando es relevante.
  4. Ambas se complementan: la primera extrae datos, la segunda los consulta.

Qué recuerda y qué no

Recuerda ✅NO recuerda ❌
Tu nombre y profesiónContraseñas o datos financieros
Tus preferencias de estilo y formatoConversaciones textuales completas
Proyectos en los que trabajasArchivos que subiste (no los almacena)
Herramientas y stack tecnológicoInformación de salud sensible
Idioma preferidoContenido de chats en modo incógnito

Cómo gestionar tu memoria

Puedes ver, editar y eliminar todo lo que Claude recuerda en Ajustes → Memoria. También puedes pausar la memoria (mantiene lo existente pero no genera nueva), o resetearla por completo. La Conversación Incógnita (Temporary Chat) permite chatear sin que se genere ninguna memoria.

Tip avanzado: Puedes decirle a Claude directamente: "Recuerda que prefiero tablas sobre listas" o "Olvida mi dirección anterior". Claude lo procesa como una instrucción de memoria explícita.
La memoria no reemplaza los Proyectos. La memoria es para preferencias personales globales. Los Proyectos son para contexto específico de un trabajo. No pongas instrucciones técnicas detalladas en la memoria — van en las instrucciones de proyecto.

Deep Research (Investigación profunda)

Deep Research es el modo de investigación avanzada de Claude. En vez de hacer una búsqueda web simple y responder en segundos, Claude ejecuta múltiples búsquedas secuenciales, lee artículos completos, cruza referencias entre fuentes, y genera un informe detallado con citas verificables. Toma entre 1 y 5 minutos, pero la profundidad es incomparable.

Búsqueda web vs. Deep Research vs. Extended Thinking

FunciónQué haceTiempoCuándo usarla
Búsqueda web1-2 búsquedas rápidas para verificar un datoSegundos"¿Quién ganó el partido?" "¿Cuál es el precio de X?"
Deep Research5+ búsquedas encadenadas, lee múltiples fuentes, sintetiza un informe1-5 min"Compara los 3 principales competidores en este mercado" "Investiga tendencias de construcción en Colombia"
Extended ThinkingRazonamiento profundo sin buscar en la web10-60 seg"Diseña la arquitectura para este sistema" "Analiza los riesgos de esta decisión"
Research + ThinkingBusca profundamente Y razona sobre lo encontrado2-10 min"Investiga y recomienda la mejor estrategia de pricing para nuestro mercado"

Cómo activar Deep Research

  1. Asegúrate de tener Búsqueda web activada (es prerequisito).
  2. Busca el botón "Research" en la parte inferior izquierda del chat.
  3. Haz clic para activarlo (se pone azul). Desactívalo con otro clic.
  4. Escribe un prompt detallado y específico — Research funciona mejor con instrucciones claras.
Disponibilidad: Deep Research está disponible en planes Pro, Max, Team y Enterprise. La búsqueda web básica está disponible en todos los planes incluyendo el gratuito.

Cómo escribir un buen prompt para Research

❌ Débil: "Investiga marketing digital"

✅ Fuerte: "Actúa como analista de mercado. Investiga las 3
principales empresas de materiales de construcción en
Colombia (pisos, cerámicas, porcelanatos). Para cada una:
pricing, canales de distribución, presencia digital y
propuesta de valor. Cruza la información entre fuentes
y presenta en tabla comparativa con fuentes citadas."

Archivos y formatos: mejores prácticas

Cómo manejar archivos con Claude es una de las decisiones que más impacta en la calidad de los resultados. Aquí están las recomendaciones probadas:

¿Formato nativo o convertir?

Formato¿Subirlo así?Recomendación
PDF✅ SíClaude lee PDFs bien. Para PDFs escaneados (imagen), la calidad baja — considera OCR previo.
Word (.docx)✅ SíClaude extrae texto y estructura. Sube en formato nativo.
Excel (.xlsx)✅ SíPara análisis simple. Si el archivo tiene macros o fórmulas complejas, exporta a CSV.
CSV✅ SíFormato ideal para datos tabulares. Ocupa menos tokens que Excel.
PowerPoint (.pptx)✅ SíClaude puede leerlo y también crear presentaciones desde cero.
Imágenes✅ SíClaude tiene visión. Puede analizar capturas, diagramas, fotos, gráficos.
JSON / XML✅ SíClaude trabaja excelente con datos estructurados.
HTML✅ SíPara análisis web. También lo genera como salida interactiva.
Google Docs/Sheets⚠️ ConectarUsa el conector de Google Drive (MCP) en vez de exportar y subir manualmente.
Regla de eficiencia: Cuanto más pequeño el archivo, menos tokens consume y más espacio queda para la conversación. Antes de subir un Excel de 50 pestañas, extrae solo las hojas que necesitas. Antes de subir un PDF de 200 páginas, sube solo las secciones relevantes.

¿Conectar con Drive o subir directamente?

MétodoVentajasDesventajas
Subir archivoSimple, funciona siempre, no requiere configuraciónArchivo estático (no se actualiza), consume tokens
Google Drive (MCP)Datos siempre actualizados, busca entre archivos, no duplicasRequiere configurar conector, depende de conexión
API directaAutomatización total, integración con sistemas propiosRequiere desarrollo, manejo de tokens y costos

Recomendación: Para trabajo diario con documentos que cambian, usa el conector de Google Drive. Para documentos de referencia que no cambian, sube el archivo directamente al proyecto.

PDF vs. Markdown: la optimización que más tokens ahorra

Esta es probablemente la recomendación más impactante de toda la guía: convertir tus PDFs a Markdown antes de subirlos a Claude puede reducir el consumo de tokens entre un 50% y un 90%. No es una exageración — es la diferencia entre usar 45,000 tokens en un PDF de 15 páginas o solo 2,000 tokens en su versión Markdown.

¿Qué pasa cuando subes un PDF?

PDF vs Markdown: qué ve Claude 📄 PDF (subido directamente) ▓▓▓▓▓▓▓▓▓ Metadata y cabeceras del PDF ▓▓▓▓▓▓▓▓▓▓▓ Fuentes, estilos, compresión ▓▓▓▓▓▓▓ Tablas XRef, objetos, streams ▓▓▓▓▓▓▓▓▓▓ Layout de posición de cajas ▓▓▓ Texto real (~20-30% del archivo) ~45,000 tokens (15 págs) 60-70% es "basura" que no aporta Tablas pueden "romperse" en texto plano 📝 Markdown (convertido) # Título del documento ## Sección con estructura semántica | Tabla | Datos | Preservados | Texto limpio, sin basura binaria (espacio ahorrado) ~2,000 - 5,000 tokens 100% contenido útil Claude entiende la jerarquía nativa

¿Cuándo convertir y cuándo subir el PDF directo?

SituaciónRecomendaciónPor qué
PDF de texto con tablas, informes, contratosConvertir a MarkdownAhorra 50-90% de tokens. Las tablas se preservan mejor con la sintaxis | col |
PDF de referencia que usarás en muchos chatsConvertir a MarkdownEl ahorro se multiplica por cada conversación que lo use
PDF escaneado (imágenes, no texto seleccionable)Subir PDF directo o hacer OCR primeroClaude tiene visión y puede leer imágenes. La conversión sin OCR previo falla
PDF donde importa el diseño visual (brochures, layouts)Subir PDF directoLa conversión pierde el diseño. Claude necesita "ver" el layout
PDF corto (<5 páginas) y uso puntualSubir PDF directoEl ahorro no justifica el esfuerzo de conversión
PDF largo (>20 páginas) para análisis de contenidoConvertir a MarkdownDiferencia masiva: de ~100K tokens a ~10K tokens
Word (.docx) con mucho formatoConvertir a MarkdownDOCX tiene metadata invisible que consume tokens innecesariamente
HTML de una página webConvertir a MarkdownHTML es el formato más "desperdiciador" — hasta 10x más tokens que su contenido real

Herramientas para convertir PDF a Markdown

Hay opciones para todos los niveles — desde hacer clic en un botón hasta automatizar pipelines completos.

Para no-programadores (sin instalar nada)

HerramientaCómo funcionaIdeal paraLimitaciones
Google Docs (truco rápido) Abre doc.new en el navegador → pega el texto del PDF → Archivo → Descargar como → Markdown (.md) Conversión rápida de texto simple No preserva tablas complejas ni imágenes
Claude mismo Sube el PDF y pide: "Convierte este documento a texto limpio en Markdown". Copia la salida. PDFs de cualquier complejidad Usa tokens para la conversión (solo vale si luego lo reutilizas en múltiples chats)
pdf2md.morethan.io Web gratuita. Sube PDF, descarga Markdown. Sin registro. Conversiones puntuales rápidas Calidad limitada en documentos complejos
file2markdown.ai Web con IA. Soporta múltiples formatos. Documentos con tablas y estructura Puede tener límites en versión gratuita

Para usuarios técnicos (línea de comandos)

HerramientaInstalaciónUsoFortaleza
PyMuPDF4LLM pip install pymupdf4llm pymupdf4llm.to_markdown("archivo.pdf") El más rápido. Ideal para PDFs con texto seleccionable. Sin GPU. Detecta encabezados, tablas, párrafos.
Marker pip install marker-pdf marker_single archivo.pdf El "navaja suiza". Maneja layouts complejos, columnas múltiples, extracción de imágenes, JSON estructurado.
Pandoc brew install pandoc (Mac) o apt install pandoc (Linux) pandoc archivo.docx -t markdown -o salida.md Mejor para DOCX y HTML que para PDF. Convierte entre 40+ formatos. Ideal para automatización.
MinerU Ver repo en GitHub CLI o API Python Excelente con papers académicos y texto CJK (chino/japonés/coreano). Tablas complejas vía HTML.
pdf-craft pip install pdf-craft CLI Especializado en libros escaneados. OCR local sin conexión a internet.
¿Cuál elegir? Para la mayoría de los casos: empieza con PyMuPDF4LLM (es el más ligero y rápido). Si la calidad no es suficiente para un PDF complejo, sube a Marker. Para DOCX y HTML, usa Pandoc. Si no quieres instalar nada, usa Claude mismo o Google Docs.

¿Qué se pierde al convertir?

Es importante saber qué sacrificas y qué ganas:

AspectoSe preserva en MarkdownSe pierde en la conversión
Texto✅ Todo el texto del documento
Encabezados✅ Convertidos a # / ## / ###
Tablas✅ Convertidas a sintaxis | col |Tablas anidadas o con celdas fusionadas pueden simplificarse
Listas✅ Convertidas a - o 1. 2. 3.
Negritas/cursivas✅ Convertidas a **texto** / *texto*
Imágenes⚠️ Depende de la herramienta (Marker las extrae, PyMuPDF las referencia)Las imágenes embebidas se pierden en herramientas básicas
Colores y fuentesTodo el diseño visual: colores, tipografía, espaciado
Layout multi-columna⚠️ Se lineariza a una columnaLa disposición espacial se pierde
Formularios PDFLos campos de formulario no se convierten
Anotaciones y comentariosSe pierden en la mayoría de herramientas

Flujo de trabajo recomendado

Flujo: decidir cómo subir un archivo ¿Necesitas el diseño visual? Sube el PDF directo a Claude NO ¿Lo usarás varias veces? Convierte a .md y sube el Markdown NO Sube el PDF uso puntual, no vale convertir
Ejemplo práctico: convertir con Claude y reutilizar

Si no quieres instalar herramientas, puedes usar Claude mismo como conversor. La clave es hacerlo una sola vez y guardar el resultado:

PASO 1 (Chat temporal):
Sube el PDF y escribe:
"Convierte este documento a Markdown limpio. 
Preserva encabezados, tablas y listas. 
No resumas ni omitas contenido."

PASO 2:
Copia la salida de Claude (el texto Markdown).
Guárdalo como archivo .md en tu computadora.

PASO 3 (Proyecto):
Sube el archivo .md a la base de conocimiento
del proyecto. Ahora cada chat del proyecto
lo lee consumiendo ~90% menos tokens.

⚠️ Este flujo solo vale la pena si vas a usar
el documento en 3+ conversaciones. Para uso
único, sube el PDF directo.
Ejemplo práctico: convertir con PyMuPDF4LLM (técnico)
# Instalar (una sola vez)
pip install pymupdf4llm

# Convertir un PDF a Markdown
python -c "
import pymupdf4llm
md = pymupdf4llm.to_markdown('mi-informe.pdf')
with open('mi-informe.md', 'w') as f:
    f.write(md)
print('Convertido exitosamente')
"

# Convertir todos los PDF de una carpeta
python -c "
import pymupdf4llm, glob
for pdf in glob.glob('*.pdf'):
    md = pymupdf4llm.to_markdown(pdf)
    with open(pdf.replace('.pdf','.md'), 'w') as f:
        f.write(md)
    print(f'Convertido: {pdf}')
"
PDFs escaneados (imágenes): Si el texto del PDF no es seleccionable (es una imagen escaneada), la conversión directa a Markdown NO funciona — obtendrás un archivo vacío. Necesitas OCR primero (Reconocimiento Óptico de Caracteres). Opciones: usa pdf-craft (local, sin internet) o Marker (usa IA para OCR). O simplemente sube el PDF a Claude — su visión puede leer imágenes directamente.

Resumen: impacto en tokens por formato

Formato de entradaTokens (15 páginas, aprox.)Eficiencia
PDF nativo (directo)~45,000
Word .docx (directo)~30,000
HTML (directo)~50,000+
Texto plano (.txt)~5,000
Markdown (.md)~3,000 - 5,000
CSV (datos tabulares)~2,000 - 4,000

Los valores son aproximados y varían según el contenido. La tendencia es consistente: los formatos de texto plano consumen una fracción de lo que consumen los formatos binarios.

MCP y conectores

El Model Context Protocol (MCP) es el sistema que conecta a Claude con servicios externos. Piénsalo como "enchufar" Claude a tus herramientas de trabajo.

MCP: cómo Claude se conecta a tus herramientas Claude "Enchufes" MCP → Gmail Drive Calendar Slack GitHub + 100 más
💡 ¿Qué puede hacer Claude con cada conector? Ejemplos reales
ConectorEjemplo de uso
Gmail"Busca los correos de Juan de la última semana y resume los que hablan de presupuesto"
Google Drive"Abre el archivo de presupuesto Q3 y actualiza las cifras de agosto"
Calendar"¿Tengo espacio mañana entre 2 y 5pm? Crea una reunión de 30 min con Ana"
Slack"Resume los mensajes del canal #proyecto-nuevo de los últimos 3 días"
GitHub"¿Cuáles issues están abiertos en el repo de frontend? Prioriza por urgencia"

Conectores más útiles

ServicioQué puede hacer ClaudeDónde funciona
Google DriveBuscar, leer y crear archivosclaude.ai, Cowork
Google CalendarVer, crear, modificar eventosclaude.ai, Cowork
GmailBuscar correos, crear borradoresclaude.ai, Cowork
SlackLeer y enviar mensajesclaude.ai, Cowork
GitHubGestionar issues, leer códigoclaude.ai, Cowork

Cómo activar un conector

  1. En claude.ai: ve a Ajustes → Conectores o haz clic en el ícono de herramientas dentro de un chat.
  2. Busca el servicio que necesitas y haz clic en "Conectar".
  3. Autoriza el acceso con tu cuenta del servicio (OAuth).
  4. Listo — Claude ahora puede interactuar con ese servicio cuando sea relevante.

Skills y herramientas

Las Skills son paquetes de instrucciones especializadas que amplían las capacidades de Claude. Cuando activas una skill, Claude sabe exactamente cómo crear archivos profesionales en formatos específicos.

Skills principales disponibles

SkillQué haceEjemplo de uso
docxCrea/edita documentos Word profesionales"Crea un informe en Word con tabla de contenidos"
xlsxCrea/edita hojas de cálculo"Genera un presupuesto en Excel con fórmulas"
pptxCrea presentaciones PowerPoint"Haz una presentación de 10 slides sobre el Q3"
pdfCrea, combina, llena formularios PDF"Combina estos 5 PDF en uno solo"
frontend-designCrea interfaces web de alta calidad"Diseña un dashboard interactivo en React"
data-analysisAnaliza datos con gráficos y estadísticas"Analiza este CSV y genera gráficos"
No necesitas activar skills manualmente. Claude las detecta automáticamente según tu solicitud. Si pides "crea un documento Word", Claude leerá la skill de docx antes de generarlo.

Funciones útiles en el chat

AcciónCómo activarlaPara qué
Búsqueda webActivar en herramientas del chatInformación actual, verificar datos, investigar
Ejecución de códigoActivar en herramientas del chatEjecutar Python, instalar paquetes, procesar datos
Creación de archivosActivar en herramientas del chatGenerar Word, Excel, PDF, HTML, código
ArtefactosActivar en herramientas del chatVisualizar código, apps interactivas, gráficos
MemoriaActivar en ajustesClaude recuerda preferencias entre conversaciones

Cómo instalar skills desde GitHub

Las skills comunitarias en GitHub amplían enormemente lo que Claude puede hacer. Una skill es simplemente una carpeta con un archivo SKILL.md — instrucciones especializadas que Claude lee automáticamente cuando son relevantes. Instalarlas es sencillo, y aquí te explico cada método paso a paso.

¿Qué es un archivo SKILL.md?

Una skill no es un plugin ni un programa. Es un archivo de texto con instrucciones que le dicen a Claude cómo hacer algo específico. La estructura mínima es:

---
name: mi-skill
description: Descripción de lo que hace
---

# Instrucciones para Claude

Cuando el usuario pida X, sigue estos pasos:
1. Hacer Y
2. Verificar Z
3. Entregar resultado en formato W

La carpeta puede incluir también archivos de referencia, plantillas o ejemplos que Claude usará.

Método 1: Desde GitHub a claude.ai (sin programar)

Este método funciona para cualquier persona, sin instalar nada.

  1. Encuentra la skill en GitHub. Busca repositorios con skills de Claude. Ejemplos populares: anthropics/courses, alirezarezvani/claude-skills, o busca "claude skills" en GitHub.
  2. Descarga el repositorio. En la página del repositorio, haz clic en el botón verde "Code""Download ZIP". Guarda el archivo en tu computadora.
  3. Descomprime el ZIP. Haz doble clic en el archivo descargado. Se creará una carpeta con los archivos.
  4. Encuentra el archivo SKILL.md. Navega dentro de la carpeta descargada hasta encontrar el archivo SKILL.md. Ábrelo con cualquier editor de texto.
  5. Copia el contenido del SKILL.md. Selecciona todo el texto y cópialo.
  6. Pégalo en Claude. Tienes dos opciones:

    Opción A (por chat): Pega el contenido al inicio de tu conversación como instrucción. Funciona pero solo dura ese chat.

    Opción B (persistente): Pega el contenido en las Instrucciones de proyecto de un Proyecto. Así aplica a todos los chats del proyecto.

  7. Verifica que funciona. Pide a Claude algo que la skill debería manejar y comprueba que sigue las instrucciones.

Método 2: Para Claude Code (terminal)

Si usas Claude Code, las skills se instalan en el sistema de archivos y se cargan automáticamente.

  1. Clona el repositorio en la carpeta de skills:
    # Instalación personal (todos tus proyectos)
    git clone https://github.com/autor/skill-name.git ~/.claude/skills/skill-name
    
    # Instalación por proyecto (solo este repo)
    git clone https://github.com/autor/skill-name.git .claude/skills/skill-name
  2. Verifica la estructura. El archivo debe estar en:
    ~/.claude/skills/skill-name/SKILL.md  ← ✅ Correcto
    ~/.claude/skills/skill-name/sub/SKILL.md  ← ❌ No funciona
  3. Reinicia Claude Code o inicia una nueva sesión. La skill se carga automáticamente.
  4. Verifica con /help — la skill debería aparecer en la lista de comandos disponibles.

Método 3: ZIP descargado para Claude Code

  1. Descarga el ZIP del repositorio desde GitHub.
  2. Descomprime en la carpeta de skills:
    unzip skill-descargada.zip -d ~/.claude/skills/
  3. Verifica que SKILL.md esté directamente en la carpeta, no anidado en subcarpetas.

Repositorios de skills populares

RepositorioQué incluyeSkills
anthropics/coursesCursos oficiales de Anthropic con skills de ejemploOficiales
alirezarezvani/claude-skills337+ skills para ingeniería, marketing, producto, finanzas330+
agensi.ioMarketplace con revisión de seguridad de cada skillCurado

Gestión de skills instaladas

# Listar skills instaladas
ls ~/.claude/skills/

# Desinstalar una skill (simplemente borrar la carpeta)
rm -rf ~/.claude/skills/nombre-skill

# Desactivar temporalmente (renombrar con _)
mv ~/.claude/skills/foo ~/.claude/skills/_foo

# Backup de todas tus skills
tar -czf ~/skills-backup.tar.gz ~/.claude/skills/
Seguridad: Las skills son archivos de texto con instrucciones, no código ejecutable. Aun así, revisa el contenido del SKILL.md antes de usarlo — una skill maliciosa podría contener instrucciones engañosas. Prefiere skills de repositorios conocidos o del marketplace de Agensi que revisa cada publicación.

GitHub: repositorios, colaboración y publicación

GitHub es la plataforma donde vive el código y los proyectos del mundo. No es solo para programadores — es donde se publican guías como esta, se instalan skills, se colabora en documentos, y se gestiona cualquier proyecto que necesite versiones e historial. Con tu cuenta activa ya puedes usarlo para todo lo que aparece en esta guía.

Git vs. GitHub — no es lo mismo

GitGitHub
Programa que se instala en tu computadoraSitio web donde guardas tus repos de Git en la nube
Rastrea los cambios de archivos localmentePermite compartir, colaborar y publicar proyectos
Funciona sin internetRequiere internet
Se usa desde la terminalTiene interfaz web visual + app de escritorio
El flujo básico de trabajo con Git y GitHub Tu computadora Archivos locales git add git commit Área de staging Cambios preparados git push ↑ sube GitHub Repositorio remoto Accesible desde cualquier lugar Otros colaboran GitHub Pages Tu guía publicada online git pull — descargar cambios de otros

Conceptos clave que necesitas dominar

ConceptoQué esAnalogía
Repositorio (repo)Carpeta de proyecto con historial completo de cambiosUna carpeta de Google Drive con historial de versiones infinito
CommitFoto guardada del estado actual de los archivosUn punto de guardado en un videojuego
Branch (rama)Versión paralela del proyecto para probar cambiosUna copia de un documento para editar sin afectar el original
PushSubir tus commits locales a GitHubGuardar en la nube
PullDescargar cambios de GitHub a tu computadoraSincronizar desde la nube
ForkCopiar el repo de otra persona a tu cuentaDuplicar un documento de Google Drive de alguien más
CloneDescargar un repo de GitHub a tu computadoraDescargar una carpeta completa con todo su historial
Pull Request (PR)Proponer que tus cambios se fusionen con el originalEnviar un documento para revisión antes de publicar
README.mdArchivo de presentación del proyecto, en formato MarkdownLa portada y descripción de un proyecto
GitHub PagesServicio gratuito que publica HTML como página webHosting gratuito incluido en tu cuenta

Caso 1: Publicar un proyecto propio (esta guía, por ejemplo)

🖥️ Opción A — Desde el navegador (sin instalar Git)
  1. Ve a github.com/new.
  2. Nombre del repo: guia-claude (sin espacios, sin tildes). Marca Public.
  3. NO marques "Add a README" — lo subirás tú.
  4. Haz clic en Create repository.
  5. En la página del repo vacío, haz clic en "uploading an existing file".
  6. Arrastra tu index.html y README.md. Escribe un mensaje en "Commit changes": Versión inicial de la guía.
  7. Haz clic en Commit changes.
  8. Ve a Settings → Pages → Source: Deploy from branch → main / root → Save.
  9. En ~60 segundos tu guía estará en: https://tu-usuario.github.io/guia-claude/
💻 Opción B — Desde la terminal (con Git instalado)
Publicar proyecto desde terminal
# 1. Configura Git la primera vez (solo una vez)
$ git config --global user.name "Tu Nombre"
$ git config --global user.email "tu@email.com"

# 2. Ve a la carpeta de tu proyecto
$ cd ~/Desktop/guia-claude

# 3. Inicializa Git en esa carpeta
$ git init
Initialized empty Git repository in .git/

# 4. Marca todos los archivos para el commit
$ git add .

# 5. Guarda el estado (commit)
$ git commit -m "Versión inicial de la guía"
[main (root-commit)] 1 file changed, 5000 insertions(+)

# 6. Conecta con GitHub (copia la URL de tu repo)
$ git remote add origin https://github.com/TU-USUARIO/guia-claude.git

# 7. Sube al repositorio
$ git push -u origin main
Branch 'main' set up to track remote branch 'main' from 'origin'.

Para actualizaciones futuras: editas el archivo → git add .git commit -m "descripción"git push. Tres comandos.

Caso 2: Usar el repositorio de otro (fork + personalizar)

Cuando encuentras un repo útil (skills de Claude, plantillas, herramientas) y quieres usarlo como base para tu propio proyecto:

Fork y personalización
# Opción A: Fork desde el navegador
# Ve al repo → botón "Fork" (arriba derecha) → Create fork
# Ahora tienes una copia en TU cuenta que puedes modificar

# Opción B: Solo descargar (sin fork, sin Git)
# En el repo → botón verde "Code" → "Download ZIP"

# Opción C: Clonar a tu computadora (con Git)
$ git clone https://github.com/autor/repo-interesante.git
$ cd repo-interesante
# Ya tienes todo el proyecto descargado y puedes modificarlo

Caso 3: Actualizar tu proyecto publicado

El flujo más común del día a día — cambias algo, lo publicas:

Actualizar — los 3 comandos que más usarás
# Después de editar cualquier archivo:

$ git add . # 1. Marca todos los cambios
$ git commit -m "Agrego módulo GitHub" # 2. Guarda snapshot
$ git push # 3. Sube a GitHub

# GitHub Pages actualiza automáticamente en ~60 segundos
✓ Tu guía en TU-USUARIO.github.io está actualizada

Caso 4: Colaborar con un equipo

Si quieres que otros miembros del equipo puedan editar la guía o los proyectos:

  1. En tu repositorio, ve a Settings → Collaborators.
  2. Haz clic en Add people y escribe el usuario de GitHub del compañero.
  3. Selecciona el nivel de permiso: Write para que pueda editar, Maintain para que pueda gestionar el repo.
  4. El colaborador recibirá una invitación por email.
  5. Cada uno trabaja en su rama (git checkout -b nombre-rama) y propone cambios con un Pull Request para revisión antes de publicar.

Repositorios de Anthropic que vale la pena seguir

RepositorioQué contieneLink
anthropics/coursesCursos oficiales de Anthropic con notebooks interactivosver repo →
anthropics/anthropic-sdk-pythonSDK oficial de Python para la API de Claudever repo →
anthropics/anthropic-sdk-javascriptSDK oficial de JavaScript/TypeScriptver repo →
anthropics/prompt-eng-interactive-tutorialTutorial interactivo de prompt engineering con ejerciciosver repo →
anthropics/model-context-protocolEspecificación oficial del protocolo MCPver repo →
Activa las notificaciones de repos que uses. En cualquier repositorio haz clic en Watch → All Activity. Recibirás email cuando Anthropic lance actualizaciones, nuevas skills o corrija bugs en las herramientas que usas.
🎯 Ejercicio: Tu primer commit y push (15 minutos)
  1. Instala Git si no lo tienes: git-scm.com/downloads. Acepta todas las opciones predeterminadas.
  2. Verifica: abre la terminal y escribe git --version. Debe mostrar un número.
  3. Configura tu identidad (solo una vez):
    git config --global user.name "Tu Nombre"
    git config --global user.email "tu@email.com"
  4. Crea una carpeta en el escritorio llamada mi-primer-repo. Dentro crea un archivo README.md con cualquier texto.
  5. En la terminal, navega a esa carpeta: cd ~/Desktop/mi-primer-repo
  6. Ejecuta los 3 comandos: git initgit add .git commit -m "primer commit"
  7. Crea un repo en github.com/new con el mismo nombre.
  8. Copia y ejecuta los dos comandos que GitHub te muestra en pantalla (git remote add origin ... y git push).
  9. Recarga GitHub — tus archivos ya están en la nube.

NVIDIA NIM APIs — 100+ modelos de IA gratis

NVIDIA NIM (NVIDIA Inference Microservices) es una biblioteca de más de 100 modelos de IA de vanguardia — DeepSeek, Llama, Mistral, Qwen, Gemma, y más — accesibles vía API desde build.nvidia.com, completamente gratis para desarrollo. Sin tarjeta de crédito. Sin vencimiento de prueba.

¿Por qué importa esto?

Normalmente acceder a modelos grandes de IA cuesta dinero (OpenAI cobra por token, AWS cobra por GPU). NVIDIA ofrece los mismos modelos — incluyendo algunos de los mejores del mundo en 2026 como DeepSeek V4 Pro y GLM-5 — con la misma interfaz compatible con OpenAI. Cambiar de modelo es cambiar una línea de código.

Cómo funciona NVIDIA NIM Tu código Python / JS API key nvapi- NVIDIA NIM DGX Cloud · TensorRT-LLM ✓ OpenAI-compatible ✓ 100+ modelos ✓ Optimizado con TensorRT Modelos disponibles 🟣 DeepSeek V4 Pro (671B) 🔵 Llama 4 Scout / Maverick 🟢 Mistral / Qwen3.5 / Gemma 🟡 Nemotron 3 Super (120B) + imagen, audio, embeddings... Base URL: integrate.api.nvidia.com/v1 · Misma interfaz para todos los modelos · Solo cambia el nombre del modelo

Paso 1: Crear cuenta y obtener tu API key

  1. Ve a build.nvidia.com y haz clic en Login (esquina superior derecha).
  2. Regístrate con tu email. Esto te inscribe en el NVIDIA Developer Program — completamente gratis, sin tarjeta de crédito.
  3. Una vez dentro, ve a tu perfil → Settings → API Keys (o directo a build.nvidia.com/settings/api-keys).
  4. Haz clic en Generate Key. Tu clave aparece una sola vez — cópiala inmediatamente y guárdala en un lugar seguro.
  5. La clave tiene el formato: nvapi-xxxxxxxxxxxxxxxxxxxx
La API key aparece UNA SOLA VEZ. Si la pierdes, debes generar una nueva. Guárdala en un gestor de contraseñas o en una variable de entorno — nunca la pegues directamente en tu código.

Paso 2: Explorar los modelos disponibles

Antes de escribir código, conviene explorar qué hay disponible. En build.nvidia.com/models puedes probar cualquier modelo directamente en el navegador antes de usar la API.

CategoríaModelos destacadosMejor para
Razonamiento / ChatDeepSeek V4 Pro, Nemotron 3 Super 120B, Llama 4 MaverickAnálisis complejo, código, redacción avanzada
Rápidos / EficientesLlama 4 Scout, Mistral Small, Qwen3.5 7BRespuestas rápidas, tareas simples, alto volumen
CódigoDeepSeek Coder, CodeLlama, Qwen2.5-CoderGeneración y revisión de código
MultimodalLlama 4 Scout (visión), Phi-3 VisionAnálisis de imágenes, documentos visuales
EmbeddingsNV-Embed-v2, E5-Mistral-7BBúsqueda semántica, similaridad de texto
EspecializadosBioNeMo (biología), FourCastNet (clima)Investigación científica

Paso 3: Instalar dependencias y primera llamada

Los endpoints de NIM son compatibles con OpenAI — usas la librería estándar openai de Python, solo cambias el base_url y el api_key. Si ya conoces OpenAI, ya sabes usar NIM.

# Instalar la librería (si no la tienes)
pip install openai
# Primera llamada — lo mínimo que necesitas
from openai import OpenAI

client = OpenAI(
    base_url="https://integrate.api.nvidia.com/v1",
    api_key="nvapi-TU-CLAVE-AQUI"
)

response = client.chat.completions.create(
    model="meta/llama-4-scout-17b-16e-instruct",
    messages=[
        {"role": "user", "content": "Explica qué es una API en 3 líneas"}
    ],
    max_tokens=512
)

print(response.choices[0].message.content)
Cambia el modelo en una sola línea. Para pasar de Llama a DeepSeek solo cambias el parámetro model. El resto del código es idéntico. Todos los modelos usan la misma URL base — solo cambia el nombre del modelo.

Paso 4: Buenas prácticas — API key en variable de entorno

Nunca pongas tu API key directamente en el código. Si subes el código a GitHub, cualquiera la verá. La forma correcta es usar variables de entorno:

🪟 Windows — configurar variable de entorno
# En PowerShell (solo para la sesión actual)
$env:NVIDIA_API_KEY = "nvapi-tu-clave-aqui"

# Permanente (para todas las sesiones)
[System.Environment]::SetEnvironmentVariable(
  "NVIDIA_API_KEY", "nvapi-tu-clave-aqui", "User"
)
🍎 macOS / Linux — configurar variable de entorno
# Agrega esta línea a tu ~/.zshrc o ~/.bashrc
export NVIDIA_API_KEY="nvapi-tu-clave-aqui"

# Luego recarga el archivo
source ~/.zshrc
# Ahora tu código lee la clave del entorno
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://integrate.api.nvidia.com/v1",
    api_key=os.environ["NVIDIA_API_KEY"]  # ✅ Seguro
)

# O con python-dotenv (recomendado para proyectos)
# pip install python-dotenv
from dotenv import load_dotenv
load_dotenv()  # Lee el archivo .env automáticamente

Paso 5: Ejemplos prácticos

💬 Chat con historial de conversación
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://integrate.api.nvidia.com/v1",
    api_key=os.environ["NVIDIA_API_KEY"]
)

# Mantener historial de la conversación
historial = [
    {"role": "system", "content": "Eres un asistente comercial experto en construcción."}
]

def chatear(mensaje_usuario):
    historial.append({"role": "user", "content": mensaje_usuario})
    
    respuesta = client.chat.completions.create(
        model="nvidia/nemotron-3-super-49b-instruct",
        messages=historial,
        max_tokens=1024,
        temperature=0.7
    )
    
    respuesta_texto = respuesta.choices[0].message.content
    historial.append({"role": "assistant", "content": respuesta_texto})
    return respuesta_texto

# Uso
print(chatear("¿Cuáles son las tendencias en materiales de construcción para 2026?"))
print(chatear("¿Y específicamente para vivienda VIS en Colombia?"))
🔄 Streaming (respuesta en tiempo real)
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://integrate.api.nvidia.com/v1",
    api_key=os.environ["NVIDIA_API_KEY"]
)

# Con streaming: el texto aparece mientras se genera
stream = client.chat.completions.create(
    model="deepseek-ai/deepseek-v4-0324",
    messages=[{"role": "user", "content": "Escribe un análisis de mercado de 3 párrafos"}],
    max_tokens=1024,
    stream=True  # ← Esta es la única diferencia
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="", flush=True)
📊 Procesar múltiples textos (batch)
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://integrate.api.nvidia.com/v1",
    api_key=os.environ["NVIDIA_API_KEY"]
)

# Clasificar una lista de textos — ideal para Haiku-equivalente en NIM
correos = [
    "Necesito la cotización urgente para mañana",
    "Newsletter de la industria de enero",
    "Reunión cancelada, reprogramar la próxima semana"
]

def clasificar(texto):
    r = client.chat.completions.create(
        model="meta/llama-4-scout-17b-16e-instruct",  # Modelo rápido
        messages=[{
            "role": "user",
            "content": f"Clasifica este email como 'urgente', 'normal' o 'spam'. Solo responde la palabra. Email: {texto}"
        }],
        max_tokens=10,
        temperature=0  # 0 = determinista, ideal para clasificación
    )
    return r.choices[0].message.content.strip()

for correo in correos:
    print(f"{clasificar(correo):8} → {correo[:50]}")
🖼️ Análisis de imágenes (modelos multimodal)
import os, base64
from openai import OpenAI

client = OpenAI(
    base_url="https://integrate.api.nvidia.com/v1",
    api_key=os.environ["NVIDIA_API_KEY"]
)

# Leer imagen local y convertirla a base64
with open("plano.jpg", "rb") as f:
    imagen_b64 = base64.b64encode(f.read()).decode()

respuesta = client.chat.completions.create(
    model="meta/llama-4-scout-17b-16e-instruct",  # Soporta visión
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Analiza este plano arquitectónico. ¿Qué tipo de espacio es?"},
            {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{imagen_b64}"}}
        ]
    }],
    max_tokens=512
)

print(respuesta.choices[0].message.content)

Límites del plan gratuito

LímiteValorQué significa
Créditos iniciales~1,0001 crédito ≈ 1 llamada API. Suficiente para prototipar.
Rate limit40 RPM40 requests por minuto. Más que suficiente para desarrollo.
Tarjeta de créditoNo requeridaSolo email para el Developer Program.
ExpiraciónSin vencimientoLos créditos no expiran.
Upgrade RPM200 RPMPuedes solicitar más por el foro de NVIDIA Developer.
Uso en producciónPlan EnterprisePara cargas de trabajo reales se requiere contrato.
Error HTTP 402: Cuando tu cuota gratuita se agota, NVIDIA devuelve un error HTTP 402 con un mensaje claro. Algunos modelos pequeños mantienen acceso con cuotas diarias base, pero para modelos flagship necesitas créditos adicionales o plan enterprise.

¿Cuándo usar NVIDIA NIM vs. Claude API?

SituaciónMejor opciónPor qué
Prototipo de proyecto con IANVIDIA NIMGratis, sin tarjeta, ideal para experimentar
Procesamiento de alto volumenNVIDIA NIMCosto menor en producción con plan Enterprise
Necesitas el mejor razonamientoClaude OpusClaude sigue siendo superior en seguir instrucciones complejas
Integración con Proyectos ClaudeClaude APINativo en el ecosistema que ya usas
Modelo especializado (bio, clima)NVIDIA NIMModelos que no existen en otras plataformas
Comparar múltiples modelosNVIDIA NIM100+ modelos, mismo código, cambias 1 línea
🎯 Ejercicio: Tu primera llamada a NVIDIA NIM (10 minutos)
  1. Ve a build.nvidia.com y crea tu cuenta.
  2. Genera tu API key en Settings → API Keys. Cópiala.
  3. Abre una terminal o Claude Code y ejecuta:
    pip install openai python-dotenv
  4. Crea un archivo .env en tu carpeta:
    NVIDIA_API_KEY=nvapi-tu-clave-aqui
  5. Crea test_nim.py con el código del Paso 3 y ejecútalo:
    python test_nim.py
  6. Deberías ver una respuesta en español de Llama 4. Ahora cambia el modelo a "deepseek-ai/deepseek-v4-0324" y compara.
🔗 Conectar NVIDIA NIM con proyectos en Claude Code

Si usas Claude Code para desarrollo, puedes llamar a NVIDIA NIM desde Claude directamente:

# En tu CLAUDE.md, agrega:
## APIs disponibles en este proyecto
- NVIDIA NIM: variable de entorno NVIDIA_API_KEY
- Modelo por defecto: meta/llama-4-scout-17b-16e-instruct
- Base URL: https://integrate.api.nvidia.com/v1
- Librería: openai (compatible)

## Cuando necesites usar IA adicional
Usa la función nim_chat() definida en utils/nim.py

Con esto, Claude Code sabe que puede usar NVIDIA NIM sin que se lo repitas en cada sesión.

Terminal y CMD: comandos que necesitas saber

Varias secciones de esta guía (Claude Code, instalar skills, NVIDIA NIM, Python) requieren usar la terminal — esa ventana de texto negra que parece de película de hacker. No necesitas ser programador para usarla. Solo necesitas conocer 10 comandos.

¿Cómo abrir la terminal en tu sistema? 🪟 Windows Tecla Win + R → escribe: powershell O busca "PowerShell" en inicio 🍎 macOS Cmd + Espacio → escribe: terminal O en /Aplicaciones/Utilidades 🐧 Linux Ctrl + Alt + T → abre directo O busca "Terminal" en apps

Anatomía de un comando

PowerShell / Terminal
PS C:\Users\Juan> pip install openai ← comando + argumento

└─ El símbolo antes del cursor (PS o $ o %) no lo escribes tú
Regla de oro: Nunca escribas el símbolo del prompt (PS> en Windows, $ en Mac/Linux). Solo escribe lo que viene después. En esta guía y en la documentación de Anthropic, los ejemplos siempre muestran el prompt para orientarte — no lo copies.

Los 10 comandos que más usarás

Navegación de carpetas
# Ver en qué carpeta estás ahora
$ pwd
/Users/Juan/Documents

# Listar archivos de la carpeta actual
$ ls ← Mac/Linux
PS> dir ← Windows

# Entrar a una carpeta
$ cd mi-proyecto

# Subir un nivel (ir a la carpeta anterior)
$ cd ..

# Ir directo al escritorio
$ cd ~/Desktop ← Mac/Linux
PS> cd $HOME\Desktop ← Windows
Python y pip (instalar librerías)
# Verificar que Python está instalado
$ python --version
Python 3.12.3

# Instalar una librería
$ pip install openai
Successfully installed openai-1.x.x

# Instalar varias a la vez
$ pip install openai python-dotenv requests

# Ejecutar un script de Python
$ python mi_script.py
npm / Node.js (instalar Claude Code)
# Verificar que Node.js está instalado
$ node --version
v22.x.x

# Instalar Claude Code globalmente (-g = global)
$ npm install -g @anthropic-ai/claude-code

# Verificar instalación
$ claude --version
Claude Code 1.x.x

# Iniciar Claude Code en la carpeta actual
$ claude
Variables de entorno (guardar API keys)
# Crear archivo .env en la carpeta actual
$ echo "NVIDIA_API_KEY=nvapi-xxx" > .env ← Mac/Linux
PS> echo "NVIDIA_API_KEY=nvapi-xxx" | Out-File .env ← Windows

# Ver el contenido del archivo .env
$ cat .env ← Mac/Linux
PS> type .env ← Windows

# Detener un proceso (cuando algo se queda colgado)
$ Ctrl + C ← funciona en todos los sistemas

Atajos que ahorran tiempo

AtajoQué haceFunciona en
↑ ↓ (flechas)Navegar el historial de comandos anterioresTodos
TabAutocompletar nombres de archivo o carpetaTodos
Ctrl + CCancelar / detener el proceso actualTodos
Ctrl + LLimpiar la pantalla (equivale a escribir clear)Todos
Ctrl + AIr al inicio de la líneaMac/Linux
Ctrl + EIr al final de la líneaMac/Linux
Error más común: "No se reconoce 'python' como comando". Solución: instala Python desde python.org y durante la instalación en Windows, marca la casilla "Add Python to PATH". Luego cierra y vuelve a abrir PowerShell.
🎯 Ejercicio: Tu primera sesión en la terminal (5 minutos)
  1. Abre PowerShell (Windows) o Terminal (Mac).
  2. Escribe pwd y presiona Enter. Verás en qué carpeta estás.
  3. Escribe ls (Mac) o dir (Windows). Verás los archivos de esa carpeta.
  4. Escribe cd Desktop para ir al escritorio.
  5. Escribe python --version. Si aparece un número, Python está instalado. Si dice "no se reconoce", ve a python.org e instálalo.
  6. Escribe pip install requests. Si todo funciona, verás un mensaje de éxito.

¡Eso es todo lo básico! Ahora ya puedes seguir los pasos de las otras secciones sin perderte.

Seguridad y privacidad

Entender qué pasa con tus datos al usar Claude es fundamental, especialmente si trabajas con información sensible o confidencial de tu empresa.

¿Qué pasa con tus datos? 👤 Tú Envías datos a Claude Claude procesa ✓ Genera respuesta ✓ Se elimina en 30 días 📄 Respuesta Solo tú la ves 🚫 NO entrena el modelo (salvo que actives opt-in) 🛡 Team / Enterprise Nunca entrena, contractual
🔒 ¿Qué plan me conviene según la sensibilidad de mis datos?
Tipo de datosPlan recomendadoPor qué
Uso personal, tareas generalesFree o ProSuficiente protección si desactivas opt-in de entrenamiento
Datos empresariales internosTeamGarantía contractual de no entrenamiento
Datos financieros, médicos, legalesEnterpriseMáxima protección, auditoría, ZDR disponible
Datos de clientes (GDPR, CCPA)Enterprise o APICumplimiento regulatorio + Zero Data Retention

¿Claude entrena con tus datos?

Tipo de cuenta¿Entrenan con tus datos?Retención de datos
Free / Pro / MaxSolo si activaste "Ayudar a mejorar Claude" (opt-in desde oct 2025). Si dijiste NO, no se usan.30 días tras eliminar (sin entrenamiento). Hasta 5 años (si opt-in).
Team / Enterprise❌ NO — nunca, por defecto. Sin excepción.Según política de la organización
API❌ NO — nunca.Según configuración (existe Zero Data Retention)

Cómo verificar tu configuración

  1. Ve a Ajustes → Privacidad en claude.ai.
  2. Busca la opción "Puedes ayudar a mejorar Claude" (o "You can help improve Claude").
  3. Si está activada y no quieres que usen tus datos: desactívala.
  4. Las conversaciones eliminadas nunca se usan para entrenamiento, sin importar la configuración.

¿Quién puede ver tus conversaciones?

Por defecto, los empleados de Anthropic no pueden acceder a tus conversaciones excepto en dos casos: si das feedback explícito (botón 👍/👎 con comentario), o si se necesita revisar una posible violación de las políticas de uso (en cuyo caso solo el equipo de Trust & Safety tiene acceso controlado).

Prácticas recomendadas de seguridad

PrácticaCómo
No subir contraseñas, API keys o tokensUsa variables de entorno: $MI_API_KEY en vez del valor real
Datos financieros sensiblesAnonimiza antes de subir (cambia nombres, redondea cifras)
Conversaciones confidencialesUsa modo Incógnito (Temporary Chat) — no se guardan ni generan memoria
Revisar configuración periódicamenteUna vez al mes, revisa Ajustes → Privacidad
Para equipos con datos reguladosUsar plan Team o Enterprise — protección contractual de datos
Contexto importante: Claude NO busca en internet ni accede a tus archivos por su cuenta. Solo puede ver lo que tú le das en la conversación, lo que está en el proyecto, y lo que conectas vía MCP. No "espía" tu computadora ni tiene acceso a datos que no le compartas explícitamente.

Preguntas frecuentes

Respuestas verificadas con la documentación oficial de Anthropic (support.claude.ai y docs.anthropic.com), julio 2026.

Sobre memoria y datos

¿Claude recuerda lo que hablé en conversaciones anteriores?

Por defecto, no. Cada conversación nueva empieza desde cero. Claude no tiene acceso al historial de tus chats anteriores a menos que:

  • Actives la Memoria en Ajustes → Memoria (extrae preferencias automáticamente)
  • Actives "Buscar en chats pasados" (planes de pago) — Claude puede buscar en conversaciones anteriores cuando es relevante
  • Uses Proyectos — las instrucciones y archivos del proyecto están disponibles en cada chat del proyecto

Fuente: support.claude.ai

¿Anthropic usa mis conversaciones para entrenar al modelo?

Depende de tu plan y configuración:

  • Free/Pro/Max: Solo si tienes activada la opción "Ayudar a mejorar Claude" (opt-in desde oct 2025). Si dijiste NO, no se usan. Ve a Ajustes → Privacidad para verificarlo.
  • Team/Enterprise: Nunca — garantía contractual.
  • API: Nunca por defecto. Zero Data Retention disponible.

Las conversaciones que eliminas nunca se usan para entrenamiento. Fuente: privacy.anthropic.com

¿Por qué Claude no responde en español a veces?

Claude responde en el idioma del prompt por defecto. Si le escribes en inglés, te responde en inglés. Soluciones:

  1. Agrega "Responde siempre en español" en tus Instrucciones para Claude (Ajustes → Preferencias). Aplica a todos tus chats.
  2. Si el archivo que subiste está en inglés, Claude puede responder en inglés sobre ese contenido. Agrega al prompt: "Responde en español aunque los documentos estén en otro idioma".

Sobre límites y velocidad

¿Cuántos mensajes puedo enviar? ¿Por qué me llega el límite?

Anthropic no publica límites exactos. Los límites se basan en una ventana de 5 horas desde tu primer mensaje. En esa ventana puedes enviar aproximadamente 15 a 40 mensajes, dependiendo de la demanda y del tamaño de tus mensajes.

El consumo depende de: longitud del mensaje, tamaño de archivos adjuntos, longitud acumulada de la conversación, uso de herramientas, creación de artefactos y modelo elegido.

Estrategias para durar más: Usa conversaciones cortas en vez de un chat largo. Prefiere Sonnet a Opus para tareas normales. No adjuntes archivos innecesarios. Usa Proyectos (los archivos del proyecto se cachean).

¿Por qué Claude se detuvo a mitad de la respuesta?

Hay dos causas principales:

  • Límite de tokens de salida: Claude tiene un límite de cuántos tokens puede generar en una sola respuesta. Si la respuesta es muy larga, se corta. Solución: pide la respuesta en partes — "Generame las primeras 5 secciones" y luego "continúa con las siguientes 5".
  • Contexto saturado: La conversación es tan larga que no hay espacio para generar una respuesta completa. Solución: inicia un chat nuevo con un resumen del estado actual.

Si la respuesta se cortó, puedes simplemente escribir "Continúa" o "Continúa desde donde te quedaste".

¿Por qué Claude es más lento a ciertas horas?

La velocidad de respuesta varía según la carga de los servidores de Anthropic. En horas pico (tarde-noche en EE.UU., 7-11pm ET) suele ser más lento. Los planes Pro/Max tienen prioridad en cola sobre el plan gratuito. Puedes ver el estado de los servidores en tiempo real en status.anthropic.com.

Sobre calidad de respuestas

¿Por qué Claude a veces inventa datos o da información falsa?

Esto se llama "alucinación" — cuando el modelo genera texto que suena plausible pero es incorrecto. Ocurre porque Claude predice el texto más probable, no porque "sepa" que algo es verdad.

Cuándo es más frecuente: datos numéricos específicos, fechas exactas, citas textuales, información de personas poco conocidas, hechos muy recientes.

Cómo reducirlo: Activa la búsqueda web. Añade al prompt: "Si no estás seguro de un dato, dímelo explícitamente". Siempre verifica datos críticos con fuentes primarias.

¿Por qué Claude da respuestas diferentes a la misma pregunta?

Claude tiene un parámetro llamado temperatura que controla la aleatoriedad. En claude.ai está ajustada para dar respuestas variadas y creativas. Dos preguntas idénticas pueden dar respuestas distintas — eso es esperado. Si necesitas resultados consistentes (clasificación, extracción de datos), usa la API con temperature=0.

¿Cuál es la fecha de corte del conocimiento de Claude?

El corte de conocimiento confiable varía por modelo. Para información actualizada, consulta la tabla de modelos en docs.anthropic.com. Para eventos recientes, activa siempre la Búsqueda web — Claude busca en internet en tiempo real cuando está activada.

Sobre archivos y formatos

¿Puedo subir un PDF completo de 200 páginas?

Técnicamente sí, pero no es lo ideal. Un PDF de 200 páginas puede consumir entre 80,000 y 180,000 tokens de tu ventana de contexto, dejando poco espacio para la conversación. Solución recomendada:

  • Convierte el PDF a Markdown (ver sección "PDF vs Markdown") para reducir el consumo hasta 90%
  • O extrae solo las secciones relevantes y súbelas por separado
  • Para PDFs escaneados (imágenes), Claude puede leerlos directamente con su capacidad de visión
¿Claude puede leer imágenes? ¿Y escuchar audio?

Imágenes: Sí. Claude puede analizar fotos, capturas de pantalla, gráficos, diagramas, planos — prácticamente cualquier imagen. Arrastra o adjunta la imagen al chat. Cada imagen consume tokens según su tamaño (ver sección de Tokens).

Audio: No directamente. Claude.ai no tiene entrada de audio nativa en modo texto. La Voz en la app móvil convierte tu voz a texto (speech-to-text) y luego Claude procesa el texto — no analiza el audio como señal.

Sobre Claude Code y técnicos

¿Qué diferencia hay entre claude.ai, Claude Code y la API?
InterfazPara quiénCómo se accede
claude.aiTodos — uso diarioNavegador web o app móvil
CoworkNo-programadores que quieren automatizaciónApp de escritorio (descarga en claude.ai/download)
Claude CodeDesarrolladores — codificación agénticaTerminal: npm install -g @anthropic-ai/claude-code
APIDesarrolladores — integración en apps propiasHTTP REST o SDK de Python/JS
¿Puedo usar Claude sin internet?

No. Claude es un servicio en la nube — siempre necesita conexión a internet para procesar tus mensajes. Los modelos no se descargan a tu computadora. La única excepción es esta guía HTML, que funciona offline una vez descargada.

¿Es seguro pegar código de mi empresa o datos confidenciales?

Depende del plan. Para datos realmente confidenciales:

  • Free/Pro: Usa el modo Incógnito (Temporary Chat) — no se guarda ni genera memoria
  • Team/Enterprise: Garantía contractual de no entrenamiento — más adecuado para datos empresariales
  • Para todos: Nunca pegues contraseñas, API keys, números de tarjeta o datos de identificación personal

Fuente: privacy.anthropic.com · trust.anthropic.com

¿Qué hago si Claude se equivoca o da una respuesta peligrosa?

Usa el botón 👎 (pulgar abajo) debajo de la respuesta y selecciona el tipo de problema. Esto envía el feedback directamente a Anthropic para mejorar el modelo. También puedes reportar contenido problemático en usersafety@anthropic.com. Para soporte técnico: support.anthropic.com.

Errores comunes y cómo corregirlos

ErrorPor qué ocurreSolución
"Claude da respuestas genéricas" Prompt vago, sin contexto específico Agrega contexto: quién eres, para qué es, qué formato quieres, un ejemplo del resultado ideal. Usa etiquetas XML.
"Inventa datos o cifras" Alucinación: el modelo genera texto plausible pero falso Pide que cite fuentes. Activa búsqueda web. Incluye en el prompt: "Si no estás seguro, dilo explícitamente".
"Olvida lo que le dije antes" La conversación excede la ventana de contexto, o estás en un chat nuevo Usa Proyectos con instrucciones persistentes. Activa la memoria. Para chats largos, resume el contexto periódicamente.
"El archivo generado está roto" Generación incompleta o formato corrupto Regenera la respuesta. Si persiste, pide que lo genere en pasos: primero la estructura, luego el contenido.
"Se niega a hacer algo legítimo" Filtros de seguridad demasiado conservadores Reformula el prompt con más contexto sobre por qué lo necesitas y su uso legítimo. Evita frases ambiguas.
"Pierde el hilo en chats largos" Contexto saturado: demasiada información acumulada Inicia un nuevo chat dentro del mismo Proyecto. Resume los puntos clave al principio del nuevo chat.
"Responde en inglés" No especificaste idioma, o los archivos son en inglés Agrega "Responde siempre en español" en tus Preferencias de usuario. Así aplica a toda conversación.
"Genera código que no funciona" Falta contexto del stack, versiones o dependencias Incluye versiones exactas en las instrucciones del proyecto. Pide que genere y ejecute tests.
"Es demasiado verboso" Comportamiento predeterminado: explicar a fondo Agrega en preferencias: "Sé conciso. Sin preámbulos. Ve al grano." O pide formato específico (solo tabla, solo JSON).
"Límite de mensajes alcanzado" Cuota del plan agotada Espera al reset (generalmente unas horas). Considera plan Pro si usas el gratuito. Optimiza tus prompts para necesitar menos mensajes.

Recomendaciones de expertos

Selección de modelo

SituaciónModelo recomendadoPor qué
Trabajo diario generalSonnet 5Mejor relación calidad-precio; cubre el 80% de las tareas
Razonamiento complejo, lógica multi-pasoOpus 4.6+Mayor capacidad de razonamiento profundo
Documentos largos (+100 páginas)Opus o SonnetVentana de contexto de 1M tokens
Clasificación masiva de datosHaiku 4.5Rápido y barato para tareas repetitivas
Escritura creativa de alta calidadSonnet 4.6Excelente balance entre creatividad y coherencia
Desarrollo de software avanzadoOpus 4.8Máxima capacidad en codificación autónoma con pensamiento adaptativo

Las 10 prácticas que más impacto tienen

  1. Configura Preferencias de usuario primero. Es lo primero que Claude lee en CADA conversación. Define tu idioma, rol, nivel de experiencia y formato preferido.
  2. Usa Proyectos para todo trabajo recurrente. Nunca trabajes en chats sueltos para algo que necesite más de una sesión.
  3. Escribe instrucciones de proyecto en los primeros 10 minutos. Invierte al inicio para ahorrar horas después.
  4. Muestra ejemplos en vez de describir. Un ejemplo del resultado esperado vale más que tres párrafos de explicación.
  5. Estructura con XML. Las etiquetas <contexto>, <tarea>, <formato> no son opcionales — son la forma más efectiva de comunicarte con Claude.
  6. Un chat, una tarea. No mezcles temas en un solo chat. Crea conversaciones nuevas dentro del Proyecto para cada tarea distinta.
  7. Itera, no esperes perfección. El primer resultado rara vez es el final. Pide ajustes, señala errores, refina. Claude mejora con cada iteración.
  8. Conecta tus herramientas (MCP). Google Drive, Calendar, Gmail — cada conector elimina pasos manuales.
  9. Verifica siempre datos críticos. Claude es un asistente, no un oráculo. Datos numéricos, fechas, nombres propios: verifica.
  10. Actualiza tus instrucciones después de cada frustración. Cada error de Claude es una oportunidad para mejorar el contexto. Añade reglas "NO hacer" cada vez que ocurra algo inesperado.

Flujo de trabajo recomendado para nuevos proyectos

1. DEFINIR Crear proyecto + escribir instrucciones 2. SUBIR CONTEXTO Archivos de referencia, datos, ejemplos 3. PRIMERA TAREA Prompt específico con formato de salida 4. ITERAR Y REFINAR Ajustar resultado, corregir errores 5. ACTUALIZAR INSTRUCCIONES Cada error → nueva regla en el proyecto ciclo continuo

Tips avanzados por tipo de trabajo

📊 Análisis de datos

Sube datos en CSV (menos tokens que Excel). Pide primero un resumen de las columnas antes de solicitar análisis. Especifica el tipo de gráfico que necesitas. Activa "Ejecución de código" para que Claude procese datos con Python.

Prompt modelo: "Analiza este CSV. Primero describe las columnas y muestra las primeras 5 filas. Luego calcula: promedio, mediana y desviación estándar de la columna 'ventas' agrupado por 'región'. Genera un gráfico de barras."

📝 Escritura y documentos

Define el público objetivo, tono y longitud antes de pedir un borrador. Proporciona un ejemplo de estilo si lo tienes. Para documentos largos, pide primero un outline y apruébalo antes de generar el contenido completo.

Prompt modelo: "Escribe un informe ejecutivo para directivos no-técnicos. Tono: profesional pero accesible. Máximo 2 páginas. Estructura: resumen ejecutivo, hallazgos clave (3), recomendaciones (3), próximos pasos."

💻 Desarrollo de software

Siempre especifica versiones exactas del stack. Incluye patrones de código existentes como ejemplo. Pide tests junto con el código. Para refactoring, muestra el código actual y describe el estado deseado.

Tip clave: Crea un archivo CLAUDE.md en la raíz del proyecto (para Claude Code) con el contexto del proyecto. Es lo primero que Claude lee y tiene el mayor impacto en la calidad del código generado.

🗂️ Automatización con Cowork

Empieza con tareas simples (renombrar archivos, organizar carpetas) antes de intentar flujos complejos. Usa instrucciones por carpeta para que Claude entienda la estructura. Programa tareas recurrentes para reportes semanales o limpiezas de carpetas.

Tip clave: Para tareas que tocan muchos archivos, pide primero un "plan" sin ejecutar — que Claude liste qué va a hacer antes de hacerlo. Así puedes corregir antes de que modifique algo.

Recursos y enlaces oficiales

Documentación oficial de Anthropic

RecursoURLPara qué
Documentación de Claudedocs.claude.comGuías de uso, configuración, funcionalidades
Soporte de Claudesupport.claude.comPreguntas frecuentes, problemas, límites
Prompt Engineeringdocs.anthropic.com/.../prompt-engineeringGuía oficial de ingeniería de prompts
Mejores prácticas Claude 4docs.anthropic.com/.../claude-4-best-practicesTécnicas específicas para modelos Claude 4.x
Context Engineeringanthropic.com/.../context-engineeringArtículo oficial sobre ingeniería de contexto
Tutorial interactivo de promptsgithub.com/anthropics/prompt-eng-interactive-tutorialCurso gratuito con ejercicios
Producto: Claude Coworkanthropic.com/product/claude-coworkPágina oficial de Cowork
Modelos disponiblesdocs.anthropic.com/.../modelsLista completa de modelos y capacidades

Tutoriales y guías comunitarias de alta calidad

RecursoTema
DataCamp: Tutorial de CoworkGuía paso a paso con ejemplos prácticos
JD Hodges: Custom InstructionsEjemplo real de instrucciones personalizadas
JD Hodges: Project InstructionsPlantillas y ejemplos de instrucciones de proyecto

Atajos y cheat sheet

AcciónCómo
Nuevo chat en el proyecto actualClic en "+" dentro del proyecto
Subir archivo al chatArrastra y suelta, o clic en 📎
Cambiar de modeloSelector de modelo en la parte inferior del chat
Regenerar respuestaClic en el ícono de regenerar (↻)
Editar tu mensaje anteriorClic en el ícono de editar en tu mensaje
Copiar respuestaClic en el ícono de copiar
Dar feedback👍 o 👎 en cada respuesta
Buscar en chats anterioresActivar "Buscar en chats pasados" en ajustes
Regala Claude, gana más Claude
Regálale a un amigo una semana gratis de Claude Code. Si le encanta y se suscribe, recibirás USD 10 en créditos de uso para seguir creando. Tus contactos pueden probar tanto Cowork como Claude Code.