SandboxAQ Switch 完整教學 2026：10 分鐘讓 Claude Code 住進 Slack／Teams，AI Agent 常駐辦公室

SandboxAQ Switch 是什麼？

想像一下：你的開發團隊在 Slack 上討論 Bug，然後直接 @claude 叫 AI 把問題分析結果貼到同一個頻道——不需要開瀏覽器、不需要切換工具、不需要複製貼上。這就是 SandboxAQ Switch 解決的核心痛點。

SandboxAQ Switch 是一個開源的 AI Agent 協作平台適配器，讓任何 AI Agent（Claude Code、LangChain Agent、Google ADK、OpenAI Assistants API）在 10 分鐘內部署進 Slack、Microsoft Teams、Discord 或 Telegram，以原生 Bot 的形式與團隊互動。

SandboxAQ 是誰？這個背景很重要

SandboxAQ 成立於 2022 年，由 Google / Alphabet 內部孵化獨立，主要專注於量子計算與 AI 安全應用。開發 Switch 的是其旗下的 Flint AI 部門，專注於企業 AI 部署加速。

這個背景意味著：Switch 不是小型創業公司的實驗性工具，背後有 Google 工程文化加持，企業級可靠性相對有保障。PR Newswire 官方公告確認這不是社群 fork 而是 SandboxAQ 的正式開源產品。

支援平台一覽

對台灣企業特別注意：LINE 個人版目前不在支援清單（LINE Messaging API 架構不同），但 LINE Works（企業版 LINE）在 Roadmap 中。如果你的公司使用 LINE Works，值得持續追蹤。

vs 原生 Bot / vs n8n 整合：到底差在哪？

一句話總結：如果你已經有一個可以用 Python / TypeScript 調用的 AI Agent，Switch 是最快把它放進 Slack 的方式，不需要再寫 Bot 後端邏輯。

完整安裝教學：Slack 範例（Step by Step）

git clone https://github.com/sandboxaq/switch
cd switch
pip install -r requirements.txt   # Python 版本
# 或
npm install                       # TypeScript 版本

# switch/templates/slack-manifest.yaml
display_information:
  name: "Switch AI Agent"
  description: "AI Agent powered by SandboxAQ Switch"
features:
  app_home:
    home_tab_enabled: false
  bot_user:
    display_name: "AI Assistant"
    always_online: true
oauth_config:
  scopes:
    bot:
      - channels:history
      - channels:read
      - chat:write
      - im:history
      - im:write
      - app_mentions:read
settings:
  event_subscriptions:
    bot_events:
      - app_mention
      - message.im
  interactivity:
    is_enabled: false
  org_deploy_enabled: false

# .env
SWITCH_PLATFORM=slack
SLACK_BOT_TOKEN=xoxb-xxxxxxxxxxxx
SLACK_SIGNING_SECRET=xxxxxxxxxxxx

# AI Agent 設定（以 Claude 為例）
AGENT_TYPE=claude
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxx
AGENT_MODEL=claude-sonnet-4-5

# 可選：自訂 system prompt
AGENT_SYSTEM_PROMPT="你是一個 AI 開發助手，協助台灣工程師解決技術問題。請用繁體中文回答。"

# 本機測試（使用 ngrok 建立公開 HTTPS）
ngrok http 3000  # 在另一個終端機執行

# 啟動 Switch
python main.py  # 或 npm start

# 輸出應看到：
# ✅ Switch running on port 3000
# ✅ Slack platform adapter loaded
# ✅ Claude agent initialized

@Switch AI Agent 請分析以下 Python code 有什麼問題：
def get_user(id):
    return db.query(f"SELECT * FROM users WHERE id={id}")

Microsoft Teams 部署教學

Teams 的設定流程類似，主要差異在使用 Azure Bot Service：

# .env（Teams 版本）
SWITCH_PLATFORM=teams
MICROSOFT_APP_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
MICROSOFT_APP_PASSWORD=xxxxxxxxxxxxxxxxxxxx

