在 ChatGPT 桌面版中透過 Unity Gateway 搭配模型、MCP 工具和技能使用 Codex 代理。 ChatGPT 桌面版也支援 使用您自己的 ChatGPT 訂閱。
在 ChatGPT 桌面中使用 支援的開源模型 ,有助於降低成本。
Prerequisites
你需要 Azure Databricks 工作空間的 URL、想使用的模型和工具的存取權,以及最新版的 ChatGPT 桌面版。
如果您的管理員已經設定了您的裝置,請依照組織的啟動指示操作。
連接 Unity Gateway CLI(建議)
安裝 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 訂閱支援 ,了解需求、管理設定、運作方式及限制。
- 在互動終端機中運行
ug configure --agents codex。 在 外部模型中,選擇 ChatGPT 訂閱方案的模型提供者服務。 - 重新啟動 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 與身分識別提供者登入是分開的步驟。