worktree
object記述場所どの設定ファイルでも可--worktree セッション用の設定を構成します。
含まれる設定
5件- baseRefstringworktree を origin/<デフォルトブランチ>(fresh)から分岐させるかローカルの HEAD(head)から分岐させるかを指定します。
- bgIsolationstringバックグラウンドセッションの隔離モードです。
- locationstringDesktop SSH セッションが worktree を作成するリモートマシン上のフォルダーを選択する。
- sparsePathsstring[]git sparse-checkoutを使用して、作業ツリーにチェックアウトするディレクトリを指定します。
- symlinkDirectoriesstring[]ディスク上のディレクトリ重複を避けるため、メインリポジトリから各ワークツリーにシンボリックリンクを貼るディレクトリを指定します。
記述例
{
"worktree": {
"baseRef": "head",
"symlinkDirectories": ["node_modules"]
}
}使い方・用途
worktree.baseRefでベースとなる Git ブランチを指定する(デフォルト:head)worktree.symlinkDirectoriesでシンボリックリンクを作成するディレクトリを指定するworktree.sparsePathsでスパースチェックアウトでチェックアウトするディレクトリを指定し、大規模リポジトリのパフォーマンスを向上させる
Configuration for --worktree sessions. See https://code.claude.com/docs/en/settings#worktree-settings
関連する変更履歴
v2.1.319(1件)
v2.1.314(2件)
claude -p --resume や --continue で入った worktree にサンドボックスの保護が適用されない問題を修正した英語原文を表示英語原文を閉じる
claude -p --resume or --continue関連ドキュメント
英語原文を表示英語原文を閉じる
v2.1.311(1件)
英語原文を表示英語原文を閉じる
v2.1.309(4件)
英語原文を表示英語原文を閉じる
関連ドキュメント
英語原文を表示英語原文を閉じる
関連ドキュメント
英語原文を表示英語原文を閉じる
英語原文を表示英語原文を閉じる
変更後
worktree の作成や再利用のときに git がオブジェクトをオンデマンドで取得しなくなるため、通常のクローンや Bash サンドボックス設定のある部分クローンでも、ネットワークアクセスを伴わずにworktree 操作が完了するようになる。部分クローンでは必要なオブジェクトを事前に取得しておくことで、セッション途中のフェッチ失敗やハングを避けられる。
v2.1.305(1件)
英語原文を表示英語原文を閉じる
v2.1.304(1件)
claude --worktree が終了時に確認なしで worktree とそのブランチを削除し、コミットが失われる可能性があった問題を修正した。英語原文を表示英語原文を閉じる
claude --worktree removing the worktree and its branch without asking at exit when HEAD was detached or on another branch, which could lose commitsv2.1.302(1件)
.git ファイルがある場合に、git 2.56 以降で worktree 分離が worktree の作成や再開を拒否する問題を修正した英語原文を表示英語原文を閉じる
.git file points at a directory that doesn't exist関連ドキュメント
v2.1.301(1件)
v2.1.300(5件)
--worktree 付きで起動した場合にプラグインの WorktreeCreate と WorktreeRemove フックが実行されない問題を修正した(--tmux ではまだ未対応)英語原文を表示英語原文を閉じる
WorktreeCreate and WorktreeRemove hooks not running when Claude Code starts with --worktree (not yet with --tmux)関連ドキュメント
--worktree セッションが誤ったコミットから開始されることがある問題と、開始時の git ステータスが新しい worktree 以外のブランチ名を示す問題を修正した英語原文を表示英語原文を閉じる
--worktree sessions sometimes starting from the wrong commit when a tag or branch was named like a commit ID, and their starting git status naming a branch other than the new worktree's--worktree が worktree を再オープンできなくなる問題を修正した英語原文を表示英語原文を閉じる
--worktree failing to reopen a worktree in repositories using git's reftable ref storage--worktree が失敗する問題を修正した。フォールバックの基点はメインリポジトリではなく現在のチェックアウトの HEAD になる英語原文を表示英語原文を閉じる
--worktree failing in a worktree of a bare repository when origin's default branch can't be fetched; the fallback base is now the current checkout's HEAD, not the main repository's英語原文を表示英語原文を閉じる
関連ドキュメント
v2.1.299(5件)
英語原文を表示英語原文を閉じる
関連ドキュメント
--worktree セッションが .git/worktrees にフォルダを残す問題を修正した英語原文を表示英語原文を閉じる
--worktree sessions leaving a folder behind in .git/worktrees in repositories using git's reftable ref storage英語原文を表示英語原文を閉じる
変更後
コミットが存在しないリポジトリなどで worktree の作成に失敗したとき、原因の見当と解決のための確認点がエラーメッセージから分かるようになる。
英語原文を表示英語原文を閉じる
変更後
ベアリポジトリ構成のルートでワークツリーを作成しようとした場合に、原因を理解しにくい無関係な git のエラーではなく、そのレイアウトを説明するエラーが表示されるようになる。
-w と -r を使う。どちらも収まらない場合は、保存された worktree の上の行に実行場所を示す英語原文を表示英語原文を閉じる
-w and -r if the long flags do not fit the terminal. If neither fits a kept worktree, rows above it say where to run it変更後
worktree セッション終了時に表示される再開コマンドがターミナルの幅に収まらない場合でも、短いフラグ(-w / -r)に自動で切り替わるため、折り返されずに読みやすくなる。worktree が保持されているセッションでは、その上の行にどこで実行すべきかが示されるので、実行場所に迷わず再開できる。
v2.1.295(1件)
英語原文を表示英語原文を閉じる
関連ドキュメント
v2.1.290(3件)
/loop 実行回数、カウントダウン、ライブステータス行が失われる問題を修正した英語原文を表示英語原文を閉じる
/loop run count, countdown and live status line after the session enters a worktree that it creates関連ドキュメント
英語原文を表示英語原文を閉じる
英語原文を表示英語原文を閉じる
関連ドキュメント
v2.1.288(1件)
tool.call フックが Bash を失敗させ、ファイル検索が誤ったフォルダーを読む問題を修正した。英語原文を表示英語原文を閉じる
tool.call hook making Bash fail and file searches read the wrong folder in subagents that run in a worktreev2.1.287(1件)
claude agents からバックグラウンドセッションを再度開けなくなる問題を修正しました。英語原文を表示英語原文を閉じる
claude agents after the agent exited and removed the worktree the session was started in関連ドキュメント
v2.1.286(2件)
英語原文を表示英語原文を閉じる
関連ドキュメント
/exit の Remove worktree(ワークツリー削除)を、Claude Code がそこで起動したサーバーとシェルを停止した後に実行するように変更した。Windows ではこれが原因でフォルダーが削除されない場合があった英語原文を表示英語原文を閉じる
/exit's Remove worktree to run after Claude Code stops the servers and shells it started there, which on Windows could keep the folder from being deleted変更後
Windows でも /exit によるワークツリーの削除が確実に完了し、フォルダが削除できずに残る問題を回避できる。
関連ドキュメント
v2.1.285(4件)
/teleport の fetch による SSH パスフレーズや新規ホストのプロンプトがターミナルを乗っ取る問題を修正した。これらの fetch は尋ねる代わりに即座に失敗するようになった英語原文を表示英語原文を閉じる
/teleport fetches taking over the terminal; these fetches now fail fast instead of asking/ultrareview が誤解を招く「core.worktree is set」エラーを表示する問題を修正した英語原文を表示英語原文を閉じる
/ultrareview when the project folder briefly could not be readcore.longpaths が設定されている git worktree から、macOS と Linux 上の /ultrareview がワーキングツリーのアップロードに失敗する問題を修正した英語原文を表示英語原文を閉じる
/ultrareview on macOS and Linux failing to upload the working tree from a git worktree whose per-worktree config sets core.longpaths/ultrareview がアップロードしてしまう問題を修正した英語原文を表示英語原文を閉じる
/ultrareview uploading a linked worktree of a repository rooted at your home folder in some cases変更後
ホームフォルダをルートとするリポジトリのリンクされたワークツリーがある場合でも、Windows で /ultrareview を正常に実行できるようになる。
v2.1.284(1件)
/ultrareview を実行した際に、作業ツリーのアップロードに失敗する問題を修正した英語原文を表示英語原文を閉じる
/ultrareview failing to upload the working tree when started from a git worktree that the Claude desktop app created on macOS or Linuxv2.1.283(1件)
GIT_CONFIG_COUNT 環境変数ペアとして git に渡される場合に、worktree のチェックアウトで証明書検証が失敗する問題(例: Git LFS のダウンロード時)を修正した。英語原文を表示英語原文を閉じる
GIT_CONFIG_COUNT environment pairsv2.1.282(1件)
permissions、autoMode、worktree、attribution 設定全体が無視される問題を修正した。ブロックの残りの部分は引き続き適用されるようになった英語原文を表示英語原文を閉じる
permissions, autoMode, worktree and attribution settings being ignored entirely when one nested value was invalid; the rest of the block now still applies関連ドキュメント
v2.1.281(2件)
--setting-sources(および SDK の settingSources)が生成されたセッションに引き継がれない問題を修正した。teammates、/bg、claude agents のセッション、--worktree --tmux は親の制限を引き継いで開始するようになった英語原文を表示英語原文を閉じる
--setting-sources (and SDK settingSources) not being forwarded to spawned sessions: teammates, /bg, claude agents sessions and --worktree --tmux now start with the parent's restriction英語原文を表示英語原文を閉じる
/batch to run where a WorktreeCreate hook provides the agent worktrees, not only inside a git repository変更後
/batch を git リポジトリの外でも実行できるようになり、SVN や Perforce など git 以外のバージョン管理システムを使うプロジェクトでも、WorktreeCreate フックを設定すればバッチ処理を並列実行できる。
関連ドキュメント
v2.1.277(1件)
.claude/skills がバージョン管理外の場合に、--worktree セッションでメインリポジトリのプロジェクトスキルが読み込まれない問題を修正した英語原文を表示英語原文を閉じる
--worktree sessions when .claude/skills is untracked関連ドキュメント
v2.1.274(2件)
英語原文を表示英語原文を閉じる
英語原文を表示英語原文を閉じる
変更後
サブモジュールのチェックアウトを含む agent worktree を削除する前に安全性チェックが強化され、チェックアウト内の未コミット作業などがあっても自動削除で失われなくなりました。これにより、定期的なクリーンアップの対象になった worktree でも submodule 内の作業を安心して保持できるようになります。
v2.1.273(1件)
.claude/scheduled_tasks.json を別のフォルダー(新しい worktree など)にコピーした後、誤ったセッションで実行される問題を修正する英語原文を表示英語原文を閉じる
.claude/scheduled_tasks.json was copied into another folder, such as a new worktreev2.1.268(1件)
claude agents で worktree を削除できないときにセッション削除が固まる問題を修正した。メッセージが原因と次のステップを示すようになり、git worktree の場合は ctrl+x をもう一度押すとディレクトリを強制削除できる英語原文を表示英語原文を閉じる
claude agents session delete getting stuck when a worktree can't be removed: the message names the cause and next step, and for a git worktree ctrl+x again deletes the directory anyway関連ドキュメント
v2.1.265(1件)
--worktree 起動を改善した。新しい worktree が並列でチェックアウトされるようになった(git 2.32+)英語原文を表示英語原文を閉じる
--worktree startup on large repositories: the new worktree is now checked out in parallel (git 2.32+)変更後
大きなリポジトリでも --worktree を使ったセッション開始が高速になり、作業を始めるまでの待ち時間を短縮できる。
v2.1.260(3件)
permissions.blockReadsOutsideWorkingDirectories により、サンドボックス化された git からユーザーの git config が見えなくなり、worktree 分離されたサブエージェントの自分のチェックアウトも見えなくなる問題を修正した。英語原文を表示英語原文を閉じる
permissions.blockReadsOutsideWorkingDirectories on macOS hiding the user's git config from sandboxed git and hiding a worktree-isolated sub-agent's own checkout-p --resume/--continue(デスクトップアプリで使用)が以降のすべての再試行で失敗する問題を修正した。現在は 1 回失敗した後、worktree なしで再開する。英語原文を表示英語原文を閉じる
-p --resume/--continue (as used by the desktop app) failing on every retry once a session's worktree directory lost its git metadata; it now fails once, then resumes without the worktree英語原文を表示英語原文を閉じる
変更後
未プッシュのコミットがあるワークツリーの削除時に、ブランチ名とコミット数が確認でき、もう一度削除操作でワークツリーを破棄できるため、コミットを失わずに安全にバックグラウンドセッションを整理できる。
v2.1.259(2件)
git rev-parse が 'not a git repository' 以外のメッセージで失敗するマシンで、ワークツリー分離がフックで作成されたワークツリーを拒否する問題を修正英語原文を表示英語原文を閉じる
git rev-parse fails with a message other than "not a git repository"関連ドキュメント
英語原文を表示英語原文を閉じる
v2.1.257(3件)
$VAR の読み取り、'$(…)'、ヒアドキュメントが「worktree 内に留まるとは検証できないほど複雑」として拒否される問題を修正した英語原文を表示英語原文を閉じる
$VAR reads, "$(…)" and heredocs that never touch git as "too complex to verify that it stays inside the worktree"関連ドキュメント
cd した後にリポジトリ共通の .git ディレクトリへの書き込み権限を失う問題を修正した英語原文を表示英語原文を閉じる
.git directory after cd into a subdirectory/fork を改善し、元の会話のプロンプトキャッシュを新しいバックグラウンドセッションで保持するようにした。ワークツリーのブリーフィングがシステムプロンプトの変更ではなくメッセージとして届くようになった英語原文を表示英語原文を閉じる
/fork to keep the original conversation's prompt cache in the new background session: its worktree briefing now arrives as a message instead of a system-prompt change変更後
バックグラウンドで動かすフォーク先のセッションが、元の会話のプロンプトキャッシュをそのまま再利用できるようになり、実行時のコストや待ち時間を抑えられる。
v2.1.251(2件)
git worktree add で自分が作成した git worktree 内のファイルを編集できなかった問題を修正した英語原文を表示英語原文を閉じる
git worktree add関連ドキュメント
--worktree --tmux を修正した。GtiHub 方式のフェッチを試みて失敗する代わりに、GitLab の ref を直接フェッチするようになった英語原文を表示英語原文を閉じる
--worktree --tmux with a merge-request number on a gitlab.com origin trying a doomed GitHub-style fetch first instead of fetching the GitLab ref directlyv2.1.248(2件)
main)にマージ済みだがまだプッシュされていない場合に、claude agents と claude rm が「has commits that are not pushed anywhere」という理由でセッションの削除を拒否する問題を修正した英語原文を表示英語原文を閉じる
claude agents and claude rm refusing to delete a session ("has commits that are not pushed anywhere") when its worktree branch was already merged into your checked-out default branch (e.g. local main) but not yet pushed関連ドキュメント
git worktree remove がその worktree に干渉しなくなる。英語原文を表示英語原文を閉じる
git worktree remove leave it alone関連ドキュメント
v2.1.246(2件)
.claude/worktrees/ 配下の git worktree を削除してしまう問題を修正した。英語原文を表示英語原文を閉じる
.claude/worktrees/ that you created yourself when an old background-session record pointed at them関連ドキュメント
/ultrareview の実行やクラウドセッションが、別の起動の未コミット変更を持って開始することがある問題を修正した英語原文を表示英語原文を閉じる
/ultrareview runs and cloud sessions launched at the same time from one repository (e.g. from several worktrees) sometimes starting with another launch's uncommitted changesv2.1.239(3件)
/resume が、削除されたディレクトリ(例: 削除済み worktree)への cd を促す問題を修正した。そのようなセッションは現在のディレクトリで再開される英語原文を表示英語原文を閉じる
/resume in all-projects mode telling you to cd into a deleted directory (e.g. a removed worktree); such sessions now resume in the current directory関連ドキュメント
**/ で始まる .worktreeinclude パターンが黙って何にも一致しなくなる問題を修正した英語原文を表示英語原文を閉じる
.worktreeinclude patterns starting with **/ silently matching nothing when the target lived in a gitignored directory.git/config.worktree を読み取ろうとして失敗し、extensions.worktreeConfig が設定されたリポジトリでサンドボックス化された git コマンドがすべて壊れる問題を修正した英語原文を表示英語原文を閉じる
.git/config.worktree unreadable, which broke every sandboxed git command in repos with extensions.worktreeConfig set関連ドキュメント
v2.1.238(1件)
英語原文を表示英語原文を閉じる
v2.1.233(1件)
--worktree フラグと claude agents ビューに GitLab マージリクエスト URL のサポートを追加した(マージリクエストは !N として表示される)英語原文を表示英語原文を閉じる
--worktree flag and the claude agents view (where MRs display as !N)変更後
--worktree フラグや claude agents 画面で、GitLab マージリクエストを番号や URL で指定できるようになり、GitHub PR と同じ操作感で MR の変更に基づく作業ブランチや worktree を手軽に用意できる。
v2.1.222(1件)
英語原文を表示英語原文を閉じる
変更後
並列セッションを実行する際に、メインのソースコードを破壊される心配をすることなく並行して安全に作業を進めることができます。
関連ドキュメント
v2.1.221(1件)
英語原文を表示英語原文を閉じる
/fork to create a new worktree of their own instead of working in the original session's checkout変更後
並行して複数のタスクを進めても、セッション間でファイルの変更が競合しなくなります。
関連ドキュメント
v2.1.216(3件)
英語原文を表示英語原文を閉じる
git -C, --git-dir, or GIT_DIR/GIT_WORK_TREE変更後
並行して複数のブランチで作業しても、Git の操作対象を間違える不安がなくなります。
関連ドキュメント
英語原文を表示英語原文を閉じる
変更後
セッション開始時に毎回、正しいディレクトリに作成されたか確認する必要がなくなります。
英語原文を表示英語原文を閉じる
v2.1.212(1件)
英語原文を表示英語原文を閉じる
.claude/worktrees, which could create files outside the repository変更後
ワークツリー作成時にファイルシステムの汚染や意図しないディレクトリ操作を意識する必要がなくなります。
関連ドキュメント
v2.1.211(2件)
英語原文を表示英語原文を閉じる
claude agents jobs becoming permanently undeletable when git no longer recognizes their worktree — the row now shows why the delete was refused instead of silently reappearing変更後
不要になったバックグラウンドタスクの行がリストに居座り続けることがなくなり、エージェントビューを常にクリーンに保てる。
関連ドキュメント
英語原文を表示英語原文を閉じる
変更後
同じリポジトリ内であれば、作業場所を変えても同じコマンドに対して何度も許可を求められる煩わしさがなくなる。
v2.1.210(2件)
英語原文を表示英語原文を閉じる
isolation: 'worktree' subagents being able to run git-mutating commands against the main repo checkout instead of their own isolated worktree変更後
並列作業中のサブエージェントがメイン作業中のファイルを誤って書き換えてしまう心配がなくなります。
英語原文を表示英語原文を閉じる
git worktree lock behind; the periodic sweep now releases locks whose owning process is gone変更後
エージェントがクラッシュした後に、手動で git コマンドを叩いてロックを解除する必要がなくなります。
関連ドキュメント
v2.1.208(1件)
英語原文を表示英語原文を閉じる
変更後
エージェントが作成したコード変更を誤って失うリスクがなくなり、安心して並列作業を行えるようになる。
関連ドキュメント
v2.1.207(3件)
worktree.sparsePathsを使用した最後のワークティが削除された後、リポジトリの.git/configにextensions.worktreeConfigが残ってしまう問題を修正しました。英語原文を表示英語原文を閉じる
extensions.worktreeConfig being left in the repo's .git/config (breaking go-git tools like tea) after the last worktree.sparsePaths worktree was removed変更後
Claude Codeを使用した並列開発を行っても他の開発ツールと干渉しなくなり、既存の開発環境を壊す心配がなくなります。
関連ドキュメント
.ignore、.worktreeinclude内の誤ったブラケット(括弧)パターンによって、ファイルの読み取りや提案、ワークツリー作成が失敗する問題を修正しました。英語原文を表示英語原文を閉じる
.ignore, and .worktreeinclude breaking file reads, file suggestions, and worktree creation変更後
ファイルの除外設定やスキル定義が意図通りに機能するようになり、リポジトリ構成の不整合によるエラーに悩まされることがなくなります。
関連ドキュメント
英語原文を表示英語原文を閉じる
変更後
長時間かかる並列タスクを安心して中断・再開でき、作業の継続性が保証されます。
v2.1.206(1件)
EnterWorktree ツールが、プロジェクトの .claude/worktrees/ 以外にある Git ワークツリーに入る前に確認を求めるようになりました英語原文を表示英語原文を閉じる
EnterWorktree now asks for confirmation before entering a git worktree outside the project's .claude/worktrees/ directory変更後
AI による不透明なディレクトリ移動を防ぎ、開発環境の安全性が高まります。
v2.1.205(1件)
英語原文を表示英語原文を閉じる
変更後
Windows環境でのファイル管理が安全になり、大切なデータが誤って消去されるリスクが排除されました。
v2.1.203(4件)
英語原文を表示英語原文を閉じる
変更後
巨大なモノレポなどでも問題なくコマンドを実行できます。
英語原文を表示英語原文を閉じる
変更後
並列作業中に意図しないファイル変更やコマンド実行が起こるリスクが低減されます。
英語原文を表示英語原文を閉じる
変更後
複雑なディレクトリ構成でも、問題なくエージェントの並列化が利用できます。
英語原文を表示英語原文を閉じる
@ directory picker in claude agents not showing registered git worktrees変更後
複数のプロジェクトを効率的に管理している場合、迅速な作業切り替えが可能です。
v2.1.202(1件)
英語原文を表示英語原文を閉じる
変更後
複雑なリポジトリ環境であっても、Claude Codeの再開速度が大幅に改善されます。
v2.1.200(1件)
英語原文を表示英語原文を閉じる
v2.1.198(2件)
英語原文を表示英語原文を閉じる
claude agents now commit, push, and open a draft PR when they finish code work in a worktree, instead of stopping to ask変更後
定型的なプルリクエスト作成プロセスが自動化され、作業のリードタイムが短縮されます。
関連ドキュメント
英語原文を表示英語原文を閉じる
/desktop failing with "Cannot determine working directory" after entering and exiting a worktree変更後
ワークツリーを使用した並列作業環境でも、デスクトップアプリとの連携がシームレスに行えます。
v2.1.187(1件)
英語原文を表示英語原文を閉じる
.git/worktrees/ entries from killed agents are now cleaned up automatically変更後
ディスク容量の無駄遣いや Git 操作時の予期せぬ競合を回避し、手動でのメンテナンスの手間を省けます。
関連ドキュメント
v2.1.181(1件)
英語原文を表示英語原文を閉じる
git cannot be resolved on Windows変更後
不要なファイルやディレクトリが残ることを防ぎ、開発環境を常に整理された状態に保てます。
関連ドキュメント
v2.1.176(1件)
/cd やワークツリー移動後に、セッションが前のディレクトリの Git ブランチを報告し続ける問題を修正しました英語原文を表示英語原文を閉じる
/cd and worktree moves leaving the session reporting the previous directory's git branch変更後
現在の作業コンテキストを正確に把握でき、誤ったブランチに対して操作を依頼するリスクを回避できます。
関連ドキュメント
v2.1.169(1件)
英語原文を表示英語原文を閉じる
EnterWorktree変更後
特にマルチタスク実行時における AI の動作効率が上がり、トークン消費の無駄を抑えられます。
関連ドキュメント
v2.1.166(1件)
claude agents から再開しようとした際に、「会話が見つからない」というエラーでクラッシュループに陥る問題を修正しました。英語原文を表示英語原文を閉じる
claude agents変更後
大規模なプロジェクトで複数のワークツリーを使い分ける際の信頼性が向上します。
関連ドキュメント
v2.1.161(3件)
英語原文を表示英語原文を閉じる
/autofix-pr reporting "cannot run on the default branch" when the session is inside a git worktree or another repository変更後
CI 失敗の修正などを自動化する際、プロジェクトの構成を気にすることなく「/autofix-pr」の恩恵を受けられるようになります。
関連ドキュメント
英語原文を表示英語原文を閉じる
--resume picker not showing sessions from the current directory when it isn't a git worktree (e.g., jj workspaces)変更後
どのような開発環境であっても、中断した作業を「--resume」から即座に再開できるようになります。
関連ドキュメント
英語原文を表示英語原文を閉じる
isolation: "worktree" in background sessions being blocked from editing files inside their own worktree変更後
メインの作業ブランチを汚さずにエージェントに並列作業を任せる「隔離ワークツリー」機能が、安定して動作するようになります。
関連ドキュメント
v2.1.157(4件)
EnterWorktree ツールで、セッションの途中に Claude が管理する別のワークツリーへ切り替えられるようになりました英語原文を表示英語原文を閉じる
EnterWorktree can now switch between Claude-managed worktrees mid-session変更後
並行して進めている複数のタスク間を、Claude との対話を途切れさせることなく自在に行き来できます。
関連ドキュメント
git worktree remove/prune でクリーンアップが可能になりました英語原文を表示英語原文を閉じる
git worktree remove/prune can clean them up変更後
不要になった一時的なディレクトリがディスクを圧迫するのを防ぎ、リポジトリを常にクリーンな状態に保てます。
.claude/worktrees/ 下のバックグラウンドエージェント用ワークツリーが孤立したままになる問題を修正しました英語原文を表示英語原文を閉じる
.claude/worktrees/ being orphaned after the 30-day job retention sweep変更後
長期間の使用においても、見えないゴミデータがプロジェクトディレクトリ内に溜まることを防げます。
関連ドキュメント
--worktree および --worktree --tmux を使用した際、現在のリンクされたワークツリーではなく、リポジトリのルートに戻ってしまう問題を修正しました英語原文を表示英語原文を閉じる
--worktree and --worktree --tmux returning to the canonical repo root instead of the current linked worktree変更後
ディレクトリ移動の手間が省け、ワークツリーによるマルチタスク環境がより安定します。
関連ドキュメント
v2.1.154(2件)
英語原文を表示英語原文を閉じる
EnterWorktreeを呼び出したりした際、worktree.baseRef: "head"が現在のワークツリーのHEADではなく、メインチェックアウトのHEADを参照してしまう問題を修正しました。英語原文を表示英語原文を閉じる
worktree.baseRef: "head" resolving to the main checkout's HEAD instead of the current worktree's HEAD when spawning subagents or calling EnterWorktree from inside a linked worktree変更後
複雑な機能を複数のブランチに分けて並行開発している際も、現在の修正内容を維持したままサブエージェントに作業を依頼できるようになります。
関連ドキュメント
v2.1.153(1件)
subagent_type: 'claude' を指定したAgentツールが、非公開のテンポラリワークツリーで実行され、.gitignore対象のファイルへの出力が消えてしまう問題を修正しました英語原文を表示英語原文を閉じる
Agent tool with subagent_type: 'claude' running in an undocumented temporary worktree, which could silently discard outputs written to gitignored paths変更後
AIが作成したファイルが見失われることがなくなり、作業結果の信頼性が向上します。
関連ドキュメント
v2.1.149(1件)
英語原文を表示英語原文を閉じる
.git directory (with hooks/ and config denied)変更後
複数のワークツリーを並行して使用する際の安全性が向上し、メインのプロジェクト設定を誤って変更される心配がなくなります。
v2.1.147(1件)
英語原文を表示英語原文を閉じる
v2.1.146(1件)
英語原文を表示英語原文を閉じる
v2.1.144(2件)
/branch を実行した際、「No conversation to branch」というエラーで失敗する問題を修正しました英語原文を表示英語原文を閉じる
/branch failing with "No conversation to branch" after entering a worktree or in some background sessions変更後
複数の試行錯誤を並行して行う際、エラーを気にせず自由に会話を分岐させて実験を続けられるようになります。
WorktreeCreate フックが設定されている場合、git 以外の VCS ユーザーでもバックグラウンドセッションのワークツリー隔離ガードが適用されるようになりました英語原文を表示英語原文を閉じる
WorktreeCreate hooks configured変更後
どのような開発環境でも、バックグラウンドでの AI の作業が自分の手元の作業を誤って上書きしてしまうリスクが解消されます。
関連ドキュメント
v2.1.143(2件)
英語原文を表示英語原文を閉じる
worktree.bgIsolation: "none" setting to let background sessions edit the working copy directly without EnterWorktree, for repos where worktrees are impractical変更後
worktreeをサポートしていない、あるいは非効率な開発環境でも、バックグラウンドでの並列作業が可能になります。
関連ドキュメント
英語原文を表示英語原文を閉じる
rm -rf when git worktree remove fails, preventing loss of gitignored or in-progress files変更後
誤操作やツールの不具合によって、手元の貴重なコードや設定ファイルが失われる心配がなくなります。
関連ドキュメント
v2.1.142(1件)
英語原文を表示英語原文を閉じる
v2.1.136(2件)
英語原文を表示英語原文を閉じる
--worktree 実行時に既存のワークツリーや不要な残存ファイルと衝突した際のエラーメッセージを改善しました。英語原文を表示英語原文を閉じる
--worktree collides with an existing or stale worktree変更後
Gitワークツリーを活用した並列作業時のトラブル解決が早まります。
関連ドキュメント
v2.1.133(1件)
英語原文を表示英語原文を閉じる
worktree.baseRef setting (fresh | head) to choose whether --worktree, EnterWorktree, and agent-isolation worktrees branch from origin/<default> or local HEAD. **Note:** the default fresh changes EnterWorktree's base back to origin/<default> (it has been local HEAD since 2.1.128) — set worktree.baseRef: "head" to keep unpushed commits in new worktrees変更後
未プッシュの変更を作業ツリーに引き継ぎたい場合に head を指定することで、作業の中断や隔離をスムーズに行えるようになります。
v2.1.119(2件)
isolation: "worktree" モードにおいて、以前のセッションの古いワークツリーが再利用されてしまう問題を修正しました英語原文を表示英語原文を閉じる
isolation: "worktree" reusing stale worktrees from prior sessions変更後
前の作業の影響を受けない独立した環境でサブエージェントが動作するため、コード生成やテストの再現性が向上し、予期せぬ副作用を防げます。
関連ドキュメント
英語原文を表示英語原文を閉じる
変更後
並行して複数のブランチを独立したディレクトリで作業するワークフローにおいても、Claude が PR の文脈を完全に理解して支援を継続できます。
v2.1.116(1件)
/update や /tui が機能しなくなる問題を修正英語原文を表示英語原文を閉じる
/update and /tui not working after entering a worktree mid-session変更後
作業ディレクトリの切り替えを伴う柔軟な開発ワークフローの中でも、Claude Code のすべての機能を一貫して利用し続けることができます。
関連ドキュメント
v2.1.105(4件)
英語原文を表示英語原文を閉じる
path parameter to the EnterWorktree tool to switch into an existing worktree of the current repository変更後
複数の作業ブランチをワークツリーで並行管理している場合に、既存の環境を即座に再利用できるため、作業の切り替えが高速化されます。
関連ドキュメント
英語原文を表示英語原文を閉じる
変更後
開発マシンのストレージ容量が無駄な一時ファイルで枯渇するのを防ぎ、環境を常にクリーンに保てます。
英語原文を表示英語原文を閉じる
英語原文を表示英語原文を閉じる
/resume, --worktree, or /branch変更後
複雑な作業の続きを再開する際のコマンドを覚えたりメモしたりする必要がなくなり、スムーズに作業に戻れます。
関連ドキュメント
v2.1.101(4件)
claude -w <name> で、過去のセッションのクリーンアップ失敗によりディレクトリが残っていると「already exists」エラーで失敗する問題を修正英語原文を表示英語原文を閉じる
claude -w <name> failing with "already exists" after a previous session's worktree cleanup left a stale directory変更後
クラッシュ後の再開や、同一名での繰り返し作業におけるワークフローの停止を防げます。
関連ドキュメント
英語原文を表示英語原文を閉じる
/resume ピッカーにおける多数の不具合(他プロジェクトのセッションが表示されない、Windows Terminalでの表示崩れ、ワークツリーでのパス異常など)を修正英語原文を表示英語原文を閉じる
/resume picker issues: narrow default view hiding sessions from other projects, unreachable preview on Windows Terminal, incorrect cwd in worktrees, session-not-found errors not surfacing in stderr, terminal title not being set, and resume hint overlapping the prompt input変更後
プロジェクトをまたいだ並行作業や、作業の中断・再開がより確実かつ快適になります。
英語原文を表示英語原文を閉じる
/remote-control failing over SSH when only CLAUDE_CODE_ORGANIZATION_UUID is set変更後
外出先からスマートフォン等で作業を依頼する際、より安定してセッションを維持・復旧できるようになります。
関連ドキュメント
v2.1.98(3件)
workspace.git_worktree フィールドを追加しました。現在のディレクトリが git worktree 内にある場合に値がセットされます。英語原文を表示英語原文を閉じる
workspace.git_worktree to the status line JSON input, set whenever the current directory is inside a linked git worktree変更後
複数の worktree を使って並行作業をしている開発者が、ターミナルの最下部を見るだけで「今どの作業空間にいるか」を一目で把握できるようになります。
関連ドキュメント
英語原文を表示英語原文を閉じる
/resume のフィルターヒントを改善し、フィルターインジケーターにプロジェクト名、ワークツリー名、ブランチ名を表示するようにしました。英語原文を表示英語原文を閉じる
/resume filter hint labels and added project/worktree/branch names in the filter indicator変更後
膨大なセッション履歴の中から、特定のプロジェクトや作業単位の記録を瞬時に見つけ出せるようになります。
v2.1.97(2件)
workspace.git_worktreeを追加しました。カレントディレクトリがリンクされたgit worktree内にある場合に設定されます。英語原文を表示英語原文を閉じる
workspace.git_worktree to the status line JSON input, set when the current directory is inside a linked git worktree変更後
並行して複数のタスクを進めている際に、今どの作業ブランチ(worktree)にいるかをステータスラインに正確に表示できるようになり、誤操作を防げます。
関連ドキュメント
cwd:オーバーライドを使用しているサブエージェントが、親セッションのBashツールに作業ディレクトリ情報を漏洩させてしまう問題を修正しました。英語原文を表示英語原文を閉じる
cwd: override leaking their working directory back to the parent session's Bash tool変更後
複数のディレクトリをまたぐ複雑な並行作業を、メイン環境を汚すことなく安全に実行できます。
関連ドキュメント
v2.1.94(1件)
--resume で同じリポジトリの別ワークツリーにあるセッションを直接再開できるよう改善英語原文を表示英語原文を閉じる
--resume to resume sessions from other worktrees of the same repo directly instead of printing a cd command変更後
複数の機能開発を並行して行っている際に、ワークツリー間をまたいだコンテキストの復元が迅速に行えます。
v2.1.85(1件)
英語原文を表示英語原文を閉じる
--worktree exiting with an error in non-git repositories before the WorktreeCreate hook could run変更後
Git以外のプロジェクト管理ツールを使用している開発者も、Claude Codeの強力な並行作業機能を活用できるようになります。
関連ドキュメント
v2.1.84(1件)
WorktreeCreate フックで作成されたパスの返却に対応英語原文を表示英語原文を閉じる
WorktreeCreate hook support for type: "http" — return the created worktree path via hookSpecificOutput.worktreePath in the response JSON変更後
独自のサーバーで管理している複雑なワークツリー作成フローをClaude Codeとシームレスに統合でき、並行作業の自動化がより強固になります。
v2.1.83(1件)
--worktree が無言で停止する問題を修正しました英語原文を表示英語原文を閉じる
--worktree hanging silently when the worktree name contained a forward slash変更後
標準的なブランチ命名規則をそのままワークツリー名に使用してもトラブルが発生せず、並行作業がスムーズに行えます。
関連ドキュメント
v2.1.81(1件)
英語原文を表示英語原文を閉じる
v2.1.78(1件)
--worktree フラグ使用時に、ワークツリーディレクトリ内のスキルやフックが読み込まれない問題を修正英語原文を表示英語原文を閉じる
--worktree flag not loading skills and hooks from the worktree directory変更後
複数の機能を並行して開発する際も、一貫した開発体験と自動化ツールを維持できます。
関連ドキュメント
v2.1.77(1件)
英語原文を表示英語原文を閉じる
v2.1.76(3件)
worktree.sparsePaths設定を追加 — 大規模なモノレポにおいて、git sparse-checkoutを使用して必要なディレクトリのみをチェックアウトできるようになりました英語原文を表示英語原文を閉じる
worktree.sparsePaths setting for claude --worktree in large monorepos to check out only the directories you need via git sparse-checkout変更後
モノレポでの開発効率が大幅に向上し、不必要なファイルの取得を避けることでセットアップ時間の短縮とディスク容量の節約が実現します。
関連ドキュメント
--worktree起動時のパフォーマンスを改善 — git refsを直接読み込むことで不要なgit fetchをスキップするように変更英語原文を表示英語原文を閉じる
--worktree startup performance by reading git refs directly and skipping redundant git fetch when the remote branch is already available locally変更後
並列作業を始めたい時に待たされる時間が短縮され、より軽快に作業環境を切り替えられます。
関連ドキュメント
英語原文を表示英語原文を閉じる
v2.1.72(1件)
英語原文を表示英語原文を閉じる
worktreePath and worktreeBranchv2.1.69(4件)
worktree フィールドを追加。ワークツリー名、パス、ブランチ等の情報を表示可能に英語原文を表示英語原文を閉じる
worktree field to status line hook commands with name, path, branch, and original repo directory when running in a --worktree session変更後
複数のワークツリーを使い分けている時に、誤った場所で変更を行ってしまうミスを防ぎ、コンテキストの把握を助けます。
関連ドキュメント
claude -w)関連ドキュメント
英語原文を表示英語原文を閉じる
--worktree startup by eliminating a git subprocess on the startup path関連ドキュメント
v2.1.64(2件)
claude remote-control server を追加しました。Git ワークツリーまたは同一ディレクトリによる分離をサポートします。英語原文を表示英語原文を閉じる
claude remote-control server for hosting multiple concurrent sessions with worktree or same-dir isolation変更後
複数のプロジェクトやブランチにまたがる作業を、リモートデバイスから並行して効率的に進めることができるようになります。
worktree フィールドを追加しました。--worktree セッション実行時に、名前、パス、ブランチ、元のリポジトリパスが表示可能です。英語原文を表示英語原文を閉じる
worktree field to status line hook commands with name, path, branch, and original repo directory when running in a --worktree session変更後
複数のワークツリーを使い分けて並行開発を行う際に、自分が今どこで作業しているのかを混同するリスクを大幅に減らせます。
関連ドキュメント
v2.1.63(1件)
英語原文を表示英語原文を閉じる
v2.1.53(1件)
--worktree オプションが初回起動時に無視されることがある問題を修正しました。英語原文を表示英語原文を閉じる
--worktree sometimes being ignored on first launch変更後
開発者は初回起動時から意図したworktree環境を確実に利用でき、作業の準備時間を短縮し、ワークフローをスムーズに進めることができます。
関連ドキュメント
v2.1.50(2件)
WorktreeCreateおよびWorktreeRemoveフックイベントが追加され、エージェントのワークツリー分離がワークツリーを作成または削除する際にカスタムVCSのセットアップとティアダウンが可能になりました。英語原文を表示英語原文を閉じる
WorktreeCreate and WorktreeRemove hook events, enabling custom VCS setup and teardown when agent worktree isolation creates or removes worktrees.変更後
VCSのセットアップとティアダウンを自動化することで、開発者はワークツリーのライフサイクル管理にかかる手間を省き、より効率的に開発を進めることができます。
関連ドキュメント
isolation: worktree をサポートし、エージェントが宣言的に分離されたgitワークツリーで実行できるようになりました。英語原文を表示英語原文を閉じる
isolation: worktree in agent definitions, allowing agents to declaratively run in isolated git worktrees.変更後
エージェントごとに独立した実行環境を用意できるため、依存関係の競合を防ぎ、よりクリーンで予測可能な開発フローを実現できます。
関連ドキュメント
v2.1.49(2件)
--worktree (-w) フラグが追加されました。英語原文を表示英語原文を閉じる
--worktree (-w) flag to start Claude in an isolated git worktree変更後
開発者は、メインブランチを汚すことなく、複数の機能開発やバグ修正を並行して安全に進めることができます。作業間のコンテキスト切り替えが容易になり、実験的な変更も気軽に試せるため、開発の効率と安全性が向上します。
isolation: "worktree"をサポートするようになりました。英語原文を表示英語原文を閉じる
isolation: "worktree" for working in a temporary git worktree変更後
サブエージェントを使用した大規模な変更や実験的なタスクを、より安全かつ独立して実行できるようになります。メインプロジェクトへの意図しない変更のリスクが低減され、サブエージェントは自信を持ってコードを変更・テストできるため、開発者は安心してAIにタスクを任せられるようになります。
関連ドキュメント
v2.1.47(3件)
英語原文を表示英語原文を閉じる
変更後
Windows環境でのワークツリーセッションの利用が改善され、ドライブレターの大文字・小文字の違いを気にすることなく、セッションを正しくマッチングできるようになりました。
.claude/agents/および.claude/skills/が含まれるようになりました(anthropics/claude-code#25816)。英語原文を表示英語原文を閉じる
.claude/agents/ and .claude/skills/ from the main repository are now included (anthropics/claude-code#25816)変更後
gitワークツリー環境でのカスタムエージェントとスキルの利用が改善され、開発者はワークツリー内でもプロジェクト固有の設定を正しく利用できるようになりました。
関連ドキュメント
英語原文を表示英語原文を閉じる
変更後
gitワークツリー環境でのバックグラウンドタスクの実行が安定し、リモートURL解決の正確性が向上しました。これにより、開発者はワークツリー内でもバックグラウンドタスクを確実に実行できます。
関連ドキュメント
v2.1.19(1件)
/rename や /tag が正しいセッションを更新しない問題を修正しました。英語原文を表示英語原文を閉じる
/rename and /tag not updating the correct session when resuming from a different directory (e.g., git worktrees)変更後
複数の作業ブランチや worktree を行き来しながら開発する際、セッション管理がより正確になり、プロジェクトの整理が容易になります。
v1.0.120(1件)
関連ドキュメント