Claude Code テンプレート

Claude Code (claude.ai/code) を効率的に利用するためのプロジェクト設定テンプレートです。

特徴

• Serena MCP Server 統合によるAI支援開発
• セキュリティファースト アプローチ
• Docusaurus 統合ドキュメントサーバー
• GitLab CI/CD によるセキュリティ自動化
• ドキュメントファースト 開発ワークフロー

クイックスタート

1. テンプレートの複製

# GitLabからクローン
git clone https://gitlab.com/future-techno-developers/public/claude-template.git your-project-name
cd your-project-name

2. Serena MCP Server のセットアップ

# Serena MCP Server のインストール
uvx --from git+https://github.com/oraios/serena serena start-mcp-server

# プロジェクトのインデックス化
uvx --from git+https://github.com/oraios/serena serena project index

3. Claude Desktop の設定

Claude Desktop の設定ファイル（~/Library/Application Support/Claude/claude_desktop_config.json）に MCP サーバーを登録：

{
  "mcpServers": {
    "serena": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server"]
    }
  }
}

4. プロジェクト設定のカスタマイズ

# テンプレートファイルをコピーしてカスタマイズ
cp CLAUDE_TEMPLATE.md CLAUDE.md
# CLAUDE.md を編集してプロジェクト固有の設定に変更

5. ドキュメントサーバーの起動

cd docs
npm install
npm start

ドキュメント

詳細な設定方法とベストプラクティスについては、統合ドキュメントサーバーをご確認ください：

• ローカル: http://localhost:3000 (npm start 実行後)
• オンライン: テンプレートドキュメント

主要ドキュメント

• はじめに - テンプレートの概要と使い方
• テンプレート設定ガイド - 詳細なセットアップ手順
• ベストプラクティス - Claude Code の効果的な活用方法
• セキュリティガイドライン - セキュアな開発のためのガイドライン

必要な環境

• Claude Desktop: MCP対応版
• Python: 3.13+ (Serena MCP Server用)
• uvx: Python パッケージマネージャー
• Node.js: 18.0以上 (Docusaurusドキュメント用)
• Git: バージョン管理

プロジェクト構造

claude-template/
├── docs/                        # Docusaurusドキュメントサーバー
│   ├── docs/                    # ドキュメントファイル
│   ├── blog/                    # ブログ記事
│   ├── src/                     # Reactコンポーネント
│   ├── static/                  # 静的ファイル
│   ├── docusaurus.config.ts     # Docusaurus設定
│   └── package.json             # Node.js依存関係
├── .serena/                     # Serena MCP Server設定
├── .gitlab-ci.yml               # CI/CDセキュリティ設定
├── CLAUDE_TEMPLATE.md           # テンプレートファイル
├── CLAUDE.md                    # プロジェクト固有設定
└── README.md                    # このファイル

セキュリティ

このテンプレートは防御的セキュリティを重視しています：

• ✅ セキュリティツール開発、脆弱性検出、防御機能実装
• ❌ 攻撃ツール作成、資格情報収集、悪意のあるコード開発

GitLab CI/CD による自動セキュリティチェック：

• SAST (Static Application Security Testing)
• Secret Detection (シークレット検出)

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。

貢献

プロジェクトへの貢献を歓迎します！以下の手順でお願いします：

1. このリポジトリをフォーク
2. 機能ブランチを作成 (git checkout -b feature/amazing-feature)
3. 変更をコミット (git commit -m 'Add some amazing feature')
4. ブランチをプッシュ (git push origin feature/amazing-feature)
5. マージリクエストを作成

サポート

• GitLab Issues: 課題報告・機能要望
• ドキュメント: 統合ドキュメントサーバーの FAQ・トラブルシューティング
• Claude Code: 公式ドキュメント

作者

• Future Techno Developers - 初期開発 - @future-techno-developers

謝辞

• Claude Code - AI支援開発プラットフォーム
• Serena MCP Server - コード解析ツール
• Docusaurus - ドキュメントサーバーフレームワーク