Koristite ovaj vodič za konfiguriranje Codexa da koristi OpenAI modele dostupne putem Amazon Bedrocka.
U ovoj konfiguraciji, Codex koristi vjerodajnice za Amazon Bedrock i šalje zahtjeve modela putem Bedrockove implementacije Responses API-ja. API koji hostuje OpenAI nije u putanji zahtjeva.
Ova postavka podržava lokalne Codex tokove rada u:
Codex CLI
Codex desktop aplikacija
Codex VS Code ekstenzija
Ovaj članak se ne odnosi na Codex konfiguriran s ChatGPT prijavom ili OpenAI API ključem.
Prije nego što počnete
Provjerite da imate:
Codex CLI verziju 0.128.0 ili noviju
Codex desktop aplikaciju ili VS Code ekstenziju verzije 26.429.30905 ili novije
Pristup podržanim OpenAI modelima u Amazon Bedrocku
AWS regiju u kojoj je odabrani model dostupan
Autentifikaciju koju podržava Bedrock konfiguriranu za vaš AWS račun
Podržani modeli
Koristite jedan od ovih tačnih ID-jeva modela:
openai.gpt-5.6-sol
openai.gpt-5.6-terra
openai.gpt-5.6-luna
openai.gpt-5.5
openai.gpt-5.4
Preporučeno zadano:
openai.gpt-5.6-sol
Konfigurišite Codex
Dodajte sljedeće u:
~/.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"
Zamijenite us-west-2 AWS regijom u kojoj je dostupan odabrani model.
Opcije autentifikacije
Codex podržava dvije putanje autentifikacije za Amazon Bedrock:
Bedrock API ključ pomoću
AWS_BEARER_TOKEN_BEDROCKLanac vjerodajnica AWS SDK-a za zahtjeve potpisane IAM-om
Codex provjerava autentifikaciju ovim redoslijedom:
AWS_BEARER_TOKEN_BEDROCKLanac vjerodajnica AWS SDK-a
Ako je AWS_BEARER_TOKEN_BEDROCK postavljen, Codex ga koristi prvi. U suprotnom, Codex se vraća na lanac vjerodajnica AWS SDK-a.
Nemojte koristiti OPENAI_API_KEY za ovu konfiguraciju. Codex koristi vjerodajnice za Amazon Bedrock kada je model_provider postavljen na amazon-bedrock.
Koristite Bedrock API ključ ako vaš AWS račun podržava Bedrock API ključeve. Koristite AWS SDK vjerodajnice ako vaša organizacija upravlja pristupom Bedrocku putem IAM-a, AWS SSO-a, imenovanih profila ili federiranog identiteta.
Opcija 1: Koristite Bedrock API ključ
Postavite svoj Bedrock API ključ u okruženju iz kojeg će ga Codex čitati:
export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
Zatim se pobrinite da vaša Codex konfiguracija uključuje Bedrock regiju:
model = "openai.gpt-5.6-sol"
model_provider = "amazon-bedrock"
[model_providers.amazon-bedrock.aws]
wire_api = "responses"
region = "us-west-2"
Regija je obavezna kada koristite autentifikaciju Bedrock API ključem.
Opcija 2: Koristite vjerodajnice za AWS SDK
Koristite ovu opciju kada želite da se Codex autentificira pomoću AWS IAM vjerodajnica.
Codex koristi lanac vjerodajnica za AWS SDK, pa mogu funkcionirati standardne konfiguracije AWS vjerodajnica, uključujući dijeljene AWS konfiguracijske datoteke, varijable okruženja, AWS SSO i imenovane profile.
Dijeljene AWS vjerodajnice
aws configure
Varijable okruženja
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>
Vjerodajnice za AWS Management Console
aws login
AWS SSO ili imenovani profil
aws sso login --profile <profile-name>
export AWS_PROFILE=<profile-name>
Profil možete postaviti i direktno u datoteci ~/.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 prvo koristi model_providers.amazon-bedrock.aws.region ako je postavljeno. U suprotnom, pri autentifikaciji putem SDK-a Codex prepušta određivanje regije zadanom konfiguracijskom lancu AWS SDK-a, uključujući AWS_REGION, AWS_DEFAULT_REGION i odabrani AWS profil.
~/.codex/config.tomlAWS_REGIONAWS_DEFAULT_REGIONOdabrani AWS profil
Postavljanje regije u datoteci ~/.codex/config.toml najizričitija je opcija.
Federirani identitet uz credential_process
Za korporativni SSO ili OIDC federaciju, konfigurišite AWS profil izvan Codexa i prepustite AWS SDK-u da razriješi vjerodajnice.
Primjer unosa u ~/.aws/config:
[profile codex-bedrock]
region = us-west-2
credential_process = /path/to/your/idp-helper --profile codex-bedrock
Zatim usmjerite Codex na taj profil u ~/.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"
Desktop aplikacija i VS Code ekstenzija
Desktop aplikacije i IDE ekstenzije možda neće naslijediti varijable okruženja iz vaše ljuske.
Ako su Codexu potrebne varijable okruženja kao što je AWS_BEARER_TOKEN_BEDROCK, dodajte ih u:
~/.codex/.env
Primjer:
AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
AWS_REGION=us-west-2
Nakon promjene ~/.codex/config.toml ili ~/.codex/.env, ponovo pokrenite Codex desktop aplikaciju ili VS Code ekstenziju.
Provjerite postavku
Nakon konfiguracije:
U Codex CLI-ju otvorite
/statusi potvrdite da Codex koristi pružaoca modelaamazon-bedrock.U Codex desktop aplikaciji ili VS Code ekstenziji pokrenite novu sesiju nakon ponovnog pokretanja aplikacije.
Poznata ograničenja
Sljedeće funkcije trenutno nisu dostupne u ovoj konfiguraciji:
Generiranje slike
Glasovna transkripcija za unos
Trgovina dodataka u oblaku
Konfiguracija i politike u oblaku
Cloud agenti, uključujući agente za pregled, sigurnost i web
Dostupnost funkcija može se razlikovati između Codexa s ChatGPT prijavom, Codexa s OpenAI API ključem i Codexa s Amazon Bedrock API ključem.
Rješavanje problema
Ako postavljanje ne uspije, provjerite sljedeće:
Vaša verzija Codexa ispunjava minimalni zahtjev.
ID vašeg modela tačno odgovara podržanom modelu.
Vaša AWS regija je postavljena i odabrani model je dostupan u toj regiji.
Vaše AWS vjerodajnice ili Bedrock API ključ su važeći i nisu istekli.
Vaš AWS identitet ima dozvolu za pristup odabranom Bedrock modelu.
AWS_BEARER_TOKEN_BEDROCKnije postavljen na istekli ili nenamjerni ključ.Ako koristite AWS SDK vjerodajnice, vaš odabrani AWS profil je važeći.
Za korištenje desktop aplikacije ili VS Code ekstenzije, potrebne varijable okruženja nalaze se u
~/.codex/.env.Ponovo ste pokrenuli aplikaciju ili ekstenziju nakon promjene konfiguracijskih datoteka ili datoteka okruženja.
Za AWS vjerodajnice, IAM dozvole, pristup Bedrock modelu, kvote, naplatu, regionalnu dostupnost ili greške Bedrock usluge, obratite se svom AWS administratoru ili AWS podršci.
OpenAI podrška može pomoći s postavljanjem Codex klijenta, konfiguracijom i lokalnim ponašanjem Codexa.