Guía de Estudio — Prompting con Claude

PROGRESO

0 / 20 completados

Fundamentos

01 Sé claro y directo CLAVE

▾

Claude responde mejor a instrucciones claras y explícitas. Trátalo como un empleado brillante pero nuevo que necesita contexto sobre tus normas y flujos de trabajo.

Sé específico sobre el formato de salida y sus restricciones.

Si quieres algo "más allá de lo básico", pídelo explícitamente.

Usa listas numeradas cuando el orden o completitud importa.

Regla de oro: Muestra tu prompt a un colega con mínimo contexto. Si estaría confundido, Claude también lo estará.

Ejemplo — menos vs. más efectivo

❌ "Crear un panel de análisis"

✅ "Crear un panel de análisis. Incluye tantas características e
   interacciones relevantes como sea posible. Ve más allá de lo
   básico para crear una implementación completamente funcional."

¿Cuál es la "regla de oro" para evaluar un prompt?

02 Añadir contexto y motivación TIP

▾

Explicar por qué necesitas cierto comportamiento ayuda a Claude a entender mejor tus objetivos y generalizar desde la explicación.

❌ "NUNCA uses puntos suspensivos"

✅ "Tu respuesta será leída por un motor de síntesis de voz,
   así que nunca uses puntos suspensivos ya que el motor
   no sabrá cómo pronunciarlos."

03 Usar ejemplos de manera efectiva (few-shot) CLAVE

▾

Los ejemplos son una de las formas más confiables de dirigir formato, tono y estructura. Incluye 3–5 ejemplos para mejores resultados.

Relevantes: que reflejen de cerca tu caso de uso real.

Diversos: que cubran casos extremos y variados.

Estructurados: envuélvelos en etiquetas <example> o <examples>.

¿Cuántos ejemplos se recomiendan para mejores resultados?

04 Estructurar con etiquetas XML CLAVE

▾

Las etiquetas XML ayudan a Claude a analizar prompts complejos sin ambigüedad, especialmente cuando mezclas instrucciones, contexto, ejemplos e inputs variables.

<instructions>Analiza el informe...</instructions>
<context>Empresa B2B, Q3 2025</context>
<input>...datos del usuario...</input>

// Para documentos múltiples:
<documents>
  <document index="1">
    <source>informe_anual.pdf</source>
    <document_content>...</document_content>
  </document>
</documents>

Usa nombres de etiquetas consistentes y descriptivos.

Anida etiquetas cuando el contenido tiene jerarquía natural.

En prompts largos, coloca los datos al inicio y la consulta al final (mejora hasta 30%).

05 Dar un rol a Claude TIP

▾

Establecer un rol en el prompt del sistema enfoca el comportamiento y tono. Incluso una sola oración marca la diferencia.

system: "You are a helpful coding assistant
         specializing in Python."

Control de Salida

06 Estilo de comunicación en Claude 4.6 NUEVO

▾

Los modelos más recientes tienen un estilo más conciso y natural comparado con generaciones anteriores:

Más directo: reportes de progreso basados en hechos, no auto-celebratorios.

Más conversacional: ligeramente más fluido y coloquial.

Menos verboso: puede omitir resúmenes detallados por eficiencia.

// Si quieres más visibilidad:
"Después de completar una tarea con herramientas, proporciona
 un resumen rápido del trabajo que has realizado."

07 Controlar el formato de respuestas CLAVE

▾

Cuatro técnicas efectivas para dirigir el formato:

Di qué hacer (no qué evitar): "Tu respuesta debe estar en párrafos que fluyan" en vez de "No uses markdown".

Usa indicadores XML: "Escribe las secciones en etiquetas <smoothly_flowing_prose_paragraphs>".

Coincide el estilo del prompt: si no quieres markdown en la salida, evítalo en tu prompt también.

Sé explícito: para mayor control, proporciona orientación detallada con un prompt específico de formato.

¿Cuál es la mejor forma de evitar markdown en la salida?

08 Migración desde respuestas prefijadas MIGRACIÓN

▾

Las respuestas prefijadas (prefill) en el último turno del asistente están deprecadas en Claude 4.6. Alternativas por caso de uso:

