Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

パーシャルクローンリポジトリ（Scalar/GVFS）で起動時に大量のblobダウンロードが発生する起動パフォーマンスの問題を修正しました。

原文（英語） ​

Fixed a startup performance issue where partial clone repositories (Scalar/GVFS) triggered mass blob downloads

概要 ​

Scalar や GVFS（Git Virtual File System）を使用したパーシャルクローンリポジトリ（大規模リポジトリを部分的にクローンする技術）で Claude Code を起動すると、不必要に大量の Git blob（ファイルデータ）がダウンロードされる問題がありました。これにより起動が著しく遅くなり、特に大規模なエンタープライズリポジトリで影響が顕著でした。v2.1.84でこの問題が修正されました。

基本的な使い方 ​

パーシャルクローンリポジトリでも通常通り Claude Code を起動できます。修正後は不要な blob ダウンロードが抑制されます。

bash
# Scalar を使用したリポジトリの場合
cd /path/to/scalar-repo
claude  # v2.1.84以降は起動が速くなります

実践例 ​

ユースケース: 大規模エンタープライズリポジトリでの利用 ​

Microsoft の Scalar（旧 GVFS）を使用した大規模リポジトリ：

bash
# Scalar でクローンしたリポジトリ
scalar clone https://github.com/large-org/large-repo

# v2.1.84以前では起動時に大量のファイルをダウンロードしてしまう
# v2.1.84以降では必要なファイルのみアクセスされる
cd large-repo
claude

ユースケース: CI/CD環境でのパーシャルクローン使用 ​

bash
# GitHub Actions などで sparse checkout を使用している場合
git clone --filter=blob:none --sparse https://github.com/org/repo
cd repo
git sparse-checkout set src/ tests/

# Claude Codeを起動しても必要なファイルのみダウンロードされます
claude

注意点 ​

  • この修正は Scalar および GVFS を使用するリポジトリに特化した最適化です
  • 通常のフルクローンリポジトリには影響しません
  • パーシャルクローンを使用している場合でも、Claude が実際にファイルにアクセスする際は必要に応じてダウンロードが行われます

関連情報 ​