Claude Codeで大規模コード移行を並列化する方法

Anthropicは、多数のリポジトリやファイルにまたがるコード移行をClaude Codeへ任せるための実装パターンを公開しました。単発の補完ではなく、対象発見、変更、テスト、レビュー、失敗の再処理までを一つの移行システムとして設計する内容です。

今回のブログ記事で語られていること

大規模移行では、ひとつのエージェントに巨大なコンテキストを渡す方法は安定しません。対象を独立して検証できる単位へ分け、各エージェントが限定された変更を担当し、中央のオーケストレーターが進行状況を管理する構成が紹介されています。対象候補は静的検索やコンパイラー、既存の依存関係情報から作り、エージェントには変更の意図、許容範囲、禁止事項、テスト方法を渡します。これにより、検索結果をそのまま機械置換するのではなく、個々の呼び出し方や型、周辺コードに応じた修正ができます。

移行の品質を決めるのは生成量より検証ループです。各変更は既存のコード整形、lint、型検査、単体テストや対象パッケージのテストを実行し、失敗した場合はログを次の試行へ返します。差分が想定範囲を超えた場合やテストが不安定な場合は自動で進めず、人のレビューへ送ります。並列化では同じファイルや依存領域を複数エージェントが同時編集しないよう作業単位を割り当て、マージ競合と重複作業を抑える必要があります。

記事は、エージェントがもっとも力を発揮するのは「正解を機械的に確かめられるが、修正自体は文脈判断を要する」移行だと示しています。API置換、非推奨機能の除去、型の厳格化、テスト方式の変更などは候補になりますが、製品仕様やアーキテクチャの決定まで自動化するものではありません。完了率、再試行、テスト失敗、レビュー差し戻しを計測し、難しい例を指示や検証器へ戻すことで、後半ほど移行の成功率を上げます。人は一件ずつコードを書く役割から、作業境界、評価基準、例外処理を設計する役割へ移ります。移行後の差分を再現できる記録と、一群の変更を安全に戻せる単位も、並列化の速度と同じくらい重要です。

今回のブログ記事が関係する人

大規模なライブラリ更新、API移行、セキュリティ修正、言語バージョン更新を抱えるプラットフォームチームと、Claude CodeをCIや開発基盤へ組み込む担当者に関係します。

結局、今回のブログ記事をどう読むべきか

対象の列挙方法、1エージェントの編集範囲、必須テスト、差分上限、再試行回数、人へ戻す条件を先に決めます。小さな代表集合で誤修正と検証時間を測り、履歴を追跡できるブランチやコミット単位で段階的に広げるのが適切です。