Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

Gitリポジトリ内のサブディレクトリを指すプラグインソースタイプ git-subdir を追加

原文（英語） ​

Added plugin source type git-subdir to point to a subdirectory within a git repo

概要 ​

git-subdir はプラグインのインストール元として、Gitリポジトリのサブディレクトリを指定できる新しいソースタイプです。これにより、複数のプラグインやツールを1つのリポジトリにまとめて管理し、必要なプラグインだけを個別にインストールできます。

基本的な使い方 ​

プラグイン設定でソースタイプとして指定：

json
{
  "plugins": [
    {
      "source": {
        "type": "git-subdir",
        "url": "https://github.com/my-org/claude-plugins",
        "subdir": "plugins/code-reviewer"
      }
    }
  ]
}

実践例 ​

モノレポからプラグインをインストール ​

json
{
  "plugins": [
    {
      "source": {
        "type": "git-subdir",
        "url": "https://github.com/my-company/internal-tools",
        "subdir": "claude-plugins/code-reviewer"
      }
    },
    {
      "source": {
        "type": "git-subdir",
        "url": "https://github.com/my-company/internal-tools",
        "subdir": "claude-plugins/test-runner"
      }
    }
  ]
}

特定ブランチ・タグを指定 ​

json
{
  "plugins": [
    {
      "source": {
        "type": "git-subdir",
        "url": "https://github.com/my-org/claude-plugins",
        "subdir": "security-scanner",
        "ref": "v2.1.0"
      }
    }
  ]
}

プラグインコレクションリポジトリの構造例 ​

claude-plugins/
├── code-reviewer/
│   ├── SKILL.md
│   └── index.js
├── test-generator/
│   ├── SKILL.md
│   └── index.js
└── doc-writer/
    ├── SKILL.md
    └── index.js

このような構造のリポジトリに対して、各サブディレクトリを個別のプラグインとして参照できます。

注意点 ​

  • git-subdir タイプを使うには、対象リポジトリへのアクセス権が必要です（プライベートリポジトリの場合はSSHキーやトークンが必要）
  • サブディレクトリはプラグインのルートディレクトリとして扱われます（SKILL.md や設定ファイルが必要）
  • strictKnownMarketplaces 設定と組み合わせて、許可するリポジトリを制限できます

関連情報 ​