Claude CodeのRefactorについてお探しですね。
広告
仕様書もテストもないレガシーコードを、Claude Codeで丸ごと解析してみた
仕様書もなければテストコードもない。
書いた本人はもう会社にいない。
そんな「レガシーコード」の保守を任されたとき、エンジニアは本当に絶望します。
変数を1つ変えただけでどこが壊れるかわからない恐怖。
スパゲッティみたいに絡まったコードを目で追いかける地獄の時間。
正直、生産的とは言えませんよね。
でも、最新のAIツール「Claude Code」を使えば、この苦行が劇的に楽になります。
この記事では、単なるコード生成じゃなくて、あなたのパソコンの中のファイルを直接いじれるClaude Codeを使って、コードの解析からリファクタリングまでを効率的に「丸投げ」する方法を紹介します。
なぜClaude Codeがレガシーコード解析に最強なのか
ChatGPTやGeminiじゃなくて、なんで「Claude Code」なの？って思いますよね。
一番の理由は、Claude Codeがターミナル（コマンドライン）で動いて、あなたのパソコンの中にあるファイルやプロジェクト全体を直接読み込めるからなんです。
普通のWeb版AIだと、コードをコピペして「これ何？」って聞く必要がありますよね。
でも数万行もあるレガシーシステムだと、ファイル同士のつながりや全体像を伝えるだけでも一苦労。
Claude Codeはその壁を取っ払って、プロジェクトフォルダ全体を理解した上で、まるで隣に詳しい先輩が座ってるみたいにコードを読み解いてくれます。
しかもClaude 3.5 SonnetやOpusっていう高性能なAIモデルを使ってるので、単にコードを説明するだけじゃなくて、「このコードは何を意図してるのか」とか「なんでこんな処理が必要なのか」まで推測してくれるんです。
レガシーコードって、意味不明な変数名とか、謎の条件分岐だらけじゃないですか。
そういうのに「なんでここでこんな処理してるの？」って聞くと、前後の文脈や呼び出し元を自分で探してきて、ちゃんと理屈の通った答えを出してくれます。
24時間文句も言わずに巨大な迷路を探検してくれる優秀なナビゲーターを手に入れた感じです。
ドキュメントがない現場では、この「探索能力」が本当に助かります。
さらにすごいのが、Claude Codeは解析するだけじゃなくて、実際にファイルを編集したりコマンドを実行したりもできること。
「コードを読んで理解する」から「安全に書き換える」まで、会話の流れでスムーズに進められます。
見つけたバグをその場で修正案として出してもらって、OKすればすぐにファイルが更新される。
この体験は、今までの開発の常識を変えるレベルです。
解析を丸投げするための最初の準備とコツ
Claude Codeを使って解析を「丸投げ」するには、まずAIにプロジェクトの全体像をつかんでもらう「地図作り」が大事です。
ターミナルでClaude Codeを起動して、対象のプロジェクトフォルダに移動したら、いきなり細かい関数の説明を聞くんじゃなくて、まずは全体の構造を教えてもらいましょう。
たとえば、「このプロジェクトのフォルダ構成を分析して、各モジュールがどんな役割を持ってるか、アーキテクチャの概要を説明して」って聞いてみてください。
そうすると、Claude Codeがファイルを見て回って、メインのプログラムはどれか、データベースの設定はどこにあるか、便利な関数群はどこに置いてあるか、みたいなことを人間にわかりやすい言葉で説明してくれます。
全体像が見えてきたら、次は具体的に直したい機能とか、よくわからない処理の深掘りをお願いします。
ここで大事なのは、「わからないことは全部聞く」っていう姿勢です。
「`ProcessUserData.pl` の中にある `calc_x` って関数、何を計算してるの？関連する定数も含めて教えて」って指示すれば、Claude Codeはそのファイルだけじゃなくて、読み込んでる別のファイルとか、継承元のクラスまで遡って調べてくれます。
人間がエディタで「定義へジャンプ」を何回もクリックして頭の中でパズルを組み立てる作業を、AIが一瞬でやってくれるわけです。
この段階で丸投げすることで、頭のメモリを節約して、ビジネスロジックの理解だけに集中できるようになります。
さらに精度を上げたいなら、「コードの品質チェック」もAIに頼んでみましょう。
「このファイルの中で、読みにくくてバグの原因になりそうなところをリストアップして、理由も教えて」って聞けば、どこから手をつけるべきかの優先順位がつけられます。
AIは遠慮なく、「if文のネストが深すぎ」とか「マジックナンバー使いすぎ」とか「変数名がバラバラ」とか指摘してくれます。
こうやって、仕様を理解するだけじゃなくて、次のリファクタリングに向けた「作戦会議」の相手としてClaude Codeを使うことで、解析の質がぐっと上がります。
安全にリファクタリングを進めるテスト自動生成のやり方
レガシーコードをいじるとき、一番怖いのは「動いてるものを壊しちゃう」ことですよね。
このリスクを減らすために、Claude Codeにまずテストコードを作ってもらいましょう。
仕様書がないレガシーコードでは、今の動きこそが「正解（仕様）」です。
だから、「今の `BillingService` クラスの動きを保証するためのテストを作って。
変なパターンも考慮して」って指示して、既存のロジックがちゃんと動いてることを確認するテストをAIに書かせます。
テスト環境がなくても、Claude Codeがその言語やフレームワークに合わせた環境の作り方まで提案してくれるので、まずは「守りの準備」から始められます。
テストで安全網ができたら、いよいよリファクタリングの本番です。
ここでも一気に全部書き換えさせるんじゃなくて、小さい単位で会話しながら進めるのがコツです。
「このメソッド長すぎて読みにくいから、機能ごとに分けて。
でも外から見た動きは絶対変えないで」って具体的に指示します。
Claude Codeが出した修正案に対して、さっき作ったテストを実行して、全部パスすることを確認してから変更を確定させます。
もしテストが失敗したら、そのエラーメッセージをそのままClaude Codeに貼り付けて、「テストが落ちた原因を調べて直して」って投げ返せばOK。
AIがすぐにデバッグして、修正版を出してくれます。
あと、リファクタリングと一緒にコメント（説明文）も書いてもらうのも大事です。
「リファクタリングしたコードの各部分に、何をしてるか、なんでこの処理が必要かを日本語でコメントして。
将来の担当者が読みやすいように」って頼めば、今までブラックボックスだったコードが、ちゃんと説明付きのきれいなコードに生まれ変わります。
Claude Codeを使うことで、コードをきれいにするだけじゃなくて、そのコードが持ってる「知識」を言葉にして、チーム全体の財産として残せるんです。
これって、リファクタリング作業の価値を何倍にもする行為なんですよね。
AIに丸投げするときの注意点とエンジニアの役割
Claude Codeは強力なツールですが、AI特有の「それっぽい嘘」のリスクは常にあります。
特にレガシーコードみたいな、普通のやり方から外れた独自設計のシステムだと、AIが一般常識に基づいて間違った解釈をすることがあるんです。
だから、AIが出した説明や修正コードを鵜呑みにせず、最後は必ず人間の目でチェックすることが大切です。
AIに丸投げするのは「調査・生成・提案」まで。
「最終判断・責任」はエンジニアが持つっていう線引きをはっきりさせておきましょう。
特に、お金の計算とかセキュリティに関わる重要な処理については、AIの提案をベースにしつつも、しっかり自分の目で確認してください。
セキュリティ面でも注意が必要です。
Claude Codeはあなたのパソコンで動くツールですが、解析のためにコードの一部をAIのサーバーに送信します。
会社で使う場合は、社内のセキュリティルールに違反しないか事前に確認しましょう。
機密情報や個人情報がコードに直接書かれてないか、AIに読ませちゃいけないファイルがないかをチェックしてください。
多くのAIコーディングツールには、特定のファイルやフォルダを送信対象から外す設定があるので、これをうまく使えばリスクをコントロールしながら便利に使えます。
最後に、エンジニア自身の考え方も変える必要があります。
今までは「自分でコードを書いて解決する」のがエンジニアの仕事でしたが、これからは「AIという優秀な部下を指示して問題を解決する」能力が求められます。
Claude Codeへの指示の出し方（プロンプトエンジニアリング）のスキルを磨くことは、レガシーコードとの戦いを終わらせるだけじゃなくて、将来どんな技術が出てきても対応できる普遍的なスキルの獲得につながります。
AIを怖がらず、でも過信もせず、良い相棒として使いこなすことで、エンジニアライフはもっと創造的で楽しくなるはずです。
広告
