Atlassian Teamwork Graph CLI 怎樣接入 Codex？2026 教程

本週建議：先按 Atlassian 官方文件安裝 Teamwork Graph CLI 與 Codex Agent skills，完成身分驗證，再從只讀查詢驗證權限；合作公告不是新權限或功能已開放的證明。

適合使用 Codex CLI 處理程式碼庫任務、需要查詢 Jira 或 Confluence 上下文的開發者。
平台工程師與管理員可參考身分、權限和撤銷核對；AI Coding 團隊則可用本文確認接線後的執行與交付邊界。

最後更新於 2026 年 10 月 8 日；公告資訊核對自 OpenAI 合作公告，安裝、認證與權限以 Atlassian 官方 CLI 文件及插件資料為準。

1Teamwork Graph CLI 接入 Codex：合作公告與現有能力的分界

OpenAI 與 Atlassian 在 2026 年 10 月 6 日宣布擴大合作，公告提及 GPT-6 系列模型進入 Atlassian 平台、Codex 使用者透過相關插件取得專案上下文，以及雙方探索更深入的 Jira 整合。這幾項內容的狀態並不相同：公告列出的合作方向，不代表更深入的 Jira 整合已經普遍開放，也不代表所有 Codex 工作流程已自動接通。請以合作公告列出的功能與探索方向為準，分清已確認事項與仍在探索的部分。

Teamwork Graph CLI 是另一條接入路徑。你需要依 Atlassian 的官方安裝說明與公開插件倉庫確認當前安裝方式；不要把公告中的合作描述，當成 CLI 已獲得新權限或安裝後便能讀取整個組織資料的依據。

在實際配置前，先分清四個環節：

• Teamwork Graph CLI：執行對 Atlassian 工作上下文的查詢。
• Codex skills 或插件：讓 Agent 知道何時以及如何使用相關能力；它本身不是登入憑證。
• 身份認證：決定請求以哪個帳戶或授權身分執行。
• Atlassian 資料權限：限制這個身分能看見哪些內容；圖譜不應被理解為越權讀取通道。

因此，CLI 能否執行、Codex 能否呼叫，以及帳戶能否讀到特定資料，是三個分開的驗收問題。

2接線前：確認帳戶、終端與低風險任務

先選一個只讀、可回查來源的任務，例如查找某個需求工單及其關聯決策文件。記下你預期該帳戶能存取的工單、文件或程式碼協作資訊；若組織尚未替你開通存取，先由管理員確認，而不是在提示詞中要求 Agent 嘗試繞過限制。

在安裝前也要確認你的 Codex 使用方式與終端環境符合官方文件要求。不要沿用舊文章中未核實的命令或目錄；對照Teamwork Graph CLI 安裝文件和官方 Agent skills 說明，按現行文件逐項操作。若文件沒有說明某個系統、終端或帳戶類型受支援，就先視為待確認，而非推定可用。

3安裝里程碑：分開設定 CLI、skills 與登入

依官方安裝說明完成 CLI 設定，再參照公開插件倉庫與 Agent skills 指引，讓 Codex 能按預期呼叫技能。由於命令、檔案位置或設定方式可能隨文件更新而變動，這裡不複製未能即時核實的指令；請直接使用官方文件當下列出的命令，並確認執行結果與提示符合說明。

注意：安裝完成只證明相關元件已進入你的工作環境，不等於帳戶已完成授權，也不等於 Codex 已取得任何指定 Jira 專案或 Confluence 空間的存取權。

完成安裝後，按官方認證說明完成登入，然後依官方權限設定文件核對授權方式與資料範圍。若使用共用終端、CI 工作流程或團隊管理帳戶，還要確認實際執行時採用哪個身分、憑證存放位置是否合規，以及如何撤銷存取；不要把某位開發者的本機登入狀態，當作整個團隊都已完成配置。

4首次查詢：驗證可見資料與來源

把查詢限制在已知資料上，先確認 CLI 目前使用的帳戶與 Atlassian 站點，再詢問一項已知可讀的工單或文件。檢查 Agent 回覆是否能指出來源，並打開原始頁面逐項對照標題、需求與決策內容。

若結果缺漏，先分辨是尚未支援該類資料、站點或專案設定不同、帳戶沒有讀取權，還是 skills 沒有按預期被呼叫。不要只靠增加提示詞重試，也不要把「搜尋不到」直接判斷成 CLI 故障。相反地，可用一項你確定無權存取的資料做邊界測試：若結果出現不應可見的內容，立即停止後續操作，保存執行紀錄並交由管理員檢查。

