settings.json

worktree.sparsePaths

型string[]記述場所どの設定ファイルでも可

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

記述例

{
  "worktree": {
    "sparsePaths": ["packages/my-app", "shared/utils"]
  }
}

使い方・用途

  • 超大規模なモノレポにおいて、--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.284(1件)

Fixed
古い git(2.39 未満)で sparsePaths プラグインマーケットプレイスが空のクローンを作成し、動作していたローカルコピーを置き換え、「marketplace.json file is no longer present」で毎回リフレッシュが失敗する問題を修正した。
英語原文を表示
Fixed sparsePaths plugin marketplaces cloning empty and replacing a working local copy on older git (before 2.39), which failed every refresh with "marketplace.json file is no longer present"

関連ドキュメント

v2.1.207(1件)

Fixed
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

変更後

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

関連ドキュメント

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

変更後

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

関連ドキュメント