Next.js build падает из-за TypeScript ошибок — как дебажить с AI?

TypeScript ошибки при сборке — частая проблема. Claude Code пишет код который работает в dev-режиме, но strict-проверки при build ловят больше ошибок.

Шаг 1: Запусти /typecheck

Команда /typecheck запускает полную проверку типов через tsc --noEmit. Это быстрее чем next build и показывает все ошибки сразу.

Шаг 2: Включи typescript-lsp плагин

Плагин typescript-lsp даёт Claude Code доступ к диагностике TypeScript в реальном времени. Ошибки типов видны сразу при написании, а не только при сборке.

Типичные ошибки

• `any` типы — Claude часто использует as any для быстрого решения. Замени на конкретные интерфейсы
• Missing props — компонент ожидает обязательные пропсы которые не переданы
• Async params в Next.js 15 — params теперь Promise<{}>, нужен await params
• null/undefined — забыли проверку на null перед обращением к свойству

Автоматизация

Добавь hook PreToolUse → Bash → build который запускает tsc --noEmit перед каждой сборкой. Или настрой CI/CD чтобы TypeScript проверялся при каждом push.

Правило: если next build падает — это не «баг TypeScript», это баг в твоём коде. Типы не врут.