Claude Codeチーム開発ガイド：CLAUDE.md共有とサブエージェント活用法

AIを知りたい

Claude Codeって一人で使うものだと思ってたんですが、チームで使う機能もあるんですか？

AIエンジニア

はい！Claude Codeにはチーム開発を強力にサポートする機能がいくつかあります。共有設定ファイルやサブエージェントを活用したチーム連携が可能です。

AIを知りたい

具体的にどんな機能があるんですか？

AIエンジニア

主にCLAUDE.mdの共有、MCPサーバーの共通設定、そしてサブエージェントによる並列作業ですね。

Claude Codeのチーム機能とは

Claude Codeのチーム機能とは、複数の開発者が一貫した設定と方針でClaude Codeを活用するための仕組みです。プロジェクトルートのCLAUDE.mdファイルでコーディング規約やプロジェクト固有の指示を共有し、チーム全体のAI活用品質を均一化します。

CLAUDE.mdによるチーム設定の共有

AIを知りたい

CLAUDE.mdをチームで共有するメリットって何ですか？

AIエンジニア

チーム全員が同じルールでClaude Codeを使えるようになります。コーディング規約、テスト方針、コミットルールなどを統一できます。

チーム用CLAUDE.mdの設定例：

# プロジェクト規約

## コーディングルール
- TypeScriptを使用し、anyの使用を禁止
- 関数には必ずJSDocコメントを付与
- テストカバレッジ80%以上を維持
- コンポーネントはfunction宣言で記述

## Git規約
- コミットメッセージはConventional Commits形式
- PRにはテスト結果のスクリーンショットを添付
- main直pushは禁止、必ずPR経由

## テスト方針
- ユニットテストはVitest使用
- E2EテストはPlaywright使用
- テストファイル名は*.test.tsとする

CLAUDE.mdの階層構造

AIを知りたい

CLAUDE.mdって複数置けるんですか？

AIエンジニア

はい！ディレクトリごとにCLAUDE.mdを配置できます。Claude Codeは作業ディレクトリから親方向にすべてのCLAUDE.mdを読み込みます。

ファイル スコープ 用途
~/.claude/CLAUDE.md ユーザー全体 個人の共通設定
プロジェクトルート/CLAUDE.md プロジェクト全体 チーム共有のルール
src/CLAUDE.md srcディレクトリ ソースコード固有の規約
tests/CLAUDE.md testsディレクトリ テスト固有の方針

サブエージェントによる並列作業

AIを知りたい

複数のClaude Codeインスタンスを同時に使うことはできますか？

AIエンジニア

Claude Codeはサブエージェント機能で複数タスクを並列実行できます。異なるファイルの修正を同時に進めたり、テストとコード修正を並行して行えます。

並列作業の例：

# メインのClaude Codeから指示
「以下のタスクを並列で実行してください：
1. src/auth/login.tsのバグ修正
2. src/api/users.tsに新しいエンドポイント追加
3. tests/auth.test.tsのテスト更新」

# Claude Codeは内部でサブエージェントを起動し
# 3つのタスクを同時に処理します

MCPサーバーのチーム共有

AIを知りたい

MCPサーバーの設定もチームで共有できますか？

AIエンジニア

はい！.claude/settings.jsonをリポジトリに含めることで、チーム全員が同じMCPサーバーに接続できます。

// .claude/settings.json（リポジトリに含める）
{
  "mcpServers": {
    "database": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-postgres"]
    },
    "github": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"]
    }
  }
}

チーム開発でのワークフロー

AIを知りたい

実際のチーム開発ではどう使うのがおすすめですか？

AIエンジニア

おすすめのワークフローを紹介します。

フェーズ 担当者 Claude Code活用
設計レビュー テックリード CLAUDE.mdに設計方針を記載
実装 各開発者 CLAUDE.mdに従ったコード生成
コードレビュー レビュアー claude “このPRをレビューして”
テスト QA担当 テストコードの自動生成
デプロイ DevOps hooks連携でCI/CDに統合

AIを知りたい

チーム全員が同じ環境で使えるのは便利ですね！

AIエンジニア

その通りです。CLAUDE.mdとMCPサーバー設定をGitリポジトリで管理するのがベストプラクティスです。新メンバーもクローンするだけですぐにチームの開発環境が整いますよ！

関連記事