Claude Code でリファクタリング｜レガシーコードを安全に改善する方法

Claude Codeを使えば、デグレードリスクを抑えながらレガシーコードを段階的・安全にリファクタリングできます。

要点1: Plan Modeでコードに触れる前に分析・計画を実施し、デグレードリスクを最小化
要点2: 1プロンプト1懸念事項の「インクリメンタルアプローチ」で安全に進める
要点3: Moderne社事例では9,000リポジトリへの適用を20分で実現、生産性55〜80%向上の実績

対象: レガシーコードの改善を検討している開発チームのリーダー・DX推進担当者

今日やること: 最も保守コストがかかっている関数を1つ選び、Claude Code Plan Modeで分析プロンプトを実行する

この記事の目次

リファクタリングとは？企業が抱える「技術的負債」の問題
Claude Code がリファクタリングに強い理由
リファクタリング前の準備：4つのステップ
Plan Modeで安全に設計する（Claude Code 実践）
段階的リファクタリングの実行手順
リファクタリング後のレビューと品質確認
よくある質問
まとめ

Claude Codeを使えば、デグレードリスクを抑えながらレガシーコードを段階的・安全にリファクタリングすることが可能です。

「古いコードに手を加えると壊れそうで怖い」「リファクタリングしたいが工数が見えない」——こうした悩みは、多くの開発チームや技術管理職の方が抱えています。特にレガシーコードは、ドキュメントが少なく依存関係が複雑なため、人手だけでの改善には限界があります。

この記事では、Claude Codeを活用したリファクタリングの実践手順を解説します。Plan Modeによる安全な設計確認から、段階的な改善の進め方、実際に使えるプロンプト例まで、明日から現場で使える内容を具体的に説明します。

リファクタリングとは？企業が抱える「技術的負債」の問題

リファクタリングとは、プログラムの外部的な動作を変えずに、内部のコード構造を整理・改善する作業のことです。機能追加やバグ修正ではなく、コードの可読性・保守性・拡張性を高めることを目的とします。

コード品質の低下が引き起こす具体的な問題

技術的負債とは、過去の開発で積み重なったコードの問題が、現在の開発を遅らせるコストを指します。具体的には以下のような問題が生じます。

問題	影響
可読性の低下	新メンバーの習熟に時間がかかる。コードレビューに時間がかかる
バグが起きやすい	変更の影響範囲が見えにくく、修正のたびに新たな不具合が発生
開発速度の低下	機能追加のたびに古いコードへの対処が必要になる
テストの困難さ	依存関係が複雑でユニットテストが書けない

経済産業省が警告した「2025年の崖」では、レガシーシステムの刷新が進まない場合、最大年間12兆円の経済損失が生じると試算されています。日本企業にとって、技術的負債の解消は経営課題でもあります。

従来のリファクタリングが難しかった理由

従来のリファクタリングには以下のような課題がありました。

工数の見積もりが難しい: どこまで改善すれば良いか判断しにくい
デグレード（先祖がえり）のリスク: 既存の動作を壊すことを恐れ、手をつけられない
テストコードの不足: レガシーコードにはテストがないことが多く、変更の安全確認ができない
属人性: コードを書いた担当者しか全体像を把握していない

Claude Codeはこれらの課題を大きく緩和します。コードベース全体を読み込んで依存関係を把握し、段階的かつ安全な改善計画を立てることができます。

Claude Code がリファクタリングに強い理由

Claude Codeは単なるコード補完ツールではなく、プロジェクト全体を理解してタスクを自律的に実行するAIコーディングエージェントです。リファクタリングにおいて特に力を発揮する理由を説明します。

従来のAIツールとの違い

機能	従来のAI補完ツール	Claude Code
コードの理解範囲	カーソル周辺の数十行	プロジェクト全体（数万行）を把握
変更の範囲	単一ファイル・関数	複数ファイルにまたがる変更が可能
計画機能	なし	Plan Modeで変更前に分析・計画
インタラクティブ性	補完のみ	対話的に要件を調整しながら実行

複数ファイルにまたがる関数の抽出や、重複ロジックの一括共通化など、人手では時間のかかる作業を一度の指示で完了できます。

企業事例：Moderne社が9,000リポジトリを20分で処理

カナダのソフトウェア企業Moderne社は、Claude Codeを活用したリファクタリングで注目の成果を上げています。同社は自動コードリファクタリングツールとClaude Codeを組み合わせることで、20分以内に9,000のソースコードリポジトリにカスタムリファクタリングレシピを適用して検証することに成功しました。

また、複数の導入事例では以下の成果が報告されています。

