Määritä Codex Amazon Bedrockin kanssa

Tämän oppaan avulla voit määrittää Codexin käyttämään Amazon Bedrockin kautta saatavilla olevia OpenAI-malleja.

Tässä kokoonpanossa Codex käyttää Amazon Bedrock -tunnistetietoja ja lähettää mallipyynnöt Bedrockin Responses API -toteutuksen kautta. OpenAI:n isännöimä API ei ole pyyntöpolussa.

Tämä määritys tukee paikallisia Codex-työnkulkuja seuraavissa:

• Codex CLI

• Codex-työpöytäsovellus

• Codex VS Code -laajennus

Tämä artikkeli ei koske Codexia, joka on määritetty ChatGPT-kirjautumisella tai OpenAI API -avaimella.

Ennen aloittamista

Varmista, että sinulla on:

• Codex CLI -versio 0.128.0 tai uudempi

• Codex-työpöytäsovellus tai VS Code -laajennus versio 26.429.30905 tai uudempi

• Käyttöoikeus tuettuihin OpenAI-malleihin Amazon Bedrockissa

• AWS-alue, jolla valittu malli on saatavilla

• AWS-tilillesi määritetty Bedrockin tukema todennus

Tuetut mallit

Käytä jotakin näistä täsmällisistä mallitunnuksista:

openai.gpt-5.6-sol

openai.gpt-5.6-terra

openai.gpt-5.6-luna

openai.gpt-5.5

openai.gpt-5.4

Suositeltu oletus:

openai.gpt-5.6-sol

Määritä Codex

Lisää seuraava tiedostoon:

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

Korvaa us-west-2 sillä AWS-alueella, jolla valitsemasi malli on käytettävissä.

Todennusvaihtoehdot

Codex tukee kahta Amazon Bedrock -todennuspolkua:

1. Bedrock API -avain käyttäen muuttujaa AWS_BEARER_TOKEN_BEDROCK

2. AWS SDK -tunnistetietoketju IAM-allekirjoitetuille pyynnöille

Codex tarkistaa todennuksen tässä järjestyksessä:

1. AWS_BEARER_TOKEN_BEDROCK

2. AWS SDK -tunnistetietoketju

Jos AWS_BEARER_TOKEN_BEDROCK on määritetty, Codex käyttää sitä ensin. Muussa tapauksessa Codex käyttää AWS SDK -tunnistetietoketjua varavaihtoehtona.

Älä käytä OPENAI_API_KEY-avainta tässä kokoonpanossa. Codex käyttää Amazon Bedrock -tunnistetietoja, kun model_provider-arvoksi on asetettu amazon-bedrock.

Käytä Bedrock API -avainta, jos AWS-tilisi tukee Bedrock API -avaimia. Käytä AWS SDK -tunnistetietoja, jos organisaatiosi hallinnoi Bedrock-käyttöoikeutta IAM:n, AWS:n kertakirjautumisen, nimettyjen profiilien tai federatiivisen identiteetin kautta.

Vaihtoehto 1: käytä Bedrockin API-avainta

Määritä Bedrockin API-avain ympäristöön, josta Codex lukee sen:

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

Varmista sitten, että Codexin määritys sisältää Bedrockin alueen:

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

wire_api = "responses"

region = "us-west-2"

Alue vaaditaan, kun käytetään Bedrockin API-avaintodennusta.

Vaihtoehto 2: Käytä AWS SDK -tunnistetietoja

Valitse tämä tapa, kun haluat Codexin todentavan käyttäjän AWS IAM -tunnistetiedoilla.

Codex käyttää AWS SDK:n tunnistetietoketjua, joten tavalliset AWS-tunnistetietomääritykset toimivat. Niitä ovat esimerkiksi jaetut AWS-määritystiedostot, ympäristömuuttujat, AWS-kertakirjautuminen ja nimetyt profiilit.

Jaetut AWS-tunnistetiedot

aws configure

Ympäristömuuttujat

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 Consolen tunnistetiedot

aws login

AWS-kertakirjautuminen tai nimetty profiili

aws sso login --profile <profile-name>

export AWS_PROFILE=<profile-name>

