連結到 ChatGPT 桌面版

在 ChatGPT 桌面版中透過 Unity Gateway 搭配模型、MCP 工具和技能使用 Codex 代理。 ChatGPT 桌面版也支援 使用您自己的 ChatGPT 訂閱。

在 ChatGPT 桌面中使用 支援的開源模型 ,有助於降低成本。

Prerequisites

你需要 Azure Databricks 工作空間的 URL、想使用的模型和工具的存取權,以及最新版的 ChatGPT 桌面版。

如果您的管理員已經設定了您的裝置,請依照組織的啟動指示操作。

安裝 ug,然後在互動終端機執行此指令:

ug configure --agents codex

選擇你的工作區並登入。 此指令同時配置 Codex CLI 與已安裝的 ChatGPT 桌面代理程式,用於同一工作區。 如果被要求,請用你的裝置密碼批准系統設定更新。 ug 配置 Unity Gateway 連線及 OAuth 權杖重新整理。

在 Windows 上,從系統管理員終端機執行該指令。 Windows 上的 ChatGPT 桌面版需要 Codex 0.156.0 或更新版本才能套用此設定。

打開或重啟 ChatGPT 桌面版,然後開始 Codex 對話。 使用模型選擇器來更換模型。

新增 MCP 工具與技能

使用 ug 來新增 MCP 伺服器和你工作區可用的技能:

ug mcp add --agents codex
ug skills add

設定好後開啟或重新啟動 ChatGPT 桌面應用程式。 輸入 /mcp 以檢查 MCP 連線。 技能可從 ~/.agents/skills/取得。

關於手動模型、MCP及技能配置,請參見 Connect Codex。 這些設定同時適用於 Codex CLI 和 ChatGPT 桌面。

自備 ChatGPT 訂閱

若要在 ChatGPT 桌面版使用您自己的 ChatGPT 訂閱,請向您的管理員索取 ChatGPT 訂閱模型提供者服務。 請參閱 ChatGPT 訂閱支援 ,了解需求、管理設定、運作方式及限制。

  1. 在互動終端機中運行 ug configure --agents codex 。 在 外部模型中,選擇 ChatGPT 訂閱方案的模型提供者服務。
  2. 重新啟動 ChatGPT 桌面並使用 ChatGPT 登入。

ug ChatGPT 桌面版會連接到 ~/.codex/config.toml 一個本地代理伺服器,該代理伺服器以每位用戶 ug 登入服務運作,因此直接執行 codex 也會使用你的 ChatGPT 訂閱。 ug codex --provider 不會變更 ChatGPT 桌面版。 如果 ~/.codex/config.toml 已經設定好 model_provider,ug 會維持其原樣並列印警告。 若要停止使用您的 ChatGPT 訂閱,請使用不使用 ChatGPT 訂閱的服務提供者重新執行 ug configure --agents codex,或執行 ug revert。

限制

此配置同時設定 Codex CLI 與 ChatGPT 桌面版。 這個設定適用於兩者中的所有對話,且其推論路徑會經由 Unity Gateway。

ChatGPT 桌面版支援透過 Unity Gateway 的開源模型。 ChatGPT 桌面版不支援智慧路由。

Troubleshooting

  • ChatGPT 桌面版要求 OpenAI 登入: 如果你 自備 ChatGPT 訂閱,請用 ChatGPT 登入。 否則,請互動式重跑 ug configure --agents codex 並完成系統設定更新。 在 Windows 上,從以系統管理員權限開啟的終端機執行。 僅靠 CLI 設定設定檔無法完成 ChatGPT 桌面版的設定。 手動設定時,請確認 model_provider 位於頂層,且 requires_openai_auth = false 位於提供者資料表中。 不要把這個標誌加到使用 auth 資料表來重新整理 OAuth token 的 provider 上。

  • ug 報告 Codex ChatGPT relay cannot start: 請參閱 ChatGPT 訂閱支援中的 故障排除 。

  • 缺少一個模型:請檢查你的模型權限。 在活躍設定中設定 model 為完整的 Unity 目錄名稱,然後開始新的對話。

  • MCP 或技能連線失敗: 檢查網址、權限及連接器錯誤。 手動連線時,也要檢查令牌過期。 遇到 ug 設定問題時,請執行 ug doctor。

  • Workspace 登入是可以的,但有個工具會要求你登入: 打開 MCP 回傳的登入連結,登入外部服務提供者,然後再試一次通話。 Workspace 與身分識別提供者登入是分開的步驟。

下一步