※ChatGPTを使用して記事を作成しています。
ここまでの記事では、Claude Codeを使った
- 基本的な使い方
- プロンプト設計
- コード生成
について解説してきました。
そして実務で使い始めると、次に見えてくるのがこの領域です。
「既存コードの改善に使えないか？」
実際、Claude Codeは “新しく作る” ことだけでなく、
「既にあるコードを改善する」
ことにも強みがあります。
この記事では、
- リファクタリング
- コードレビュー
- 設計改善
にClaude Codeをどう活用できるのかを解説します。
リファクタリングは「どこを直すべきか」が難しい
まず前提として、リファクタリングで難しいのは「書き直すこと」ではありません。
本当に難しいのは、
- 何が問題なのか
- どこに違和感があるのか
- なぜ読みにくいのか
を言語化することです。
例えば、
- Composableが長すぎる
- ViewModelの責務が重い
- Repositoryが何でもやっている
こうした違和感は感じても、明確に説明するのは意外と難しいです。
Claude Codeは、この“言語化”を補助してくれます。
Claude Codeは「改善観点」を出すのが得意
例えば、以下のようなコードがあるとします。
fun loadUser() {
isLoading = true
api.getUser(
onSuccess = {
name = it.name
age = it.age
address = it.address
isLoading = false
},
onError = {
errorMessage = it.message
isLoading = false
}
)
}動作自体には問題がなくても、
- 状態更新が分散している
- UI状態管理が曖昧
- エラーハンドリングが肥大化しそう
といった改善ポイントがあります。
Claude Codeに対して、
このコードの改善点を、
可読性・保守性・責務分離の観点でレビューしてください。のように依頼することで、改善の方向性を整理できます。
「どこを見てほしいか」を指定する
ここはかなり重要です。
単に、
リファクタリングしてくださいだけでは、期待する結果になりにくいです。
例えば、
- 可読性を改善したい
- テストしやすくしたい
- Composeらしくしたい
- 責務を分離したい
など、
「何を重視するか」
を伝えることで、回答の質が大きく変わります。
実務で使いやすいレビュー依頼の例
例えば、以下のような依頼は実務で使いやすいです。
可読性レビュー
このコードを可読性の観点でレビューしてください。
命名・責務・関数分割に問題がないか確認したいです。Composeレビュー
Jetpack Composeらしい実装になっているかレビューしてください。
特に：
- state hoisting
- Composableの責務
- 再利用性
を確認してください。ViewModelレビュー
ViewModelの責務が適切か確認してください。
UIロジックとビジネスロジックが混在していないか見てほしいです。
「違和感の正体」を探る使い方が強い
実務では、
「なんか微妙」
という状態がよくあります。
しかし、その違和感を自力で整理するのは難しいです。
例えば：
- なぜ読みにくいのか
- なぜ修正しづらいのか
- なぜ責務が曖昧に感じるのか
Claude Codeは、こうした“モヤモヤ”を整理するのが得意です。
そのため、
このコードに違和感があります。
設計上の問題点を整理してください。という相談もかなり有効です。
リファクタリングで気をつけるべきこと
便利だからこそ、注意点もあります。
① 「綺麗なコード」が正解とは限らない
Claude Codeは、理想的な構造を提案してくることがあります。
しかし実務では、
- チーム文化
- 既存設計
- 保守コスト
も重要です。
そのため、
「理論上正しい」より「現場で維持できる」
ことを優先する必要があります。
② 分割しすぎ問題
AIは責務分離を強く提案する傾向があります。
結果として、
- ファイルが増えすぎる
- 追跡しづらくなる
- 学習コストが上がる
ケースがあります。
これは特にComposeで起こりやすいです。
③ “なぜそうしたか”を理解する
提案を採用する場合は、
- なぜ改善なのか
- 何が問題だったのか
を理解することが重要です。
ここを飛ばすと、設計力が身につきません。
Claude Codeは「第二のレビュアー」として強い
実務で特に有効なのは、レビューの補助です。
例えば：
- PR前のセルフレビュー
- 命名の違和感確認
- 責務分離チェック
- 可読性確認
などに使えます。
特に一人開発では、
「別視点を得られる」
価値が非常に大きいです。
まとめ
Claude Codeは、コード生成だけでなく、
- リファクタリング
- 設計改善
- コードレビュー
にも強みがあります。
特に価値が高いのは、
「違和感を言語化できること」
です。
そして重要なのは、
- 何を改善したいのか
- どの観点で見てほしいのか
を明確にすることです。
