Claude Code チーム活用ガイド|共有設定・権限・コスト管理を徹底解説
Claude Code をチームで活用する方法を実装コード付きで解説。CLAUDE.md の Git 共有・Skills 標準化・GitHub 連携・コスト管理・セキュリティ設定・新メンバーオンボーディング 30 分テンプレートまで網羅します。
Claude Code を個人で使いこなしたあと、次のステップは チーム全体に横展開することです。しかし「自分の設定をそのままチームに渡せない」「誰がいくら使っているかわからない」「新人に使い方を教えるのが大変」という課題がよく聞かれます。
本記事では、Claude Code をチームで活用するための設定共有・Skills 標準化・GitHub 連携・コスト管理・セキュリティ制御を、コピーして使える実装コード付きで解説します。Claude Code の基本的な仕組みは Claude Code 完全ガイド を参照してください。
1. チームで Claude Code を使う前に確認すること
個人利用と異なり、チーム利用では 「誰でも同じ品質のアウトプットが出せる」環境を作ること が最初のゴールです。そのために必要な要素を整理します。
チーム導入で解決すべき 4 つの課題
| 課題 | 放置した場合のリスク | 解決策 |
|---|---|---|
| 設定の属人化 | メンバーごとに挙動が違い、コードレビューコストが増大 | CLAUDE.md を Git 管理 |
| ナレッジの孤立 | チームで同じ失敗を繰り返す | Skills を共有リポジトリ化 |
| コスト不透明 | 月末に予算超過が発覚 | API キー単位でコスト追跡 |
| セキュリティ事故 | 本番 DB の削除・機密情報の漏洩 | Hooks で破壊的操作をブロック |
プランの選び方(チーム向け)
Anthropic は 2026 年 6 月時点で Claude Code のチーム向け一括契約を一般提供しており、5 名以上のチームには Max プランの法人割引が適用されます(出典: Anthropic 公式料金ページ)。
- 3 名以下の小規模チーム: 個人 Max $200 × 人数。シンプルで管理しやすい
- 5 名以上のチーム: Claude for Work(法人プラン)を検討。SSO / 監査ログが付属
- 自動化エージェント主体: API 従量課金 + 共有 API キーで運用コスト最適化
2. CLAUDE.md をチームで共有する
CLAUDE.md はプロジェクトの「Claude への説明書」です。Git にコミットしてチーム全員が同じ設定を使えるようにするのが最初の一手です。
CLAUDE.md の配置戦略
Claude Code は複数箇所の CLAUDE.md を階層的に読み込みます。
プロジェクトルート/
├── CLAUDE.md # ← プロジェクト共通ルール(Git 管理)
├── src/
│ └── CLAUDE.md # ← src 配下の詳細ルール(任意)
└── .claude/
└── settings.json # ← ツール許可リスト(Git 管理)
チームで最初に Git コミットすべきなのは ルートの CLAUDE.md と .claude/settings.json の 2 ファイルです。
チーム向け CLAUDE.md テンプレート
# Project Overview
このリポジトリは〇〇のための Next.js アプリです。
担当: △△チーム(Slack: #dev-channel)
# Tech Stack
- Frontend: Next.js 15 (App Router) + TypeScript 5 strict
- Backend: Supabase (PostgreSQL + Auth + Storage)
- Styling: Tailwind CSS 4 + shadcn/ui
# Coding Rules
- TypeScript の `any` 禁止。不明な型は `unknown` を使い narrowing する
- 関数は 50 行以内、ファイルは 800 行以内に保つ
- コミットメッセージは conventional commits 形式(feat / fix / docs / refactor)
# Forbidden Operations
- `rm -rf` は Hooks でブロック済み。削除は必ず git rm か UI から
- `.env` ファイルへの直接書き込み禁止。Vercel 環境変数で管理
- 本番 DB への直接 SQL 実行禁止。必ずマイグレーションを通す
# Review Checklist
PR 作成前に必ず確認:
1. `pnpm lint` が通っているか
2. `pnpm test` が通っているか
3. 新機能には Jest ユニットテストを書いたか
.claude/settings.json でチームの許可リストを統一する
{
"permissions": {
"allow": [
"Bash(git:*)",
"Bash(npm:*)",
"Bash(pnpm:*)",
"Read(*)",
"Edit(*)",
"Write(src/*)"
],
"deny": [
"Bash(rm -rf*)",
"Bash(git push --force*)",
"Bash(DROP TABLE*)",
"Write(.env*)"
]
}
}
deny リストに登録されたコマンドは、どのメンバーが実行しようとしても Claude Code が物理的にブロックします。設定ファイル 1 枚でチーム全体の安全ネットになるのが最大のメリットです。
3. Skills をチーム共有ライブラリとして運用する
Skills はプロジェクトリポジトリ内の .claude/skills/ に置くことで、チーム全員が同じ知識ベースを参照できます。
Skills ディレクトリ構成(推奨)
.claude/
└── skills/
├── coding-style.md # コーディング規約(言語共通)
├── typescript.md # TypeScript 固有のパターン
├── database.md # DB スキーマ・クエリルール
├── testing.md # テスト設計の方針
├── deployment.md # デプロイ手順と注意点
└── onboarding.md # 新メンバー向けクイックスタート
Skills のメンテナンスルール
Skills は 「書いたら終わり」にしないのが重要です。月次でレビューし、古い情報を削除・更新するサイクルを作ります。
# coding-style.md のヘッダー例
---
last_updated: 2026-06-12
owner: @dev-lead
review_cycle: monthly
---
owner を明示することで、Skills の情報が陳腐化したときに責任者が明確になります。
チームで Skills を活用するプロンプト例
このチームの coding-style.md に従って、src/components/UserCard.tsx を
リファクタリングしてください。
変更後は testing.md のルールに基づいてテストも追加してください。
Skills に社内ルールが集約されていれば、Claude Code が毎回同じ基準でコードを書くため、レビュー指摘が激減します。
4. GitHub 連携でチームのコードレビューを自動化する
Claude Code は GitHub と組み合わせることで、PR の自動レビューやコメント生成をチームワークフローに組み込めます。
PR 自動レビューのセットアップ
# GitHub Actions ワークフロー(.github/workflows/claude-review.yml)
name: Claude Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Run Claude Code Review
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
npm install -g @anthropic-ai/claude-code
git diff origin/main...HEAD > pr_diff.txt
claude -p "以下の diff をレビューし、バグ・セキュリティ問題・
コーディング規約違反を日本語で報告してください。
問題がなければ '✅ LGTM' と返してください。" \
--file pr_diff.txt
これにより、PR を開くと自動で Claude Code がコードをレビューし、問題点を GitHub コメントとして投稿します(詳細設定は Claude Code × GitHub 連携ガイド を参照)。
レビュー精度を上げる 3 つのコツ
- diff のみ渡す: ファイル全体ではなく
git diffの結果を渡すことでトークン消費を抑えられる - Skills をプロンプトに含める: チームのコーディング規約を Claude に読ませてからレビューさせる
- チェックリスト形式で指示する: 「セキュリティ / 型安全性 / テスト有無」の 3 軸で返す形式に統一
5. チームのコスト管理と使用量追跡
Claude Code のコストをチームで最適化するには、誰がどれだけ使っているかを可視化することが先決です。
API キーの分割管理
チーム利用では、用途別に API キーを分けることをお勧めします。
| キー | 用途 | 月次予算目安 |
|---|---|---|
ANTHROPIC_DEV_KEY | 開発者の日常利用 | $50〜100 / 人 |
ANTHROPIC_CI_KEY | GitHub Actions の自動レビュー | $20〜50 |
ANTHROPIC_BOT_KEY | Slack Bot・自動化エージェント | $30〜80 |
Anthropic の管理コンソール(console.anthropic.com)でキーごとの使用量が確認できます。キーに月次上限を設定しておくことで予算超過を防げます。
コスト削減の実践パターン
# Haiku を使う(Sonnet の約 1/12 のコスト)
claude --model claude-haiku-4-5 "このコードのコメントを日本語に翻訳して"
# Prompt Caching を活用(長い CLAUDE.md を頻繁に読む場合)
# キャッシュが効くと最大 90% コスト削減
# → Anthropic 公式: https://docs.claude.com/en/docs/build-with-claude/prompt-caching
チームで 「ルーティンタスク = Haiku、設計判断 = Sonnet / Opus」 の使い分けを明文化するだけで、月次コストが 30〜40% 削減できます(試算: 当社調べ / 効果を保証するものではない)。
6. セキュリティと権限管理
チームで運用する場合、個人利用より厳しいセキュリティ設計が必要です。
PreToolUse Hooks で危険操作をブロックする
# .claude/hooks/pre-tool-use.sh
#!/bin/bash
COMMAND="$1"
# 本番 DB への直接アクセスをブロック
if echo "$COMMAND" | grep -q "PROD\|production"; then
echo "⛔ 本番環境への直接操作はブロックされています。Runbook を参照してください。"
exit 1
fi
# .env ファイルへの書き込みをブロック
if echo "$COMMAND" | grep -q "\.env"; then
echo "⛔ .env への直接書き込みは禁止です。Vercel 環境変数から設定してください。"
exit 1
fi
exit 0
// .claude/settings.json(Hooks の登録)
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "bash .claude/hooks/pre-tool-use.sh \"$CLAUDE_TOOL_INPUT\""
}
]
}
]
}
}
セキュリティチェックリスト(チーム導入時)
-
.envファイルは.gitignoreに追加済みか - API キーは環境変数で管理されているか(ソースコードに直書きしていないか)
-
denyリストに破壊的コマンドを登録済みか - Plan モードを有効化しているか(本番環境では必須)
- PII を扱う場合、PostToolUse Hooks でマスキングを実装しているか
Hooks の詳細実装は Claude Code Hooks 完全ガイド を参照してください。
7. 新メンバーのオンボーディング手順
Claude Code のチーム利用で最も時間がかかるのが 新メンバーへの使い方説明です。onboarding.md Skills を作っておくと、Claude Code 自身が新人をガイドできます。
オンボーディング Skills テンプレート(.claude/skills/onboarding.md)
# 新メンバー向け Claude Code クイックスタート
## セットアップ手順(30 分で完了)
1. Node.js 20+ をインストール
2. `npm install -g @anthropic-ai/claude-code`
3. `claude login` で Anthropic アカウントと連携
4. このリポジトリをクローンして `claude` を起動
## 最初に試すコマンド
このリポジトリの構造を教えて。どこから読めばいい?
## チームルール(必読)
- CLAUDE.md を読んでから作業開始すること
- 本番 DB への直接操作は禁止(Runbook を参照)
- PR 前に `pnpm test` と `pnpm lint` を必ず通すこと
- わからないことは #dev-help に質問する前に Claude Code に聞く
30 分オンボーディングの流れ
graph LR
A[インストール 5分] --> B[claude login 5分]
B --> C[CLAUDE.md 読み込み 10分]
C --> D[サンプルタスクで動作確認 10分]
D --> E[初 PR レビュー依頼 ✅]
- インストール (5 分):
npm install -g @anthropic-ai/claude-code - ログイン (5 分):
claude login→ ブラウザで認証 - CLAUDE.md 確認 (10 分):
claude "このプロジェクトのルールを教えて"と打つだけで Claude が CLAUDE.md を読んで説明してくれる - 動作確認 (10 分):
claude "src/components/Button.tsx に型エラーがないか確認して"などの小タスクを実行
8. チーム導入でよくある失敗パターン
Claude Code のチーム導入が停滞する原因を事前に把握しておくと、スムーズに展開できます。
失敗 1: 最初から大きな業務で始める
NG: 「まず月次レポートの全自動化から」 OK: 「まず Slack の日報要約から」(30 分で動くもの)
小さく始めて成功体験を積み、スコープを広げていく順序が重要です。
失敗 2: CLAUDE.md をメンテナンスしない
CLAUDE.md は「書いたら終わり」にすると、3 ヶ月後には古い情報だらけになります。月次レビューをカレンダーに登録し、実態と乖離したルールを定期的に削除・更新しましょう。
失敗 3: 全員に同じプランを割り当てる
ヘビーユーザー(開発者)と軽量ユーザー(企画・CS)ではリクエスト量が 5〜10 倍異なります。役割ごとにプランを分けることでコストを最適化できます。
| 役割 | 推奨プラン | 月額目安 |
|---|---|---|
| エンジニア(ヘビー利用) | Max または API | $100〜200 |
| 企画・マーケ(ライト利用) | Pro | $20 |
| 自動化エージェント専用 | API(キー単位管理) | 使用量に応じて |
失敗 4: Hooks を入れずに本番運用する
個人利用では許容できるミスも、チームの本番環境では致命的なインシデントになります。チーム導入初日に Hooks を設定するのがベストプラクティスです。
9. チーム利用のまとめ
Claude Code をチームで活用するための要点を整理します。
| 優先度 | やること | 効果 |
|---|---|---|
| ★★★(初日必須) | CLAUDE.md + settings.json を Git にコミット | 全員の挙動を統一 |
| ★★★(初日必須) | Hooks で破壊的操作をブロック | セキュリティ事故防止 |
| ★★(1 週間以内) | Skills ライブラリを整備 | コードレビューコスト削減 |
| ★★(1 週間以内) | API キーを用途別に分割・上限設定 | コスト管理を透明化 |
| ★(1 ヶ月以内) | GitHub Actions で PR 自動レビュー | 品質ゲートの自動化 |
| ★(1 ヶ月以内) | onboarding.md Skills を整備 | 新人オンボーディングを 30 分に短縮 |
Claude Code のチーム活用は「小さく始めて確実に広げる」が鉄則です。まず CLAUDE.md と Hooks の 2 点から始め、運用が安定してから Skills や GitHub Actions に拡張していくと、チーム全体への展開がスムーズに進みます。
法人として複数名で導入する場合の稟議書テンプレート・費用対効果計算式については Claude Code 法人導入ガイド を参照してください。
よくある質問
よくある質問
- Q. Claude Code はチームで同時に使えますか?
はい。各メンバーが個別のアカウント(または API キー)でアクセスします。CLAUDE.md と Skills を Git で共有すれば、全員が同じルールで動作します。同一 API キーの共有は使用量追跡が困難になるため、人別または用途別にキーを分けることをお勧めします。
- Q. CLAUDE.md を共有すると個人設定が上書きされますか?
上書きされません。Claude Code は「グローバル(~/.claude/CLAUDE.md)→ プロジェクト(CLAUDE.md)→ サブディレクトリ」の順で階層的に読み込みます。個人設定はグローバル層に書き、プロジェクト共通ルールはリポジトリ層に書くと両立できます。
- Q. チームの Claude Code 利用を禁止にするセキュリティポリシーはどう設定しますか?
settings.json の deny リストで操作を制限し、Hooks でルール外の動作を検出・停止させます。社内ネットワークからのアクセス制限が必要な場合は Anthropic の Claude for Work(法人プラン)の SSO 機能を利用してください(出典: Anthropic Enterprise)。
