Descripción del Proyecto

Configurar Claude Code para un nuevo proyecto solía tomar horas: copiar agentes, ajustar skills, configurar servidores MCP, definir permisos, configurar estándares, reemplazar placeholders. Cada proyecto terminaba ligeramente diferente porque siempre se olvidaba algo.

Claude Code Config automatiza todo esto. Ejecuta un comando, responde algunas preguntas, y obtén un entorno Claude Code completamente configurado en minutos. El CLI detecta tu stack, sugiere módulos relevantes, configura estándares, y maneja todo el trabajo tedioso de configuración.

Características Principales

Detección Inteligente de Stack

El CLI analiza tu proyecto y detecta automáticamente:

• Gestor de paquetes: pnpm, npm, yarn, bun
• Framework: React, Next.js, Astro, Hono, Express, NestJS, Fastify
• Base de datos: Drizzle, Prisma, Mongoose
• Testing: Vitest, Jest, Playwright

1
$ qazuor-claude-config init
2

3
Detectando configuración del proyecto...
4
  ✓ Gestor de paquetes: pnpm
5
  ✓ Framework: Hono (detectado desde dependencias)
6
  ✓ Base de datos: Drizzle (detectado desde scripts)
7
  ✓ Testing: Vitest (detectado desde devDependencies)
8

9
Bundles sugeridos basados en tu stack:
10
  ◉ stack-hono-drizzle
11
  ◉ testing-complete

Arquitectura Modular

Más de 100 módulos organizados en 5 categorías:

Instala solo lo que necesitas. Cada módulo es independiente pero puede combinarse mediante bundles.

23 Bundles Preconfigurados

Bundles específicos por stack que instalan módulos relacionados juntos:

1
# Bundles de stack
2
stack-react-tanstack    # React + TanStack Query/Router
3
stack-astro-react       # Astro + React Islands
4
stack-hono-drizzle      # Hono + Drizzle ORM
5
stack-nextjs-prisma     # Next.js + Prisma
6
stack-express-prisma    # Express + Prisma
7

8
# Bundles por categoría
9
testing-complete        # Suite completa de testing
10
testing-minimal         # Herramientas esenciales de testing
11
quality-complete        # Todos los comandos de calidad
12
database-drizzle        # Ingeniero + skills de Drizzle
13
database-prisma         # Ingeniero + skills de Prisma

27 Servidores MCP Verificados

Integraciones preconfiguradas para herramientas externas:

• Documentación y Búsqueda: Context7, Brave Search, Perplexity
• Bases de datos: PostgreSQL, Neon, MySQL, Redis, Supabase
• Control de versiones: GitHub, GitLab, Git
• Despliegue: Vercel, Cloudflare, Docker, AWS
• Testing: Playwright, Chrome DevTools
• Comunicación: Slack, Linear, Notion
• Pagos: Stripe, Mercado Pago
• Diseño: Figma, Shadcn UI, Magic UI

1
? ¿Qué servidores MCP quieres configurar?
2
  ◉ github (Sugerido: detectado remote de GitHub)
3
  ◉ postgres (Sugerido: detectada dependencia de base de datos)
4
  ◯ vercel
5
  ◯ stripe

Asistente de Estándares de Proyecto

Configura estándares a nivel de proyecto en 6 categorías con 5 presets (strict, balanced, relaxed, startup, enterprise):

Estándares de Código - Estilo de indentación, comillas, punto y coma, longitud de línea, reglas TypeScript, requisitos de JSDoc

Estándares de Testing - Objetivos de cobertura (60-95%), requisitos de TDD, patrones de test, preferencias de ubicación de archivos

Estándares de Documentación - Niveles de JSDoc, requisitos de ejemplos, formatos de changelog, políticas de comentarios

Estándares de Diseño - Framework CSS, librería de componentes, nivel de accesibilidad (A/AA/AAA), soporte de modo oscuro

Estándares de Seguridad - Patrón de autenticación, validación de entrada, protección CSRF, rate limiting

Estándares de Rendimiento - Objetivos de Core Web Vitals (LCP, FID, CLS), límites de tamaño de bundle y tiempo de respuesta de API

Configuración de Hooks Pre-commit

Hooks de Git configurables via Husky con tres presets:

• Minimal: Solo lint
• Standard: Lint + typecheck
• Strict: Lint + typecheck + tests

Soporta Biome o ESLint, verificación de TypeScript, ejecución de tests en archivos staged, y comandos de validación personalizados.

Personalización del Estilo de Respuesta

Personaliza cómo se comunica Claude:

