Codex konfigurēšana ar Amazon Bedrock

Izmantojiet šo ceļvedi, lai konfigurētu Codex lietot OpenAI modeļus, kas pieejami caur Amazon Bedrock.

Šajā konfigurācijā Codex izmanto Amazon Bedrock akreditācijas datus un sūta modeļa pieprasījumus, izmantojot Bedrock Responses API implementāciju. OpenAI mitinātais API nav pieprasījuma ceļā.

Šis iestatījums atbalsta lokālās Codex darbplūsmas šeit:

• Codex CLI

• Codex darbvirsmas lietotne

• Codex VS Code paplašinājums

Šis raksts neattiecas uz Codex, kas konfigurēts ar ChatGPT pierakstīšanos vai OpenAI API atslēgu.

Pirms sākat

Pārliecinieties, ka jums ir:

• Codex CLI versija 0.128.0 vai jaunāka

• Codex darbvirsmas lietotne vai VS Code paplašinājuma versija 26.429.30905 vai jaunāka

• Piekļuve atbalstītiem OpenAI modeļiem Amazon Bedrock vidē

• AWS reģions, kurā atlasītais modelis ir pieejams

• Bedrock atbalstīta autentifikācija, kas konfigurēta jūsu AWS kontam

Atbalstītie modeļi

Izmantojiet vienu no šiem precīzajiem modeļa ID:

openai.gpt-5.6-sol

openai.gpt-5.6-terra

openai.gpt-5.6-luna

openai.gpt-5.5

openai.gpt-5.4

Ieteicamais noklusējums:

openai.gpt-5.6-sol

Konfigurējiet Codex

Pievienojiet tālāk norādīto:

~/.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"

Aizstājiet us-west-2 ar AWS reģionu, kurā ir pieejams jūsu atlasītais modelis.

Autentifikācijas opcijas

Codex atbalsta divus Amazon Bedrock autentifikācijas ceļus:

1. Bedrock API atslēga, izmantojot AWS_BEARER_TOKEN_BEDROCK

2. AWS SDK akreditācijas datu ķēde IAM parakstītiem pieprasījumiem

Codex pārbauda autentifikāciju šādā secībā:

1. AWS_BEARER_TOKEN_BEDROCK

2. AWS SDK akreditācijas datu ķēde

Ja ir iestatīts AWS_BEARER_TOKEN_BEDROCK, Codex vispirms izmanto to. Pretējā gadījumā Codex izmanto AWS SDK akreditācijas datu ķēdi.

Neizmantojiet OPENAI_API_KEY šai konfigurācijai. Codex izmanto Amazon Bedrock akreditācijas datus, kad model_provider ir iestatīts uz amazon-bedrock.

Izmantojiet Bedrock API atslēgu, ja jūsu AWS konts atbalsta Bedrock API atslēgas. Izmantojiet AWS SDK akreditācijas datus, ja jūsu organizācija pārvalda piekļuvi Bedrock, izmantojot IAM, AWS SSO, nosauktos profilus vai federētu identitāti.

1. iespēja: izmantojiet Bedrock API atslēgu

Iestatiet Bedrock API atslēgu vidē, ko nolasīs Codex:

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

Pēc tam pārliecinieties, ka Codex konfigurācijā ir norādīts Bedrock reģions:

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

wire_api = "responses"

region = "us-west-2"

Izmantojot Bedrock API atslēgas autentifikāciju, reģions ir obligāts.

2. iespēja: izmantot AWS SDK akreditācijas datus

Izmantojiet šo metodi, ja vēlaties, lai Codex autentificētos ar AWS IAM akreditācijas datiem.

Codex izmanto AWS SDK akreditācijas datu ķēdi, tāpēc var izmantot standarta AWS akreditācijas datu konfigurācijas, tostarp koplietojamos AWS konfigurācijas failus, vides mainīgos, AWS SSO un nosauktos profilus.

Koplietojamie AWS akreditācijas dati

aws configure

Vides mainīgie

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 pārvaldības konsoles akreditācijas dati

aws login

AWS SSO vai nosaukts profils

aws sso login --profile <profile-name>