生産性向上: AI活用のリファクタリングで生産性が55〜80%向上
処理時間短縮: あるeコマース企業では、重複ロジック排除後に検索クエリ処理時間が平均30%短縮
レビュー時間削減: 同企業でコードレビューに要する時間が40%削減
テスト通過率: リファクタリング後もテスト通過率100%を維持

これらの数値は、適切な手順でClaude Codeを活用すれば、安全かつ高速なリファクタリングが現実的であることを示しています。

リファクタリング前の準備：4つのステップ

Claude Codeを使ったリファクタリングは、準備が成功の8割を決めます。コードに変更を加える前に、以下の4つのステップを必ず実施してください。

ステップ1：コードベースの現状分析

まずClaude Codeにコードベース全体を分析させ、問題箇所を把握します。以下のプロンプトが有効です。

このプロジェクトのコードベースを分析して、以下を日本語で報告してください。1. リファクタリングが必要な主な問題点（重複コード、複雑な関数、技術的負債）2. 各問題の優先度（高・中・低）3. まず着手すべき箇所の具体的な理由変更は一切加えず、分析レポートのみ作成してください。

ステップ2：特性テスト（Characterization Test）の作成

リファクタリング前に、現在の動作を記録するテストを作成します。これが「安全ネット」になり、変更後の動作確認に使えます。

[対象ファイル名]の現在の動作を記録する特性テスト（Characterization Test）を作成してください。コードの動作を変えることなく、現状の入出力パターンをテストコードに落としてください。

ポイントレガシーコードにテストがない場合でも、Claude Codeが既存の動作パターンを読み取り、テストコードを自動生成します。これにより、リファクタリング後の「動作が壊れていないか」を確認できます。

ステップ3：リファクタリング目標の明確化

「なんとなくきれいにする」ではなく、具体的な目標を設定します。例：

「1関数の行数を50行以内に抑える」
「重複コードを3箇所から1箇所に集約する」
「TypeScriptの型定義を追加して型安全にする」

目標が明確なほど、Claude Codeへの指示も具体的になり、成果物の品質が上がります。

ステップ4：安全なブランチの用意

必ずGitでブランチを切り、元のコードを保護します。Claude Codeはブランチ管理も指示できます。

git checkout -b refactor/legacy-cleanup

リファクタリングは必ずフィーチャーブランチで行い、問題があれば即座にロールバックできる体制を整えてください。

Claude Codeの導入や活用方法について、個別にご相談いただけます。「どの機能から使えばいいか」「自社業務への適用方法を知りたい」といった段階から対応しています。

Claude Code個別指導の無料相談はこちら →

Plan Modeで安全に設計する（Claude Code 実践）

Claude Codeの「Plan Mode」は、コードに変更を加えずに分析・計画フェーズだけを実行できる機能です。大規模なリファクタリングや、影響範囲が読みにくいコード変更を行う前に必ず活用してください。

Plan Modeの起動方法と使い方

Plan Modeはターミナル上で Claude Code を起動後、Shift + Tab で切り替えられます（または設定から有効化）。Plan Modeでは、Claude Codeはファイルの読み取りと計画の提示のみを行い、ファイルへの書き込みは行いません。

効果的な分析プロンプトの例

以下は、Plan Modeで実際に使えるプロンプト例です。

【Plan Modeで実行】src/utils/dataProcessor.jsのリファクタリング計画を作成してください。分析してほしい点：1. 現在の問題点（重複コード、長い関数、複雑な条件分岐）2. 変更による影響範囲（どのファイルが影響を受けるか）3. 段階的な実行計画（何を先に、何を後に変更するか）4. 各フェーズで確認すべきテストポイント変更は加えず、計画書のみを作成してください。

Claude Codeは計画書を出力した後、内容を確認してから実際の変更実行に移ります。これにより「気づいたら大量のファイルが変更されていた」という事態を防げます。

実務での活用ポイント計画書の内容に不満があれば、修正指示を出してから実行に移れます。「ステップ3は後回しにして、ステップ1と2だけ先に実行して」といった柔軟な調整が可能です。

段階的リファクタリングの実行手順

リファクタリングは「1プロンプト、1つの改善」が鉄則です。一度に大量の変更を依頼すると、影響範囲の把握が難しくなり、問題が起きたときの原因特定も困難になります。

重複コードの排除（プロンプト例付き）

最も効果が見えやすく、かつ安全なリファクタリングの入口です。

src/components/以下のファイルで重複しているAPIフェッチロジックをshared/api.jsという共通モジュールに抽出してください。条件：- 既存の動作は変えない- 変更後にすべての既存テストが通過すること- 新しい共通モジュールにはJSDocコメントを追加すること

実行後、テストを走らせて動作確認してからコミットします。

