Claude Codeでシステム構成図を自動生成・更新する方法【ZOZO事例から学ぶ】

システム構成図は開発チームにとって重要なドキュメントですが、手動で作成・更新するのは時間のかかる作業です。ZOZO TECH BLOGの事例では、Claude Codeを活用してこのプロセスを自動化しています。ここでは、その背景と具体的な方法を解説します。

📑目次

1. Claude Code構成図自動生成の背景と手動作成の課題
2. 中間ファイル（規約・構造ファイル）の役割と作成方法
3. CI連携による自動更新ワークフロー
4. 実際の効果・知見と注意点
5. 導入判断のための比較表とFAQ
6. まとめと読者が次に取るべきアクション

---

Claude Code構成図自動生成の背景と手動作成の課題

従来、AWSのシステム構成図は手作業で描くことが一般的でした。エンジニアがVisioやdraw.ioなどのツールを使って1から作成し、コード変更のたびに手動で更新していました。この方法では、以下のような課題がありました。

• 作成に多くの時間がかかる
• コードと図の乖離が発生しやすい
• 複数人でメンテナンスすると一貫性が失われる

Claude Codeは、自然言語で指示を出すだけでコードや仕様から構成図を生成できるため、これらの課題を解決します。ZOZOの事例では、Claude Codeを導入することで図の作成時間を大幅に短縮しました。

---

中間ファイル（規約・構造ファイル）の役割と作成方法

自動生成の鍵は、中間ファイルの作成です。まずはプロジェクトの構造や規約を定義したファイルを作成します。例えば、以下のようなJSONやYAML形式でサービス間の関係を記述します。

{
  "services": [
    {"name": "WebServer", "type": "EC2", "connections": ["Database"]},
    {"name": "Database", "type": "RDS", "connections": []}
  ]
}

この中間ファイルをClaude Codeに渡すことで、MermaidやPlantUML形式の図を自動生成します。規約ファイルはチームで共有し、更新ルールを明確にしておくことが重要です。

---

CI連携による自動更新ワークフロー

生成した図をCI/CDパイプラインと連携させることで、コード変更時に自動で図を更新できます。GitHub Actionsの例では、以下のようなステップを組み込みます。

1. リポジトリの変更を検知
2. Claude Codeに中間ファイルを更新させるプロンプトを実行
3. 生成された図をリポジトリにコミット
4. ドキュメントサイトに反映

このワークフローにより、図の陳腐化を防ぎます。ZOZOの事例では、CI連携により常に最新の構成図が維持されています。

---

実際の効果・知見と注意点

導入の効果として、図の作成時間が半分以下になったという報告があります。また、コードと図の一貫性が保たれ、レビュー効率が向上しました。

注意点として、生成された図は必ず人間が確認する必要があります。Claude Codeの出力には誤りが含まれる可能性があるため、セキュリティや依存関係の誤りをチェックしましょう。また、機密情報を含む図の生成には注意が必要です。

---

導入判断のための比較表とFAQ

項目	手動作成	Claude Code自動生成
作成時間	数時間	数分
更新頻度	手動	自動 (CI連携)
一貫性	低い	高い
コスト	人的コスト	AI利用料 + 初期設定

FAQ

Q: Claude Codeの利用に特別なプランは必要ですか？

Proプラン以上で利用可能です。詳細は公式ドキュメントを確認してください。

Q: 生成された図の形式はカスタマイズできますか？

はい、MermaidやPlantUMLなど希望の形式を指定できます。

Q: 既存の図をClaude Codeで更新するにはどうすればよいですか？

既存の図のソースを中間ファイルとしてClaude Codeに渡し、更新指示を出します。

---

まとめと読者が次に取るべきアクション

Claude Codeを活用した構成図の自動生成は、開発効率を大幅に向上させる手法です。まずは中間ファイルの作成から始め、CI連携を試してみてください。

読者の皆さんは、以下のアクションをおすすめします。 – ZOZO TECH BLOGの事例記事を読み、詳細を確認する – 自社プロジェクトで中間ファイルを作成してみる – Claude Codeの公式ドキュメントを参照してセットアップする

これにより、手動作業から解放され、より創造的な開発に集中できます。

関連記事:

• Claude CodeとObsidianの連携で実現する部長のナレッジ管理術
• Claude Fable 5を活用したAgent SOP構築のタイミングと手順【Fable 5限定ガイド】
• Claude API費用を劇的に削減するpxpipeツールの仕組みと実践

関連する新しい記事:

• 16GBノートPCでClaude Code + ローカルLLMを安定運用する方法 — CodeRouterでTool Callを改善する2026年7月版 – This published update adds current operational context for Claude Codeでシステム構成図を自動生成・更新する方法【ZOZO事例から学ぶ】.