Skip to content

using-config-base-image.md

Latest commit

 

History

History
194 lines (141 loc) · 6.29 KB

using-config-base-image.md

File metadata and controls

194 lines (141 loc) · 6.29 KB

config-base イメージの使用方法

概要

ghcr.io/keito4/config-base イメージは、Claude Code の完全なセットアップを含む DevContainer イメージです。新しいリポジトリでこのイメージを使用することで、以下がすぐに利用可能になります：

  • Claude Code CLI と設定
  • 事前インストールされたプラグイン
  • カスタムコマンド（/config-base-sync-check, /security-credential-scan など）
  • カスタムエージェント（DDD, パフォーマンス分析など）
  • Git hooks（Quality Gates）
  • 開発ツール（Node.js, pnpm, Rust, terraform, aws-cli など）

推奨構成（DevContainer用）

新しいリポジトリで使用する場合の推奨設定：

// .devcontainer/devcontainer.json
{
  "name": "My Project",
  "image": "ghcr.io/keito4/config-base:latest",
  "remoteEnv": {
    "TMPDIR": "/home/vscode/.claude/tmp"
  }
}

重要: ホストの ~/.claude をマウントしないことで、イメージに含まれている設定がそのまま使えます。

📝 上記の構成をそのまま .devcontainer/devcontainer.json として使用できます。

この構成では以下がすぐに利用できます：

  • 事前インストールされたプラグイン
  • カスタムコマンド
  • カスタムエージェント
  • Git hooks

利用可能なコマンド

# Claude Code コマンド
claude --help

# カスタムコマンド
/config-base-sync-check      # イメージバージョン確認
/security-credential-scan    # 認証情報スキャン
/code-complexity-check       # コード複雑度チェック
/dependency-health-check     # 依存関係ヘルスチェック
/pre-pr-checklist           # PR前チェックリスト
# その他多数...

プラグイン

以下のプラグインが事前インストールされています：

公式プラグイン (claude-plugins-official):

  • commit-commands - Git commit 関連のコマンド
  • hookify - Git hooks の管理
  • plugin-dev - プラグイン開発ツール
  • typescript-lsp - TypeScript 言語サーバー
  • code-review - コードレビュー支援

ワークフロープラグイン (claude-code-workflows):

  • code-refactoring - リファクタリング支援
  • kubernetes-operations - Kubernetes 運用
  • javascript-typescript - JavaScript/TypeScript 開発
  • backend-development - バックエンド開発
  • full-stack-orchestration - フルスタック開発オーケストレーション
  • database-design - データベース設計
  • database-migrations - データベースマイグレーション

高度な構成（ホスト設定の永続化）

プラグインの追加インストールや設定のカスタマイズを永続化したい場合：

// .devcontainer/devcontainer.json
{
  "name": "My Project",
  "image": "ghcr.io/keito4/config-base:latest",
  "remoteEnv": {
    "TMPDIR": "/home/vscode/.claude/tmp"
  },
  "initializeCommand": "mkdir -p ~/.claude",
  "mounts": ["source=${localEnv:HOME}/.claude,target=/home/vscode/.claude,type=bind,consistency=cached"],
  "postCreateCommand": "/usr/local/bin/setup-claude.sh"
}

注意: この構成では：

  • ホストの ~/.claude をマウントすると、イメージの設定が上書きされます
  • setup-claude.sh がイメージの設定をホスト側にコピーします
  • ホスト側の設定が優先されるため、存在しないプラグインのエラーが出る可能性があります
  • DevContainer 専用で使う場合は、マウントなしの構成を推奨します

プロジェクト固有の設定を追加

プロジェクト固有のコマンドやプラグインを追加する場合：

1. リポジトリに .claude/ ディレクトリを作成

mkdir -p .claude/commands
mkdir -p .claude/plugins

2. プロジェクト固有のコマンドを追加

<!-- .claude/commands/my-custom-command.md -->

# My Custom Command

プロジェクト固有のコマンド説明...

3. プロジェクト固有のプラグインを追加

# .claude/plugins/plugins.txt
# プロジェクト固有のプラグイン
my-plugin@marketplace

4. devcontainer.json を更新

{
  "name": "My Project",
  "image": "ghcr.io/keito4/config-base:latest",
  "remoteEnv": {
    "TMPDIR": "/home/vscode/.claude/tmp"
  },
  "initializeCommand": "mkdir -p ~/.claude",
  "mounts": ["source=${localEnv:HOME}/.claude,target=/home/vscode/.claude,type=bind,consistency=cached"],
  "postCreateCommand": "/usr/local/bin/setup-claude.sh"
}

setup-claude.sh は以下を自動的に行います：

  • リポジトリの .claude/commands/ を ~/.claude/commands/ にコピー
  • リポジトリの .claude/plugins/plugins.txt からプラグインをインストール

イメージのビルドとリリース

このリポジトリでイメージをビルドする場合：

# ローカルビルド（認証情報を使用）
DOCKER_BUILDKIT=1 docker build \
  --secret id=claude_credentials,src=$HOME/.claude/.credentials.json \
  -t ghcr.io/keito4/config-base:local \
  -f .devcontainer/Dockerfile \
  .

# GitHub Actions でのビルド（自動）
# main ブランチへのプッシュで自動的にビルド・リリース
git push origin main

トラブルシューティング

プラグインがインストールされていない

イメージビルド時に認証情報がない場合、プラグインのインストールがスキップされます。コンテナ起動後に手動でインストールしてください：

claude plugin install <plugin>@<marketplace>

hooks が動作しない

setup-claude.sh を実行してhookifyパッチを適用してください：

/usr/local/bin/setup-claude.sh

設定が反映されない

マウント設定により、ホストの ~/.claude がイメージの内容を上書きしている可能性があります。postCreateCommand で setup-claude.sh を実行することで、イメージの設定をホスト側にコピーできます。

参考情報