settings.json

sparsePaths

git sparse-checkoutを使用して、作業ツリーにチェックアウトするディレクトリを指定します。大規模なモノレポでの速度向上に役立ちます。

使い方・用途

  • 超大規模なモノレポにおいて、--worktree フラグ使用時にリポジトリ全体ではなく必要なパスのみを「疎なチェックアウト」することで、セットアップ時間の短縮とディスク容量の節約を実現します。
英語原文(公式ドキュメントより)

Directories to check out in each worktree via git sparse-checkout (cone mode). Only the listed paths are written to disk, which is faster in large monorepos. See https://code.claude.com/docs/en/settings#worktree-settings

関連ドキュメント

関連する変更履歴

v2.1.207(1件)

Fixed
Settings
worktree.sparsePathsを使用した最後のワークティが削除された後、リポジトリの.git/configにextensions.worktreeConfigが残ってしまう問題を修正しました。
英語原文を表示
Fixed extensions.worktreeConfig being left in the repo's .git/config (breaking go-git tools like tea) after the last worktree.sparsePaths worktree was removed

変更前

並列作業用のワークツリーを削除した後もGitの設定ファイル（.git/config）に不要なエントリが残り続け、これが原因でteaなどのgo-gitベースのツールが正常に動作しなくなることがありました。

変更後

ワークツリーのクリーンアップ処理が改善され、関連するGit設定も適切に削除されるようになりました。

ユーザーへの恩恵

Claude Codeを使用した並列開発を行っても他の開発ツールと干渉しなくなり、既存の開発環境を壊す心配がなくなります。

関連ドキュメント

v2.1.76(1件)

Added
Settings
worktree.sparsePaths設定を追加 — 大規模なモノレポにおいて、git sparse-checkoutを使用して必要なディレクトリのみをチェックアウトできるようになりました
英語原文を表示
Added worktree.sparsePaths setting for claude --worktree in large monorepos to check out only the directories you need via git sparse-checkout

変更前

--worktreeフラグを使用するとリポジトリ全体がチェックアウトされるため、超大規模なリポジトリではディスク容量の消費や初期化に時間がかかっていました。

変更後

この設定により、特定のパスのみを対象とする「疎なチェックアウト(sparse-checkout)」が可能になり、必要なファイルだけを作業ツリーに含めることができます。

ユーザーへの恩恵

モノレポでの開発効率が大幅に向上し、不必要なファイルの取得を避けることでセットアップ時間の短縮とディスク容量の節約が実現します。

関連ドキュメント