Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

Windows での worktree ファイルコピーを修正しました

原文（英語） ​

Fixed worktree file copy on Windows

概要 ​

claude -w（--worktree フラグ）を使用して git worktree を作成する際、Windows 環境でファイルコピーが正常に動作しないバグがありました。Linux/macOS では問題なく動作していましたが、Windows 固有のファイルシステムの違い（パス区切り文字やファイルアクセス権限など）により、worktree の初期化時にファイルのコピーに失敗していました。修正後は Windows でも worktree が正しく作成されます。

基本的な使い方 ​

powershell
# Windows の PowerShell または Command Prompt で
claude --worktree
# または
claude -w

# 修正後: Windows でも正しく worktree が作成される

実践例 ​

Windows での worktree 作成 ​

powershell
# Windows で Claude Code を起動（worktree モード）
cd C:\Users\username\projects\my-app
claude --worktree

# 修正後の動作:
# 1. git worktree が正しく作成される
# 2. 必要なファイルがコピーされる
# 3. worktree 内で Claude Code が正常に起動

# 修正前の動作:
# 1. worktree の作成を試みる
# 2. ファイルコピーでエラー発生
# 3. Claude Code が起動できない

Windows Subsystem for Linux（WSL）との比較 ​

bash
# WSL（Linux 環境）では以前から動作していた
wsl
cd /home/username/projects/my-app
claude --worktree  # ← WSL では問題なし

# ネイティブ Windows では今回の修正で動作するようになった
# (PowerShell や CMD から直接実行)

worktree 機能の基本的な使い方（Windows） ​

powershell
# プロジェクトディレクトリに移動
cd C:\Projects\my-repo

# worktree でインタラクティブセッションを開始
claude -w

# Claude Code 内でタスクを依頼
# > このモジュールをリファクタリングして

# セッション終了後、worktree はクリーンアップされる

注意点 ​

  • この修正は Windows ネイティブ環境（PowerShell, CMD）での問題に対するものです
  • WSL（Windows Subsystem for Linux）では以前から動作していました
  • Windows のパス区切り文字（\ vs /）や長いパス名の制限が原因でした
  • Windows で git worktree を使用するには git for Windows がインストールされている必要があります

関連情報 ​