Voit määrittää profiilin myös suoraan tiedostossa ~/.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 käyttää ensisijaisesti asetusta model_providers.amazon-bedrock.aws.region, jos se on määritetty. Muussa tapauksessa Codex jättää SDK-todennuksessa alueen määrityksen AWS SDK:n oletusmääritysketjulle, johon kuuluvat AWS_REGION, AWS_DEFAULT_REGION ja valittu AWS-profiili.

• ~/.codex/config.toml

• AWS_REGION

• AWS_DEFAULT_REGION

• Valittu AWS-profiili

Alueen määrittäminen tiedostossa ~/.codex/config.toml on yksiselitteisin vaihtoehto.

Federoitu identiteetti credential_process-määrityksellä

Määritä yrityksen kertakirjautumista tai OIDC-federaatiota varten AWS-profiili Codexin ulkopuolella ja anna AWS SDK:n selvittää tunnistetiedot.

Esimerkki ~/.aws/config-merkinnästä:

[profile codex-bedrock]

region = us-west-2

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

Määritä sitten kyseinen profiili Codexille tiedostossa ~/.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"

Työpöytäsovellus ja VS Code -laajennus

Työpöytäsovellukset ja IDE-laajennukset eivät välttämättä peri ympäristömuuttujia komentotulkistasi.

Jos Codex tarvitsee ympäristömuuttujia, kuten AWS_BEARER_TOKEN_BEDROCK, lisää ne kohteeseen:

~/.codex/.env

Esimerkki:

AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>

AWS_REGION=us-west-2

Kun olet muuttanut tiedostoa ~/.codex/config.toml tai ~/.codex/.env, käynnistä Codex-työpöytäsovellus tai VS Code -laajennus uudelleen.

Vahvista määritys

Määrityksen jälkeen:

• Avaa Codex CLI:ssä /status ja varmista, että Codex käyttää amazon-bedrock-mallintarjoajaa.

• Käynnistä Codex-työpöytäsovelluksessa tai VS Code -laajennuksessa uusi istunto sovelluksen uudelleenkäynnistyksen jälkeen.

Tunnetut rajoitukset

Seuraavat ominaisuudet eivät ole tällä hetkellä käytettävissä tässä kokoonpanossa:

• Kuvan luonti

• Syötteen puheentunnistus

• Pilvilaajennuskauppa

• Pilvimääritys ja käytännöt

• Pilviagentit, mukaan lukien tarkistus-, suojaus- ja verkkoagentit

Ominaisuuksien saatavuus voi vaihdella Codexin ChatGPT-kirjautumisella, Codexin OpenAI API -avaimella ja Codexin Amazon Bedrock API -avaimella välillä.

Vianmääritys

Jos määritys epäonnistuu, tarkista seuraavat:

• Codex-versiosi täyttää vähimmäisvaatimuksen.

• Mallitunnuksesi vastaa täsmälleen tuettua mallia.

• AWS-alueesi on määritetty ja valittu malli on saatavilla kyseisellä Alueella.

• AWS-tunnistetietosi tai Bedrock API -avaimesi ovat kelvolliset eivätkä vanhentuneet.

• AWS-identiteetilläsi on oikeus käyttää valittua Bedrock-mallia.

• AWS_BEARER_TOKEN_BEDROCK-muuttujaa ei ole asetettu vanhentuneeseen tai väärään avaimeen.

• Jos käytät AWS SDK -tunnistetietoja, valittu AWS-profiilisi on kelvollinen.

• Työpöytäsovelluksen tai VS Code -laajennuksen käytössä vaaditut ympäristömuuttujat ovat tiedostossa ~/.codex/.env.

• Olet käynnistänyt sovelluksen tai laajennuksen uudelleen määritys- tai ympäristötiedostojen muuttamisen jälkeen.

AWS-tunnistetietoja, IAM-oikeuksia, Bedrock-mallin käyttöoikeutta, kiintiöitä, laskutusta, alueellista saatavuutta tai Bedrock-palveluvirheitä koskevissa asioissa ota yhteyttä AWS-ylläpitäjääsi tai AWS Supportiin.

OpenAI Support voi auttaa Codex-asiakasohjelman käyttöönotossa, määrityksissä ja paikallisessa Codex-toiminnassa.