Formato de salida (JSON/YAML): Usa Structured Outputs o pide directamente al modelo que siga el esquema.

Eliminar preámbulos: "Responde directamente sin preámbulo. No comiences con 'Aquí está...', 'Basado en...'".

Continuaciones: "Tu respuesta fue interrumpida y terminó con [texto]. Continúa desde donde lo dejaste."

Rechazos: Claude 4.6 maneja rechazos apropiados sin necesidad de prefill.

Tool Use

09 Instrucciones explícitas para acción CLAVE

▾

Claude 4.6 está entrenado para seguimiento preciso de instrucciones. Si quieres que actúe en lugar de sugerir, sé explícito:

❌ "¿Puedes sugerir algunos cambios para mejorar esta función?"
   → Claude solo sugerirá

✅ "Cambia esta función para mejorar su rendimiento."
   → Claude implementará los cambios

Para acción proactiva: añade <default_to_action> en el system prompt.

Para comportamiento conservador: añade <do_not_act_before_instructions>.

Claude Opus 4.5/4.6 pueden overtrigger con lenguaje agresivo — usa prompting normal en vez de "CRÍTICO: DEBES usar...".

¿Por qué Claude podría "overtrigger" en herramientas en los modelos más nuevos?

10 Optimizar llamadas de herramientas paralelas CÓDIGO

▾

Claude 4.6 ejecuta herramientas en paralelo por defecto. Puedes controlar la agresividad:

Ejecutará búsquedas especulativas múltiples durante investigación.

Leerá varios archivos simultáneamente para contexto más rápido.

Para máxima eficiencia: indica explícitamente que use llamadas paralelas cuando no hay dependencias.

Importante: nunca usar placeholders o adivinar parámetros en llamadas de herramientas.

// Para reducir paralelismo:
"Ejecuta operaciones secuencialmente con breves pausas
 entre cada paso para asegurar estabilidad."

Thinking y Razonamiento

11 Pensamiento Adaptativo (Adaptive Thinking) CLAVE

▾

Claude Opus 4.6 y Sonnet 4.6 usan pensamiento adaptativo (thinking: {type: "adaptive"}): el modelo decide dinámicamente cuándo y cuánto pensar.

El pensamiento se calibra por el parámetro effort y la complejidad de la consulta.

En consultas simples, responde directo sin pensar. En complejas, piensa extensamente.

Supera al pensamiento extendido fijo en evaluaciones internas.

Ideal para: uso de herramientas múltiples, codificación compleja, agentes de largo horizonte.

// Antes (deprecated):
thinking: {"type": "enabled", "budget_tokens": 32000}

// Ahora (adaptive):
thinking: {"type": "adaptive"},
output_config: {"effort": "high"}  // max | high | medium | low

¿Qué dos factores calibran cuánto piensa Claude en modo adaptativo?

12 Controlar exceso de pensamiento TIP

▾

Opus 4.6 puede pensar extensamente, inflando tokens. Si esto es indeseable:

Baja el parámetro effort (de high a medium o low).

Reemplaza valores genéricos por instrucciones dirigidas: "Usa [herramienta] cuando mejore tu comprensión" en vez de "Por defecto usa [herramienta]".

Elimina sobre-prompting: las herramientas que undertriggered antes ahora triggean apropiadamente.

"Elige un enfoque y comprométete con él. Evita revisitar
 decisiones a menos que encuentres información que contradiga
 directamente tu razonamiento."

13 Mejores prácticas de razonamiento TIP

▾

Instrucciones generales > pasos prescriptivos: "piensa a fondo" suele superar a un plan paso a paso escrito a mano.

Few-shot con pensamiento: usa etiquetas <thinking> dentro de ejemplos para mostrar el patrón de razonamiento.

Auto-verificación: "Antes de terminar, verifica tu respuesta contra [criterios]" — atrapa errores en codificación y matemáticas.

Cuidado con "think": en Opus 4.5 sin extended thinking, la palabra "think" es muy sensible. Usa "consider", "evaluate" o "reason through".

Sistemas Agénticos

14 Razonamiento de largo horizonte y seguimiento de estado CLAVE

