OpenAI
Šis puslapis buvo išverstas mašininiu būdu. Peržiūrėti originalų straipsnį anglų kalba.

Konfigūruokite Codex su Amazon Bedrock

Sukonfigūruokite Codex darbui su Amazon Bedrock, įskaitant palaikomus modelius, AWS prisijungimo duomenis ir vietinio kliento nuostatas.

Atnaujinta: 8 days ago

Naudokite šį vadovą, kad sukonfigūruotumėte Codex naudoti OpenAI modelius, pasiekiamus per Amazon Bedrock.

Šioje konfigūracijoje Codex naudoja Amazon Bedrock kredencialus ir siunčia modelio užklausas per Bedrock Responses API įgyvendinimą. OpenAI priglobta API nėra užklausos kelyje.

Ši sąranka palaiko vietines Codex darbo eigas:

  • Codex CLI

  • Codex darbalaukio programa

  • Codex VS Code plėtinys

Šis straipsnis netaikomas Codex, sukonfigūruotam prisijungti naudojant ChatGPT arba OpenAI API raktą.

Prieš pradėdami

Įsitikinkite, kad turite:

  • Codex CLI 0.128.0 arba naujesnę versiją

  • Codex darbalaukio programą arba VS Code plėtinį, 26.429.30905 arba naujesnės versijos

  • Prieigą prie palaikomų OpenAI modelių Amazon Bedrock

  • AWS regioną, kuriame pasiekiamas pasirinktas modelis

  • Bedrock palaikomą autentifikavimą, sukonfigūruotą jūsų AWS paskyrai

Palaikomi modeliai

Naudokite vieną iš šių tikslių modelių ID:

openai.gpt-5.6-sol

openai.gpt-5.6-terra

openai.gpt-5.6-luna

openai.gpt-5.5

openai.gpt-5.4

Rekomenduojamoji numatytoji reikšmė:

openai.gpt-5.6-sol

Konfigūruokite Codex

Pridėkite toliau nurodytą turinį į:

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

Pakeiskite us-west-2 į AWS regioną, kuriame pasiekiamas jūsų pasirinktas modelis.

Autentifikavimo parinktys

Codex palaiko du Amazon Bedrock autentifikavimo būdus:

  1. Bedrock API raktas naudojant AWS_BEARER_TOKEN_BEDROCK

  2. AWS SDK kredencialų grandinė IAM pasirašytoms užklausoms

Codex tikrina autentifikavimą šia tvarka:

  1. AWS_BEARER_TOKEN_BEDROCK

  2. AWS SDK kredencialų grandinė

Jei AWS_BEARER_TOKEN_BEDROCK nustatytas, Codex jį naudoja pirmiausia. Kitu atveju Codex grįžta prie AWS SDK kredencialų grandinės.

Nenaudokite OPENAI_API_KEY šiai konfigūracijai. Codex naudoja Amazon Bedrock kredencialus, kai model_provider nustatyta į amazon-bedrock.

Naudokite Bedrock API raktą, jei jūsų AWS paskyra palaiko Bedrock API raktus. Naudokite AWS SDK kredencialus, jei jūsų organizacija valdo Bedrock prieigą per IAM, AWS SSO, pavadintus profilius arba federuotą tapatybę.

1 parinktis: naudokite Bedrock API raktą

Nustatykite Bedrock API raktą aplinkoje, kurią skaitys Codex:

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

Tada įsitikinkite, kad jūsų Codex konfigūracijoje yra Bedrock regionas:

model = "openai.gpt-5.6-sol"

model_provider = "amazon-bedrock"

[model_providers.amazon-bedrock.aws]

wire_api = "responses"

region = "us-west-2"

Naudojant autentifikavimą Bedrock API raktu, regionas yra būtinas.

2 variantas: naudokite AWS SDK prisijungimo duomenis

Rinkitės šį būdą, jei norite, kad Codex autentifikuotųsi naudodamas AWS IAM prisijungimo duomenis.

Codex naudoja AWS SDK prisijungimo duomenų grandinę, todėl tinka įprastos AWS prisijungimo duomenų konfigūracijos, įskaitant bendrinamus AWS konfigūracijos failus, aplinkos kintamuosius, AWS SSO ir įvardytus profilius.

