Codexi konfigureerimine Amazon Bedrockiga

Kasutage seda juhendit, et konfigureerida Codex kasutama Amazon Bedrocki kaudu saadaolevaid OpenAI mudeleid.

Selles konfiguratsioonis kasutab Codex Amazon Bedrocki mandaate ja saadab mudelipäringud Bedrocki Responses API teostuse kaudu. OpenAI hostitud API ei ole päringuteekonnas.

See seadistus toetab kohalikke Codexi töövooge järgmistes:

• Codex CLI

• Codexi töölauarakendus

• Codexi VS Code'i laiendus

See artikkel ei kehti Codexi kohta, mis on konfigureeritud ChatGPT sisselogimise või OpenAI API võtmega.

Enne alustamist

Veenduge, et teil oleks:

• Codex CLI versioon 0.128.0 või uuem

• Codexi töölauarakendus või VS Code'i laiendus versiooniga 26.429.30905 või uuem

• Juurdepääs Amazon Bedrockis toetatud OpenAI mudelitele

• AWS-i piirkond, kus valitud mudel on saadaval

• Teie AWS-i konto jaoks konfigureeritud Bedrocki toetatud autentimine

Toetatud mudelid

Kasuta üht järgmistest täpsetest mudeli ID-dest:

openai.gpt-5.6-sol

openai.gpt-5.6-terra

openai.gpt-5.6-luna

openai.gpt-5.5

openai.gpt-5.4

Soovitatav vaikevalik:

openai.gpt-5.6-sol

Codexi seadistamine

Lisa järgmine siia:

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

Asenda us-west-2 AWS-i piirkonnaga, kus valitud mudel on saadaval.

Autentimisvalikud

Codex toetab kahte Amazon Bedrocki autentimisteed:

1. Bedrocki API võti, kasutades AWS_BEARER_TOKEN_BEDROCK

2. AWS SDK mandaatide ahel IAM-iga allkirjastatud päringute jaoks

Codex kontrollib autentimist järgmises järjekorras:

1. AWS_BEARER_TOKEN_BEDROCK

2. AWS SDK mandaatide ahel

Kui AWS_BEARER_TOKEN_BEDROCK on määratud, kasutab Codex seda esimesena. Muidu kasutab Codex varuvariandina AWS SDK mandaatide ahelat.

Ärge kasutage selle konfiguratsiooni jaoks OPENAI_API_KEY. Codex kasutab Amazon Bedrocki mandaate, kui model_provider väärtuseks on määratud amazon-bedrock.

Kasutage Bedrocki API võtit, kui teie AWS-i konto toetab Bedrocki API võtmeid. Kasutage AWS SDK mandaate, kui teie organisatsioon haldab Bedrocki juurdepääsu IAM-i, AWS SSO, nimega profiilide või födereeritud identiteedi kaudu.

Valik 1: kasuta Bedrocki API-võtit

Määra Bedrocki API-võti keskkonnas, kust Codex seda loeb:

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

Seejärel veendu, et Codexi konfiguratsioon sisaldaks Bedrocki piirkonda:

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

wire_api = "responses"

region = "us-west-2"

Bedrocki API-võtmega autentimise korral on piirkond nõutav.

Variant 2: AWS SDK identimisteabe kasutamine

Kasutage seda varianti, kui soovite, et Codex autendiks AWS IAM-i identimisteabega.

Codex kasutab AWS SDK identimisteabe ahelat, seega toimivad standardsed AWS-i identimisteabe seadistused, sealhulgas jagatud AWS-i konfiguratsioonifailid, keskkonnamuutujad, AWS SSO ja nimega profiilid.

Jagatud AWS-i identimisteave

aws configure

Keskkonnamuutujad

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’i identimisteave

aws login

AWS SSO või nimega profiil

aws sso login --profile <profile-name>

export AWS_PROFILE=<profile-name>

Profiili saab määrata ka otse failis ~/.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 kasutab esmalt väärtust model_providers.amazon-bedrock.aws.region, kui see on määratud. Vastasel juhul delegeerib Codex SDK autentimise korral piirkonna määramise AWS SDK vaikekonfiguratsiooni ahelale, mis hõlmab väärtusi AWS_REGION ja AWS_DEFAULT_REGION ning valitud AWS-i profiili.

• ~/.codex/config.toml

• AWS_REGION

• AWS_DEFAULT_REGION

• Valitud AWS-i profiil

Piirkonna määramine failis ~/.codex/config.toml on kõige selgesõnalisem variant.

Föderatiivne identiteet: credential_process

Ettevõtte SSO või OIDC föderatsiooni puhul seadista AWS-i profiil väljaspool Codexit ja lase mandaadid lahendada AWS SDK-l.

Näide kirjest failis ~/.aws/config:

[profile codex-bedrock]

region = us-west-2

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

Seejärel määra Codex kasutama seda profiili failis ~/.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"

Töölauarakendus ja VS Code'i laiendus

Töölauarakendused ja IDE laiendused ei pruugi teie käsureakestast keskkonnamuutujaid pärida.

Kui Codex vajab keskkonnamuutujaid, nagu AWS_BEARER_TOKEN_BEDROCK, lisage need siia:

~/.codex/.env

Näide:

AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>

AWS_REGION=us-west-2

Pärast ~/.codex/config.toml või ~/.codex/.env muutmist taaskäivitage Codexi töölauarakendus või VS Code'i laiendus.

Seadistuse kontrollimine

Pärast konfigureerimist:

• Avage Codex CLIs /status ja kinnitage, et Codex kasutab amazon-bedrock mudeli pakkujat.

• Codexi töölauarakenduses või VS Code'i laienduses alustage pärast rakenduse taaskäivitamist uut seanssi.

Teadaolevad piirangud

Järgmised funktsioonid pole selles konfiguratsioonis praegu saadaval:

• Pildi genereerimine

• Sisendi kõnetranskriptsioon

• Pilve pluginate pood

• Pilve konfiguratsioon ja poliitikad

• Pilveagendid, sealhulgas ülevaatuse, turbe ja veebi agendid

Funktsioonide saadavus võib erineda Codexi puhul ChatGPT sisselogimisega, Codexi puhul OpenAI API võtmega ja Codexi puhul Amazon Bedrocki API võtmega.

Tõrkeotsing

Kui seadistamine nurjub, kontrollige järgmist:

• Teie Codexi versioon vastab miinimumnõudele.

• Teie mudeli ID vastab täpselt toetatud mudelile.

• Teie AWS-i piirkond on määratud ja valitud mudel on selles piirkonnas saadaval.

• Teie AWS-i mandaadid või Bedrocki API võti on kehtivad ega ole aegunud.

• Teie AWS-i identiteedil on luba valitud Bedrocki mudelile juurde pääseda.

• AWS_BEARER_TOKEN_BEDROCK ei ole määratud aegunud või soovimatule võtmele.

• Kui kasutate AWS SDK mandaate, on teie valitud AWS-i profiil kehtiv.

• Töölauarakenduse või VS Code'i laienduse kasutamisel on nõutavad keskkonnamuutujad olemas failis ~/.codex/.env.

• Taaskäivitasite rakenduse või laienduse pärast konfiguratsiooni- või keskkonnafailide muutmist.

AWS-i mandaatide, IAM-i õiguste, Bedrocki mudeli juurdepääsu, kvootide, arvelduse, piirkondliku saadavuse või Bedrocki teenuse vigade korral võtke ühendust oma AWS-i administraatori või AWS Supportiga.

OpenAI Support saab aidata Codexi kliendi seadistamise, konfiguratsiooni ja kohaliku Codexi käitumisega.