Claude Codeでリファクタリングを自動化する方法

Claude Codeを使うと、重複コードの整理、関数分割、命名改善、責務分離、型定義の見直し、テスト追加、Git差分レビューまでを効率化できます。この記事では、リファクタリングを安全に自動化するための進め方、プロンプト例、CLAUDE.mdの書き方、Hooks、GitHub Actions、チーム運用の注意点まで実務向けにまとめます。

Claude Codeとは

Claude Codeは、コードベースを読み取り、ファイル編集やコマンド実行ができるAI開発支援ツールです。リファクタリングでは、構造改善や可読性向上の作業に強みがあります。

リファクタリング自動化で大事な考え方

この作業はリファクタリングです。
外部仕様、画面表示、APIレスポンス、DB構造は変更しないでください。
動作を変えずに内部構造のみ改善してください。

対象範囲を限定する

src/components/UserProfile.tsxのみを対象にリファクタリングしてください。
まず改善方針だけを出してください。
まだコードは変更しないでください。

問題点の洗い出し

以下のファイルを確認し、リファクタリングすべき点を洗い出してください。
まだコードは変更しないでください。

確認項目
重複処理
長い関数
責務の多さ
命名の問題
テストしにくい構造

リファクタリング方針の比較

リファクタリング案を3つ提示してください。

比較項目
改善内容
メリット
デメリット
影響範囲
修正量

テスト確認

この処理に関連するテストを確認してください。
不足している場合は追加案を出してください。

小さく分けて実行する

UserProfileの条件分岐のみ整理してください。
表示内容は変更しないでください。
変更はこのファイルだけに限定してください。

命名改善

変数名と関数名を確認し、改善候補を出してください。
外部に影響する名前は変更しないでください。

重複コード整理

重複している処理を探してください。
共通化すべきかも判断してください。

関数分割

この関数を役割ごとに分割してください。
戻り値は変更しないでください。

条件分岐整理

条件分岐を整理してください。
ネストを浅くし、可読性を向上させてください。

型定義整理

型定義を確認してください。
anyを減らし、型の役割を明確にしてください。

CLAUDE.mdルール

リファクタリング時のルール

外部仕様を変更しない
変更範囲は最小限
無関係な修正をしない
テストを確認する

Hooksで自動チェック

リファクタリング後に以下を実行する

npm run lint
npm run test
npm run typecheck

Git差分確認

git diffで変更を確認する

確認項目
仕様変更がないか
不要な変更がないか
影響範囲が広すぎないか

避けるべき依頼

全体をきれいにしてください
いい感じに直してください

このような曖昧な依頼は避ける

安全な依頼例

src/services/orderService.tsを対象にしてください。
目的は金額計算ロジックの整理です。
仕様は変更しないでください。
まず方針だけ出してください。

自動化しやすい作業

関数分割
重複削除
命名改善
条件整理
型整理

危険なリファクタリング

決済処理
認証処理
DB構造変更
API変更

チーム運用ルール

リファクタリングと機能追加は分ける
差分は小さくする
AIの変更は必ず確認する

チェックリスト

仕様が変わっていないか
テストは通るか
差分は最小か
影響範囲は適切か

まとめ

Claude Codeを使うことでリファクタリングの効率は大きく上がります。ただし、安全に進めるには、範囲を限定し、小さく実行し、必ず差分確認とテストを行うことが重要です。AIに任せるのではなく、補助として使うことで安定した改善が可能になります。