Commencez avec les agents de codage
Unity Gateway connects coding agents such as Claude Code, Codex, and OpenCode to models from multiple providers, MCP tools, and shared skills. Choose a model for the task, give your agent access to company data, and use your team's workflows.
You can connect in two ways:
- Utilisez
ug(recommandé) : installez la CLI Unity Gateway, connectez-vous et lancez votre agent de prédilection.uggère les paramètres de connexion spécifiques à l’agent et applique la configuration de votre organisation, ce qui vous permet de start à coder sans modifier de fichiers de configuration ni rédiger de scripts d’installation. - Configurez la connexion vous-même : saisissez l’endpoint de la passerelle et les paramètres d’authentification dans votre agent. Consultez les agents de codage et de travail pris en charge pour choisir votre agent et ouvrir son guide.
Ce guide vous accompagne dans l'utilisation de ug.
Si votre administrateur a déjà installé ug et configuré votre appareil, passez directement au lancement de votre agent.
Prérequis
You need:
- Your Databricks workspace URL and access to the models you want to use. Ask your admin if you don't have these.
- Python 3,12 ou version ultérieure et
uv. - Un droit de workspace : accès Workspace ou accès Consommateur. Voir Gérer les droits.
Configurez et exécutez votre agent
Installer ug
Dans votre terminal, exécutez :
uv tool install git+https://github.com/databricks/unity-gateway
Pour vérifier l'installation, exécutez :
ug --version
Vous devriez voir le numéro de version installé.
Lancez votre agent
Ouvrez un terminal dans le répertoire de votre projet. Exécutez la commande pour l'agent que vous souhaitez utiliser :
- Claude Code
- Codex
- Gemini CLI
- OpenCode
- GitHub Copilot CLI
- Pi
ug claude
ug codex
ug gemini
ug opencode
ug copilot
ug pi
Lors de la première utilisation, suivez les invites pour sélectionner votre workspace et vous connecter. ug gère la connexion à Unity Gateway, puis ouvre l’agent que vous avez choisi avec la même interface et le même flux de travail que ceux que vous connaissez déjà.
Pour Claude et Codex, ug configure configure la CLI et l’agent de travail correspondant s’il est installé. Après la configuration, ouvrez normalement Claude pour ordinateur de bureau ou ChatGPT pour ordinateur de bureau. Parmi les agents de travail, le relais d’abonnement Anthropic n’est disponible que dans Claude pour ordinateur de bureau.
Pour changer de modèle au cours d’une session, utilisez /model pour faire votre choix parmi ceux qui sont mis à disposition par votre organisation.
Ajouter des outils et des compétences
Dans votre terminal, exécutez :
ug mcp add
ug skills add
Choisissez les serveurs MCP et les compétences que vous souhaitez ajouter parmi ceux auxquels vous avez accès. Les outils MCP connectent votre agent à des données et à des services ; les compétences fournissent des instructions pour des tâches spécifiques.
Lancez ensuite ou redémarrez votre agent pour utiliser ce que vous avez ajouté :
Commande au sein de votre agent | Ce que vous pouvez faire |
|---|---|
| Affichez les serveurs MCP que vous avez ajoutés ainsi que leur état de connexion. |
| Parcourez les compétences que vous avez ajoutées et sélectionnez-en une pour votre tâche. |
Les commandes par barre oblique varient selon l'agent. Consultez son menu d'aide pour connaître les commandes relatives aux modèles, au MCP et aux compétences. Consultez la page Add tools and skills pour plus d'options de configuration.
Vérifiez votre utilisation
Vérifiez votre consommation de budget Unity Gateway depuis votre terminal :
ug usage
La sortie affiche vos limites de dépenses personnelles et partagées ainsi que le pourcentage utilisé pour chacune. Elle affiche jusqu’à cinq limites, classées du pourcentage utilisé le plus élevé au plus bas. Exécutez ug usage --all pour voir toutes les limites applicables.
Pour plus d'information, consultez la référence CLI ug.