开始使用编码代理

Unity Gateway 将 Claude Code、Codex 和 OpenCode 等编码代理连接到多个提供者的模型、MCP 工具和共享技能。 为任务选择一个模型,允许你的客服访问公司数据,并使用团队的工作流程。

你可以通过两种方式连接:

  • 建议使用 ug : 安装 Unity Gateway CLI,登录后启动你偏好的代理。 ug 它负责代理专用的连接设置并应用组织的配置,这样你可以在不修改配置文件或编写设置脚本的情况下开始编码。
  • 自己搭建连接: 在你的代理中输入网关端点和认证设置。 请参阅支持的编码和工作智能体,选择你的智能体并打开其指南。

通过 Unity Gateway 使用 Codex CLI、Claude Code、GitHub Copilot 和 ChatGPT 桌面版,搭配受支持的开源模型。

本指南将一步步引导你使用 ug。

注释

如果你的管理员已经安装 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 桌面版(如果已安装的话)。 要设置不使用选择器的具体代理,请用 --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

Pi

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 参考。

后续步骤