Διαμόρφωση του Codex με το Amazon Bedrock

Χρησιμοποιήστε αυτόν τον οδηγό για να διαμορφώσετε το Codex ώστε να χρησιμοποιεί μοντέλα OpenAI που είναι διαθέσιμα μέσω του Amazon Bedrock.

Σε αυτήν τη διαμόρφωση, το Codex χρησιμοποιεί διαπιστευτήρια Amazon Bedrock και στέλνει αιτήματα μοντέλου μέσω της υλοποίησης του Responses API από το Bedrock. Το API που φιλοξενείται από την OpenAI δεν βρίσκεται στη διαδρομή αιτήματος.

Αυτή η ρύθμιση υποστηρίζει τοπικές ροές εργασίας Codex σε:

• Codex CLI

• Εφαρμογή υπολογιστή Codex

• Επέκταση Codex VS Code

Αυτό το άρθρο δεν ισχύει για το Codex που έχει διαμορφωθεί με σύνδεση ChatGPT ή κλειδί API OpenAI.

Πριν ξεκινήσετε

Βεβαιωθείτε ότι έχετε:

• Codex CLI έκδοση 0.128.0 ή νεότερη

• Εφαρμογή υπολογιστή Codex ή επέκταση VS Code έκδοση 26.429.30905 ή νεότερη

• Πρόσβαση σε υποστηριζόμενα μοντέλα OpenAI στο Amazon Bedrock

• Μια Περιοχή AWS όπου είναι διαθέσιμο το επιλεγμένο μοντέλο

• Έλεγχος ταυτότητας που υποστηρίζεται από το Bedrock, διαμορφωμένος για τον λογαριασμό AWS σας

Υποστηριζόμενα μοντέλα

Χρησιμοποιήστε ένα από αυτά τα ακριβή αναγνωριστικά μοντέλου:

openai.gpt-5.6-sol

openai.gpt-5.6-terra

openai.gpt-5.6-luna

openai.gpt-5.5

openai.gpt-5.4

Προτεινόμενη προεπιλογή:

openai.gpt-5.6-sol

Διαμόρφωση του Codex

Προσθέστε τα εξής στο:

~/.codex/config.toml

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

region = "us-west-2"

wire_api = "responses"

# Optional for AWS SDK auth. If omitted, the AWS SDK uses AWS_PROFILE or the default profile.

# profile = "codex-bedrock"

Αντικαταστήστε το us-west-2 με την Περιοχή AWS όπου είναι διαθέσιμο το επιλεγμένο μοντέλο σας.

Επιλογές ελέγχου ταυτότητας

Το Codex υποστηρίζει δύο διαδρομές ελέγχου ταυτότητας Amazon Bedrock:

1. Κλειδί API Bedrock με χρήση του AWS_BEARER_TOKEN_BEDROCK

2. Αλυσίδα διαπιστευτηρίων AWS SDK για αιτήματα υπογεγραμμένα με IAM

Το Codex ελέγχει τον έλεγχο ταυτότητας με αυτήν τη σειρά:

1. AWS_BEARER_TOKEN_BEDROCK

2. Αλυσίδα διαπιστευτηρίων AWS SDK

Αν έχει οριστεί το AWS_BEARER_TOKEN_BEDROCK, το Codex το χρησιμοποιεί πρώτο. Διαφορετικά, το Codex επιστρέφει στην αλυσίδα διαπιστευτηρίων AWS SDK.

Μην χρησιμοποιείτε το OPENAI_API_KEY για αυτήν τη διαμόρφωση. Το Codex χρησιμοποιεί διαπιστευτήρια Amazon Bedrock όταν το model_provider έχει οριστεί σε amazon-bedrock.

Χρησιμοποιήστε ένα κλειδί API Bedrock αν ο λογαριασμός AWS σας υποστηρίζει κλειδιά API Bedrock. Χρησιμοποιήστε διαπιστευτήρια AWS SDK αν ο οργανισμός σας διαχειρίζεται την πρόσβαση στο Bedrock μέσω IAM, AWS SSO, ονομασμένων προφίλ ή ομόσπονδης ταυτότητας.

Επιλογή 1: Χρήση κλειδιού API του Bedrock

Ορίστε το κλειδί API του Bedrock στο περιβάλλον από το οποίο θα το διαβάσει το Codex:

export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>

Στη συνέχεια, βεβαιωθείτε ότι η διαμόρφωση του Codex περιλαμβάνει μια Περιοχή Bedrock:

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

wire_api = "responses"

region = "us-west-2"

Η Περιοχή απαιτείται όταν χρησιμοποιείτε έλεγχο ταυτότητας Bedrock με κλειδί API.

Επιλογή 2: Χρήση διαπιστευτηρίων AWS SDK

Χρησιμοποιήστε αυτήν τη διαδρομή όταν θέλετε το Codex να ελέγχει την ταυτότητά του με διαπιστευτήρια AWS IAM.

Το Codex χρησιμοποιεί την αλυσίδα διαπιστευτηρίων AWS SDK, επομένως μπορούν να λειτουργήσουν τυπικές ρυθμίσεις διαπιστευτηρίων AWS, όπως κοινόχρηστα αρχεία διαμόρφωσης AWS, μεταβλητές περιβάλλοντος, AWS SSO και ονομασμένα προφίλ.

Κοινόχρηστα διαπιστευτήρια AWS

aws configure

Μεταβλητές περιβάλλοντος

export AWS_ACCESS_KEY_ID=<your-access-key-id>

export AWS_SECRET_ACCESS_KEY=<your-secret-access-key>

export AWS_SESSION_TOKEN=<your-session-token>

Διαπιστευτήρια AWS Management Console