Teamwork Graph CLI 與 Atlassian MCP 的差別，也應在這個階段按實際 Agent 架構評估，而不是只看名稱。參照官方 CLI 與 MCP 選型指南，確認你的工作流程需要 CLI 搭配 skills，還是以 MCP 工具為主；無論選哪一種，都不能省略身分與資料權限的核驗。

5FAQ：設定與權限邊界

Teamwork Graph CLI 要怎樣設定給 Codex 使用？

先依官方安裝文件設定 CLI，再按公開插件倉庫及 Agent skills 說明，設定 Codex 可呼叫的技能。CLI 負責執行查詢，skills 提供 Agent 使用方式，登入建立請求身分；三者不能互相代替。實際命令及路徑以你當下查閱的官方文件為準。

Codex 接上後可以查詢哪些 Atlassian 內容？

可查範圍取決於 CLI 支援的資料類型、組織設定及登入帳戶原有權限。用只讀查詢核對工單、文件與關聯上下文，並檢查回覆能否追溯至原始來源。圖譜可檢索不代表可以讀取帳戶原本無權存取的資料。

Teamwork Graph CLI 與 Atlassian MCP 應怎樣選？

先比對團隊現有 Agent 架構和整合方式，再參照官方選型指南。若 Codex 工作流依賴 skills 配合 CLI，可先驗證 CLI 路徑；若現有 Agent 以 MCP 工具為核心，則評估 MCP。選擇任一路徑，都要另行驗證身分、權限與資料來源。

如何驗證 Codex 使用的資料符合現有權限？

確認 CLI 登入身分與 Atlassian 站點，接著用已知可讀和不可讀的資料進行只讀測試，將 Agent 回覆與原始頁面逐項比較。依官方權限文件檢查組織設定、授權範圍及撤銷方式；不要只憑 Agent 的自述判定權限正確。

6編碼里程碑：從上下文查詢到交付驗收

通過只讀檢查後，再選一項影響範圍小、容易撤回的程式碼庫任務，例如依工單整理實作範圍或提出局部修改。讓 Codex 先列出引用的需求、決策和協作資料，再逐一開啟原始來源；只要引用錯誤或來源不可追溯，就不要讓 Agent 直接提交變更。

你可用以下清單作為首次接入的放行條件：

• [ ] CLI 安裝流程符合目前官方文件，Codex skills 也已按對應說明設定。
• [ ] 已確認執行請求採用的帳戶、站點及組織授權狀態。
• [ ] 只讀查詢能找到預期資料，回覆中的需求與決策可追溯至原始頁面。
• [ ] 邊界測試沒有顯示帳戶無權存取的資料。
• [ ] 程式碼修改、測試執行與交付審查分開記錄，沒有把「查到上下文」等同於「任務已完成」。

最後一項尤其重要：資料檢索成功，只能證明上下文取得流程有結果；程式碼修改是否正確，仍要審查差異並執行適用的測試。涉及 iOS 或 macOS 專案時，還要另外確認是否需要真實 macOS 與 Xcode 環境；Codex CLI 接通 Atlassian 資料，不能代替 Apple 工具鏈建置或交付驗收。

若你要延伸檢查 Agent 執行環境、身份與權限驗收，可從 vpstix 的繁體中文技術文章繼續了解長任務 Agent 的執行環境與恢復驗證。若工作本身需要持續遠端操作，可參閱 vpstix 的繁體中文使用說明，確認環境是否符合任務要求；Teamwork Graph CLI 並不因此必須部署在雲端 Mac。

7收尾判斷：本機工作流與 Mac 執行環境

一般只讀查詢或不需要 Apple 工具鏈的程式碼任務，先在現有終端按權限要求完成驗收即可。這樣不用為了接入 CLI 額外租用環境；但若你的工作站需要長時間保持執行、與日常開發環境隔離，或專案必須使用 Xcode 完成建置與測試，本機方案可能受限於設備可用性、環境一致性，以及離開工作站後難以持續操作等問題。遠端 Mac 可以作為這類工作的另一種執行環境，但不會替你解決 Atlassian 授權，也不代表任何 Agent 任務都需要 Mac。

先依任務需求選擇：只查工作上下文，就把重點放在 CLI 設定、身分及權限證據；需要 Apple 工具鏈或遠端持續執行，再比較自有 Mac、遠端環境與租用方案。若你正在驗證 Codex 程式碼庫工作流，並確實需要遠端 Mac 來承接 Apple 工具鏈交付，可再評估 vpstix 的租用方案；若不需要這類執行環境，維持本機工作流會更直接。