Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

--worktree フラグがワークツリーディレクトリからスキルとフックを読み込まない問題を修正しました。

原文（英語） ​

Fixed --worktree flag not loading skills and hooks from the worktree directory.

概要 ​

--worktree フラグを使用してGitワークツリーでClaude Codeを起動した場合、そのワークツリーディレクトリに配置されたスキルファイルやフック設定が読み込まれないバグが修正されました。修正後は、ワークツリー固有のスキルとフックが正しく認識されます。

基本的な使い方 ​

bash
# ワークツリーで Claude Code を起動
claude --worktree /path/to/worktree

# 修正後: /path/to/worktree/.claude/ 内のスキルとフックが読み込まれる

実践例 ​

ユースケース: 機能ブランチ別のスキル設定 ​

複数の機能ブランチを別々のワークツリーで管理する場合：

main-project/
├── .git/
├── .claude/
│   └── skills/          ← メインブランチのスキル
├── src/
└── worktrees/
    └── feature-branch/
        ├── .claude/
        │   └── skills/  ← ワークツリー固有のスキル（修正後に読み込まれる）
        └── src/
bash
# feature-branchのワークツリーで起動
claude --worktree worktrees/feature-branch

# 修正後: worktrees/feature-branch/.claude/skills/ のスキルが使用可能

ユースケース: ワークツリー別のフック設定 ​

bash
# ワークツリーの .claude/hooks/ にフックを配置
mkdir -p worktrees/feature-branch/.claude/hooks

# フックファイルを作成
cat > worktrees/feature-branch/.claude/hooks/post-tool.sh << 'EOF'
#!/bin/bash
echo "ワークツリー固有のフック実行"
EOF

# ワークツリーで起動すると、このフックが読み込まれる
claude --worktree worktrees/feature-branch

注意点 ​

  • 修正前は --worktree を指定しても、メインリポジトリのスキルとフックのみが使用されていました
  • ワークツリー固有の .claude/ ディレクトリが存在する場合のみ、ワークツリーのスキルとフックが使用されます
  • メインリポジトリのスキルとフックとの優先順位は、ワークツリーの設定が優先されます

関連情報 ​