Claude Code /team-onboarding完全ガイド【2026年】

2026.04.13 公開 8分で読める

この記事の結論

Claude Code v2.1.101の新コマンド/team-onboardingは、チームの使用実態を解析してramp-upガイドを自動生成する。CLAUDE.mdやスキルが原料になる仕組みと準備方法を解説する。

「チームにClaudeを導入した。でも結局、新メンバーに使い方を口頭で教えてる」

そういう声を、ここ数ヶ月でずっと聞いてきた。CLAUDE.mdを整備して、スキルも揃えて、フックも組んだ。でもその知識が人の頭の中にしかない、という問題は解決されていなかった。

それが変わった。Claude Code v2.1.101（2026年4月10日リリース）に搭載された/team-onboardingコマンドの話だ。

何が変わったのか

/team-onboardingは、プロジェクトのローカルClaude Code使用履歴を解析して、新メンバー向けのramp-upガイドを自動生成するコマンドだ。

どういう意味か具体的に言うと、このコマンドは以下を読み込む：

プロジェクトのCLAUDE.md（ルートとネスト両方）
インストール済みのスキル（~/.claude/skills/）
カスタムサブエージェント定義（~/.claude/agents/）
フック設定（settings.json内のhooks）
よく使われるスラッシュコマンドのパターン
最近のセッションで頻繁にアクセスされたファイル・ディレクトリ

これらを統合して、「このプロジェクトでClaudeをどう使えばいいか」を一枚のドキュメントにまとめてくれる。

ポイントは、汎用的なClaudeの使い方ガイドではないということだ。あなたのチームが、あなたのコードベースで、実際にどうClaudeを使っているかを映し出したドキュメントが生成される。

使い方は3ステップ

実際に試すなら、以下の手順だ：

# ステップ1: プロジェクトルートで実行
cd /path/to/your-project
claude

# ステップ2: コマンドを叩く
/team-onboarding

# ステップ3: 生成されたドキュメントを確認・編集してリポジトリにコミット
# （通常 ONBOARDING.md として出力される）

動作環境: Claude Code v2.1.101以降。claude --versionで確認。古い場合はnpm update -g @anthropic-ai/claude-codeでアップデートする。

注意: 本番環境で使用する前に、必ずテスト環境で動作確認してください。

/team-onboardingが実際に生成するもの

生成されるガイドの構成は、プロジェクトの実態に応じて変わる。一般的には以下のセクションが含まれる：

このプロジェクトでのClaudeの役割

CLAUDE.mdの内容をもとに、「このプロジェクトでClaude Codeは何をするエージェントなのか」を整理する。コーディングアシスタントなのか、テスト実行エージェントなのか、デプロイパイプラインの管理者なのか。その位置づけが新メンバーに伝わる。

使えるスキルとコマンド一覧

インストール済みスキルとカスタムコマンドが一覧化される。「/deployコマンドがあること」「/reviewでコードレビューが走ること」を、新メンバーが自力で発見する必要がなくなる。

サブエージェントの役割分担

複数のサブエージェントが存在する場合、それぞれの役割と使い分けが説明される。「testerエージェントにはテストを、security-reviewerにはセキュリティチェックを任せる」という運用ルールが文書化される。

フックの動作と注意点

PostToolUseフックやStopフックが設定されている場合、「どのタイミングで何が自動実行されるか」が説明される。フックの存在を知らずに混乱するのを防ぐ。

/team-onboardingが最大の効果を発揮するCLAUDE.md構成

生成されるガイドの品質は、CLAUDE.mdの書き込みの質に比例する。以下は/team-onboardingが読み込む情報を最大化する記述例だ。

# CLAUDE.md — /team-onboarding用に最適化した構成例

## プロジェクト概要とClaudeの役割
このプロジェクトでClaudeは主に3つの役割を担います：
1. コードレビュー（/reviewコマンドで起動）
2. テスト生成（tdd-guideサブエージェントが担当）
3. デプロイ前チェック（Stopフックで自動実行）

## 絶対ルール（Claudeに必ず守らせること）
- 本番DBには絶対に直接接続しない（必ずstaging経由）
- APIキーをコードにハードコードしない
- PRの説明文は日本語で書く

## よく使うスキル
- /deploy: ステージング環境へのデプロイ手順
- /review: コードレビューのチェックリスト実行
- /db-migration: マイグレーションファイルの作成と検証

## チーム固有の用語定義
- 「本番反映」= mainブランチへのマージ + CloudFrontのキャッシュクリア
- 「リリース」= バージョンタグ付け + SNS通知 + リリースノート更新

## 新メンバーが最初に知るべき注意事項
- .envファイルはGitに含めない（.env.exampleを参照）
- Claudeにsudo権限のあるコマンドを実行させない

# 注意: 本番環境で使用する前に、必ずテスト環境で動作確認してください。

ポイント: 「Claudeの役割」「絶対ルール」「スキル一覧」「チーム用語」「新メンバー向け注意事項」の5セクションが揃っていると、/team-onboardingの出力クオリティが大幅に上がる。

