Unity Gateway 將 Claude Code、Codex 和 OpenCode 等編碼代理程式與多個提供者的模型、MCP 工具及共享技能連結起來。 為任務選擇模型,讓客服人員存取公司資料,並使用團隊的工作流程。
你可以有兩種方式連結:
-
建議使用
ug: 安裝 Unity Gateway CLI,登入後啟動你偏好的代理程式。ug它會處理代理專屬的連線設定,並套用組織的設定,讓你可以直接開始寫程式,而不必修改設定檔或撰寫設定腳本。 - 自己設定連線: 在你的代理程式中輸入閘道端點和認證設定。 請參閱 支援的編碼與工作代理程式,選擇您的代理程式並開啟其指南。
透過 Unity Gateway 使用支援的開源模型,使用 Codex CLI、Claude Code、GitHub Copilot 和 ChatGPT 桌面版。
本指南將引導您逐步使用ug。
Note
如果你的管理員已經安裝 ug 並設定了你的裝置,那就直接啟動你的代理程式吧。
Prerequisites
您需要:
- 你的 Azure Databricks 工作空間 URL 以及你想使用的模型存取權。 如果沒有這些,請問你的行政人員。
- Python 3.12 或更新版本,以及
uv。 - 工作空間權限:工作區存取權或消費者存取權。 請參閱 權限管理。
設定並執行你的代理程式
安裝 ug
在你的終端機裡,執行:
uv tool install git+https://github.com/databricks/unity-gateway
要檢查安裝情況,請執行:
ug --version
你應該會看到安裝的版本號。
設定您的代理程式
在互動式終端機中執行:
ug configure
選擇您的工作區、登入,並選擇要設定的代理程式。 對於 Claude 和 Codex,ug configure 會設定 CLI 以及對應的桌面應用程式(如果已安裝),也就是 Claude 桌面 版或 ChatGPT desktop。 若要設定不含選擇器的特定代理,請使用 --agents 列出它們,例如 ug configure --agents claude,codex。 請參閱 ug CLI 參考資料。
啟動你的代理程式
在你的專案目錄中開啟終端機。 執行你想使用的代理程式指令:
克勞德密碼
ug claude
Codex
ug codex
Gemini CLI
ug gemini
OpenCode
ug opencode
GitHub Copilot 命令列界面 (CLI)
ug copilot
圓周率
ug pi
ug 處理與 Unity Gateway 的連線,然後用你已經熟悉的介面和工作流程開啟你選擇的代理程式。
若要使用 Claude 桌面 版或 ChatGPT 桌面版,請在 ug configure 完成後,開啟或重新啟動應用程式。
在會談中切換模式時,請從 /model 你組織提供的模式中選擇。
新增工具與技能
在你的終端機裡,執行:
ug mcp add
ug skills add
從你可存取的 MCP 伺服器和技能中,選擇你想新增的項目。 MCP 工具將您的客服人員與資料及服務連結;技能則提供特定任務的指示。
接著啟動或重啟代理程式,使用你新增的功能:
| 在代理程式內下達指令 | 您可以執行的作業 |
|---|---|
/mcp |
查看你新增的 MCP 伺服器及其連線狀態。 |
/skills |
瀏覽你新增的技能,並選擇一項適合你的任務。 |
斬擊指令因特工而異。 請查看它的說明選單,了解模型、MCP 和技能指令。 請參閱 「新增工具與技能 」以獲得更多設定選項。
檢查您的使用量
從終端查看 Unity Gateway 預算使用情況:
ug usage
輸出顯示你的個人與共享支出上限,以及各自使用的百分比。 它顯示最多五個限制,依使用率由高到低排序。 執行 ug usage --all 查看所有適用的限制。
欲了解更多資訊,請參閱 ug CLI 參考資料。