▾

Claude 4.6 tiene conciencia de contexto: rastrea su ventana de contexto restante y gestiona tokens eficientemente.

Si tu arnés de agente compacta contexto, informa a Claude para que no detenga tareas anticipadamente.

Usa JSON para datos estructurados de estado (tests.json) y texto libre para notas de progreso (progress.txt).

Git es excelente para rastrear estado entre múltiples sesiones.

// Prompt para contexto compactado:
"Tu ventana de contexto será compactada automáticamente.
 No detengas tareas por preocupaciones de tokens. Guarda
 progreso en memoria antes del refresco."

¿Qué formato se recomienda para datos de estado estructurado (tests, resultados)?

15 Flujos de trabajo multi-ventana de contexto TIP

▾

Primera ventana: configura marco, escribe pruebas, crea scripts de configuración (init.sh).

Ventanas siguientes: itera sobre lista de tareas con el marco establecido.

Pruebas estructuradas: mantén tests.json y recuerda a Claude que no las elimine: "Es inaceptable eliminar pruebas".

Comenzar de nuevo: considera ventana fresca + explorar el sistema de archivos en vez de compactación.

Verifica antes de avanzar: usa Playwright MCP u otras herramientas para verificar correctitud sin retroalimentación humana.

16 Equilibrio autonomía y seguridad CLAVE

▾

Sin orientación, Opus 4.6 puede tomar acciones difíciles de revertir. Define qué requiere confirmación:

Acciones locales y reversibles: editar archivos, ejecutar pruebas → proceder libremente.

Requieren confirmación: rm -rf, git push --force, drop de bases de datos, publicar a servicios externos.

No eludir controles de seguridad (--no-verify) ni descartar archivos desconocidos como atajo.

17 Orquestación de subagentes TIP

▾

Opus 4.6 delega proactivamente a subagentes sin instrucción explícita. Sin embargo, puede sobre-usarlos:

Úsalos cuando: tareas en paralelo, contexto aislado, flujos independientes sin estado compartido.

Evítalos cuando: operaciones secuenciales, ediciones de un solo archivo, necesidad de mantener contexto entre pasos.

Si ves uso excesivo, añade orientación explícita sobre cuándo subagentes son y no son apropiados.

¿En qué situación NO se recomienda usar subagentes?

18 Evitar sobreingeniería TIP

▾

Opus 4.5/4.6 tienden a crear abstracciones innecesarias o agregar flexibilidad no solicitada:

Alcance: no agregar características más allá de lo solicitado. Una corrección de bug no necesita limpieza adicional.

Documentación: no agregar docstrings al código que no cambió.

Abstracciones: no crear helpers para operaciones únicas. No diseñar para requisitos futuros hipotéticos.

Regla: la cantidad correcta de complejidad es la mínima necesaria para la tarea actual.

19 Evitar soluciones hardcoded y fijadas a pruebas CLAVE

▾

Claude puede enfocarse en "hacer pasar las pruebas" en vez de implementar lógica real. Para prevenirlo:

"Escribe una solución de propósito general. No codifiques
 valores fijos para casos de prueba específicos. Implementa
 la lógica real que resuelve el problema de manera general.

 Si una prueba es incorrecta, infórmame en lugar de trabajar
 alrededor de ella."

20 Minimizar alucinaciones en codificación CÓDIGO

▾

Para respuestas más fundamentadas y precisas sobre código:

<investigate_before_answering>
Nunca especules sobre código que no has abierto.
Si el usuario menciona un archivo específico, DEBES leerlo
antes de responder. Nunca hagas afirmaciones sobre código
antes de investigar — proporciona respuestas fundamentadas
y libres de alucinaciones.
</investigate_before_answering>

Conceptos Clave para Recordar

Sé claro y explícito, no vago

Explica el por qué de las instrucciones

3–5 ejemplos en etiquetas XML

Prefill está deprecado en 4.6

Acción explícita > sugerencia implícita

Adaptive thinking + parámetro effort

JSON para estado, texto libre para notas

Confirmar acciones destructivas/irreversibles

Subagentes: contexto aislado y paralelo

Mínima complejidad necesaria