Claude Code el primer día: CLAUDE.md, Superpowers, Context7 y más

Instalar Claude Code lleva un minuto. Ejecutar claude en la carpeta de un proyecto e iniciar sesión, otro. A partir de ahí mucha gente se pone a lanzar prompts y luego se pregunta por qué las respuestas suenan genéricas y por qué la herramienta no deja de preguntar por un stack que ya debería conocer. Una lista corta de instalaciones y ajustes, unos 20 a 30 minutos de trabajo, elimina la mayor parte de eso. La selección de abajo sigue las recomendaciones de la propia Anthropic para el primer día, más los plugins que aparecen una y otra vez en las configuraciones de desarrolladores reales.

Empiece con un CLAUDE.md

Si solo va a hacer una cosa, que sea esta. Escriba /init en la sesión y Claude analizará el repositorio y redactará un CLAUDE.md en la raíz del proyecto. Léalo, borre lo que esté mal y haga commit.

Claude carga ese archivo al inicio de cada sesión, así que debe contener sus comandos reales de build, tests y lint, además de un puñado de reglas firmes. Manténgalo en unas 200 líneas. El relleno del tipo "escribe código limpio" gasta espacio para nada, mientras que una línea concreta como "ejecuta pnpm test antes de decir que una tarea está terminada" sí cala.

Sin el archivo, tendrá que volver a explicar el proyecto en cada sesión. Con él, el modelo ya conoce los puntos de entrada y las convenciones.

Superpowers para trabajar con el plan primero

Desde dentro de Claude Code, ejecute:

/plugin install superpowers@claude-plugins-official

Si quiere recibir las actualizaciones antes, añada primero el marketplace del propio autor e instale desde allí:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Superpowers incluye skills para hacer lluvia de ideas, escribir un plan, desarrollar guiado por tests, depurar de forma sistemática y comprobar antes de cantar victoria. Las sesiones nuevas las cargan solas. En la práctica, rompe el hábito de «ponerse a programar sin más» que hay detrás de tantas funcionalidades a medio hacer.

Context7 para documentación al día

Los datos de entrenamiento nunca coinciden con la versión exacta de cada librería que usa. Context7 trae bajo demanda la documentación de la versión correcta. Una forma habitual de instalarlo:

claude mcp add - scope user context7 - npx -y @upstash/context7-mcp - api-key YOUR_KEY

Una clave gratuita de context7.com/dashboard le da límites de peticiones más amplios. Una vez instalado, basta con decirle a Claude "use context7" cuando importe la documentación de un paquete. Eso evita buena parte de las llamadas a la API inventadas, que de otro modo consumen tokens y tiempo.

Acceso a GitHub

Si su día gira en torno a issues y pull requests, instale el servidor MCP de GitHub o el plugin de GitHub de Anthropic. La sintaxis varía un poco según la versión del paquete, pero la forma es la misma: claude mcp add apuntando al servidor de GitHub, con un token que tenga los permisos necesarios.

Una vez conectado, Claude puede listar los PR abiertos, leer los hilos de los issues y redactar un pull request, todo sin cambiar de ventana. El plugin commit-commands del marketplace oficial combina bien con él para un flujo de git más ordenado.

Relaje los permisos con cuidado

Por defecto, Claude Code pregunta antes de cada edición y de cada comando de shell. El primer día es lo correcto. Tras unas cuantas sesiones sin sobresaltos, querrá relajar los casos rutinarios.

Busque el archivo de configuración, normalmente en ~/.claude o en la carpeta .claude del proyecto, y permita los comandos de bajo riesgo que ejecuta todo el día: el ejecutor de tests, el linter, git status y git diff. Todo lo que pueda borrar archivos o hacer un force-push debería quedarse en "ask" o "deny". Aprenda también pronto Shift+Tab, que va cambiando entre los modos de permisos en mitad de la sesión.

Plugin de revisión de código

También del marketplace oficial:

/plugin install code-review@claude-plugins-official

Ejecuta varios agentes de revisión en paralelo, que cubren seguridad, corrección, estilo y patrones históricos, y luego presenta los hallazgos con puntuaciones de confianza. Úselo antes de hacer merge. Llega más hondo que pedir una sola pasada de revisión en la conversación principal.

Plugin de diseño frontend

/plugin install frontend-design@claude-plugins-official

Tal cual viene, Claude construye interfaces que funcionan pero se ven genéricas. Este plugin empuja hacia una jerarquía tipográfica más clara, mejores espaciados y decisiones visuales que parecen intencionadas. Si trabaja solo en backend o infraestructura, puede saltárselo.

Plugins de servidores de lenguaje

Hay plugins para TypeScript, Python, Go, Rust y más. Instale los de los lenguajes que de verdad escribe. Le dan a Claude navegación por símbolos y conocimiento de los tipos dentro de la sesión, de modo que no se limita a hacer grep por los archivos.

Un CLAUDE.md personal

Los CLAUDE.md del proyecto se comparten con el equipo. El suyo personal está en ~/.claude/CLAUDE.md y se aplica a todos los proyectos. Úselo para las reglas que nunca cambian para usted, como su estilo preferido de mensajes de commit, cómo quiere que se escriba el manejo de errores y las herramientas a las que recurre primero. Manténgalo también breve, porque se carga en cada sesión.

Ahorrar tokens, más adelante

Las sesiones largas o muchos agentes en paralelo pueden pedir skills que compriman la comunicación o eliminen llamadas a herramientas innecesarias. Las skills de compresión al estilo «cavernícola» salen a menudo en los hilos sobre optimización de tokens. Espere hasta haber observado su propio consumo durante unos días y saber adónde va el gasto.

Un último paso de mantenimiento: ejecute una vez claude update y claude doctor para confirmar que el binario y el PATH están en orden.

En resumen

Solo con CLAUDE.md, Superpowers y Context7 ya cambia la calidad de la primera funcionalidad real que construya. Todo lo demás de la lista simplemente quita fricción a medida que crece el proyecto.