@phaseo/cli et exécutez phaseo login pour connecter des agents de code à Phaseo et gérer les clés, les espaces de travail, les préréglages, les réglages et les garde-fous depuis le terminal. La CLI lit aussi les modèles, les fournisseurs, les tarifs, les crédits, l’activité, les analyses et les générations.
Installer
Les exécutions interactives affichent aussi un message lorsqu’une version plus récente est publiée.
Se connecter
Les environnements distants et non interactifs utilisent automatiquement le code d’appareil. Vérifiez sous quelle identité vous êtes connecté, avec vos scopes, votre espace de travail actif et vos autres espaces de travail :
Gérer votre espace de travail
--json lorsqu’un agent ou un script lit la sortie. La CLI couvre les tâches courantes du compte ; les limites des clés, les budgets, le BYOK, les règles de routage, les préréglages et l’identité se modifient dans le tableau de bord ou avec une clé de gestion. Consultez Gérer Phaseo depuis un agent pour savoir quelles tâches la CLI couvre.
Connecter un agent de code
Utilisez le nom de l’agent comme commande. La CLI demande une clé dédiée, que vous approuvez dans votre navigateur, et écrit la configuration de l’agent :--model, --catalog all|default ou --dry-run selon vos besoins. phaseo setup <agent> et phaseo integrations setup <agent> fonctionnent aussi.
Approuver la clé dans le navigateur
La première fois que vous configurez un agent, la CLI ouvre une page du tableau de bord Phaseo et affiche son lien. La page indique l’espace de travail, le nom de la clé, sa limite de dépenses mensuelle de $100 et son expiration au bout de 90 jours, ainsi que le fait que la CLI Phaseo l’a demandée. Choisissez Approuver et créer la clé : la CLI récupère la clé une seule fois et termine la configuration. Si vous choisissez Refuser, ou laissez la demande expirer au bout de 10 minutes, rien n’est créé. Approuvez en étant connecté au tableau de bord avec le compte utilisé dans la CLI, en tant que propriétaire ou administrateur de l’espace de travail, et avec votre second facteur si vous en avez configuré un. En SSH ou en CI, ouvrez le lien affiché sur n’importe quel appareil où vous êtes connecté. Pour utiliser plutôt une clé créée dans le tableau de bord, transmettez-la avec--key <key>, ou avec --key-stdin pour qu’elle n’apparaisse pas dans l’historique du shell. La CLI vérifie la clé et l’enregistre, et ne la révoque pas quand vous retirez l’agent.
Pour exécuter Cline, Kilo Code, oh-my-pi, Muse Code ou MiniMax Code avec des réglages temporaires supprimés à leur fermeture, utilisez le lanceur de session. Les options Phaseo se placent avant --, celles de l’agent après :
phaseo run <cline|kilo|omp|muse|minimax> est la forme longue. Ajoutez --catalog all pour lister tous les modèles texte Phaseo actifs, ou --dry-run --json pour prévisualiser sans créer de clé. Dans un terminal interactif, les lanceurs proposent d’installer un agent manquant (MiniMax Code utilise son installateur PowerShell officiel sous Windows ; Muse Code doit être installé à la main sous Windows). Utilisez --skip-install lorsque vous gérez l’agent vous-même.
Agents de code liste chaque agent, ce que fait sa commande et son guide.
Écrire des scripts avec la CLI
Les commandes avec--json affichent une sortie structurée simple, sans couleurs ni indicateurs de progression. Ailleurs, les indicateurs de progression s’écrivent sur stderr et effacent leur ligne une fois terminés.
Comment la CLI protège les identifiants
- Les sessions sont stockées dans le magasin d’identifiants du système d’exploitation. Ne définissez
PHASEO_SESSION_BACKEND=fileque si aucun magasin d’identifiants n’est disponible ; les jetons d’actualisation sont alors conservés dans un fichier en clair aux permissions restreintes. phaseo logoutrévoque le jeton d’actualisation stocké avant d’effacer l’état local.- Les clés de gestion exigent des capacités explicites. Les clés d’inférence sont limitées par les garde-fous, les politiques de routage et les réglages de l’espace de travail, et non par des scopes.
Applications OAuth
Phaseo utilise un seul serveur d’autorisation OAuth pour la CLI, les applications créées par les utilisateurs et les clients MCP enregistrés dynamiquement. La CLI utilise la connexion par navigateur ou par appareil, avec des jetons d’actualisation renouvelés à chaque usage. Les clients tiers utilisent le code d’autorisation avec PKCE, des scopes explicites, le consentement par espace de travail et, en option, la liaison à une ressource protégée. Ils reçoivent un jeton d’accès révocable valable 7 jours et un jeton d’actualisation renouvelé à chaque usage, valable 90 jours après sa dernière utilisation ; consultez Créer un Workbench Next.js avec OAuth pour le fonctionnement de l’actualisation. Approuver à nouveau la même application renouvelle sa clé au lieu d’en ajouter une deuxième. OAuth pour les tiers est activé sur l’API Phaseo hébergée. Les déploiements de l’API auto-hébergés et de préversion le laissent désactivé, sauf siPHASEO_THIRD_PARTY_OAUTH_ENABLED a une valeur vraie : 1, true, yes ou on, sans distinction de casse et en ignorant les espaces autour.
.env