export AWS_PROFILE=<profile-name>

Profilu varat iestatīt arī tieši failā ~/.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"

Ja ir iestatīts model_providers.amazon-bedrock.aws.region, Codex vispirms izmanto to. Pretējā gadījumā SDK autentifikācijai Codex reģiona noteikšanu uztic AWS SDK noklusējuma konfigurācijas ķēdei, tostarp AWS_REGION, AWS_DEFAULT_REGION un atlasītajam AWS profilam.

• ~/.codex/config.toml

• AWS_REGION

• AWS_DEFAULT_REGION

• Atlasītais AWS profils

Reģiona iestatīšana failā ~/.codex/config.toml ir visprecīzākā iespēja.

Federēta identitāte ar credential_process

Korporatīvajai SSO vai OIDC federācijai konfigurējiet AWS profilu ārpus Codex un ļaujiet AWS SDK noteikt akreditācijas datus.

Ieraksta piemērs failā ~/.aws/config:

[profile codex-bedrock]

region = us-west-2

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

Pēc tam norādiet Codex uz šo profilu failā ~/.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"

Darbvirsmas lietotne un VS Code paplašinājums

Darbvirsmas lietotnes un IDE paplašinājumi var nemantot vides mainīgos no jūsu čaulas.

Ja Codex ir nepieciešami vides mainīgie, piemēram, AWS_BEARER_TOKEN_BEDROCK, pievienojiet tos šeit:

~/.codex/.env

Piemērs:

AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>

AWS_REGION=us-west-2

Pēc ~/.codex/config.toml vai ~/.codex/.env maiņas restartējiet Codex darbvirsmas lietotni vai VS Code paplašinājumu.

Pārbaudiet iestatījumu

Pēc konfigurēšanas:

• Codex CLI atveriet /status un apstipriniet, ka Codex izmanto amazon-bedrock modeļa nodrošinātāju.

• Codex darbvirsmas lietotnē vai VS Code paplašinājumā pēc lietotnes restartēšanas sāciet jaunu sesiju.

Zināmie ierobežojumi

Šajā konfigurācijā pašlaik nav pieejamas šādas funkcijas:

• Attēlu ģenerēšana

• Balss transkripcija ievadei

• Mākoņa spraudņu veikals

• Mākoņa konfigurācija un politikas

• Mākoņa aģenti, tostarp pārskatīšanas, drošības un tīmekļa aģenti

Funkciju pieejamība var atšķirties Codex ar ChatGPT pierakstīšanos, Codex ar OpenAI API atslēgu un Codex ar Amazon Bedrock API atslēgu.

Problēmu novēršana

Ja iestatīšana neizdodas, pārbaudiet tālāk norādīto:

• Jūsu Codex versija atbilst minimālajai prasībai.

• Jūsu modeļa ID precīzi atbilst atbalstītam modelim.

• Jūsu AWS reģions ir iestatīts, un atlasītais modelis ir pieejams šajā reģionā.

• Jūsu AWS akreditācijas dati vai Bedrock API atslēga ir derīgi un nav beigušies.

• Jūsu AWS identitātei ir atļauja piekļūt atlasītajam Bedrock modelim.

• AWS_BEARER_TOKEN_BEDROCK nav iestatīts uz atslēgu, kurai beidzies derīgums, vai neparedzētu atslēgu.

• Ja izmantojat AWS SDK akreditācijas datus, jūsu atlasītais AWS profils ir derīgs.

• Darbvirsmas lietotnei vai VS Code paplašinājumam nepieciešamie vides mainīgie ir pieejami failā ~/.codex/.env.

• Pēc konfigurācijas vai vides failu maiņas jūs restartējāt lietotni vai paplašinājumu.

Par AWS akreditācijas datiem, IAM atļaujām, Bedrock modeļa piekļuvi, kvotām, norēķiniem, reģionālo pieejamību vai Bedrock pakalpojuma kļūdām sazinieties ar savu AWS administratoru vai AWS Support.

OpenAI Support var palīdzēt ar Codex klienta iestatīšanu, konfigurāciju un lokālo Codex darbību.