Claude Codeでチーム開発を効率化する方法｜権限管理・レビュー・共有設定の実践ガイド

AI駆動開発が本格化する中、Claude Codeを個人の生産性向上ツールとしてだけでなく、チーム全体の開発効率を底上げする基盤として導入する企業が増えています。しかし、チーム開発でClaude Codeを活用するには、個人利用とは異なるナレッジ共有や権限管理の仕組みが必要です。詳しくは「Claude Codeの企業導入セキュリティガイド」で解説しています。

本記事では、Claude Codeをチーム開発に導入する際のCLAUDE.mdの設計、settings.jsonによる権限管理、Agent Teamsによるマルチエージェント並列開発、コードレビュー自動化まで、開発リーダーやCTOが押さえるべき実践ノウハウを体系的に解説します。AI活用完全ガイドで、AI活用の全体像を把握できます。

この記事でわかること

Claude Codeをチーム全体の開発基盤として導入したい開発リーダー・CTOに向けた記事です。

• CLAUDE.mdを活用してチーム全員が同じコンテキストでClaude Codeを使えるようにする設計方法 — CLAUDE.mdは、ClaudeCodeがセッション開始時に自動で読み込む指示書ファイルです。
• settings.jsonの階層構造を理解し、プロジェクト単位で適切な権限ポリシーを設定する手順 — ClaudeCodeの権限設定は、3つのレベルで管理されます。
• Agent Teams（サブエージェント自動生成・Orchestrator-Workers構成）の具体的な活用パターン — ClaudeCodeでは、メインのエージェントから専門的なタスクをサブエージェントに委任できます。
• GitHub Actionsと連携したPRレビューの自動化により、レビュー待ち時間を削減する方法 — Anthropicが公式に提供するを使えば、PRが作成されるたびにClaudeCodeが自動でコードレビューを実行し、コメントを投稿します。
• Team/Enterpriseプランの選定基準と、組織規模に応じた導入ステップ — 2025年8月にAnthropicはClaudeCode対応のTeam/Enterpriseプランを発表しました。

CLAUDE.mdでチームのコンテキストを統一する

CLAUDE.mdとは何か

CLAUDE.mdは、Claude Codeがセッション開始時に自動で読み込む指示書ファイルです。プロジェクトのルート直下に .claude/CLAUDE.md として配置することで、チームメンバー全員が同一のコンテキストでClaude Codeを利用できます。詳しくは「Claude Code × CI/CD」で解説しています。

個人利用では暗黙知として各自が持っていた「コーディング規約」「アーキテクチャの前提」「禁止事項」を、CLAUDE.mdに明文化することでチーム全体に自動適用できる点が最大のメリットです。詳しくは「Claude Codeでプロジェクト管理を効率化する方法」で解説しています。

なお、既存プロジェクトにCLAUDE.mdを新規作成する場合は、/init コマンドを実行するとClaude Codeがプロジェクトのディレクトリ構造・package.json・README等を自動スキャンし、技術スタック、ビルドコマンド、テストコマンド、ディレクトリ構成を含むCLAUDE.mdのひな形を自動生成してくれます。ゼロから手書きする必要はありません。

チーム向けCLAUDE.mdの設計パターン

効果的なCLAUDE.mdには以下の要素を含めます。

実世界の事例: ShopifyのオープンソースCLAUDE.md

Shopifyは自社のオープンソースプロジェクトで詳細なCLAUDE.mdを公開しており、チームでのClaude Code活用の先進事例として注目されています。ShopifyのCLAUDE.mdには、モジュール境界の定義、検証コマンドの一覧、PRテンプレート、コントリビューション時の注意事項が明記されており、外部コントリビューターを含む大規模チームでもエージェントが独立してコードベースを探索できるよう設計されています。

ShopifyのCEO Tobi Lutke氏は「AIの活用は全社員の基本スキル」と公言しており、CLAUDE.mdをチームのナレッジハブとして位置づける運用方針は、同社のAIファースト文化を反映したものです。

CLAUDE.mdの階層構造

CLAUDE.mdは複数階層で管理できます。

• リポジトリルート .claude/CLAUDE.md — プロジェクト全体のルール
• サブディレクトリ src/api/CLAUDE.md — モジュール固有のルール
• ユーザーローカル ~/.claude/CLAUDE.md — 個人の好み（Gitに含めない）

