Claude Codeでブランチ戦略を実践する

ブランチ戦略とは

ブランチ戦略とは、チームでコードを開発する際のブランチの使い方のルールです。「どのブランチから分岐するか」「どこにマージするか」「ブランチ名はどう付けるか」を事前に決めておくことで、混乱なく並行開発ができます。

Claude Codeはブランチ操作を自然言語で指示でき、適切な戦略に基づいた運用をサポートしてくれます。

基本操作: ブランチの作成と切替

操作	手動コマンド	Claude Codeへの指示
ブランチ一覧	`git branch`	「ブランチの一覧を見せて」
新規作成+切替	`git checkout -b feature/xxx`	「ログイン機能用のブランチを作って」
切替	`git checkout main`	「mainブランチに切り替えて」
削除	`git branch -d feature/xxx`	「マージ済みのfeatureブランチを削除して」
リモート追跡	`git branch -r`	「リモートブランチの一覧を見せて」

3大ブランチ戦略の比較

1. Git Flow

最も伝統的なブランチ戦略で、リリースサイクルが長い（月1回以上）プロジェクトに適しています。

ブランチ構成:
├── main          ← 本番リリース用（タグ付き）
├── develop       ← 開発統合ブランチ
├── feature/*     ← 機能開発（developから分岐）
├── release/*     ← リリース準備（developから分岐）
└── hotfix/*      ← 緊急修正（mainから分岐）

フロー:
1. developからfeature/xxxを作成
2. 機能完成後、developにマージ
3. リリース時、developからrelease/x.xを作成
4. テスト完了後、mainとdevelopにマージ
5. mainにバージョンタグを付ける

2. GitHub Flow

シンプルで、継続的デプロイを行うプロジェクトに最適です。多くのWebサービスで採用されています。

ブランチ構成:
├── main          ← 本番（常にデプロイ可能）
└── feature/*     ← 機能開発（mainから分岐）

フロー:
1. mainからfeature/xxxを作成
2. 定期的にコミット＆push
3. PRを作成してレビューを依頼
4. レビュー承認後、mainにマージ
5. 自動デプロイ

3. トランクベース開発

最もシンプルで、CI/CDが十分に整備されたチームに適しています。

ブランチ構成:
├── main          ← 全員がここに直接コミット
└── (短命な作業ブランチ)  ← 1-2日で完了しマージ

フロー:
1. mainから短命なブランチを作成（任意）
2. 小さな単位で頻繁にコミット
3. フィーチャーフラグで未完成機能を隠す
4. 最短でmainにマージ

戦略	適するプロジェクト	複雑さ	デプロイ頻度
Git Flow	リリース頻度が低い、大規模	高	月1回程度
GitHub Flow	Webサービス、中小規模	低	日次～週次
トランクベース	CI/CD完備、小規模チーム	最低	日に複数回

ブランチ命名規則

ブランチ名の規則を統一することで、目的が一目でわかります。

推奨する命名パターン

feature/user-authentication    ← 新機能
fix/login-validation-error     ← バグ修正
hotfix/security-patch          ← 緊急修正
refactor/database-queries      ← リファクタリング
docs/api-documentation         ← ドキュメント
test/payment-integration       ← テスト追加
chore/update-dependencies      ← メンテナンス

CLAUDE.mdでブランチ規約を設定

## ブランチ規約
- mainブランチへの直接push禁止
- ブランチ名は「種類/説明」形式（例: feature/user-profile）
- 説明部分はケバブケース（小文字+ハイフン）
- Issue番号を含める場合: feature/123-user-profile

Worktree ― 並列作業のための機能

Claude Codeにはworktree（ワークツリー）機能があり、同じリポジトリの複数ブランチを同時に作業できます。

worktreeの使い方

あなた: worktreeで新しい作業を始めたい

Claude Code:
新しいworktreeを作成します。
.claude/worktrees/ 配下に作業ディレクトリが作成されます。

作業ディレクトリ: .claude/worktrees/fix-header/
ブランチ: fix-header（HEADから分岐）

現在のセッションをこのworktreeに切り替えました。
元の作業に影響を与えずに作業できます。

worktreeの利点: 通常のブランチ切替では未コミットの変更が邪魔になることがありますが、worktreeなら完全に独立した作業ディレクトリで並行して作業できます。

まとめ

ブランチ戦略はプロジェクトの規模とデプロイ頻度で選ぶ
GitHub Flowがシンプルで最も多くのプロジェクトに適する
ブランチ命名規則を統一して可読性を確保する
Claude Codeなら自然言語でブランチ操作が可能
worktreeで複数ブランチの並列作業ができる