CLIツール「Claude Code」は新規アプリ開発用途で注目されがちですが、実務ではむしろ 既存プロジェクトの理解・調査・テスト補助 に強みがあります。
ただし万能ではありません。コンテキスト制限・静的解析の限界・誤修正リスク・API課金などを理解した上で使うことが重要です。
1. レガシーコードから“ユーザーストーリー候補”を抽出する
ドキュメントがない案件や途中アサイン案件では、まず「このシステムは何を解決しているのか」を把握する必要があります。
Claude Codeはディレクトリ構造やルーティング、API定義を横断的に分析し、機能単位で整理することが可能です。
プロンプト例
リポジトリ全体を解析対象にし、以下を整理してください。
1. 主要なエンドポイント
2. 各エンドポイントの責務
3. フロントエンドとの接続箇所
4. 推測できるユーザーストーリー（3〜5個）
※ 推測であることを明示してください
注意点
- 巨大リポジトリでは分割解析が必要
- 動的挙動は完全には把握できない
- あくまで仮説生成ツールとして使う
2. 認証や決済など重要フローのトレース
設定ファイル（docker-compose.yml、環境変数、ミドルウェア）とロジックを横断的に追わせることで仕様理解を高速化できます。
プロンプト例
ユーザー認証フローを解析してください。
対象:
- src/auth ディレクトリ
- 認証関連ミドルウェア
- 環境変数参照箇所
以下を出力:
1. リクエスト受信からレスポンスまでのシーケンス説明
2. JWT発行・検証箇所
3. 例外処理パターン
注意点
- .envのシークレットは必ずマスクする
- 実行ログと併用して検証する
- DBスキーマを参照させないと精度が落ちる
3. テストコード生成＋実行ループ
既存ロジックに対してテストを生成し、実行 → 失敗 → 修正まで回すことも可能です。
プロンプト例
src/services/payment.ts の processTransaction に対する
Jest単体テストを作成してください。
条件:
- 正常系
- APIタイムアウト時
- 不正入力値
- 外部APIが500を返した場合
現実的な注意点
- モック設計は必ず人間がレビューする
- テストを通すためだけの修正を行う場合がある
- 無限修正ループになることがある
CIへ反映する前に必ず差分レビューを行いましょう。
実践パターン
A. ビルドエラー解析
npm run build 実行時のエラーです。
スタックトレースを含めて解析し、
原因特定と修正パッチ案を提示してください。
- スタックトレースは必須
- 型エラーは波及影響に注意
B. React再レンダリング改善
src/components 配下をレビューし、
不要な再レンダリングが発生している
可能性のある箇所を指摘してください。
- 静的解析では実レンダリング回数は分からない
- React DevToolsと併用する
C. README生成
以下を参照対象にすると精度が向上します：
- package.json
- Dockerfile
- docker-compose.yml
- tsconfig.json
重要な注意事項
1. コンテキスト制限
巨大リポジトリは分割して解析する必要があります。
2. 動的挙動の限界
実行時の挙動はログや動作確認と併用する必要があります。
3. セキュリティ管理
.envやAPIキー、秘密鍵は必ずマスクしてから解析させてください。
4. API課金に注意
Claude CodeはAPIを利用するため、利用量に応じて課金が発生します。
- 大規模リポジトリ解析はトークン消費が大きい
- ループ修正は想定以上にコストが膨らむことがある
- CI組み込み時は特に注意
利用上限の設定や、検証環境での限定利用を推奨します。
まとめ
Claude Codeは魔法の自動開発ツールではありません。
- 強力な調査アシスタント
- 仮説生成エンジン
- テスト作成補助ツール
特にレガシー案件や仕様不明プロジェクトでは、「理解の初速を上げるツール」として非常に有効です。
制約・コスト・リスクを理解した上で、開発だけでなく調査・テスト・提案などにも効率よく活用していきましょう。
ここまで読んでいただき、ありがとうございます。もしこの記事の技術や考え方に少しでも興味を持っていただけたら、ネクストのエンジニアと気軽に話してみませんか。
- 選考ではありません
- 履歴書不要
- 技術の話が中心
- 所要時間30分程度
- オンラインOK