これは何を解決するのか — 私の解釈

正直に言うと、このコマンドが解決しようとしている問題は、技術的な問題ではなく組織的な問題だ。

ほとんどのチームは、Claude Codeの「使い方」を口頭で伝えている。なぜなら、それを文書化するコストが高かったから。CLAUDE.mdを書き、スキルを整備し、さらに「新メンバー向けのガイド」も書く——それは二重作業だった。

/team-onboardingはその二重作業をなくす。既存のCLAUDE.md、スキル、サブエージェント定義から自動的にオンボーディングドキュメントが生成される。これは「書くコストがゼロになった」ということを意味する。

書くコストがゼロになると、更新コストもゼロになる。チームの使い方が変わったら、再度/team-onboardingを実行すればいい。ガイドが常に最新の実態を反映する状態を保てる。

Before v2.1.101	After v2.1.101
口頭でClaude使い方を伝える	/team-onboardingで自動生成
CLAUDE.mdと別でオンボーディング資料を管理	CLAUDE.mdがそのままオンボーディングの原料になる
チームの使い方が変わっても資料は古いまま	再実行でドキュメントが最新化される
スキル・フックの存在を新メンバーが知らない	自動的にリストアップされる

同時リリースされた企業向け機能との連携

v2.1.101では/team-onboarding以外にも、チーム運用を意識した機能が同時リリースされた：

OS CA証明書ストアのデフォルト信頼: エンタープライズTLSプロキシが追加設定なしで動作するようになった。社内プロキシ環境での「なぜかTLSエラーが出る」問題が解消される
リモートコントロールセッション名のデフォルト改善（v2.1.92〜）: ホスト名がデフォルトプレフィックスに使われるようになり、複数メンバーが同時使用する際の識別が楽になった
チームメンバーのパーミッション継承改善（v2.1.98〜）: Agent Teamsでリーダーのパーミッションモードが自動継承されるようになった

これらを合わせると、Claude Code全体が「個人ツール」から「チームインフラ」に移行する方向性がはっきり見えてくる。

私が注目するのは「実態の可視化」という視点

ここからは個人的な見解だ。

/team-onboardingの本質は「ドキュメント生成ツール」ではなく、「チームのAI使用実態を可視化するツール」だと思っている。

生成されたドキュメントを見ると、チームが「何に自動化を任せているか」「どこに手動の判断を残しているか」が一目瞭然になる。その可視化は、新メンバーのオンボーディングだけでなく、チームのAI活用を振り返るレビューにも使える。

「私たちはこのフックを本当に使いこなせているか？」「このスキルは実際にどれくらい活用されているか？」

そういう問いを立てる起点になる。

まだ発展途上な機能ではある。生成されるガイドの質は、CLAUDE.mdやスキルの書き込みの質に依存する。ドキュメントが薄いプロジェクトでは、薄いガイドしか生成されない。「ガベージイン、ガベージアウト」は相変わらず成立する。

それでも、「チームのClaude使用実態を自動的に文書化する仕組みが標準搭載された」という事実は、今後のチーム展開を大幅に加速させると見ている。

【要注意】使う前に準備すること

失敗1: CLAUDE.mdが空か最小限しか書かれていない

❌ CLAUDE.mdに「このプロジェクトはNext.js + TypeScript」しか書いていない
⭕ ワークフロー、禁止事項、チーム固有のルール、よく使うコマンドを詳細に記載

なぜ重要か: /team-onboardingはCLAUDE.mdを主要な入力源として使う。記載が薄いと生成されるガイドも薄くなる。

失敗2: スキルとサブエージェントを未整備のままコマンドを実行する

❌ scripts/フォルダにバラバラにスクリプトを置いている
⭕ チームで繰り返し使う処理はスキル（SKILL.md）として整備してからコマンドを実行

なぜ重要か: スキルとして定義されていない作業は、オンボーディングガイドに反映されない。「知ってる人だけが使えるテクニック」がそのまま残る。

失敗3: 生成されたドキュメントをそのままコミットする

❌ /team-onboardingの出力をそのままgit addしてpushする
⭕ 生成後に人間がレビューし、不正確・時代遅れな記述を修正してからコミット

なぜ重要か: 自動生成されたドキュメントはあくまで草稿。最終的な判断は人間が行う必要がある。特に「なぜそのルールを設けているか」という背景の説明は、自動では書かれない。

参考・出典

AIエージェント構築の基本概念や設計パターンについては、AIエージェント構築完全ガイドで体系的にまとめています。

この記事を読んで導入イメージが固まってきた方へ

Uravationでは、AIエージェントの要件整理、PoC設計、社内導入、研修まで一気通貫で支援しています。

30分無料相談を予約支援実績を見る

※ 本記事の情報は2026年4月時点のものです。サービスの料金・仕様は変更される可能性があります。最新情報は各サービスの公式サイトをご確認ください。