OpenAI Codex mit Google Cloud verbinden

Private Vorschau

Dieses Produkt oder diese Funktion unterliegt den Bedingungen für Pre‑GA-Angebote im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen und den Zusatzbedingungen für Vorschauprodukte auf Basis von generativer KI. Pre-GA-Produkte und -Features sind "im Ist-Zustand" verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

Sie können die OpenAI Codex CLI und die Codex Desktop-Anwendung so konfigurieren, dass Modellanfragen über Ihr Projekt in Google Cloud auf der Agent Platform weitergeleitet werden.

Codex wird lokal auf Ihrer Entwicklungsarbeitsstation ausgeführt und authentifiziert sich überGoogle Cloud Identity and Access Management (IAM). Dabei werden Ihre genehmigten Marketplace-Kontingente verwendet.

Hinweis

Wenn Sie OpenAI Codex mit der Gemini Enterprise Agent Platform verwenden möchten, müssen Sie die folgenden Schritte ausführen. Die Gemini Enterprise Agent Platform API (aiplatform.googleapis.com) muss in Ihrem Google Cloud -Projekt aktiviert sein.

Melden Sie sich in Ihrem Google Cloud Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

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. Führen Sie die Onboarding-Schritte unter OpenAI GPT-Modelle aus, einschließlich des Kaufs des Produkts über den Google Cloud Marketplace und der Aktivierung des Modells in Model Garden.

2. Wenn die Richtlinie Ihrer Organisation den Zugriff auf das Modell einschränkt, lassen Sie das Modell in dieser Richtlinie zu.

3. Installieren Sie die Google Cloud CLI und konfigurieren Sie Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC):

   gcloud auth application-default login

4. Installieren Sie die OpenAI Codex CLI oder die Codex Desktop-Anwendung auf Ihrer Workstation.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Agent Platform User (roles/aiplatform.user) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Verbinden von Codex mit OpenAI-Partnermodellen benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Interaktive Einrichtung

Sie können Codex interaktiv über den integrierten Anmeldevorgang konfigurieren.

Codex CLI

1. Starten Sie codex in Ihrem Terminal:

   codex

2. Wählen Sie Sign in another way (Auf andere Weise anmelden) und dann Use Google Cloud (Google Cloud verwenden) aus. In der Befehlszeile wird dies als Use Google Cloud Vertex AI (Google Cloud Vertex AI verwenden) angezeigt.

3. Geben Sie Ihre Google Cloud -Projekt-ID ein.

4. Geben Sie den Speicherort ein oder drücken Sie die Eingabetaste, um global zu akzeptieren.

5. Drücken Sie die Eingabetaste, um die Standardanmeldedaten für Anwendungen auf Ihrem Computer zu verwenden, oder geben Sie einen absoluten Pfad zu einer JSON-Datei mit den Anmeldedaten für ein Dienstkonto ein.

Codex Desktop-App

1. Öffnen Sie die Codex Desktop-App.
2. Wählen Sie Andere Option wählen und dann Google Cloud verwenden aus.
3. Geben Sie Ihre Google Cloud -Projekt-ID ein.
4. Geben Sie den Speicherort ein oder lassen Sie das Feld leer, um global zu akzeptieren.
5. Lassen Sie den Pfad für die Anmeldedaten leer, um die Standardanmeldedaten für Anwendungen zu verwenden, oder wählen Sie eine JSON-Datei für den Dienstkontoschlüssel aus.
6. Wählen Sie Weiter aus und prüfen Sie die Verbindung.

Codex manuell konfigurieren

Wenn Sie Codex ohne die interaktive Eingabeaufforderung konfigurieren möchten, fügen Sie die Anbietereinstellungen zu ~/.codex/config.toml hinzu. Platzieren Sie die Einstellung model_provider auf oberster Ebene vor allen Tabellenüberschriften:

model_provider = "gcp"

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

Ersetzen Sie Folgendes:

• <var>PROJECT_ID</var>: Ihre Google Cloud Projekt-ID (z. B. my-project-123).

Wenn Sie eine Dienstkontoschlüsseldatei anstelle von Standardanmeldedaten für Anwendungen verwenden, geben Sie credential_file an:

