/install-slack-appでClaude Slackアプリを導入する
Claude Codeの/install-slack-appは、Slack上の@ClaudeメンションからClaude Codeセッションを起動できるようにする導入コマンドです。前提条件と手順、よくあるつまずきをまとめます。
/install-slack-app は、Claude Codeのセッション内から実行するコマンドです。実行するとブラウザが開き、SlackへClaudeアプリを追加するOAuth認証フローが始まります。認証を完了させると、Slackチャンネルで@ClaudeにメンションするだけでClaude Codeセッションを起動できるようになります。
/install-slack-appは何をするコマンドか
/install-slack-app が導入するのは、Claude for Slackアプリのうち「SlackからClaude Codeのセッションを起動する」機能です。この仕組みは公式ドキュメント上ではClaude Code in Slackと呼ばれ、Pro・Max・Team・Enterpriseの各プランで使えます。ただしTeam・Enterpriseプランでは、組織の共有アイデンティティとして動く新しいClaude Tagへの移行が進んでおり、この旧方式は順次置き換えの対象です。Pro・Maxの個人プランにはClaude Tagが提供されないため、/install-slack-app が導く設定方法が引き続き唯一の経路になります。
似た名前の機能に、Slackの会話ログをClaude Codeが外部データとして検索するSlack MCPサーバーがあります。/install-slack-app が扱うのはその逆方向で、SlackからClaudeにタスクを渡す入り口です。両者は独立した仕組みなので、片方を導入してももう片方には影響しません。
/install-slack-app導入前に満たしておく条件
/install-slack-app を実行する前に、次の4点を確認します。
| 条件 | 内容 |
|---|---|
| Claudeプラン | 内容Pro・Max・Team・Enterpriseのいずれか(Claude Codeへのアクセス権を含むシート) |
| Claude Code on the web | 内容事前に有効化されていること |
| GitHubアカウント | 内容Claude Code on the webに接続済みで、対象リポジトリを最低1つ認証済み |
| Slack認証 | 内容自分のSlackアカウントをClaudeアプリ経由で接続できる状態 |
無料プランはClaude Code on the webの対象外のため、/install-slack-app を実行しても導入は完了しません。まずclaude.ai/codeにサインインし、GitHubアカウントとリポジトリを接続してから実行します。GitHub連携の認証方式にはClaude GitHub Appと/web-setupの2種類があります。選び方はClaude Code WebのGitHub認証で扱っています。
手順 — コマンド実行からチャンネル招待まで
- Claude Codeのセッションで
/install-slack-appを実行する - ブラウザが開き、Slackへのサインインとワークスペースの選択、権限の許可を進める。Slackはワークスペースへのアプリ追加に管理者権限を要求することが多いため、自分が管理者でない場合はここで承認が止まる
- Slack内のClaudeアプリを開き、App Homeタブから「Connect」を押して自分のClaudeアカウントとSlackアカウントを紐づける
- claude.ai/codeにサインインし、GitHubアカウントと少なくとも1つのリポジトリが接続されているか確認する
- App Homeの「Routing Mode」で振り分け方法を選ぶ
- 使いたいチャンネルで
/invite @Claudeを実行する
インストール直後、Claudeはどのチャンネルにも参加していません。/invite @Claude を実行するまでは、メンションしても反応しない点に注意します。DMには対応していないため、チャンネルへの招待が必須です。
ルーティングモードでコーディングとチャットを振り分ける
App Homeで選ぶRoutingModeは、@Claude宛のメッセージをどう処理するかを決める設定です。
| モード | 挙動 |
|---|---|
| Code only | 挙動すべての@メンションをClaude Codeセッションへ送る。開発タスク専用に使うチームに向く |
| Code + Chat | 挙動メッセージ内容を判定し、コーディングならClaude Codeへ、それ以外は通常のClaude Chatへ振り分ける |
Code + Chatモードで判定を間違えた場合、返信に表示される「Retry as Code」ボタンでコーディングセッションへ切り替えられます。逆にコードへ振り分けられたが雑談として続けたい場合も、そのスレッド内で選択肢を選べます。スレッド内で再度@Claudeにメンションすると、そのスレッドの会話全体をコンテキストとして読み込みます。
導入後のセッションはどう進むか
@Claudeへのメンションからセッション完了までは、次の順で進みます。
- Slackで
@Claudeにコーディングの依頼をメンションする - Claudeがメッセージを分析し、コーディング意図を検出する
- claude.ai/code上に新しいClaude Codeセッションが作成される
- 作業の進捗がSlackスレッドに逐次投稿される
- 完了すると要約とアクションボタン付きで
@Claudeから返信が来る - 「View Session」で全履歴を確認するか、「Create PR」でプルリクエストを作成する
セッションはメンションを含むスレッド全体、または直接メンションされたチャンネルの直近の会話からコンテキストを集めます。この文脈がリポジトリの選択やタスクの解釈に使われるため、関連する議論はスレッド内で行うほうが精度が上がります。
誰が何にアクセスできるか
/install-slack-app 経由のセッションは、常にメンションした本人のClaudeアカウントで動きます。利用枠もその人のプラン上限に対してカウントされ、アクセスできるリポジトリも本人が個人で接続したものに限られます。セッション履歴もclaude.ai/codeの本人アカウントに残りますが、Team・Enterpriseアカウントでは、Slack経由で作成したセッションが組織内に自動で可視化される点がPro・Maxとの違いです。
| 制御の階層 | 内容 |
|---|---|
| ワークスペース単位 | 内容管理者がClaudeアプリのインストール可否を決める。Enterprise Gridでは組織管理者がワークスペース単位の利用可否を制御できる |
| チャンネル単位 | 内容インストール直後はどのチャンネルにも参加せず、/invite @Claude で招待されたチャンネルでのみ@メンションに反応する |
ワークスペースからアプリを削除すると、そのワークスペース内の全ユーザーのアクセスが即座に失われます。チャンネルへの招待可否を管理することで、ワークスペース全体の許可とは別にもう一段階アクセスを絞り込めます。
Slackで頼むか、Web版を直接開くか
同じClaude Codeでも、Slack経由とclaude.ai/codeへの直接アクセスでは向く場面が違います。
| 場面 | 向いている経路 |
|---|---|
| バグ報告のスレッドなど、文脈がすでにSlackにある | 向いている経路Slack(@Claudeメンション) |
| 非同期にタスクを投げて他の作業を続けたい | 向いている経路Slack |
| チームに進捗を見せながら進めたい | 向いている経路Slack |
| ファイルのアップロードが必要 | 向いている経路Web版を直接開く |
| リアルタイムでやり取りしながら開発したい | 向いている経路Web版を直接開く |
| 長時間・複雑なタスクに集中したい | 向いている経路Web版を直接開く |
依頼を書くときは、ファイル名や関数名、エラーメッセージを具体的に含めると精度が上がります。リポジトリが会話から自明でない場合は名前を明記し、「完了」の定義(テストを書くか、ドキュメントを更新するか、PRまで作るか)まで指定すると手戻りが減ります。
導入後によくあるつまずき
セットアップ直後に@Claudeへメンションしても反応がない場合、Claudeがまだそのチャンネルに招待されていないことが最も多い原因です。/invite @Claudeを実行済みか確認します。
「Claude Code is not enabled for your account」というエラーは、Slackと接続したClaudeアカウントにクラウド環境がまだ無い状態を示します。claude.ai/codeに一度サインインし、GitHub連携までのオンボーディングを完了させると、次のメンションでエラーが消えます。この確認は各ユーザーが個別に行う必要があり、誰か1人が済ませても他のメンバーには反映されません。
セッションがそもそも起動しない場合は3点を順に確認します。App HomeでClaudeアカウントが接続済みか、Claude Code on the webへのアクセスが有効か、GitHubリポジトリが最低1つ接続されているかです。選ばれたリポジトリが意図と違う場合は「Change Repo」ボタンで選び直せるほか、依頼にリポジトリ名を含めておくと次回以降の精度が上がります。認証エラーが出る場合は、App Home上で一度接続を切ってから再接続します。ブラウザで正しいClaudeアカウントにサインインしているかも確認します。
より一般的なClaude Code on the webのエラー(セッション作成の失敗、GitHubリポジトリが一覧に出ない等)は、Slack連携特有の問題ではなく基盤側の問題であることが多いです。個別の症状はClaude Code webのトラブルシューティングで扱っています。
現在の制限事項
/install-slack-app 経由のClaude Code in Slackには、次の制限があります。
- 対象はGitHubリポジトリのみ。GitLabやBitbucketのリポジトリは扱えない
- 1セッションで作成できるプルリクエストは1つまで
- Claude Code on the webへのアクセスが前提。アクセスがないユーザーは、通常のチャット応答しか受け取れない
Team・EnterpriseはClaude Tagへ移行
Team・Enterpriseのワークスペースでこのコマンドを使っている場合、Anthropicは段階的にClaude Tagへの切り替えを進めています。移行してもSlackアプリと@Claudeのハンドルはそのまま引き継がれ、切り替えのタイミングは各組織のアカウントチームから案内されます。権限モデルは個人のGitHub接続から組織管理のサービスアカウントへ変わります。そのため移行後に個人アカウントで作成したクラウド環境を使っているチャンネルは、Owner権限の管理者が組織共有の環境へ作り直す必要があります。
Claude TagとClaude Code in Slackの権限・課金・対応範囲の違いは、Claude TagとClaude CodeのSlack連携は何が違うかで詳しく比較しています。Team・Enterprise側のセットアップ手順まで含めた全体像はClaudeとSlackの連携にまとめてあります。
よくある質問
ワークスペース管理者でなくても/install-slack-appを実行できますか
コマンド自体は誰でも実行できますが、SlackはワークスペースへのアプリインストールにSlack側の管理者権限を要求することが多く、自分が管理者でない場合はブラウザでの承認画面で止まります。この場合は管理者にインストールを依頼し、完了後にApp Homeから自分のアカウントを接続します。
Claude Tag導入済みのワークスペースでこのコマンドを実行するとどうなりますか
Claude Tagが導入されているチャンネルでは、セッションは組織共有の環境で起動する設計になっています。自分の個人アカウントでクラウド環境を作成していると、その環境ではClaude Tag側のチャンネルセッションを起動できず即座に失敗します。この場合はOwner権限を持つ管理者が、組織共有のクラウド環境を作り直す必要があります。
まとめ
/install-slack-app は、Claude Code in SlackをPro・Maxプランで使うための導入コマンドです。実行してブラウザでOAuth認証を終えたあとも、App Homeでのアカウント接続とチャンネルへの/invite @Claudeが別途必要になる点は忘れやすいポイントです。Team・EnterpriseはClaude Tagへの移行対象になっているため、契約プランによって今後の位置づけが変わることも踏まえて導入するとよいでしょう。