
【2026年4月AI最前線】Agent Teams GA後の `/team-onboarding` 実運用Tips
Claude Code Agent Teams が GA (General Availability: 一般提供/正式版) に入り、個人利用からチーム導入フェーズに踏み出す環境が増えてきました。なかでも `/team-onboarding` コマンドは、従来なら手順書と設定ファイルの往復で進めていた初期セットアップを一本化してくれます。触って分かった勘所と、最初にハマりやすい点を共有します。
1. `/team-onboarding` が置き換えるもの
これまでチームに Claude Code を広げるときは、推奨設定のドキュメント整備、個別 PC でのセットアップ、権限周りの認識合わせを別々に走らせていました。`/team-onboarding` はこの初期導線を1本のコマンドから進められる構成になっています。
導入側が主に意識するのは次の4観点です。
共有ルール(CLAUDE.md などの仕様ファイル)
権限と許可リスト
共有スキル
共通化したい MCP サーバー
2. 触って分かった設定の勘所
実際に小規模チームで走らせた経験からの勘所です。
共有ルールは最小から。最初からフルセットの CLAUDE.md を渡すと、メンバー側の既存運用とぶつかります。合意済みの数項目だけで始め、運用で増やすほうがスムーズでした。
権限は「全員共通で許可するもの」だけを共有に寄せる。個別許可は個人設定のままにしておきます。共有側で広げすぎると、あとで絞るのが面倒です。
共有スキルは1〜2個から。レビュー用・コミットメッセージ整形など、誰が見ても効果が分かるものを最初に置きます。数を揃える前に、使われているかを見るほうが大事です。
MCP サーバーはチームで使う前提のものだけ共通化。個人ツール系は共有にしないほうが事故が少ないです。
3. ハマりどころと回避策
初回導入で遭遇しやすい落とし穴は2つありました。
1つ目は個人設定との競合です。既に個人で CLAUDE.md を書いているメンバーがいると、共有ファイルの読み込み順で意図しない上書きが起きます。最初に現状を棚卸ししてから共有を入れるのが安全です。
2つ目は権限の閉塞です。共有で厳しめに設定すると「今まで通る操作が急に止まる」ストレスにつながります。共有は最小許可で置き、個別で広げる設計のほうが導入直後の不満が少なくて済みます。
まとめ
`/team-onboarding` は「コマンド1本でチーム整備」ですが、中身は設計思想の勝負です。最初から完成形を目指さず、小さく共有して運用で育てるのが定着への近道でした。
関連記事
私のことが気になった方は、自己紹介もあわせてどうぞ。
生成AIの活用術の全記事をマガジンにまとめています。
生成AI関連の全記事はマガジンにまとめています。
今後も生成AIについてや生成AIの活用術についても発信しています。ご興味ある方はフォローお願いします🙇🏻