aws login

AWS SSO ή ονομασμένο προφίλ

aws sso login --profile <profile-name>

export AWS_PROFILE=<profile-name>

Μπορείτε επίσης να ορίσετε το προφίλ απευθείας στο ~/.codex/config.toml:

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

profile = "codex-bedrock"

wire_api = "responses"

region = "us-west-2"

Το Codex χρησιμοποιεί πρώτα το model_providers.amazon-bedrock.aws.region, όταν έχει οριστεί. Διαφορετικά, για έλεγχο ταυτότητας SDK, το Codex αναθέτει την επίλυση της Περιοχής στην προεπιλεγμένη αλυσίδα διαμόρφωσης του AWS SDK, συμπεριλαμβανομένων των AWS_REGION, AWS_DEFAULT_REGION και του επιλεγμένου προφίλ AWS.

• ~/.codex/config.toml

• AWS_REGION

• AWS_DEFAULT_REGION

• Το επιλεγμένο προφίλ AWS

Ο ορισμός της Περιοχής στο ~/.codex/config.toml είναι η πιο ρητή επιλογή.

Ομόσπονδη ταυτότητα με credential_process

Για εταιρικό SSO ή ομοσπονδία OIDC, διαμορφώστε το προφίλ AWS εκτός του Codex και αφήστε το AWS SDK να επιλύσει τα διαπιστευτήρια.

Παράδειγμα καταχώρισης ~/.aws/config:

[profile codex-bedrock]

region = us-west-2

credential_process = /path/to/your/idp-helper --profile codex-bedrock

Στη συνέχεια, κατευθύνετε το Codex σε αυτό το προφίλ στο ~/.codex/config.toml:

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

profile = "codex-bedrock" wire_api = "responses"

region = "us-west-2"

Εφαρμογή υπολογιστή και επέκταση VS Code

Οι εφαρμογές υπολογιστή και οι επεκτάσεις IDE ενδέχεται να μην κληρονομούν μεταβλητές περιβάλλοντος από το κέλυφός σας.

Αν το Codex χρειάζεται μεταβλητές περιβάλλοντος όπως AWS_BEARER_TOKEN_BEDROCK, προσθέστε τις στο:

~/.codex/.env

Παράδειγμα:

AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>

AWS_REGION=us-west-2

Αφού αλλάξετε το ~/.codex/config.toml ή το ~/.codex/.env, επανεκκινήστε την εφαρμογή υπολογιστή Codex ή την επέκταση VS Code.

Επαλήθευση ρύθμισης

Μετά τη διαμόρφωση:

• Στο Codex CLI, ανοίξτε το /status και επιβεβαιώστε ότι το Codex χρησιμοποιεί τον πάροχο μοντέλου amazon-bedrock.

• Στην εφαρμογή υπολογιστή Codex ή στην επέκταση VS Code, ξεκινήστε μια νέα περίοδο λειτουργίας μετά την επανεκκίνηση της εφαρμογής.

Γνωστοί περιορισμοί

Οι ακόλουθες δυνατότητες δεν είναι προς το παρόν διαθέσιμες σε αυτήν τη διαμόρφωση:

• Δημιουργία εικόνας

• Μεταγραφή φωνής για είσοδο

• Κατάστημα πρόσθετων cloud

• Διαμόρφωση και πολιτικές cloud

• Πράκτορες cloud, συμπεριλαμβανομένων πρακτόρων ελέγχου, ασφάλειας και ιστού

Η διαθεσιμότητα δυνατοτήτων μπορεί να διαφέρει μεταξύ του Codex με σύνδεση ChatGPT, του Codex με κλειδί API OpenAI και του Codex με κλειδί API Amazon Bedrock.

Αντιμετώπιση προβλημάτων

Αν η ρύθμιση αποτύχει, ελέγξτε τα εξής:

• Η έκδοση Codex σας πληροί την ελάχιστη απαίτηση.

• Το αναγνωριστικό μοντέλου σας ταιριάζει ακριβώς με ένα υποστηριζόμενο μοντέλο.

• Η Περιοχή AWS σας έχει οριστεί και το επιλεγμένο μοντέλο είναι διαθέσιμο σε αυτήν την Περιοχή.

• Τα διαπιστευτήρια AWS ή το κλειδί API Bedrock είναι έγκυρα και δεν έχουν λήξει.

• Η ταυτότητα AWS σας έχει άδεια πρόσβασης στο επιλεγμένο μοντέλο Bedrock.

• Το AWS_BEARER_TOKEN_BEDROCK δεν έχει οριστεί σε ληγμένο ή μη προβλεπόμενο κλειδί.

• Αν χρησιμοποιείτε διαπιστευτήρια AWS SDK, το επιλεγμένο προφίλ AWS είναι έγκυρο.

• Για χρήση εφαρμογής υπολογιστή ή επέκτασης VS Code, οι απαιτούμενες μεταβλητές περιβάλλοντος υπάρχουν στο ~/.codex/.env.

• Επανεκκινήσατε την εφαρμογή ή την επέκταση αφού αλλάξατε αρχεία διαμόρφωσης ή περιβάλλοντος.

Για διαπιστευτήρια AWS, άδειες IAM, πρόσβαση σε μοντέλα Bedrock, ποσοστώσεις, χρέωση, περιφερειακή διαθεσιμότητα ή σφάλματα υπηρεσίας Bedrock, επικοινωνήστε με τον διαχειριστή AWS σας ή την Υποστήριξη AWS.

Η Υποστήριξη OpenAI μπορεί να βοηθήσει με τη ρύθμιση του προγράμματος-πελάτη Codex, τη διαμόρφωση και την τοπική συμπεριφορά του Codex.