関数の分割・責務の明確化（プロンプト例付き）

「1つの関数が複数の責務を担っている」場合の改善例です。

src/services/userService.jsのprocessUserData関数（150行）を単一責任の原則に従って分割してください。分割の指針：- 1関数は最大30行を目安に- 各関数の役割が関数名から明確に読み取れること- 既存のユニットテストを壊さないことまず分割案を提示してください。承認後に実装します。

最後の「まず案を提示して」という一文が重要です。変更前に内容を確認できる習慣をつけましょう。

型定義の追加とコードの近代化（プロンプト例付き）

JavaScriptからTypeScript化や、古いPromiseチェーンをasync/awaitへ置き換えるケースです。

src/utils/dataFetcher.jsをTypeScriptに移行してください。対応内容：1. ファイル拡張子を.tsに変更2. 関数の引数・返り値に型定義を追加3. PromiseチェーンをAsync/Awaitに置き換え4. 型エラーがないことをtscで確認段階的に実行し、各ステップでコミットしてください。

大規模リファクタリング：セッションを分割する方法

リファクタリング対象が大きい場合は、セッションを複数に分割します。Claude Codeでは /rename でセッションに名前をつけ、後から /resume で再開できます。

# セッション1: 認証モジュールの抽出/rename auth-module-extraction# セッション2: ルーティングの分離（次回）/rename routing-separation

セッションを小さく保つことで、コンテキストウィンドウが集中し、変更の品質が向上します。

リファクタリング後のレビューと品質確認

Claude Codeの出力は「ジュニア開発者のプルリクエスト」として扱ってください。有能ですが、必ずレビューが必要です。

コード品質の測定方法（Before/After）

リファクタリング前後で以下のメトリクスを記録します。

メトリクス	測定方法	目標の目安
循環的複雑度	ESLint（complexity）, SonarQube	関数あたり10以下
関数の行数	ESLint（max-lines-per-function）	30行以下
テストカバレッジ	Jest, pytest等	80%以上を維持
重複コード率	jscpd, SonarQube	5%以下

Claude Codeに「リファクタリング前後のメトリクスを比較してください」と指示すれば、定量的な改善効果をレポートとして出力できます。

デグレードを防ぐチェックポイント

テストを必ず実行: 変更後は必ずすべてのテストを走らせてください
差分確認: git diff で変更内容を目視確認してからコミットします
段階的コミット: まとめてコミットせず、1つの改善ごとにコミット履歴を残します
CI/CDとの連携: GitHub Actionsなどで自動テストを組み込むと、デグレードを自動検知できます

実務での活用ポイントClaude Codeはテストが通ったことを確認しながら進めることを前提に設計されています。「テストが通ったら次に進んで」という指示を習慣にすると、品質を保ちながらスピードを上げられます。

よくある質問

Q. Claude Code はプログラミング言語を選ばずリファクタリングできますか？

Python、JavaScript/TypeScript、Java、Ruby、Go など主要言語に広く対応しています。特にPythonとJavaScript/TypeScriptは対応品質が高く、型定義追加・モジュール分割・テスト生成まで一貫して対応できます。COBOLなど古い言語では、より詳細なコンテキストを提供することで対応精度が向上します。

Q. 大量のレガシーコードがある場合、どこから手をつければいいですか？

以下の優先順位で着手することをお勧めします。

変更頻度が高い箇所: 毎週触るコードは保守コストが最大。先に整理すると効果が大きい
バグが多い箇所: 問題の根源になっているコードを整理することで、障害対応コストを削減できる
新機能追加の妨げになっている箇所: 拡張性が低いコードは今後の開発を継続的に妨げる

Claude Codeに「このプロジェクトでリファクタリングの優先度が高い箇所はどこですか？理由と影響規模を教えてください」と尋ねると、優先度付きのリストを作成してくれます。

Q. リファクタリング中にバグが発生したらどうすればいいですか？

Gitブランチを利用しているため、git checkout main（または git revert）で元の状態に即座に戻せます。このため、「リファクタリング前に必ずGitコミットする」という習慣が最大の安全策です。Claude Codeでも「変更前に現状をコミットしてから進めてください」と明示的に指示すると、自動的にコミットを挿入しながら進めてくれます。

Q. 非エンジニアでも Claude Code でリファクタリングできますか？

プログラミングの基礎知識があれば、詳細なコードを書けなくても Claude Code を使ったリファクタリングは可能です。ただし、リファクタリングは既存のコードを変更する作業のため、「何が変わったか」「テストが通っているか」を確認する最低限の理解は必要です。完全な非エンジニアの方は、技術的なパートナーと協力して進めることをお勧めします。