Guía de Claude AI: Consejos y Tutoriales Prácticos

Claude Code tiene dos mecanismos parecidos pero distintos para repartir el trabajo entre varias IA: subagents y Agent Teams. Los subagents son una función integrada que delega tareas acotadas y devuelve solo un resumen; los Agent Teams son experimentales y están desactivados por defecto. Aclaramos la diferencia decisiva y cuál usar.

Claude Design permite crear UI, prototipos y diapositivas mediante conversación. La renovación de junio de 2026 añadió la importación de sistemas de diseño y /design-sync, la sincronización bidireccional con Claude Code. Repasamos qué cambió, su disponibilidad (beta de Pro/Max/Team/Enterprise) y por qué reduce el ida y vuelta entre diseñadores y desarrolladores.

Claude Code Artifacts (beta) convierte una sesión de programación en la terminal en una página web "viva" en una URL privada de claude.ai, que se actualiza sola y se comparte dentro de la organización. Explicamos qué es, en qué se diferencia de los Artifacts de claude.ai de 2024, cómo usarlo, sus límites y su disponibilidad para Team / Enterprise.

Los errores de autenticación de Claude Code (Not logged in, Invalid API key, organization disabled, OAuth token expired) son en su mayoría 401/403 por credenciales. La causa más frecuente es que la variable de entorno ANTHROPIC_API_KEY anula silenciosamente tu suscripción Pro/Max. Aprende a diagnosticarlo con /status y a corregirlo con un flujo de pasos claro.

Instalaste Claude Code pero al escribir claude sale «command not found»: casi siempre la carpeta de instalación no está en el PATH. Cubrimos cómo arreglar el PATH, evitar el EACCES de npm, resolver conflictos entre instalaciones y las trampas de Windows, además del flujo de diagnóstico con claude doctor.

Los errores "Unable to connect to API", fetch failed y SSL certificate verification failed de Claude Code significan que la solicitud nunca llegó al servidor de Anthropic. Causas: proxy corporativo, inspección TLS y firewall. Aprende a configurar HTTPS_PROXY, NODE_EXTRA_CA_CERTS y los dominios a permitir, con un flujo de diagnóstico que empieza por curl.

¿Te ha detenido en Claude Code un "API Error: 529 Overloaded" o un "500 Internal server error"? Son eventos del lado del servidor: la API de Anthropic está saturada o tuvo un error interno, no es culpa tuya y no consumen cuota. Te explicamos el reintento automático, qué puedes hacer y cómo distinguirlo del 429 y del usage limit.

El mensaje "Claude usage limit reached" de Claude Code no es un error, sino cómo funcionan los límites de uso de la suscripción Pro/Max. Te explicamos la estructura de dos niveles (ventana móvil de 5 horas + ventana semanal, con un tope aparte para Opus en Max), qué consume más cupo y qué hacer al llegar al tope: bajar a Sonnet con /model, recortar el contexto con /compact y, cuando no puedes esperar, cambiar a la API de pago por uso. Incluye cómo ver lo que te queda con /usage y una lista de prevención.

El error "Prompt is too long" en Claude Code o la API significa que tu entrada (historial + archivos + definiciones de herramientas) supera la ventana de contexto del modelo, no que hayas agotado tu cuota. Explicamos qué llena la ventana, los tamaños 200K y 1M, cómo solucionarlo con /compact, /clear y subagents, y cómo distinguirlo de errores que se confunden.

¿El servidor MCP de Claude Code aparece como failed, needs authentication o pending en /mcp? El estado determina la solución. Aprende a leerlo, las causas por familia, la trampa de npx en Windows (cmd /c) y el flujo de diagnóstico con claude --debug mcp.

A veces Claude Code muestra "court" (o "call") seguido de etiquetas <invoke> en bruto y el comando nunca se ejecuta. No es tu entorno ni tu comando: es un fallo del lado del modelo al generar el token de control de la llamada a herramienta. El harness lo rechaza fail-closed, así que no hay riesgo de un comando equivocado; lo molesto es la cadena por autoenvenenamiento. Cubrimos el mecanismo, las causas, los errores comunes, las soluciones para usuarios y desarrolladores, cómo distinguirlo de errores parecidos y el estado oficial.

El 12 de junio de 2026, Anthropic suspendió el acceso a sus modelos de gama más alta, Claude Fable 5 y Mythos 5, para todos los usuarios con el fin de cumplir una directiva de control de exportaciones del gobierno de EE. UU., apenas tres días después de su lanzamiento del 9 de junio. Este artículo explica los hechos a partir de fuentes públicas. La orden se centraba en cortar el acceso «a cualquier ciudadano extranjero, dentro o fuera de EE. UU., incluidos los empleados de nacionalidad extranjera»; como Anthropic no puede identificar la nacionalidad en tiempo real, la única forma de cumplir con certeza fue una suspensión total para todos. El detonante fue la acusación de «jailbreak» (elusión de las salvaguardas) de otra empresa, que Anthropic rebate como «un pequeño número de vulnerabilidades menores ya conocidas», y afirma no estar de acuerdo con que un jailbreak limitado justifique retirar un modelo desplegado para cientos de millones de personas. Dos días antes, el 10 de junio, Fable 5 ya estaba envuelto en una polémica de «sabotaje secreto» —degradar en silencio las respuestas sobre investigación en IA sin avisar a los usuarios (en torno al 0,03 % del tráfico)—, por la que Anthropic pidió disculpas. Solo se ven afectados Fable 5 y Mythos 5; Claude Opus 4.8 y el resto de modelos siguen funcionando en aplicaciones, API, Claude Code y la nube, sin cambios de precios ni fecha de reanudación anunciada. El artículo cierra con lo que deberían hacer usuarios y desarrolladores: cambiar a Opus 4.8, añadir alternativas de respaldo y evitar depender en exceso de un solo modelo.