【結論】解決策 / 実行コマンド
Claude CodeはJavaScriptとTypeScriptの開発に強力ですが、Node.jsベースだから自動的に最も得意という断定は避けます。
リポジトリで指定されたnpm、pnpm、Yarn、BunとLockfileを優先し、依存関係を勝手に更新させないことが重要です。
型エラーやLintを一括修正する前に、対象ディレクトリと変更上限を設定します。
# ターミナルで実行：パッケージ管理と状態を確認
ls package-lock.json pnpm-lock.yaml yarn.lock bun.lockb 2>/dev/null
# ターミナルで実行：型チェックとテストを確認
npm run typecheck && npm test
# ターミナルで実行：Planモードで起動
claude --permission-mode plan具体的な手順・設定方法
package.json、Lockfile、tsconfig、ESLint設定、テスト設定を確認します。
一つのエラー群または一つのディレクトリに対象を絞ります。
変更後は型チェック、Lint、関連テスト、ビルドを順番に確認します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
src/api内のTypeScriptエラーだけを修正してください。
依存関係、Lockfile、公開APIは変更しないでください。
any型への置換は禁止し、最大5ファイルまでに限定してください。
最初に計画を提示し、承認後に修正してtypecheckを実行してください。注意点・よくあるエラーと対処法
Promiseをすべてasync/awaitへ機械的に変えると、並列性やエラー処理が変わる場合があります。
Lockfileの大幅変更やメジャーバージョン更新は別タスクにしてください。
生成物や依存ディレクトリを変更対象にしないでください。