Claude Codeをオートコンプリートのように使うのはやめよう：リポジトリを認識したリファクタリングで得られる真の成果

r/ClaudeAIの開発者が重要な洞察を共有しています。Claude Codeは、機能全体を生成するためのオートコンプリートとして使うのをやめると、はるかに有用になります。真の利点は、既存のコードベースで段階的に作業するリポジトリ全体を考慮したリファクタリングアシスタントとして使用することにあります。

変わったこと

当初、そのユーザーはClaude Codeをワンショット生成（「この機能全体を作ってくれ」）に頼っていましたが、結果はまちまちでした。ブレークスルーは、実際のコードベース内で段階的かつ反復的な編集に移行したときに訪れました。

最大の成果

• アーキテクチャの追跡 — 馴染みのないコードベース全体で
• 乱雑なファイルの整理 — 大規模な関数の分割、依存関係の明確化
• 反復的な編集 — 長いセッションを通じて、ロジックを段階的に洗練
• 隠れた結合の発見 — 読んだだけでは明らかでなかったモジュール間の結合
• なぜ壊れているかの説明 — 単に修正するのではなく

重要なポイント

このツールは、既存のリポジトリを段階的に扱うときに真価を発揮します。「アプリ全体を作ってくれ」というワンショットのプロンプトには向いていません。Claude Codeでうまくいかないと感じたら、アプローチを変えてみてください。ゼロから生成するのではなく、理解してリファクタリングするために使いましょう。