この階層構造により、チーム共通ルールと個人設定を分離しつつ、特定モジュールには追加ルールを適用できます。たとえば、フロントエンドチームは src/frontend/CLAUDE.md にReactのコンポーネント設計規約を、バックエンドチームは src/api/CLAUDE.md にAPIのエラーハンドリング方針を配置するといった運用が可能です。

settings.jsonによる権限管理

権限設定の3階層

Claude Codeの権限設定は、3つのレベルで管理されます。

1. ユーザー設定（~/.claude/settings.json）— 個人のグローバル設定
2. プロジェクト設定（.claude/settings.json）— リポジトリ共有設定
3. ローカルオーバーライド（.claude/settings.local.json）— 個人の上書き設定

評価順序は ローカル > プロジェクト > ユーザー で、deny > ask > allow の順に判定されます。denyルールは常に最優先されるため、危険な操作を確実にブロックできます。

プロジェクト向け推奨設定

チーム開発では、.claude/settings.json で以下のような設定をリポジトリにコミットします。

{
  "permissions": {
    "allow": ["Read", "Edit", "Write", "Glob", "Grep"],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push --force)",
      "Bash(git reset --hard)"
    ]
  }
}

これにより、ファイルの読み書きは許可しつつ、破壊的なGit操作やファイル削除はチーム全体でブロックできます。

4つのパーミッションモード

acceptEdits モードは、ファイルの編集操作は自動承認しつつ、シェルコマンド実行時には確認を求めるモードです。コード生成やリファクタリングのような編集中心の作業では操作の中断が減り、生産性が大幅に向上します。

チーム開発では、NormalモードをデフォルトとしつつCIパイプラインではAuto-acceptを使う構成が一般的です。Claude Codeでプロジェクト管理を効率化する方法で、タスク分割やマルチエージェント構成の運用パターンも紹介しています。

Agent Teamsによる並列開発

サブエージェントの仕組み

Claude Codeでは、メインのエージェントから専門的なタスクをサブエージェントに委任できます。サブエージェントは親と同じCLAUDE.md、MCPサーバー、スキルを読み込むため、プロジェクトのコンテキストを維持したまま並列処理が可能です。

出典: Anthropic公式: Sub-agents

特筆すべきは、Claude Codeが複雑なタスクに対して自動的に専門エージェントを生成（spawn）する「Agent Teams」の機能です。たとえば、大規模なリファクタリングを指示すると、Claude Codeは以下のような専門サブエージェントを自動的に起動します。

• UX専門エージェント — UIコンポーネントの変更とアクセシビリティの検証を担当
• アーキテクチャ専門エージェント — モジュール間の依存関係と設計の整合性を検証
• セキュリティ専門エージェント — 認証・認可の実装とセキュリティリスクの検出を担当
• テスト専門エージェント — 変更箇所のテストケース生成とカバレッジの確認

開発者が手動でエージェントを割り当てる必要はなく、タスクの性質に応じてClaude Codeが最適なチーム構成を判断します。

Orchestrator-Workersアーキテクチャ

Agent Teamsの設計思想は、Anthropicが提唱する「Orchestrator-Workers」パターンに基づいています。このパターンでは、中央のオーケストレーター（調整役）がタスクを分解し、複数のワーカーエージェントに並列で委任した後、それぞれの成果を統合します。

出典: Anthropic「Building Effective Agents」

Orchestrator-Workersパターンの流れは以下のとおりです。

1. タスク受領 — オーケストレーターが開発者からの指示を受け取る
2. 分解と委任 — タスクを独立した単位に分解し、各ワーカーに割り当て
3. 並列実行 — 各ワーカーが独立して作業を実行
4. 統合と検証 — オーケストレーターが各ワーカーの成果物を統合し、整合性を検証
5. 結果の返却 — 統合された成果物を開発者に返す

このパターンは、コードベースのモジュール性が高く、各タスクが独立して実行可能な場合に最も効果を発揮します。モノリシックなコードベースでは、ワーカー間のファイル競合が頻発するため、事前にモジュール境界をCLAUDE.mdに明記しておくことが重要です。

Git Worktreeによる並列実行

