Claude Code セットアップキットの機能
Claude Code セットアップキットは、プロジェクトのメモリ、エンジニアリングルール、ヘルパーエージェント、テスト、Lint、デプロイ時の安全対策を追加し、Claude Codeをより構造化された開発チームとして機能させます。事業主、バイブコーダー、ITプロフェッショナル、そしてClaude Codeをより規律正しく使いたい開発者向けに設計されています。
Claude Codeは、セッション間で重要なプロジェクトのコンテキストを忘れたり、一貫したガードレールなしで作業したり、壊れた変更を本番アプリケーションへ反映しようとしたりすることがあります。このキットは、1つのセットアップファイルから実用的なプロジェクト構成を生成することで、これらの問題に対処します。
新規リポジトリと既存リポジトリの両方で使用できます。特にCloudflare Workersに適していますが、Vercel、Node、Pythonなどのスタックにも対応します。
主な機能
- プロジェクトメモリ:
CLAUDE.mdとdocs/ディレクトリに、現在の状態、次の作業、決定事項を保存します。 - 開発ルール:
.claude/rules/内のファイルで、セキュリティ、テスト、クリーンコード、平易な言葉でのコミュニケーションに関する要件を定義します。 - 7つのヘルパーエージェント: より安価で高速なモデルが検索、構築、テスト、確認を担当し、メインモデルは計画とレビューに集中できます。
- リスクベースのレーン: 小規模、中規模、大規模の変更に対して、段階的に強化されたチェックを適用します。
- プッシュガード: 誤った送信先へのプッシュ、強制プッシュ、チェックに失敗した状態でのプッシュをブロックできます。
- 自動テストとLint: 変更がユーザーに届く前に確認します。
- ドキュメント更新:
/update-docsコマンドで、次のセッションのために進捗を記録します。 - オプション機能: 公開リポジトリへの情報漏えいチェック、すべてのプロジェクト向けの安全ネットとしてのプッシュガード、Claudeのセットアップ用バックアップと復元テストが含まれます。
セットアップキットをインストールする
ステップ1: セットアップファイルをダウンロードする
リポジトリでSETUP-CLAUDE-STRUCTURE.mdを開き、Download raw fileを選択します。最初に追加する必要があるファイルはこれだけです。
ステップ2: プロジェクトに配置する
SETUP-CLAUDE-STRUCTURE.mdをプロジェクトのルートフォルダーにコピーします。既存のリポジトリを使用することも、新しい空のフォルダーから始めることもできます。
ステップ3: Claude Codeを実行する
同じプロジェクトフォルダーでClaude Codeを開き、セットアップ手順に従うよう指示します。
Follow SETUP-CLAUDE-STRUCTURE.mdClaudeは5つの簡単な質問をし、計画を提示してから、構造変更を行う前に承認を待ちます。計画を確認し、準備ができたら明確に承認してください。
Claude Codeは
.claude/フォルダーを保護しているため、個別のファイルへの書き込み前に許可を求める場合があります。セットアップ操作を承認する場合はAllowを選択してください。
セットアップ中に行われること
Claudeはまずプロジェクトについて質問し、技術スタックを特定します。次に、アプリケーションの動作を変更するのではなく、既存のコードを中心に適切な構成を構築します。
このセットアップは、整理、ドキュメント、チェック、テストを追加することを目的としています。アプリケーションの動作は変更しません。すでにCLAUDE.mdファイルがある場合、Claudeはその内容を保持し、適切な場所へ移動したうえで、以前のバージョンをGit履歴に残します。
Cloudflare固有の要素は、該当しない場合はスキップされます。たとえばNodeまたはPythonのプロジェクトには、Cloudflare専用の設定ではなく、検出されたスタックに適したチェックとルールが適用されます。
基本的な使い方
新しい作業セッションを開始する
セットアップ後、プロジェクトディレクトリでClaude Codeを開き、完了したいタスクを説明します。生成されたプロジェクトメモリによって、現在の状態、今後の作業、過去の決定事項に関するコンテキストがClaudeに提供されます。
プロジェクトのドキュメントに記載されている次の機能の追加を手伝ってください。Claudeはプロジェクトのルールとリスクベースのレーンを使い、変更に必要な計画、実装、テスト、レビューの範囲を判断します。
小規模な変更を依頼する
限定的な変更の場合は、望む結果を明確に伝え、確認まで依頼します。
この小さなUIテキストの変更を行い、関連するチェックを実行して、変更内容を報告してください。小規模な作業はグリーンレーンで処理され、より大規模またはリスクの高い変更には、より広範なチェックが適用されます。
セッション間で進捗を記録する
作業セッションの最後にドキュメント更新コマンドを実行し、プロジェクトのメモリに最新の進捗を反映します。
/update-docsこれにより現在の状態が次のセッション用に保存され、Claudeは最初からやり直すのではなく、有用なコンテキストをもとに開始できます。
安全性と承認ルール
このキットは、明示的な承認と最小権限の原則に基づいて設計されています。
- Claudeは構造変更を行う前に確認します。
- プッシュによってアプリケーションが公開される可能性があるため、Claudeが確認なしにプッシュすることはありません。
- シークレット名はドキュメント化できますが、シークレットの値は保存されません。
- ルールにより、
.envや.dev.varsなどの機密ファイルをClaudeが開くことを禁止します。 - テストでは空のシークレットを使用するため、実際のサービスにアクセスできません。
- プッシュガードにより、強制プッシュ、誤った送信先へのプッシュ、チェック失敗時のプッシュを防止できます。
Claudeが保護されたセットアップファイルへのアクセス許可を求めた場合は、要求された操作を確認し、実行させる作業だけを承認してください。
高度なヒント
レーンを使って、リスクに応じたレビュー工数を設定する
3つのレーンは、軽量な変更管理システムだと考えてください。緑は小規模な変更、黄色は中規模な変更、赤は大規模な変更を表します。潜在的な影響が大きくなるほど、変更を準備完了とみなす前に、より多くの計画、検証、レビューが必要になります。
プロジェクトの記録を最新に保つ
長期プロジェクトの最後まで待つのではなく、重要な作業の後に/update-docsを使用してください。ドキュメントを最新に保つことで、今後のセッションの信頼性が高まり、決定事項を明確に確認できます。
公開中または稼働中のプロジェクトでは任意の安全対策を使用する
プロジェクトが公開されている場合は、任意の漏洩チェックを有効にすることを検討してください。誤ったデプロイが懸念されるプロジェクトでは、安全ネットとしてプッシュガードを使用してください。バックアップオプションを使うと、Claudeの設定を保持でき、テスト済みの復元手順も利用できます。
既存のプロバイダーや技術スタックに合わせてキットを調整する
このキットでは、1つのキーで複数のモデルにアクセスできるため、AIアプリケーション向けにOpenRouterを推奨していますが、特定のプロバイダーを強制するものではありません。プロジェクトですでに別のプロバイダーを使用している場合は、既存の選択がそのまま維持されます。
Windowsでは、プッシュガードはBashスクリプトです。WSLまたはGit Bashを使用し、必要なインストールについてはClaudeの案内に従ってください。
まとめ
Claude Code Setup Kitを使うと、自分で構成を設計しなくても、Claude Codeに再現性のあるプロジェクトワークフローを導入できます。1つのファイルをダウンロードしてプロジェクトに配置し、Claudeに従うよう指示するだけです。承認後は、永続的なプロジェクト記録、明確なルール、ヘルパーエージェント、リスクベースのレーン、自動チェック、ドキュメント更新、より安全なプッシュ動作を利用できます。
最新バージョンについては、リポジトリのCHANGELOG.mdを確認し、利用可能なリリースを確認してください。プロジェクトはCC BY 4.0ライセンスで提供されており、Abdo Samyへのクレジットとリポジトリへのリンクを付けることで、使用、共有、改変が認められています。