Guía para Principiantes en IA: Primeros Pasos

Los plugins de Claude Code agrupan skills, subagentes, hooks, configuración MCP y otras extensiones para distribuirlas. Un marketplace es un catálogo que indica dónde obtenerlas. Este artículo explica los catálogos oficial y comunitario, el registro, la instalación y la habilitación; después muestra cómo crear una skill, validar su plugin y catálogo y distribuirlos mediante Git con una estructura de directorios coherente. También aborda los ámbitos de instalación, las condiciones de actualización según la versión y lo que una revisión de seguridad no garantiza.

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.

Claude Code muestra "Prompt is too long" cuando la entrada total, incluidos historial, archivos y resultados de herramientas, supera el límite de contexto. Este artículo distingue entre compactar un historial largo, reducir una primera entrada excesiva y resolver la causa de un error de compactación, como un fallo de autenticación. Las definiciones MCP se cargan bajo demanda de forma predeterminada; la disponibilidad de 1M depende del modelo, la conexión y el plan. También explica el recuento de tokens y los motivos de parada al usar directamente la API.

Si un servidor MCP no conecta en Claude Code, revisa conjuntamente el estado, el método de conexión y los detalles de Issue. failed puede indicar un fallo de inicio stdio, un problema de comunicación HTTP o el rechazo de una cabecera fija de autenticación. El artículo explica Connection closed, las variables de entorno y las referencias no definidas, la configuración y aprobación del proyecto, el inicio de npx en Windows, los registros de depuración y las pruebas tras reconectar. También aclara por qué cero herramientas no implica necesariamente un error y por qué un inicio independiente no garantiza una conexión MCP correcta.

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.