Bendrinami AWS prisijungimo duomenys

aws configure

Aplinkos kintamieji

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 valdymo pulto prisijungimo duomenys

aws login

AWS SSO arba įvardytas profilis

aws sso login --profile <profile-name>

export AWS_PROFILE=<profile-name>

Profilį taip pat galite nurodyti tiesiogiai faile ~/.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"

Jei nustatyta reikšmė model_providers.amazon-bedrock.aws.region, Codex pirmiausia naudoja ją. Kitu atveju, autentifikuojantis per SDK, Codex perduoda regiono nustatymą numatytajai AWS SDK konfigūracijos grandinei, apimančiai AWS_REGION, AWS_DEFAULT_REGION ir pasirinktą AWS profilį.

  • ~/.codex/config.toml

  • AWS_REGION

  • AWS_DEFAULT_REGION

  • Pasirinktas AWS profilis

Aiškiausia regioną nurodyti faile ~/.codex/config.toml.

Federuotoji tapatybė su credential_process

Įmonės SSO arba OIDC federavimui sukonfigūruokite AWS profilį už Codex ribų ir leiskite AWS SDK nustatyti kredencialus.

Pavyzdinis ~/.aws/config įrašas:

[profile codex-bedrock]

region = us-west-2

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

Tada nurodykite Codex naudoti tą profilį ~/.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"

Darbalaukio programa ir VS Code plėtinys

Darbalaukio programos ir IDE plėtiniai gali nepaveldėti aplinkos kintamųjų iš jūsų apvalkalo.

Jei Codex reikia aplinkos kintamųjų, pvz., AWS_BEARER_TOKEN_BEDROCK, pridėkite juos į:

~/.codex/.env

Pavyzdys:

AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>

AWS_REGION=us-west-2

Pakeitę ~/.codex/config.toml arba ~/.codex/.env, iš naujo paleiskite Codex darbalaukio programą arba VS Code plėtinį.

Patikrinkite sąranką

Po konfigūravimo:

  • Codex CLI atidarykite /status ir patvirtinkite, kad Codex naudoja amazon-bedrock modelio teikėją.

  • Codex darbalaukio programoje arba VS Code plėtinyje, paleidę programą iš naujo, pradėkite naują seansą.

Žinomi apribojimai

Šios funkcijos šiuo metu nepasiekiamos šioje konfigūracijoje:

  • Vaizdų generavimas

  • Balso transkripcija įvesčiai

  • Debesies papildinių parduotuvė

  • Debesies konfigūracija ir strategijos

  • Debesies agentai, įskaitant peržiūros, saugos ir žiniatinklio agentus

Funkcijų pasiekiamumas gali skirtis tarp Codex su ChatGPT prisijungimu, Codex su OpenAI API raktu ir Codex su Amazon Bedrock API raktu.

Trikčių šalinimas

Jei sąranka nepavyksta, patikrinkite:

  • Jūsų Codex versija atitinka minimalų reikalavimą.

  • Jūsų modelio ID tiksliai atitinka palaikomą modelį.

  • Jūsų AWS regionas nustatytas ir pasirinktas modelis tame regione pasiekiamas.

  • Jūsų AWS kredencialai arba Bedrock API raktas galioja ir nėra pasibaigę.

  • Jūsų AWS tapatybė turi leidimą pasiekti pasirinktą Bedrock modelį.

  • AWS_BEARER_TOKEN_BEDROCK nėra nustatytas į pasibaigusį arba nenumatytą raktą.

  • Jei naudojate AWS SDK kredencialus, jūsų pasirinktas AWS profilis galioja.

  • Naudojant darbalaukio programą arba VS Code plėtinį, būtini aplinkos kintamieji yra faile ~/.codex/.env.

  • Pakeitę konfigūracijos arba aplinkos failus iš naujo paleidote programą arba plėtinį.

Dėl AWS kredencialų, IAM leidimų, Bedrock modelio prieigos, kvotų, atsiskaitymo, regioninio pasiekiamumo arba Bedrock paslaugos klaidų kreipkitės į savo AWS administratorių arba AWS Support.

OpenAI Support gali padėti dėl Codex kliento sąrankos, konfigūracijos ir vietinės Codex elgsenos.

Ar šis straipsnis buvo naudingas?