# AI Agent（同 Slack，可用同一個 .env 切換 SWITCH_PLATFORM）
AGENT_TYPE=claude
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxx

讓 Claude Code Agent 常駐 Slack 頻道：進階設定

Switch 支援 Claude Code 的工具調用（Tool Use）功能，讓它在 Slack 頻道裡也能執行完整的 agent 任務。以下是一個讓 Claude Code 處理 GitHub PR Review 的設定：

# switch.config.yaml（進階設定）
agent:
  type: claude
  model: claude-sonnet-4-5
  system_prompt: |
    你是 AutoDev 團隊的 AI 開發助手。
    當收到 PR Review 請求時，分析程式碼品質、安全性和效能。
    用繁體中文回覆，格式化輸出包含：
    1. 問題摘要（1-3 個重點）
    2. 具體建議（附 code snippet）
    3. 嚴重程度（Critical / Major / Minor）

  tools:
    - file_read        # 讀取檔案
    - web_search       # 搜尋技術文檔
    - github_pr_fetch  # 取得 PR 差異

slack:
  allowed_channels:
    - "#engineering"
    - "#code-review"
  mention_required: true    # 需要 @mention 才觸發
  thread_replies: true      # 回覆在 thread 而非頻道主流

rate_limiting:
  requests_per_user_per_hour: 20
  max_tokens_per_response: 2000

台灣企業四大實戰場景

場景 1：工程團隊 Slack — Claude Code 常駐 PR Review

在 #code-review 頻道設定 Switch，讓 Claude Code 自動回應 PR Review 請求。開發者只需貼上 GitHub PR 連結並 @AI Review，10 秒內收到中文分析報告。

省時估算：5 人工程團隊，每週 20 個 PR，每個節省 5 分鐘 = 每週省 100 分鐘人力。

場景 2：電商公司 Teams — 庫存與訂單問答

將 LangChain Agent（已連接公司 ERP API）透過 Switch 部署進 Teams。業務人員直接在 Teams 問：「今天庫存還有幾件 SKU-123？」——不用進 ERP 後台，也不需要 IT 人員協助。

場景 3：新創公司 Discord — 全棧技術問答機器人

Discord 是台灣工程師社群常用平台。將 Google ADK Agent（連接技術文檔向量資料庫）透過 Switch 掛到 #dev-help 頻道，Junior 工程師可以直接在 Discord 問框架問題，不佔用 Senior 時間。

場景 4：遠端工作 Telegram 群組 — 多語言工作助手

台灣公司與海外合作夥伴常用 Telegram。Switch 可以讓 Claude 以多語言 Agent 身份在 Telegram 群組中運作，自動翻譯會議摘要、回答規格問題，讓台灣端與海外合作夥伴溝通更順暢。

Apache 2.0 + Commons Clause 授權說明

Switch 採用 Apache 2.0 + Commons Clause 雙重授權，這是近年來開源工具常用的「開源但不可商業競爭」模式：

• ✅ 可以：用於自家公司內部部署（商業使用，但是自用）
• ✅ 可以：修改源碼、整合進自家產品
• ✅ 可以：為客戶部署（顧問/SI 廠商）
• ❌ 不可以：把 Switch 包裝後以服務形式販售（即不能做「Switch as a Service」直接賺錢）

常見問題 FAQ

延伸閱讀

• DeepSeek Harness 完整教學：165K★ 插件式 Coding Agent 框架
• n8n 工作流程自動化教學 2026
• Claude Code 完整教學 2026
• Telegram Bot 商業應用完整指南
• OpenAI DevDay 2026 完整攻略：9/29 Fort Mason

本文部分連結為聯盟行銷連結，你點擊後若購買相關服務，AutoDev AI 可能獲得佣金，不影響你的費用，也不影響本文的客觀性。所有費用數字以官方頁面為準，AI API 定價可能隨時調整。