Konfiguriranje Codex z Amazon Bedrock

S tem vodnikom konfigurirajte Codex za uporabo modelov OpenAI, ki so na voljo prek Amazon Bedrock.

V tej konfiguraciji Codex uporablja poverilnice Amazon Bedrock in pošilja zahteve modela prek Bedrockove implementacije API-ja Responses. API, ki ga gosti OpenAI, ni na poti zahteve.

Ta nastavitev podpira lokalne poteke dela Codex v:

• Codex CLI

• Namizna aplikacija Codex

• Razširitev Codex za VS Code

Ta članek ne velja za Codex, konfiguriran s prijavo ChatGPT ali ključem API OpenAI.

Preden začnete

Prepričajte se, da imate:

• Codex CLI različice 0.128.0 ali novejše

• Namizno aplikacijo Codex ali razširitev VS Code različice 26.429.30905 ali novejše

• Dostop do podprtih modelov OpenAI v Amazon Bedrock

• Regijo AWS, kjer je izbrani model na voljo

• Preverjanje pristnosti, ki ga podpira Bedrock, konfigurirano za vaš račun AWS

Podprti modeli

Uporabite enega od teh točnih ID-jev modelov:

openai.gpt-5.6-sol

openai.gpt-5.6-terra

openai.gpt-5.6-luna

openai.gpt-5.5

openai.gpt-5.4

Priporočena privzeta vrednost:

openai.gpt-5.6-sol

Konfigurirajte Codex

Dodajte naslednje v:

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

Zamenjajte us-west-2 z regijo AWS, kjer je na voljo izbrani model.

Možnosti preverjanja pristnosti

Codex podpira dve poti preverjanja pristnosti za Amazon Bedrock:

1. Ključ API za Bedrock z uporabo AWS_BEARER_TOKEN_BEDROCK

2. Veriga poverilnic AWS SDK za zahteve, podpisane z IAM

Codex preverja pristnost v tem vrstnem redu:

1. AWS_BEARER_TOKEN_BEDROCK

2. Veriga poverilnic AWS SDK

Če je nastavljen AWS_BEARER_TOKEN_BEDROCK, ga Codex uporabi najprej. Sicer Codex preide na verigo poverilnic AWS SDK.

Za to konfiguracijo ne uporabljajte OPENAI_API_KEY. Codex uporablja poverilnice Amazon Bedrock, ko je model_provider nastavljen na amazon-bedrock.

Uporabite ključ API za Bedrock, če vaš račun AWS podpira ključe API za Bedrock. Uporabite poverilnice AWS SDK, če vaša organizacija upravlja dostop do Bedrock prek IAM, AWS SSO, poimenovanih profilov ali zvezne identitete.

Možnost 1: uporabite ključ API-ja Bedrock

Ključ API-ja Bedrock nastavite v okolju, ki ga bo prebral Codex:

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

Nato poskrbite, da konfiguracija Codexa vključuje regijo za Bedrock:

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

wire_api = "responses"

region = "us-west-2"

Pri preverjanju pristnosti s ključem API-ja Bedrock je regija obvezna.

Možnost 2: Uporaba poverilnic za AWS SDK

To možnost uporabite, ko želite, da se Codex preverja s poverilnicami AWS IAM.

Codex uporablja verigo poverilnic za AWS SDK, zato delujejo standardne nastavitve poverilnic AWS, vključno s skupnimi konfiguracijskimi datotekami AWS, spremenljivkami okolja, AWS SSO in imenovanimi profili.

Skupne poverilnice AWS

aws configure

Spremenljivke okolja

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>

Poverilnice za upravljavsko konzolo AWS

aws login

AWS SSO ali imenovani profil

aws sso login --profile <profile-name>

export AWS_PROFILE=<profile-name>

Profil lahko nastavite tudi neposredno v datoteki ~/.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 najprej uporabi model_providers.amazon-bedrock.aws.region, če je ta nastavljen. Sicer Codex pri preverjanju pristnosti prek SDK določitev regije prepusti privzeti konfiguracijski verigi za AWS SDK, ki vključuje AWS_REGION, AWS_DEFAULT_REGION in izbrani profil AWS.

• ~/.codex/config.toml

• AWS_REGION

• AWS_DEFAULT_REGION

• Izbrani profil AWS

Nastavitev regije v datoteki ~/.codex/config.toml je najbolj nedvoumna možnost.

Federirana identiteta z credential_process

Za poslovni SSO ali federacijo OIDC konfigurirajte profil AWS zunaj Codexa in pustite, da AWS SDK razreši poverilnice.

Primer vnosa v ~/.aws/config:

[profile codex-bedrock]

region = us-west-2

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

Nato v ~/.codex/config.toml nastavite Codex, da uporablja ta profil:

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"

Namizna aplikacija in razširitev VS Code

Namizne aplikacije in razširitve IDE morda ne podedujejo spremenljivk okolja iz vaše lupine.

Če Codex potrebuje spremenljivke okolja, kot je AWS_BEARER_TOKEN_BEDROCK, jih dodajte v:

~/.codex/.env

Primer:

AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>

AWS_REGION=us-west-2

Po spremembi ~/.codex/config.toml ali ~/.codex/.env znova zaženite namizno aplikacijo Codex ali razširitev VS Code.

Preverite nastavitev

Po konfiguraciji:

• V Codex CLI odprite /status in potrdite, da Codex uporablja ponudnika modela amazon-bedrock.

• V namizni aplikaciji Codex ali razširitvi VS Code po ponovnem zagonu aplikacije začnite novo sejo.

Znane omejitve

Naslednje funkcije trenutno niso na voljo v tej konfiguraciji:

• Generiranje slik

• Glasovni prepis za vnos

• Trgovina vtičnikov v oblaku

• Konfiguracija in pravilniki v oblaku

• Agenti v oblaku, vključno z agenti za pregled, varnost in splet

Razpoložljivost funkcij se lahko razlikuje med Codex s prijavo ChatGPT, Codex s ključem API OpenAI in Codex s ključem API za Amazon Bedrock.

Odpravljanje težav

Če nastavitev ne uspe, preverite naslednje:

• Vaša različica Codex izpolnjuje minimalno zahtevo.

• Vaš ID modela se točno ujema s podprtim modelom.

• Vaša regija AWS je nastavljena in izbrani model je na voljo v tej regiji.

• Vaše poverilnice AWS ali ključ API za Bedrock so veljavni in niso potekli.

• Vaša identiteta AWS ima dovoljenje za dostop do izbranega modela Bedrock.

• AWS_BEARER_TOKEN_BEDROCK ni nastavljen na potekli ali nenamerni ključ.

• Če uporabljate poverilnice AWS SDK, je vaš izbrani profil AWS veljaven.

• Pri uporabi namizne aplikacije ali razširitve VS Code so zahtevane spremenljivke okolja prisotne v ~/.codex/.env.

• Po spremembi konfiguracijskih datotek ali datotek okolja ste znova zagnali aplikacijo ali razširitev.

Za poverilnice AWS, dovoljenja IAM, dostop do modelov Bedrock, kvote, obračunavanje, regionalno razpoložljivost ali napake storitve Bedrock se obrnite na skrbnika AWS ali podporo AWS.

Podpora OpenAI lahko pomaga pri nastavitvi odjemalca Codex, konfiguraciji in lokalnem vedenju Codex.