EnterWorktreeとは?作業部屋を切り替える仕組み

EnterWorktreeって何のこと?

EnterWorktreeは、Claude Codeが「どのワークツリー(作業用のフォルダ)に入って作業するか」を切り替えるときに関わる名前です。名前をそのまま読むと「ワークツリーに入る(Enter)」。つまり、作業場所の移動を表しています。

正直なところ、最初にこの単語を見たときは「ワークツリーって何だっけ」で止まる人が多いと思います。なのでそこから話します。

まず「ワークツリー」をイメージする

Gitで管理しているプロジェクトには、いろいろな作業の枝(ブランチ)があります。「新機能を作る枝」「バグを直す枝」「リリース準備の枝」といった具合です。

普通は1つのフォルダの中で、その枝を切り替えながら作業します。でもそれだと、新機能の作業の途中で急にバグ修正を頼まれたときに、いったん作業を片付けてから切り替える必要があって面倒です。

ワークツリーは、ざっくり言えば「同じプロジェクトの作業部屋を、もう一つ別の場所に用意する」仕組みです。

この「隣の部屋」がワークツリーで、そこに入っていくのが EnterWorktree という名前が表している動作です。

どういうときに出てくるのか

Claude Codeに作業をお願いしていると、「このタスクは別の作業場所でやった方がいい」という状況が出てきます。たとえば、今いじっている内容を壊さずに別の変更を試したいとき。そういうときに、作業場所を移すという動きが発生します。

利用者から見ると、ログや表示の中に EnterWorktree のような名前が現れて、「あ、今作業場所が切り替わったんだな」とわかる、という程度の付き合い方になることが多いはずです。自分で毎回手打ちするコマンドというより、仕組みの側の名前だと思っておくといいでしょう。

勘違いしやすいポイント

ブランチを切り替えるのとは少し違う

ブランチの切り替えは、同じ部屋の中で中身を入れ替えるイメージです。対してワークツリーは、部屋そのものを増やします。だから片方の作業を途中のまま残しておける。ここが一番大きな違いです。

プロジェクトのコピーではない

フォルダは別に見えますが、元のリポジトリとつながっています。完全に独立したコピーを作っているわけではなく、「同じ本棚を共有しつつ、机だけ増やしている」ような関係です。

なぜこういう仕組みが便利なのか

AIに作業を任せると、自分が手元で別のことをしている最中にAIが動く、という場面が普通に起きます。そのときに同じフォルダを共有していると、お互いのファイル変更がぶつかって事故ります。「え、今いじってたファイルが勝手に変わってる」というやつです。

作業場所を分けておけば、そういう衝突を減らせます。AIには隣の部屋で作業してもらって、結果だけ後で取り込む。この発想が、ワークツリーを使う一番の動機だと思ってもらえればいいです。

覚えておくとよいこと

• ワークツリー = 同じプロジェクトの作業部屋を増やす仕組み
• EnterWorktree = その作業部屋に入る(作業場所を切り替える)という動作を表す名前
• 目的は、複数の作業を同時に進めても互いにぶつからないようにすること

細かい挙動まで最初から理解する必要はありません。「作業場所が切り替わった合図」くらいの認識で十分で、実際に複数の作業を並行させたくなったタイミングで調べ直せば、意味がすっと入ってくるはずです。