CCPM（Claude Code Project Manager）のようなツールを使えば、Git Worktreeを活用して複数のエージェントが同じリポジトリの異なるブランチで同時に作業できます。GitHub Issuesと連携してPRDから実装、PR作成まで自動化する構成も実現可能です。経営データの可視化やコンテンツマーケティングを含め、Claude Codeの業務活用に関心のある方はぜひ参考にしてください。

# メインブランチからWorktreeを作成し、各エージェントが独立作業
git worktree add ../feature-auth feature/auth
git worktree add ../feature-payment feature/payment
git worktree add ../feature-notification feature/notification

各Worktreeで独立してClaude Codeを起動し、実装が完了したらPRを作成してマージする流れです。Worktreeはファイルシステムレベルで分離されるため、ブランチ間のファイル競合を物理的に防止できます。

ただし、マルチエージェント構成ではAPIコストが増大するため、タスクの粒度とエージェント数のバランスを慎重に設計する必要があります。

コードレビューの自動化

GitHub Actions連携

Anthropicが公式に提供する anthropics/claude-code-action@v1 を使えば、PRが作成されるたびにClaude Codeが自動でコードレビューを実行し、コメントを投稿します。

出典: Anthropic公式: GitHub Actions

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

jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: $
          prompt: |
            このPRの変更点をレビューしてください。
            以下の観点で評価してください：
            1. ロジックの正確性
            2. エラーハンドリングの網羅性
            3. パフォーマンスへの影響
            4. セキュリティリスク
            5. テストの十分性

レビュー待ち時間の短縮効果は大きく、PRを出してから数分以内にフィードバックが得られます。人間のレビューアがコードを読む前に構文チェック、ロジックの問題、セキュリティリスクを事前に検出することで、レビューの質と速度が同時に向上します。

詳しいCI/CD統合の設計については、Claude Code × CI/CDのパイプライン設計で解説しています。

レビューチェックリストのカスタマイズ

CLAUDE.mdにレビュー観点を記載しておけば、Claude Codeは毎回同じ基準でレビューを実施します。コーディング規約の遵守、テストの有無、パフォーマンスへの影響、セキュリティリスクなど、チーム固有の観点を統一できます。

さらに、claude-code-action はPRの差分だけでなくリポジトリ全体のコンテキストを読み込むため、変更箇所が他のモジュールに与える影響（たとえば共通コンポーネントの変更が依存先に破壊的影響を与えないか）まで検出できる点が、単純なリンターやコード分析ツールとの大きな違いです。

Team/Enterpriseプランの選定

プラン比較

2025年8月にAnthropicはClaude Code対応のTeam/Enterpriseプランを発表しました。

5名以下の小規模チームならTeamプラン、SSO・監査ログ・ポリシーの組織展開が必要な場合はEnterpriseプランを選択するのが一般的です。

managed-settings.jsonによる全社ポリシー

Enterpriseプランでは、IT部門が managed-settings.json で全社統一のポリシーを強制適用できます。個々の開発者がローカルで設定を変更しても、managed-settingsの内容はオーバーライドできないため、セキュリティポリシーの徹底が可能です。

組織レベルのセキュリティ対策については、Claude Codeの企業導入セキュリティガイドも合わせてご覧ください。

導入ステップと成功のポイント

段階的な導入プロセス

チーム全体への展開は、以下のステップで進めるのが効果的です。

1. パイロット（1-2週間） — リーダー1-2名が個人利用で検証。/init コマンドでCLAUDE.mdのひな形を生成
2. CLAUDE.md整備（1週間） — コーディング規約・禁止事項の明文化。Shopifyの公開事例を参考にチーム固有のルールを追加
3. 小チーム展開（2-4週間） — 3-5名のチームで運用ルールを確立。settings.jsonのdenyルールを調整
4. CI/CD統合（1-2週間） — GitHub Actions連携でレビュー自動化
5. Agent Teams導入（2-4週間） — サブエージェントを段階的に追加し、並列開発を試行
6. 全体展開 — settings.jsonの標準化とTeam/Enterpriseプラン契約

運用上の注意点

Claude Codeの導入で最も重要なのは、CLAUDE.mdの継続的なメンテナンスです。プロジェクトの進化に合わせてCLAUDE.mdを更新し続けないと、エージェントの出力品質が徐々に低下します。CLAUDE.mdの更新をPRレビューの対象に含め、チーム全員が改善に参加する文化を作ることが成功の鍵です。