credential_file = "CREDENTIAL_FILE_PATH"

Ersetzen Sie Folgendes:

• <var>CREDENTIAL_FILE_PATH</var>: Der absolute Pfad zur heruntergeladenen JSON-Datei des Dienstkontoschlüssels (z. B. /Users/myuser/.config/gcloud/sa-key.json).

Achtung: Dienstkontoschlüssel können ein Sicherheitsrisiko darstellen, wenn sie manipuliert werden. Verwenden Sie nach Möglichkeit Standardanmeldedaten für Anwendungen oder kurzlebige Tokens, anstatt Dienstkontoschlüssel auf Ihrer lokalen Workstation zu speichern. Weitere Informationen finden Sie unter Best Practices für die Verwaltung von Dienstkontoschlüsseln.

Umgebungsvariablen

Sie können auch Umgebungsvariablen auf dem Codex-Hostcomputer verwenden, um Ihre Einstellungen zu konfigurieren oder zu überschreiben:

• GOOGLE_CLOUD_PROJECT: Legt Ihre Google Cloud Projekt-ID fest, sodass Sie project_id in config.toml weglassen können.
• GOOGLE_CLOUD_LOCATION: Überschreibt den Endpunktstandort (Standardwert ist global).

Modelle auswählen und Zugriff prüfen

Prüfen Sie nach der Einrichtung die Verbindung und den Modellzugriff:

1. Starten Sie eine neue Sitzung mit codex oder erstellen Sie eine neue Aufgabe in Codex Desktop.
2. Führen Sie /model in der Befehlszeile aus oder öffnen Sie die Modellauswahl in Codex Desktop.
3. Wählen Sie ein aktiviertes Modell für Ihre Arbeitslast aus:
   • gpt-6.1-sol: Flaggschiff-Partnermodell für Programmierung und Agentic Workflows.
   • gpt-6-luna: Partnermodell mit niedriger Latenz für schnelle interaktive Unterstützung.
   • gpt-6-astra: Leistungsstärkstes Partnermodell für komplexe mehrstufige Problemlösung.
   • gpt-6.1-terra: Ausgewogenes Partnermodell für die Automatisierung mit hohem Durchsatz.
4. Senden Sie einen Test-Prompt (z. B. „Dateien im aktuellen Verzeichnis auflisten“), um zu prüfen, ob die Authentifizierung und die Anfrageverarbeitung erfolgreich sind.

Funktionsunterstützung in Codex

Wenn Codex mit der Agent Platform verbunden ist, verwendet es die OpenAI Responses API. In der folgenden Tabelle sind die unterstützten und nicht unterstützten Funktionen aufgeführt:

Funktion	Unterstützt?	Beschreibung
Lokale Shell- und Bash-Ausführung	Unterstützt	Codex führt Shell-Befehle lokal auf Ihrer Entwicklungsmaschine innerhalb genehmigter Terminalgrenzen aus.
Dateien bearbeiten und patchen	Unterstützt	Codex liest und ändert Dateien lokal auf Ihrer Workstation.
Lokales Model Context Protocol (MCP)	Unterstützt	Lokale MCP-Server, die in ~/.codex/config.toml konfiguriert sind, werden auf Ihrer Workstation ausgeführt.
Clientseitige Funktionsaufrufe	Unterstützt	Anfragen an Modelltools werden vom Codex-Client lokal ausgewertet und ausgeführt.
Gehostete Websuche und Dateisuche	Nicht unterstützt	Gehostete OpenAI-Suchtools sind während der privaten Vorabversion nicht auf Agent Platform-Endpunkten verfügbar.
Gehosteter Code-Interpreter	Nicht unterstützt	Von OpenAI gehostete Remote-Cloud-Sandboxes sind nicht verfügbar. Die Code-Ausführung erfolgt lokal mit lokalen Tools.

Nächste Schritte

• Informationen zur programmatischen SDK-Integration finden Sie in der Responses API.
• Informationen zu den Funktionen und Spezifikationen der Modelle finden Sie unter OpenAI GPT-Modelle.
• Monitoring von Missbrauch und Keine Datenaufbewahrung.