Claude Codeでチーム開発を加速する実践ガイド

Claude Codeは個人開発で力を発揮するツールですが、チーム導入することでさらに大きな効果を生みます。本記事では、チーム全体で使うときに押さえておきたい設定・運用ノウハウを解説します。

1. CLAUDE.md をチーム共通の規約にする

最も重要なのは、プロジェクトルートの CLAUDE.md をチーム全員で共有することです。Gitで管理して、メンバー全員が同じコンテキストでClaude Codeを使えるようにします。

# プロジェクト共通規約

## 技術スタック
- TypeScript 5.4
- Next.js 15
- Prisma + PostgreSQL

## コーディング規約
- 関数は async/await を使う（Promise.then は避ける）
- import は絶対パス（@/...）
- テストは Vitest

## 命名規則
- コンポーネント: PascalCase
- フック: useXxx
- 定数: SCREAMING_SNAKE

## PRルール
- 1PR = 1機能
- テストカバレッジ80%以上

これだけで、メンバー全員が「同じ方針で書くClaude Code」を使えます。詳しくは CLAUDE.md ベストプラクティス を参照。

2. 個人設定とチーム設定を分ける

.claude/settings.json はチーム共有、.claude/settings.local.json は個人用、と使い分けます。

.claude/
├── settings.json          # チーム共有（git管理）
└── settings.local.json    # 個人用（.gitignore）

settings.json の例:

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(npm test)",
      "Bash(git diff)",
      "Bash(git status)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push --force)"
    ]
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npx prettier --write $CLAUDE_FILE_PATH" }
        ]
      }
    ]
  }
}

.gitignore には以下を必ず追加:

.claude/settings.local.json

3. PRレビューを自動化する

GitHub ActionsとClaude Codeを組み合わせると、PR作成時に自動レビューが走ります。

name: Claude Auto Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
      - name: Run review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          gh pr diff ${{ github.event.pull_request.number }} | \
            claude -p "セキュリティ・パフォーマンス・可読性の観点でレビューし、問題があれば指摘してください"

人間のレビュアーの負担が大幅に減り、PRがマージされるまでの時間が短縮されます。

4. プロンプトテンプレートを共有する

チームで使うプロンプトを .claude/prompts/ に集約しておくと、誰でもすぐに使えます。

.claude/prompts/
├── code-review.md
├── refactor-function.md
├── write-test.md
└── update-docs.md

例: code-review.md

このファイルをレビューしてください。

観点:
1. バグの可能性
2. セキュリティリスク
3. パフォーマンス問題
4. 命名や可読性
5. テストカバレッジ

問題があれば重要度（高/中/低）を付けて報告してください。

メンバーは claude < .claude/prompts/code-review.md のように呼び出せます。

5. オンボーディングを自動化する

新人メンバーのオンボーディングにもClaude Codeが活躍します。

claude -p "
このプロジェクトの構造を解説してください。
特に以下を中心に説明:
- ディレクトリ構成
- 主要な技術スタック
- 開発フロー（ローカル起動・テスト・デプロイ）
- 注意すべきポイント

新人メンバーが最初に読むドキュメントとして書いてください。
"

これだけで、入社1日目で全体像を把握できる資料が手に入ります。詳しい活用法は サブエージェント活用パターン も参考に。

6. コミットメッセージを統一する

チーム全員でConventional Commitsに揃えるなら、CLAUDE.mdに以下を追記します。

## コミットメッセージ規約
すべてのコミットメッセージはConventional Commits形式で書くこと。

形式: type(scope): subject

type:
- feat: 新機能
- fix: バグ修正
- docs: ドキュメント
- style: フォーマット
- refactor: リファクタリング
- test: テスト追加・修正
- chore: その他

例: feat(auth): JWTリフレッシュトークンを実装

これでClaude Codeが自動でこの形式のメッセージを生成するようになります。

7. 知見を全員で共有する

Claude Codeを使っていて得た「効くプロンプト」「ハマった点」をチームのドキュメントに集約しましょう。Notion、Confluence、社内Wiki、なんでも構いません。

ハマりどころメモの例:

• /clear は完全リセット、/compact は要約。長時間セッションは /compact を優先
• 大量ファイル探索はサブエージェントに任せると速い
• テストが失敗したら、まずエラーログをそのまま貼る

まとめ

• CLAUDE.md でチーム規約を統一
• 個人設定と共有設定を分離
• GitHub Actions でPRレビューを自動化
• プロンプトテンプレートを共有
• オンボーディングもClaude Codeで自動化
• コミット規約も統一できる
• 知見はチームで蓄積する

Claude Codeを「個人の道具」から「チームの武器」に進化させると、開発スピードが何倍にもなります。公式ドキュメントは Anthropic Claude Code を参照してください。