また、Claude Codeの基本的な使い方をチームメンバー全員が理解していることが前提になるため、導入前の教育セッションも欠かせません。

あわせて読みたい

• Claude Codeでプロジェクト管理を効率化する方法｜CLAUDE.md・タスク分割・進捗管理の実践
• Claude Codeの企業導入セキュリティガイド
• Claude Code × CI/CD｜コードレビュー・テスト・デプロイを自動化するパイプライン設計
• Claude Coworkとは？AIが仕事を実行する新しい働き方の全体像
• AI駆動開発とは？従来開発との違い・メリット・導入ステップを実践者が解説

まとめ

本記事では、Claude Codeをチーム開発で効率的に活用する方法について、基本的な考え方から具体的な実践方法までを解説しました。このテーマの全記事はClaude Code実践ガイドでご覧いただけます。

ポイントを振り返ります。

• CLAUDE.mdにコーディング規約・アーキテクチャ方針・禁止事項を明文化し、チーム全員が同一コンテキストで作業できる環境を構築することが出発点です。/init コマンドでひな形を自動生成し、Shopifyの公開事例を参考にカスタマイズするのが効率的です
• settings.jsonの3階層（ユーザー・プロジェクト・ローカル）を活用し、denyルールで破壊的操作をブロックする権限管理が安全なチーム運用の基盤になります
• Agent Teams（Orchestrator-Workersパターン）により、Claude Codeが自動でUX・アーキテクチャ・セキュリティ等の専門サブエージェントを生成し、複雑なタスクを並列処理できます。ただしAPIコストとタスク粒度のバランス設計が不可欠です
• GitHub Actionsとclaude-code-actionを連携したPRレビュー自動化により、レビュー待ち時間を短縮しつつレビュー基準を統一できます

CRMを活用した業務効率化やAIとの連携に関するご相談は、CRM特化型コンサルティングのStartLinkまでお気軽にお問い合わせください。

よくある質問（FAQ）

Q1. CLAUDE.mdはGitリポジトリにコミットすべきですか？

はい、.claude/CLAUDE.md と .claude/settings.json はリポジトリにコミットしてチーム全員で共有するのが推奨です。個人的な設定は .claude/settings.local.json や ~/.claude/ に配置し、.gitignore で除外します。なお、/init コマンドで生成したCLAUDE.mdは、チームの運用に合わせてカスタマイズしてからコミットしてください。

Q2. マルチエージェント構成のAPIコストはどの程度ですか？

エージェント数に比例してAPIコストが増加します。一般的に、サブエージェントを3つ並列で動かすと、シングルエージェントの2.5〜3.5倍程度のコストになります。タスクの粒度が大きい場合（モジュール単位のリファクタリングなど）はコスト効率が良く、細かいタスクの並列化はオーバーヘッドが大きくなる傾向があります。Agent Teamsの自動生成機能を使う場合も同様で、タスクの複雑さに応じて自動的にエージェント数が調整されます。

Q3. Claude CodeのTeamプランとMax（個人向け）プランの違いは何ですか？

Maxプランは個人開発者向けで、Teamプランはチーム管理機能（シート管理、利用分析、支出制御）が追加されます。Teamプランでは管理者がメンバーの利用状況を把握し、組織・ユーザー単位で支出上限を設定できます。5名以上で利用する場合はTeamプランのほうがコスト管理が容易です。

Q4. 既存のESLint/Prettierとの併用は可能ですか？

はい、CLAUDE.mdにフォーマッタやリンターの設定を記載しておけば、Claude Codeはそれらのルールに従ってコードを生成します。CI/CDパイプラインでESLint/Prettierのチェックを走らせれば、Claude Codeが生成したコードも同じ基準で検証されます。

Q5. Agent Teamsのサブエージェントは手動で指定できますか？

Claude Codeはタスクの複雑さに応じて自動的にサブエージェントを生成しますが、プロンプトで「フロントエンドとバックエンドを別々のサブエージェントで実装してください」のように明示的に指示することも可能です。CLAUDE.mdにモジュール境界を明記しておけば、サブエージェントの分担がより適切になります。