Pour accéder à l’index complet de la documentation, consultez llms.txt. Pour obtenir la version Markdown d’une page de documentation, ajoutez .md à la fin de l’URL de la page.
Navigation principale

Collaboration et partage

Connecter Codex à Google Cloud Vertex AI

Configurez Codex pour envoyer des requêtes aux modèles via votre projet Google Cloud.

Les modèles OpenAI sur Google Cloud sont en préversion privée. Pour les utiliser dans votre projet, demandez l’accès.

Avant de commencer

Demandez à votre administrateur l’ID du projet, le nom du modèle et l’emplacement Vertex AI à utiliser avec Codex. Votre compte utilisateur ou votre compte de service doit être autorisé à appeler le modèle dans ce projet. Pour savoir comment configurer la facturation, accepter une offre privée sur Marketplace et activer le modèle, consultez les prérequis Google Cloud.

Avec l’emplacement par défaut, global, Google Cloud peut traiter les requêtes aux modèles dans plusieurs régions. Si votre organisation exige un traitement dans une région précise, vérifiez auprès de votre administrateur quel emplacement compatible utiliser avant d’envoyer une requête.

S’authentifier sur l’hôte Codex

Installez la CLI Google Cloud sur la machine où s’exécute Codex. Pour le développement local, exécutez la commande suivante pour vous connecter et configurer les identifiants par défaut de l’application (ADC).

gcloud auth application-default login

Si votre administrateur vous a fourni un fichier ADC, passez l’étape de connexion interactive et utilisez ce fichier lors de la configuration. Codex exécute gcloud auth application-default print-access-token pour obtenir un jeton d’accès.

Configurer Google Cloud dans Codex

Utilisez la CLI Codex version 0.167.0 ou ultérieure, ou l’application de bureau Codex version 26.1103.32239 ou ultérieure.

Si vous êtes déjà connecté à Codex ou si Google Cloud ne figure pas parmi les options de connexion, authentifiez-vous sur l’hôte Codex, puis configurez le fournisseur manuellement. Démarrez une nouvelle session dans la CLI ou une nouvelle tâche dans l’application de bureau, puis vérifiez qu’une requête au modèle aboutit.

Configuration de Google Cloud selon le client
  1. Lancez codex. Sélectionnez Sign in another way, puis Use Google Cloud Vertex AI.

Écran de sélection du fournisseur dans la CLI Codex, avec l’option « Use Google Cloud Vertex AI » sélectionnée.

  1. Saisissez l’ID du projet Google Cloud fourni par votre administrateur.

Écran de configuration de Google Cloud dans la CLI Codex qui demande l’ID du projet.

  1. Saisissez l’emplacement Vertex AI ou appuyez sur Entrée pour utiliser global.
  2. Saisissez le chemin absolu de votre fichier JSON d’identifiants ou appuyez sur Entrée pour utiliser les ADC de cet ordinateur. Codex vérifie qu’il peut obtenir un jeton avant d’enregistrer vos paramètres.
  3. Vérifiez qu’une requête au modèle aboutit.

Configurer le fournisseur manuellement

Dans ~/.codex/config.toml, définissez model_provider sur "gcp" avant tout en-tête de table. Renseignez l’ID du projet et l’emplacement sous [model_providers.gcp].

model_provider = "gcp"

[model_providers.gcp]
project_id = "my-project"
location = "global"

Si vous utilisez un fichier ADC, ajoutez credential_file = "/absolute/path/to/credentials.json" sous [model_providers.gcp]. Codex définit GOOGLE_APPLICATION_CREDENTIALS pour la commande d’authentification.

Vous pouvez omettre project_id si vous définissez GOOGLE_CLOUD_PROJECT sur l’hôte Codex. Si vous omettez location, Codex utilise GOOGLE_CLOUD_LOCATION si cette variable est définie et global dans le cas contraire.

Vérifier qu’une requête au modèle aboutit

  1. Démarrez une nouvelle session avec codex et saisissez /model, ou démarrez une nouvelle tâche dans l’application de bureau et ouvrez le sélecteur de modèles.
  2. Sélectionnez un modèle que votre administrateur a activé pour votre projet et demandez-lui de vous répondre par une courte salutation. Si vous recevez une réponse, Codex a pu s’authentifier et appeler ce modèle.

Si la validation des identifiants échoue, vérifiez que la machine où s’exécute Codex peut lancer gcloud et lire le fichier d’identifiants si vous en avez indiqué un. Pour vous reconnecter avec les identifiants de votre compte utilisateur local, exécutez gcloud auth application-default login sur cette machine.

Si l’authentification réussit, mais que la requête au modèle échoue, vérifiez que l’ID de votre projet et l’emplacement correspondent au déploiement du modèle. Demandez à votre administrateur de confirmer que votre compte utilisateur ou votre groupe a accès au projet et que le compte qui exécute Codex est autorisé à appeler le modèle.