このディレクトリはClaude Codeのプラグイン管理設定を含みます。
config.json- カスタムプラグインリポジトリの設定known_marketplaces.json.template- マーケットプレイス設定のテンプレート（環境非依存）plugins.txt- インストールするプラグインのリストREADME.md- このドキュメント
known_marketplaces.json- 環境固有のマーケットプレイス設定（テンプレートから自動生成）installed_plugins.json- インストール済みプラグインのメタデータ（環境依存）marketplaces/- マーケットプレイスからダウンロードされたプラグイン実体repos/- カスタムリポジトリのプラグイン
known_marketplaces.json.templateでマーケットプレイスを定義します。{{HOME}}プレースホルダーを使用することで、macOS/Linux/DevContainer環境すべてで動作します：
{
"claude-code-plugins": {
"source": {
"source": "github",
"repo": "anthropics/claude-code"
},
"installLocation": "{{HOME}}/.claude/plugins/marketplaces/claude-code-plugins"
}
}setup-claude.sh実行時に、テンプレートから環境固有のknown_marketplaces.jsonが自動生成されます。
.claude/settings.local.json（git管理対象外）でどのプラグインを有効にするか設定：
{
"enabledPlugins": {
"frontend-design@claude-code-plugins": true,
"feature-dev@claude-code-plugins": true
}
}リポジトリの自動セットアップスクリプトを使用：
# すべてセットアップ（設定同期 + プラグインインストール）
make claude-setup
# または、プラグインのみインストール
make claude-pluginsこのコマンドにより：
- リポジトリの
plugins.txtとknown_marketplaces.json.templateを~/.claude/plugins/にコピー - テンプレートから環境固有の
known_marketplaces.jsonを生成 - 必要なマーケットプレイスを自動追加
plugins.txtに記載されたすべてのプラグインをインストール
-
マーケットプレイス設定の生成
# テンプレートから環境固有の設定を生成 sed "s|{{HOME}}|${HOME}|g" .claude/plugins/known_marketplaces.json.template > ~/.claude/plugins/known_marketplaces.json
-
マーケットプレイスの追加
claude plugin marketplace add anthropics/claude-plugins-official claude plugin marketplace add wshobson/agents
-
プラグインのインストール
# 個別インストール claude plugin install commit-commands@claude-plugins-official # または一括インストール make claude-plugins
現在このリポジトリで管理されているマーケットプレイス：
- anthropics/claude-code (
claude-code-plugins) - 公式Claude Codeプラグイン - anthropics/claude-plugins-official (
claude-plugins-official) - 公式プラグイン（commit-commands, hookify, etc.） - davila7/claude-code-templates (
claude-code-templates) - コミュニティテンプレート - wshobson/agents (
claude-code-workflows) - ワークフロー自動化プラグイン - supabase/agent-skills (
supabase-agent-skills) - Supabase/PostgreSQL開発ベストプラクティス - vercel-labs/agent-browser (
agent-browser) - ブラウザ自動化（テスト、フォーム、スクリーンショット） - intellectronica/agent-skills (
intellectronica-skills) - ライブラリ・フレームワークの最新ドキュメント - anthropics/skills (
anthropic-agent-skills) - Anthropic公式スキル - lackeyjb/playwright-skill (
playwright-skill) - Playwright自動化スキル
開発効率向上のために以下のプラグインを推奨：
frontend-design@claude-code-plugins- フロントエンド設計支援feature-dev@claude-code-plugins- 機能開発サポートsecurity-guidance@claude-code-plugins- セキュリティガイダンスjavascript-typescript@claude-code-workflows- JS/TS開発ワークフロー
Docker イメージのビルド時にプラグインをインストールするには、BuildKit の secret 機能を使用します。
# ANTHROPIC_API_KEY を環境変数として設定してビルド
DOCKER_BUILDKIT=1 docker build \
--secret id=anthropic_api_key,env=ANTHROPIC_API_KEY \
-f .devcontainer/Dockerfile \
-t config-base .
# または、ファイルから読み込む場合
echo "your-api-key" > /tmp/anthropic_key
DOCKER_BUILDKIT=1 docker build \
--secret id=anthropic_api_key,src=/tmp/anthropic_key \
-f .devcontainer/Dockerfile \
-t config-base .
rm /tmp/anthropic_key--secretを使用することで、API キーがイメージレイヤーに残りません- API キーを
--build-argで渡さないでください（履歴に残ります） - ビルド後、一時ファイルは必ず削除してください
API キーを指定しない場合、プラグインのインストールはスキップされます：
docker build -f .devcontainer/Dockerfile -t config-base .この場合、コンテナ起動後に手動でインストールできます：
make claude-plugins- マーケットプレイスが正しく追加されているか確認
- Claude Codeを再起動
~/.claude/plugins/installed_plugins.jsonを削除して再インストール
claude marketplace update
claude plugin update <plugin-name>@<marketplace>症状:
Hookify import error: No module named 'hookify'
原因:
hookify プラグインの Python モジュール構造の問題により、絶対インポート（from hookify.core.config_loader）が失敗します。
解決方法:
setup-claude.sh は自動的にこの問題を修正します。手動で修正する場合：
# マーケットプレイスのhookifyプラグインにパッチを適用
cd ~/.claude/plugins/marketplaces/claude-code-plugins/plugins/hookify
find . -name "*.py" -type f -exec sed -i '' \
-e 's/from hookify\.core/from core/g' \
-e 's/from hookify\.utils/from utils/g' \
-e 's/from hookify\.matchers/from matchers/g' \
{} \;
# プラグインを再インストール
claude plugin uninstall hookify@claude-code-plugins
claude plugin install hookify@claude-code-plugins注意: マーケットプレイスの更新後は、再度パッチの適用が必要になる場合があります。make claude-plugins を実行すれば自動的にパッチが適用されます。