Connecter OpenAI Codex à Google Cloud

Preview privée

Ce produit ou cette fonctionnalité sont soumis aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service et aux Conditions supplémentaires pour les produits d'IA générative en version preview. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Vous pouvez configurer la CLI OpenAI Codex et l'application de bureau Codex pour acheminer les requêtes de modèle via votre projet Google Cloud sur Agent Platform.

Codex s'exécute localement sur votre poste de travail de développement tout en s'authentifiant via Google Cloud Identity and Access Management (IAM) et en utilisant vos quotas Marketplace approuvés.

Avant de commencer

Pour utiliser OpenAI Codex avec Gemini Enterprise Agent Platform, vous devez procéder comme suit. L'API Gemini Enterprise Agent Platform (aiplatform.googleapis.com) doit être activée sur votre projet Google Cloud .

Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Gemini Enterprise Agent Platform API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Gemini Enterprise Agent Platform API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

1. Suivez les étapes d'intégration décrites dans Modèles OpenAI GPT, y compris l'achat du produit via Google Cloud Marketplace et l'activation du modèle dans Model Garden.

2. Si la règle de votre organisation limite l'accès au modèle, autorisez le modèle dans cette règle.

3. Installez la CLI Google Cloud et configurez les identifiants par défaut de l'application (ADC) :

   gcloud auth application-default login

4. Installez la CLI OpenAI Codex ou l'application de bureau Codex sur votre poste de travail.

Rôles requis

Pour obtenir les autorisations nécessaires pour connecter Codex aux modèles partenaires OpenAI, demandez à votre administrateur de vous accorder le rôle IAM Utilisateur de la plate-forme d'agents (roles/aiplatform.user) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Configuration interactive

Vous pouvez configurer Codex de manière interactive à l'aide du flux de connexion intégré.

CLI Codex

1. Démarrez codex dans votre terminal :

   codex

2. Sélectionnez Se connecter d'une autre manière, puis choisissez Utiliser Google Cloud (affiché sous la forme Utiliser Google Cloud Vertex AI dans la CLI).

3. Saisissez l'ID de votre projet Google Cloud .

4. Saisissez l'emplacement ou appuyez sur Entrée pour accepter global.

5. Appuyez sur Entrée pour utiliser les Identifiants par défaut de l'application sur votre ordinateur, ou saisissez un chemin absolu vers un fichier JSON d'identifiants de compte de service.

Application de bureau Codex

1. Ouvrez l'application de bureau Codex.
2. Sélectionnez Se connecter d'une autre manière, puis Utiliser Google Cloud.
3. Saisissez l'ID de votre projet Google Cloud .
4. Saisissez l'emplacement ou laissez le champ vide pour accepter global.
5. Laissez le chemin d'accès aux identifiants vide pour utiliser les Identifiants par défaut de l'application, ou sélectionnez un fichier JSON de clé de compte de service.
6. Sélectionnez Continuer, puis vérifiez la connexion.

Configurer Codex manuellement

Pour configurer Codex sans l'invite interactive, ajoutez les paramètres du fournisseur à ~/.codex/config.toml. Placez le paramètre model_provider de premier niveau avant les en-têtes de table :

model_provider = "gcp"

[model_providers.gcp]
project_id = "PROJECT_ID"
location = "global"

Remplacez les éléments suivants :

• <var>PROJECT_ID</var> : l'ID de votre projet Google Cloud (par exemple, my-project-123).

Si vous utilisez un fichier de clé de compte de service plutôt que les identifiants par défaut de l'application, spécifiez credential_file :

credential_file = "CREDENTIAL_FILE_PATH"

Remplacez les éléments suivants :

• <var>CREDENTIAL_FILE_PATH</var> : chemin absolu vers votre fichier JSON de clé de compte de service téléchargé (par exemple, /Users/myuser/.config/gcloud/sa-key.json).

Attention : Les clés de compte de service peuvent présenter des risques de sécurité si elles sont compromises. Dans la mesure du possible, utilisez les Identifiants par défaut de l'application ou des jetons de courte durée au lieu de stocker des clés de compte de service sur votre poste de travail local. Pour plus d'informations, consultez la page Bonnes pratiques pour gérer les clés de compte de service.

Variables d'environnement

Vous pouvez également utiliser des variables d'environnement sur la machine hôte Codex pour configurer ou remplacer vos paramètres :

• GOOGLE_CLOUD_PROJECT : définit l'ID de votre projet Google Cloud , ce qui vous permet d'omettre project_id de config.toml.
• GOOGLE_CLOUD_LOCATION : remplace l'emplacement du point de terminaison (par défaut : global).

Sélectionner des modèles et vérifier l'accès

Après la configuration, vérifiez votre connexion et l'accès au modèle :

1. Démarrez une nouvelle session avec codex ou créez une tâche dans Codex Desktop.
2. Exécutez /model dans la CLI ou ouvrez le sélecteur de modèle dans Codex Desktop.
3. Sélectionnez un modèle activé pour votre charge de travail :
   • gpt-6.1-sol : modèle partenaire phare pour le codage et les workflows agentiques.
   • gpt-6-luna : modèle partenaire à faible latence pour une assistance interactive rapide.
   • gpt-6-astra : modèle partenaire le plus performant pour le raisonnement complexe en plusieurs étapes.
   • gpt-6.1-terra : modèle de partenaire équilibré pour l'automatisation à haut débit.
4. Envoyez un prompt de test (par exemple, "Lister les fichiers du répertoire actuel") pour confirmer que l'authentification et le traitement de la requête ont réussi.

Compatibilité des fonctionnalités dans Codex

Lorsqu'il est connecté à Agent Platform, Codex utilise l'API OpenAI Responses. Le tableau suivant présente les fonctionnalités compatibles et non compatibles :

Fonctionnalité	Compatibilité	Description
Exécution locale de shell et de bash	Compatible	Codex exécute des commandes shell localement sur votre ordinateur de développement dans les limites autorisées du terminal.
Modification et application de correctifs aux fichiers	Compatible	Codex lit et modifie les fichiers localement sur votre poste de travail.
MCP (Model Context Protocol) local	Compatible	Les serveurs MCP locaux configurés dans ~/.codex/config.toml s'exécutent sur votre poste de travail.
Appel de fonction côté client	Compatible	Les requêtes d'outils de modèle sont évaluées et exécutées localement par le client Codex.
Recherche sur le Web et recherche de fichiers hébergées	Non compatible	Les outils de recherche OpenAI hébergés ne sont pas disponibles sur les points de terminaison Agent Platform pendant la preview privée.
Interpréteur de code hébergé	Non compatible	Les bacs à sable cloud distants hébergés par OpenAI ne sont pas disponibles. L'exécution de code s'effectue localement à l'aide d'outils locaux.

Étapes suivantes

• Découvrez l'intégration programmatique du SDK dans l'API Responses.
• Examinez les fonctionnalités et les spécifications des modèles dans Modèles OpenAI GPT.
• En savoir plus sur la surveillance des utilisations abusives et la conservation zéro des données