# 策展 · X (Twitter) 🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：Jori Lallo (@jorilallo) · 平台：X (Twitter) · 日期：2026-04-10

> 原始來源：https://x.com/jorilallo/status/2042260534762856681

## 中文摘要

利用 Claude Managed Agents 建立 Linear 專案代理的橋接範例。

此專案提供一個橋接伺服器，能將 Claude Managed Agents 整合至 Linear 的 Agent Platform，讓使用者透過 @mention 即可與 Agent 互動。

**專案定位與限制**
此專案僅為示範性質，開發者需特別注意，官方明確標示該專案「不適用於生產環境」，僅適合作為技術驗證或參考使用。

**運作機制**
當使用者在 Linear 的 Issue 或評論中 @mention Agent 時，系統會透過以下流程運作：
- Linear 發送 `AgentSessionEvent` webhook 至伺服器。
- 伺服器必須在 10 秒內回覆「thinking」活動以確認請求。
- 系統隨即建立 Claude Managed Agent 工作階段，並將 Issue 的上下文帶入。
- Claude 的串流回應將被轉發回 Linear，並以 Agent 活動形式呈現給使用者。

**部署需求與設定**
若要部署此橋接服務，需滿足以下條件：
- 執行環境：需安裝 Bun runtime。
- 必要憑證：需準備 Anthropic API key、Claude Managed Agent ID 與環境 ID。
- Linear 設定：需具備管理員權限的 Linear 工作區，並建立 OAuth 應用程式以獲取 Client ID、Client Secret 及 Webhook Signing Secret。
- 環境變數：需配置 `.env.local` 檔案，填入包含 API 金鑰、URL 設定及 Linear 相關憑證等必要資訊。

**專案結構與介面**
該專案的程式碼結構清晰，主要分為以下模組：
- `main.ts`：負責處理 Webhook、OAuth 及健康檢查路由。
- `oauth.ts`：處理 Linear OAuth 流程（actor=app）以及 token 更新。
- `agent.ts`：負責 Claude Managed Agent 工作階段的橋接邏輯。
- 介面端點：包含 `/` (健康檢查)、`/oauth/authorize` (啟動 Linear OAuth 安裝流程)、`/oauth/callback` (OAuth 回呼並交換 token) 以及 `/webhook` (接收 Linear Agent 工作階段事件)。

## 標籤

Agent, 開源專案, 教學資源, Anthropic, Claude, Linear
