Claude Codeのworktreeの使い方｜別作業の作成・確認・取り込みまで

Gitの履歴と、今の変更を確認する

worktreeはGitの同じ履歴から別の作業場所を用意します。まずエディターに未保存の変更がないかを確認し、次にgit statusで未コミット・未追跡のファイルを見ます。git statusだけでは、まだ保存していない編集までは分かりません。コミットが一つもない新規リポジトリでは、開始元の履歴を先に用意します。

最初は仕事の本体ではなく、小さな練習用プロジェクトで仕組みを試してください。既存の変更を消してきれいにする必要はありません。どの状態を出発点にするかを確認してから進みます。

• 出典：Claude Codeのworktree公式手順（新しいタブ）
• 出典：Git worktreeの仕組み（新しいタブ）

名前を付けて、別の作業場所を作る

公式のCLIではclaude --worktree header-fixのように名前を付けます。既定では.claude/worktrees/header-fix/に作業場所ができ、worktree-header-fixというブランチが使われます。初回のフォルダー信頼確認が必要な場合は、画面の案内で対象を確かめます。

開始したら「現在の作業フォルダーとブランチを確認し、まだ変更しないでください」と頼みます。想定した場所にいることを見てから、一つの見出しを直すなど小さな依頼をします。同じ名前を使い回して、どの作業か分からなくならないようにしましょう。

既定の開始元は、リモートの既定ブランチです。いま編集中のブランチや未コミット変更を、そのまま引き継ぐ操作とは限りません。作成後のファイルを読み、使いたい開始点と合っているかを確かめてから依頼します。

ファイルが分かれても、接続先は別に確認

新しい作業場所には、依存パッケージや無視対象の設定ファイルがそろっていない場合があります。起動しなければ、まずプロジェクトの通常のセットアップ方法を確認します。本番用の秘密情報を丸ごとコピーして解決しようとしないでください。

同じデータベースやストレージへ接続すれば、別worktreeでも操作先は共通です。画面を起動するポートも重なることがあります。作業フォルダー、テスト用の接続先、起動ポートを別々に確認すると、どこが分かれたのかが明確になります。

作業後は、何が変わったかを確認

git status --shortで変更や未追跡ファイルを見て、git diffで未コミットの差分を確認します。新しいファイルは差分表示だけで見落とすことがあるため、一覧にも目を通します。見出しだけの修正なら、他の設定まで変わっていないかを見てください。

変更をコミットした後は、未コミット差分が空でも「作業がなかった」わけではありません。取り込みたいブランチとの差や、新しいコミットを確認します。テスト結果と画面の確認も、変更した側のworktreeで実施します。

取り込みは、元の作業場所で差分を見てから

変更を残したブランチを元の作業へ取り込むには、Gitのmergeなどを使います。元の作業場所へ戻り、現在のブランチと残っている変更を確認してから、対象ブランチの変更を取り込みます。ここで競合が出たら、両方の変更意図を見て解決します。

取り込み直後にも、必要なテストを行います。別の場所で動いたことだけでは、元の作業の変更と合わさった状態まで確認できません。手順が分からない場合は、実行を任せる前に、対象ブランチと取り込み案を説明してもらいましょう。

• 出典：Git merge（新しいタブ）

削除するのは、成果を確認してから

終了時には保持や削除の確認が出る場合があります。まだ使う変更、未追跡ファイル、コミットが残っているなら保持します。フォルダーを直接削除するより、GitとClaude Codeが把握するworktreeの状態を確認して片付けてください。

複数の作業を扱うようになると、コードを書く以外にGitの差分やテストの理解も役立ちます。下の開発書は継続して学びたい人の候補です。まずこの小さな例で「どこで直し、どこへ取り込むか」を説明できる状態を目指してください。