/team-onboarding でガイドを作ったとき、最後に出てくる許可の確認が何をするものか知りたい人向け
料理ブログや家計簿アプリなどのプロジェクトで /team-onboarding を実行してチーム向け手引きを作り、その手引きをアップロードして新メンバーが開ける共有リンクとして渡したい場面で、Claudeが出す送信の許可確認に対して同意するときに登場する。送りたくないときは拒否すればリンクは出ず、手元のファイルだけが残る。
ShareOnboardingGuide は、Claude Code が /team-onboarding でチーム向けの手引き書（ONBOARDING.md という名前の説明ファイル）を書き終えたあと、その中身を外部に送り出して、仲間がそのまま開けるリンクを返す道具です。私たちが直接打つ命令ではありません。Claude が裏で「これを送ってリンクにしていいですか」と確認してくる、その確認の主体がこれです。
料理ブログのプロジェクトで使い方をひと通り回したガイドを、新しく入る人に渡したい。そんな場面で最後にひょっこり出てくる確認ウィンドウが何をしているのか。そこだけを切り出して説明します。
噛み砕くと
新しい職場で、先輩が自分の作業メモを1冊にまとめてくれたとします。その紙の束を「社内の共有棚に置いて、URLを配れば誰でも見られるよ」とコピーしてくれる係。それがこの道具です。
メモを書く人と、それを共有棚に上げてリンクを配る人は別。書くのは /team-onboarding の方で、上げるのがこっち。役割がはっきり分かれています。
そして共有棚に上げる＝中身が手元のパソコンの外に出る、ということ。だから上げる前に必ず「上げていい？」と一度止まる。ここが地味に大事です。
大事な前提：自分で呼ぶ道具ではなく、流れの最後に出てくる確認
これは単体で叩いて起動するものではありません。公式の表にも「/team-onboarding からガイドが書き上がったあとに呼ばれる」と書かれていて、ここだけを直接動かす方法は公式に載っていません。
つまり登場のしかたは1つだけ。/team-onboarding を実行 → ガイドが完成 → Claude が「これを送ってリンク化していい？」と聞いてくる、という流れの最後尾に出てきます。
もう1つ。共有リンクが出るのは claude.ai の Pro・Max・Team・Enterprise の4つの契約のどれかに入っている場合だけ。それ以外だとリンクは出ず、手元のガイドファイルだけが残ります。
「料理ブログのチームに新メンバーを迎える」場面で、実際の流れを見る
料理ブログのプロジェクト cooking-blog で、世界の郷土料理を紹介するサイトを少人数で作っているとします。新しく1人加わるので、Claude Code の使い方を渡したい。ここで /team-onboarding から共有リンクまでの一連を追います。
ステップ1: cooking-blog で /team-onboarding を実行する
まず連動元のコマンドを打ちます。これがガイドを書く側です。
$ cd cooking-blog
$ claude
> /team-onboardingClaude が直近30日ぶんの作業履歴を読みにいきます。どんな命令を使ったか、どんな外部連携（MCP サーバー）をつないでいたか、といった記録です。
ステップ2: ガイド（ONBOARDING.md）が書き上がる
分析が終わると、新メンバーが最初の一言として貼り付けるだけでセットアップが進む手引きが ONBOARDING.md として手元に作られます。ここまでは送信なし。完全に自分のパソコンの中の話です。
ステップ3: ここで Claude が ShareOnboardingGuide を呼ぼうとする
ガイドが完成した瞬間、Claude が「このガイドを送って、仲間が開けるリンクにしていいですか」と確認を出します。これがこの道具の登場シーン。公式の表で Permission Required が「Yes」になっているのはここのことで、中身を外部に送る前に必ず一度止まる作りです。
ここで初心者がやりがちな勘違いを1つ。この確認を「ガイドを保存していいか」の確認だと思ってそのまま許可してしまう人がいます。違います。これは「中身を外に送っていいか」の確認です。中身を見てから返事するのが正解。
ステップ4: 中身を確認してから許可する
許可する前に、できた ONBOARDING.md を一度開いて読みます。30日ぶんの履歴から作られているので、プロジェクト名や使った命令、つないでいた外部連携の構成などが入っています。社外に出したくない情報が紛れていないか、ここで目を通す。問題なければ確認ウィンドウで許可します。
$ less ONBOARDING.md
（中身を一読して、出して困る情報がないか確認）許可すると、ONBOARDING.md の中身が送られて、仲間が Claude Code で直接開ける共有リンクが返ってきます。
ステップ5: 新メンバーがそのリンクを Claude Code で開く
返ってきたリンクを新メンバーに渡します。受け取った側は Claude Code でそのリンクを開くだけ。料理ブログの作業の流れを、最初の一言を打つところから追体験できる状態になります。紙のメモを手渡しするより1段ラク、というのがこの機能の狙いです。
ステップ6: 出したくない情報が入っていたら拒否してファイル手渡しに切り替える
もしステップ4で「この構成は外に出したくない」と感じたら、確認ウィンドウで拒否すればいい。拒否すると共有リンクは発行されません。ただしガイドファイル自体は手元に残るので、中身を整えてから markdown ファイルそのものを渡す、という運用に切り替えられます。リンクが出ないだけで、手詰まりにはなりません。
つまり ShareOnboardingGuide は何をしてくれるのか
- やってくれる: 書き上がった ONBOARDING.md を外部に送り、仲間が Claude Code で直接開ける共有リンクを返す。送信の前には必ず確認を出す
- やってくれない: ガイド自体を書く仕事はしない。それは
/team-onboarding側の分析処理の担当。これはあくまで「送ってリンクにする」係 - 意味が薄い場面: claude.ai の Pro・Max・Team・Enterprise 以外の契約だと、そもそも共有リンクが出ない。リンク配布が目的でないなら出番もない
使いどころ3シナリオ（具体題材で再現）
シナリオ1: 料理ブログに業務委託の編集者を1人迎えるとき
世界の郷土料理サイトに、記事を書く編集者が外部から加わるとします。Claude Code の使い方を口頭で説明するのは骨が折れる。/team-onboarding で30日ぶんの作業からガイドを作り、リンクを1本渡せば、相手は最初の一言から流れを追えます。送る前に中身を読んで、下書き中の非公開メニュー名が混ざっていないかだけ確認すれば安心です。
シナリオ2: 家計簿アプリを2人で作っていて、3人目の開発者が入るとき
家計簿アプリの開発に新しい人が合流する場面。すでに使っている外部連携や、よく叩く命令の流れをガイドにまとめて共有リンクで渡せば、環境のセットアップ待ちで初日が溶けるのを減らせます。ただし家計データを扱う構成情報が入る可能性があるので、許可前の一読は省かないこと。
シナリオ3: 公開できないクライアント案件で、リンク共有を避けたいとき
守秘義務のあるクライアント案件だと、中身を外部に上げること自体を避けたい場合があります。そのときは確認ウィンドウで拒否。共有リンクは出ませんが、手元の ONBOARDING.md を読んで安全な範囲に整えてから、ファイルそのものを社内ストレージ経由で渡す。リンク機能を使わない選択肢があると覚えておくと判断がラクです。
初心者が踏みやすい落とし穴
- 許可前に中身を読まずに通してしまう。ガイドは30日ぶんの履歴から作られ、プロジェクト名・使った命令・外部連携の構成が入ります。社外に出せない情報が混ざっていないか、許可する前に一度開いて読むのが鉄則です
- 自分で打つ命令だと思い込む。これは
/team-onboardingの流れの最後に Claude が呼ぶもので、単体で起動する方法は公式に載っていません。確認ウィンドウが出てから関わる道具です - ガイドを書く道具だと勘違いする。書くのは
/team-onboarding側。これは書き上がったものを送ってリンクにするだけで、文章の中身は作りません - リンクをローカル共有だと思う。これは手元の場所を教えるだけの機能ではなく、中身を外部に送る動作です。だから確認が出ます。送信を伴うという前提を取り違えないこと
- 無料の契約でもリンクが出ると期待する。共有リンクが出るのは claude.ai の Pro・Max・Team・Enterprise の4つだけ。対象外だとガイドファイルしか残らず、これは故障ではありません
- 許可ルールで止めたいとき書き方を間違える。送信を禁止したい場合は、許可設定の deny にツール名そのまま
ShareOnboardingGuideと書きます。公式いわく、この道具は(...)で中身を細かく指定する形は受け付けず、名前だけを書く形しか取りません - 拒否したら全部消えると思う。確認で拒否しても共有リンクが発行されないだけで、ガイドファイル自体は手元に残ります。リンクなしで markdown を手渡しする運用に切り替えられます
- リンクの期限や取り消し方を公式に探す。リンクの有効期限や取り消し方法は、現時点の公式ドキュメントに記載がありません。気になる人は、出す前に中身を絞っておくのが現実的です
書き方
（自分で打つ命令ではない。/team-onboarding でガイドが書き上がったあと、Claudeが送信の許可確認とともに呼ぶ。許可設定で止めるときは deny にツール名そのまま ShareOnboardingGuide と書く）やってみるとこうなる
入力
/team-onboarding
（ガイド完成後、Claudeが「このガイドを送って共有リンクにしていいですか」と確認を出す）出力例
許可すると ONBOARDING.md の中身が送られ、仲間がClaude Codeで直接開ける共有リンクが返る。Pro/Max/Team/Enterprise 以外の契約だとリンクは出ず、手元のガイドファイルだけが残る。拒否した場合も共有リンクが発行されないだけで、ガイドファイルは手元に残る。このページに出てきた言葉
- ONBOARDING.md
- 新しく入る人がプロジェクトの使い方を短時間でつかめるよう、作業の流れや使った道具をまとめた説明ファイル。<code>.md</code> は文字だけのテキスト形式
- アップロード
- 手元のパソコンにあるファイルの中身を、外部のサーバーに送って預けること
- オンボーディング
- 新しく入った人が早く戦力になれるよう、必要な情報や手順をまとめて渡すこと。日本語の「受け入れ準備」に近い
- MCP サーバー
- Claude Code に外部のサービスやデータをつなぐための連携窓口
- 確認ウィンドウ（許可の確認）
- Claudeが外部送信のような後戻りしにくい操作をする前に、やっていいかを1回だけ尋ねてくる画面