• Tono: Amigable, profesional, formal, estricto, mentor
• Verbosidad: Conciso, balanceado, detallado
• Idioma: Inglés, español, o auto-detectar
• Reporte de errores: Comprensivo, neutral, o directo
• Proactividad: Nivel de sugerencias no solicitadas

Cuatro presets disponibles: friendly, professional, strict, mentor.

Control Granular de Permisos

Tres presets de permisos con opciones de personalización:

• Default: Balance entre seguridad y productividad
• Trust: Operaciones completas excepto git push
• Restrictive: Solo lectura para codebases sensibles

1
{
2
  "allow": ["Read", "Edit", "Write", "Bash(pnpm run *)", "Bash(git status)"],
3
  "deny": ["Bash(rm -rf *)", "Bash(git push --force)"]
4
}

Reemplazo Automático de Placeholders

Las plantillas incluyen placeholders como {{PROJECT_NAME}}, {{GITHUB_ORG}}, {{DOMAIN}}. El CLI:

1. Detecta valores desde package.json y git
2. Solicita valores faltantes
3. Reemplaza en todos los archivos automáticamente
4. Guarda preferencias en ~/.claude/defaults.json para reutilizar

1
Escaneando archivos en busca de placeholders...
2
  .claude/CLAUDE.md - 12 reemplazos
3
  .claude/agents/tech-lead.md - 3 reemplazos
4
  .claude/commands/commit.md - 2 reemplazos
5

6
✓ 47 archivos actualizados con 156 reemplazos

Herramientas de Estilo de Código

Configuración integrada para consistencia en el desarrollo:

• EditorConfig: Reglas agnósticas del editor (indentación, fin de línea)
• Biome: Linting y formateo rápido
• Prettier: Formateo de código opinionado
• Commitlint: Validación de commits convencionales

Comandos

init

Asistente de configuración completo para nuevos proyectos:

1
qazuor-claude-config init [path]

Opciones: --bundle, --template, --dry-run, --force

list

Muestra módulos, bundles o servidores MCP disponibles:

1
qazuor-claude-config list agents
2
qazuor-claude-config list skills
3
qazuor-claude-config list bundles
4
qazuor-claude-config list mcp

add / remove

Gestiona módulos individuales:

1
qazuor-claude-config add agent tech-lead
2
qazuor-claude-config add skill api-testing
3
qazuor-claude-config remove command review-code

configure

Reconfigura placeholders de plantillas:

1
qazuor-claude-config configure [--scan] [--preview] [--category <name>]

standards

Configura estándares del proyecto:

1
qazuor-claude-config standards [--preset <name>] [--category <name>]

status

Muestra el estado actual de la configuración:

1
qazuor-claude-config status [--verbose] [--json]

update

Actualiza configuración y módulos:

1
qazuor-claude-config update [--modules] [--config]

Generadores Adicionales

Además de módulos, el CLI puede generar:

• CLAUDE.md: Archivo de instrucciones dinámico del proyecto
• Estilo de Código: EditorConfig, Biome, Prettier, Commitlint
• Git Hooks: Husky con commit-msg y pre-commit
• CI/CD: Workflows de GitHub Actions
• VSCode: Configuraciones y recomendaciones de extensiones

Detalles Técnicos

Requisitos

• Node.js 18.0+
• pnpm, npm, yarn, o bun
• Git (opcional pero recomendado)

Instalación

1
# Instalación global (recomendada)
2
pnpm add -g @qazuor/claude-code-config
3

4
# O ejecutar directamente sin instalación
5
npx @qazuor/claude-code-config init

Stack

• Runtime: Node.js con ESM
• Lenguaje: TypeScript 5.7+ (modo estricto)
• Framework CLI: Commander.js
• Prompts: Inquirer.js
• Estilos: chalk, ora, figlet
• Testing: Vitest con memfs

API Programática

Disponible como paquete npm para aplicaciones Node.js, proporcionando funciones para:

• Leer/escribir configuración
• Cargar registro de módulos
• Detectar tipos de proyecto
• Procesar plantillas
• Resolver bundles
• Gestionar placeholders

Tipos de TypeScript incluidos para toda la funcionalidad.

Estado

Desarrollo activo con nuevas características añadidas regularmente. Estable para uso en producción.

Por Qué Construí Esto

Cada nuevo proyecto significaba horas de configuración repetitiva. Copiar agentes de otro proyecto, ajustar configuraciones, configurar servidores MCP, reemplazar placeholders manualmente. Cada proyecto terminaba ligeramente diferente.

Esta herramienta resuelve eso: configuración consistente y automatizada en minutos en lugar de horas. Es opinionada (TypeScript, TDD, arquitectura en capas) pero lo suficientemente modular para adaptarse a diferentes stacks.

El objetivo es dedicar tiempo a resolver problemas, no a configurar herramientas.