メインコンテンツまでスキップ

コーディングエージェントの使用を開始する

Unity Gatewayは、Claude Code、Codex、OpenCodeなどのコーディングエージェントを複数のプロバイダーのモデル、MCPツール、および共有スキルに接続します。タスクのモデルを選択し、エージェントに社内データへのアクセス権を付与し、チームのワークフローを使用します。

接続方法には、次の 2 つがあります。

  • ug の使用(推奨): Unity Gateway CLI をインストールし、サインインして、ご希望のエージェントを起動します。ug がエージェント固有の接続設定を処理し、組織の構成を適用するため、設定ファイルの編集やセットアップスクリプトの作成を行わずにコーディングを開始できます。
  • 自分で接続をセットアップする: エージェントにゲートウェイEndpointと認証設定を入力します。エージェントを選択してガイドを開くには、対応しているコーディングエージェントと作業エージェントをご覧ください。

このガイドでは、ug の使用方法について説明します。

注記

管理者が既に ug をインストールし、デバイスを構成している場合は、直接エージェントの起動に進んでください。

前提条件​

必要なもの:

  • DatabricksワークスペースのURL、および使用するモデルへのアクセス権。これらをお持ちでない場合は、管理者にお問い合わせください。
  • Python 3.12以降およびuv。
  • ワークスペースの権利: ワークスペース アクセスまたはコンシューマー アクセス。エンタイトルメントの管理を参照してください。

エージェントを設定してランする​

ugのインストール​

ターミナルで次をランします。

Bash
uv tool install git+https://github.com/databricks/unity-gateway

インストールを確認するには、次を実行します:

Bash
ug --version

インストールされているバージョン番号が表示されます。

エージェントを起動する​

プロジェクトディレクトリでターミナルを開きます。使用するエージェントのコマンドを実行します。

Bash
ug claude

初回使用時は、プロンプトに従ってワークスペースを選択し、サインインします。ug は Unity Gateway への接続を処理し、使い慣れたインターフェイスとワークフローで選択したエージェントを開きます。

ClaudeおよびCodexの場合、ug configureはCLIおよび対応するワークエージェントがインストールされている場合はそれを構成します。構成後、通常通り Claude デスクトップ または ChatGPT デスクトップ を開きます。ワークエージェントのうち、AnthropicサブスクリプションリレーはClaudeデスクトップでのみ利用できます。

セッション中にモデルを切り替えるには、/modelを使用して、組織で利用可能なモデルから選択します。

ツールとスキルの追加​

ターミナルで次をランします。

Bash
ug mcp add
ug skills add

アクセス権を持つMCPサーバーとスキルの中から、追加するものを選択します。MCPツールはエージェントをデータやサービスに接続し、スキルは特定のタスクのための手順を提供します。

追加した内容を使用するには、エージェントを起動または再起動します。

エージェント内のコマンド

できること

/mcp

追加したMCPサーバーとその接続状態を表示します。

/skills

追加したスキルを参照して、タスクに適用するスキルを1つ選択します。

エージェント内のコマンド

できること

/mcp

追加したMCPサーバーとその接続状態を表示します。

/skills

追加したスキルを参照して、タスクに適用するスキルを1つ選択します。

スラッシュコマンドはエージェントによって異なります。モデル、MCP、スキルコマンドについては、そのヘルプメニューを確認してください。その他の設定オプションについては、ツールとスキルの追加を参照してください。

使用状況を確認する​

ターミナルからUnity Gatewayの予算使用量を確認します:

Bash
ug usage

出力には、個人および共有の支出制限と、それぞれに使用された割合が表示されます。最大 5 つの制限が表示され、使用割合の高い順に並べられます。すべての該当する制限を表示するには、ug usage --allをランします。

情報については、ug CLI リファレンスを参照してください。

次のステップ​