Unity Gateway CLI(ug)를 사용해 코딩 에이전트를 구성하고 실행하세요. 공략은 코딩 에이전트 퀵스타트를 참고하세요.
Install
설치하고 ug설치된 버전을 확인하세요:
uv tool install git+https://github.com/databricks/unity-gateway
ug --version
필수 uv 이며 Python 3.12 이상이 필요합니다.
Configure
| Command | 용도 |
|---|---|
ug configure |
Azure Databricks 작업 공간에 로그인하고 관리자 설정이나 가이드 설정으로 에이전트를 구성하세요. |
ug configure --workspace https://your-workspace.databricks.com |
에이전트가 지정된 URL에서 작업 공간을 사용하도록 설정하세요. |
ug configure --profile <name> --use-pat |
OAuth 대신 개인 액세스 토큰 으로 인증하세요. 먼저 databricks configure --host <workspace-url>토큰을 구성 프로필에 저장한 후, (예: )로 --profile 그 프로필을 전달합니다. --profile DEFAULT 프로필은 작업 공간 URL을 제공합니다. |
에이전트를 출동시키세요
이 명령들은 터미널에서 에이전트를 열어 평소 코딩 워크플로우를 시작할 수 있게 합니다.
| Command | 용도 |
|---|---|
ug |
관리자가 게시한 작업 공간 설정에서 선택한 에이전트를 실행하세요. |
ug claude |
Unity 게이트웨이를 통해 Claude 코드를 실행하세요. |
ug codex |
Unity 게이트웨이를 통해 코덱스를 출시하세요. |
ug gemini |
Unity 게이트웨이를 통해 Gemini CLI를 실행하세요. |
ug opencode |
Unity 게이트웨이를 통해 OpenCode를 실행하세요. |
ug copilot |
Unity 게이트웨이를 통해 GitHub Copilot CLI를 실행하세요. |
ug pi |
Unity 게이트웨이를 통해 Pi를 실행하세요. |
ug cursor |
에이전트 발사. 모델 요청은 당신의 커서 계정을 사용합니다. |
Claude Code나 Codex의 경우, 실행 전에 작업 공간 인증, 모델, 구성을 새 --refresh 로고침하세요. 또한 실행 명령어에 에이전트별 인자를 전달할 수도 있습니다.
MCP 서버
| Command | 용도 |
|---|---|
ug mcp add |
MCP 서버를 선택하고 그 연결을 설정한 에이전트에 추가하세요. |
ug mcp list |
설정된 MCP 서버와 각 에이전트가 보고한 상태를 표시합니다. |
ug mcp remove |
에이전트에서 제거할 MCP 연결을 선택하세요. 서버는 작업 공간에 남아 있습니다. |
기술
| Command | 용도 |
|---|---|
ug skills add |
게시된 기술을 선택하여 해당 파일을 로컬 에이전트 기술 디렉토리에 다운로드하세요. |
ug skills add --via mcp |
파일을 다운로드하지 않고도 MCP를 통해 선택한 Unity 카탈로그 스키마의 스킬을 연결할 수 있습니다. |
ug skills list |
에이전트에게 설정된 기술과 그 기술이 어떻게 추가되었는지 보여주세요. |
ug skills remove |
컴퓨터에서 삭제할 다운로드 스킬 폴더를 선택하세요. 출판된 기술은 변함이 없습니다. |
ug skills remove --via mcp |
스킬 레지스트리의 MCP 연결에서 선택한 스키마를 제거하세요. 다운로드한 스킬 파일은 보관됩니다. |
이름 서버와 기술, 스키마 선택, 프로젝트 다운로드에 대해서는 도구 및 기술 추가를 참조하세요.
세팅을 관리하세요
| Command | 용도 |
|---|---|
ug usage |
현재 지출, 총 예산, 사용 비율을 보여주세요. |
ug doctor |
로컬 설치 및 에이전트 구성을 확인하고, 발견된 문제에 대한 수정 방법을 제안하세요. |
ug upgrade |
GitHub에서 최신 Unity Gateway CLI 버전을 설치하세요. |
ug export |
관리자가 저장한 코딩 에이전트 구성을 JSON으로 출력해 재사용하세요. |
ug revert |
백업된 에이전트 구성 파일을 복원하고 저장된 설정 상태를 지우 ug세요. |
지휘부 도움말
설치된 버전의 옵션을 보려면 다음을 사용 --help 하세요:
| Command | 용도 |
|---|---|
ug --help |
사용 가능한 명령어와 일반 옵션을 표시하세요. |
ug configure --help |
작업 공간과 에이전트 설정 옵션을 표시하세요. |
ug skills add --help |
스킬 다운로드 옵션이나 MCP를 통해 연결하는 옵션을 보여주세요. |