從 Linear 使用 Codex

📖 本篇術語速查表

英文 / 縮寫	中文	一句話解釋
Linear	—	專案管理工具，可把 issue 委派給 Codex。
自動分派	auto-assign	按規則自動把 issue 指給 Codex。
MCP for Local	本地 MCP	在本地任務裡連 Linear 的方式。

不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你配好 Linear 和 Codex 的整合（委派、自動分派、隱私）。

你是 Codex 與 Linear 整合顧問，幫我配好整合，把合適的 issue 委派給 Codex。

【角色】
你熟悉 Linear 整合的設定、委派工作、自動分派 issue、資料隱私安全、排障，以及本地任務連 Linear 的 MCP 方式。

【輸入】
- 我的 Linear 使用情況：___
- 想委派給 Codex 的 issue 型別：___
- 是否要自動分派：___
- 資料隱私顧慮：___

【工作流程】
1. 給整合設定步驟
2. 說明怎麼委派和（可選）自動分派
3. 標出資料隱私和許可權注意點
4. 給本地任務連 Linear 的 MCP 方式和排障

【輸出規範】
▌一、整合設定步驟
▌二、委派 / 自動分派設定
▌三、資料隱私與許可權提醒
▌四、本地 MCP 連線 + 排障

【硬約束】
- 只委派範圍明確、適合 Agent 的 issue
- 自動分派要有規則和兜底，不無差別派
- 注意 issue 資料的隱私邊界
- 許可權按最小必要
- 不確定的整合機制標註需查官方文件

你可以在 Linear 中使用 Codex，把 issues 裡的工作交給它處理。

把 issue assign 給 Codex，或在 comment 中 mention @Codex，Codex 就會建立 cloud task，並回復 progress 和 results。

Codex in Linear 適用於 paid plans，見 Pricing。

如果你使用 Enterprise plan，請讓 ChatGPT workspace admin 在 workspace settings 中開啟 Codex cloud tasks，並在 connector settings 中啟用 Codex for Linear。

Set Up the Linear Integration

先設定 Codex cloud tasks：在 Codex 中連線 GitHub，併為你希望 Codex 工作的 repository 建立 environment。
開啟 Codex settings，為 workspace 安裝 Codex for Linear。
在 Linear issue 的 comment thread 中 mention @Codex，以 link 你的 Linear account。

Delegate Work to Codex

你可以用兩種方式把工作交給 Codex。

Assign an Issue to Codex

安裝 integration 後，你可以像 assign 給 teammates 一樣，把 issues assign 給 Codex。

Codex 會開始工作，並把 updates 發回 issue。

截圖：

Mention `@Codex` in Comments

你也可以在 comment threads 中 mention @Codex，用來 delegate work 或 ask questions。

Codex 回覆後，可以繼續在同一 thread 中 follow up，延續同一個 session。

截圖：

Codex 開始處理 issue 後，會 choose an environment and repo 作為工作位置。

如果要固定到某個具體 repo，請寫在 comment 裡，例如：

@Codex fix this in openai/codex

跟蹤 progress：

開啟 issue 的 Activity，檢視 progress updates。
開啟 task link，檢視更詳細的執行過程。

task 完成後，Codex 會發布 summary 和 completed task link，方便你建立 pull request。

Codex 如何選擇環境和儲存庫

Linear 會根據 issue context suggested repository。Codex 會選擇最匹配該 suggestion 的 environment。若 request ambiguous，則 fallback 到你最近使用過的 environment。
task 會基於該 environment repo map 中列出的第一個 repository default branch 執行。如果你需要不同 default 或更多 repositories，請在 Codex 中更新 repo map。
如果沒有 suitable environment 或 repository，Codex 會在 Linear 中回覆修復說明，你處理後再 retry。

Automatically Assign Issues to Codex

你可以透過 triage rules 自動把 issues assign 給 Codex：

在 Linear 中開啟 Settings。
在 Your teams 下選擇你的 team。
在 workflow settings 中開啟 Triage 並啟用它。
在 Triage rules 中建立 rule，選擇 Delegate > Codex，並設定其他需要的 properties。

進入 triage 的 new issues 會自動 assign 給 Codex。

使用 triage rules 時，Codex 會使用 issue creator 的 account 執行 tasks。

截圖：

Data Usage, Privacy, and Security

當你 mention @Codex 或把 issue assign 給它時，Codex 會接收你的 issue content，用來理解 request 並建立 task。

data handling 遵循 OpenAI 的 Privacy Policy、Terms of Use 以及其他適用 policies。

更多 security 資訊，見 Codex security documentation。

Codex 使用 large language models，可能出錯。始終 review answers 和 diffs。

Tips and Troubleshooting

Missing connections：如果 Codex 無法確認你的 Linear connection，它會在 issue 中回覆一個 account connection link。
Unexpected environment choice：在 thread 中回覆你希望使用的 environment，例如 @Codex please run this in openai/codex。
Wrong part of the code：在 issue 中新增更多 context，或在 @Codex comment 中給出明確 instructions。
More help：見 OpenAI Help Center。

Connect Linear for Local Tasks (MCP)

如果你使用 Codex app、CLI 或 IDE Extension，並希望 Codex 在本地訪問 Linear issues，請設定 Codex 使用 Linear Model Context Protocol (MCP) server。

更多資訊見 Linear MCP docs。

IDE extension 和 CLI 使用同一套 configuration，因此 MCP server 的 setup steps 相同。

Use the CLI (Recommended)

如果已經安裝 CLI，執行：

codex mcp add linear --url https://mcp.linear.app/mcp

這個命令會提示你 sign in with Linear account，並連線到 Codex。

Configure Manually

在 editor 中開啟 ~/.codex/config.toml。
新增下面設定：

[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"

執行 codex mcp login linear 登入。

從 Linear 使用 Codex

本頁目錄