> ## Documentation Index > Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # CLI Phaseo > Installez la CLI officielle Phaseo, configurez vos environnements de programmation et gérez Phaseo depuis le terminal. La CLI Phaseo est distribuée sous la forme de `@phaseo/cli`. Elle connecte les environnements de programmation à Phaseo et fournit un workflow terminal officiel pour gérer le plan de contrôle Phaseo. Utilisez-la pour : * Vous connecter en tant qu’utilisateur Phaseo depuis un shell local ou distant, ou un environnement d’agent * Créer et renouveler des clés API ou des clés de gestion * Gérer les espaces de travail, les préréglages, les paramètres et les garde-fous * Utiliser OAuth dans la CLI officielle pendant que les applications OAuth créées par les utilisateurs restent en test privé * Consulter les modèles, fournisseurs, tarifs, crédits, activité, analyses et générations ## Installation ```bash title="npm" theme={null} npm install -g @phaseo/cli ``` ```bash title="pnpm" theme={null} pnpm add -g @phaseo/cli ``` ```bash title="yarn" theme={null} yarn global add @phaseo/cli ``` ```bash title="bun" theme={null} bun add -g @phaseo/cli ``` ## Vérifier la version installée ```bash theme={null} phaseo --version phaseo version phaseo version --json ``` * `phaseo --version` affiche la version installée. * `phaseo version` affiche la version et la commande de mise à jour recommandée pour le gestionnaire de paquets actuel. * Les exécutions interactives affichent aussi une suggestion de mise à jour lorsqu’une version publiée plus récente est disponible. L’ancienne commande `phaseo` reste disponible comme alias de compatibilité. ## Connexion Commencez par : ```bash theme={null} phaseo login ``` La CLI prend en charge deux parcours officiels : * **Se connecter avec Phaseo** : OAuth dans le navigateur avec code d’autorisation et PKCE * **Se connecter avec un code d’appareil** : idéal pour SSH, CI, les shells sans interface et les environnements d’agents Vous pouvez imposer l’un ou l’autre parcours : ```bash theme={null} phaseo login --browser phaseo login --device-code ``` Les environnements distants et non interactifs privilégient automatiquement le code d’appareil. ## Sortie du terminal Les terminaux interactifs affichent les couleurs et la hiérarchie visuelle de Phaseo, ainsi que des indicateurs temporaires pendant la configuration. Ceux-ci utilisent `stderr` et effacent leur ligne une fois le travail terminé. Un `stderr` non TTY et `TERM=dumb` désactivent l’animation ; `NO_COLOR` désactive les couleurs. Les commandes avec `--json` renvoient toujours une sortie structurée sans décoration, adaptée aux agents et à l’automatisation. N’utilisez `FORCE_COLOR=1` que si un wrapper de terminal prend en charge les couleurs sans se déclarer comme TTY. ## Vérifier votre identité ```bash theme={null} phaseo whoami phaseo whoami --json ``` Cette commande renvoie votre utilisateur Phaseo actuel, ses portées, l’espace de travail actif et les espaces disponibles. ## Créer des clés ```bash theme={null} phaseo keys create --name "Local CLI Key" phaseo keys create --name "Agent Sandbox Key" --json phaseo keys current ``` Utilisez `--json` lorsqu’un agent ou une automatisation doit récupérer une seule fois la clé créée au format brut. ## Gérer les espaces de travail et les garde-fous ```bash theme={null} phaseo workspaces list phaseo workspaces members phaseo guardrails list phaseo guardrails create --name "Production Safety" --body-json '{"enabled":true}' ``` La CLI permet d’utiliser depuis le terminal les fonctions utiles du tableau de bord Phaseo et des API de gestion. ## Lancer les outils de programmation compatibles Les intégrations persistantes utilisent directement le nom du produit : ```bash theme={null} phaseo codex phaseo claude-code phaseo deepseek-harness phaseo opencode phaseo pi phaseo prime-agent phaseo openclaw phaseo aider phaseo roo-code phaseo kilo-code phaseo continue phaseo cursor phaseo zed ``` Utilisez `--model`, `--catalog all|default` ou `--dry-run` selon vos besoins. L’ancienne forme `phaseo integrations setup ` reste disponible pour la compatibilité, mais n’est pas obligatoire. La CLI peut lancer Cline, Kilo Code, oh-my-pi, Muse Code et MiniMax Code avec une configuration fournisseur temporaire et une clé Phaseo dédiée. Chaque outil dispose d’un guide d’intégration avec les détails de configuration et de dépannage : [Cline](./cline), [Kilo Code](./kilo-code), [oh-my-pi](./oh-my-pi), [Muse Code](./muse-code) et [MiniMax Code](./minimax-code). ```bash theme={null} phaseo cline --model openai/gpt-5.6-terra -- --tui phaseo kilo --model openai/gpt-5.6-terra -- phaseo omp --model openai/gpt-5.6-terra -- phaseo muse --model meta/muse-spark-1.3 -- phaseo minimax --model openai/gpt-5.6-terra -- ``` Utilisez `phaseo run ` pour la forme explicite. Les options Phaseo précèdent `--` ; celles de l’outil le suivent. Utilisez `--catalog all` pour synchroniser tous les modèles texte/chat Phaseo actifs, ou prévisualisez sans créer d’identifiant avec : ```bash theme={null} phaseo cline --model openai/gpt-5.6-terra --dry-run --json ``` L’installation de Cline, Kilo Code et oh-my-pi est proposée interactivement s’ils sont absents. Muse Code et MiniMax Code utilisent leurs installateurs officiels si la commande manque. Sous Windows, MiniMax Code utilise son installateur PowerShell officiel ; utilisez `--skip-install` si vous gérez l’un des outils séparément. Les lanceurs n’écrasent pas les configurations Cline, Kilo, oh-my-pi, Muse Code ou MiniMax Code existantes. ## Applications OAuth Phaseo utilise un seul serveur d’autorisation OAuth pour la CLI officielle, les applications créées par les utilisateurs et les clients MCP enregistrés dynamiquement. La CLI utilise une connexion par navigateur ou code d’appareil avec des jetons d’actualisation renouvelés. Les clients tiers utilisent le code d’autorisation avec PKCE, des portées explicites et le consentement de l’espace de travail, des jetons d’accès délégués révocables et, en option, une association à une ressource protégée. L’API Phaseo hébergée active OAuth tiers. Les déploiements auto-hébergés ou de prévisualisation le désactivent, sauf si `PHASEO_THIRD_PARTY_OAUTH_ENABLED` reçoit une valeur vraie. Les valeurs acceptées sont `1`, `true`, `yes` et `on`, sans distinction de casse après suppression des espaces. Son activation expose la gestion des applications OAuth créées par les utilisateurs et l’enregistrement dynamique des clients ; associez-la donc à une configuration vérifiée des URI de redirection, du consentement, des secrets clients, des limites de débit et de l’autorisation des espaces de travail. ```bash title=".env" theme={null} PHASEO_THIRD_PARTY_OAUTH_ENABLED=true ``` ```bash title="Docker" theme={null} docker run -e PHASEO_THIRD_PARTY_OAUTH_ENABLED=true phaseo ``` ```yaml title="Kubernetes" theme={null} env: - name: PHASEO_THIRD_PARTY_OAUTH_ENABLED value: "true" ``` ## Modèle de sécurité * Par défaut, les sessions CLI nécessitent un stockage sécurisé fourni par le système d’exploitation. Définissez explicitement `PHASEO_SESSION_BACKEND=file` uniquement si aucun trousseau système n’est disponible ; les jetons d’actualisation seront stockés dans un fichier texte aux permissions restreintes. * `phaseo logout` révoque le jeton d’actualisation stocké avant d’effacer l’état local. * Les clés de gestion nécessitent des capacités explicites. * Les clés d’inférence classiques s’appuient sur les garde-fous, les règles de routage et les paramètres de l’espace de travail plutôt que sur un modèle de portées distinct. ## Mettre à jour ```bash title="npm" theme={null} npm install -g @phaseo/cli@latest ``` ```bash title="pnpm" theme={null} pnpm add -g @phaseo/cli@latest ``` ```bash title="yarn" theme={null} yarn global add @phaseo/cli@latest ``` ```bash title="bun" theme={null} bun add -g @phaseo/cli@latest ``` ## Étapes suivantes * [Clés de gestion de l’API](../../developers/management-api-keys.mdx) * [Authentification](../../developers/authentication.mdx) * [Codex](./codex.mdx) * [Claude Code](./claude-code.mdx) * [Cline](./cline) * [Kilo Code](./kilo-code) * [oh-my-pi](./oh-my-pi) * [Muse Code](./muse-code) * [MiniMax Code](./minimax-code) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.