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.76 (1件)

Added
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)」が可能になり、必要なファイルだけを作業ツリーに含めることができます。

ユーザーへの恩恵

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

関連ドキュメント