Folosiți acest ghid pentru a configura Codex să utilizeze modelele OpenAI disponibile prin Amazon Bedrock.
În această configurație, Codex folosește acreditări Amazon Bedrock și trimite cereri de model prin implementarea API-ului Responses din Bedrock. API-ul găzduit de OpenAI nu se află pe ruta cererii.
Această configurare acceptă fluxuri de lucru Codex locale în:
Codex CLI
Aplicația desktop Codex
Extensia Codex VS Code
Acest articol nu se aplică pentru Codex configurat cu autentificare ChatGPT sau cu o cheie API OpenAI.
Înainte de a începe
Asigurați-vă că aveți:
Codex CLI versiunea 0.128.0 sau ulterioară
Aplicația desktop Codex sau extensia VS Code versiunea 26.429.30905 sau ulterioară
Acces la modele OpenAI acceptate în Amazon Bedrock
O Regiune AWS în care modelul selectat este disponibil
Autentificare acceptată de Bedrock configurată pentru contul dvs. AWS
Modele acceptate
Folosiți unul dintre aceste ID-uri de model exacte:
openai.gpt-5.5
openai.gpt-5.4
openai.gpt-oss-120b
openai.gpt-oss-20b
Valoare implicită recomandată:
openai.gpt-5.5
Configurați Codex
Adăugați următoarele în:
~/.codex/config.toml
model = "openai.gpt-5.5"
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"
Înlocuiți us-west-2 cu Regiunea AWS în care modelul selectat este disponibil.
Opțiuni de autentificare
Codex acceptă două metode de autentificare Amazon Bedrock:
Cheie API Bedrock folosind
AWS_BEARER_TOKEN_BEDROCKLanțul de acreditări AWS SDK pentru cereri semnate IAM
Codex verifică autentificarea în această ordine:
AWS_BEARER_TOKEN_BEDROCKLanțul de acreditări AWS SDK
Dacă AWS_BEARER_TOKEN_BEDROCK este setat, Codex îl folosește primul. În caz contrar, Codex revine la lanțul de acreditări AWS SDK.
Nu folosiți OPENAI_API_KEY pentru această configurație. Codex folosește acreditări Amazon Bedrock când model_provider este setat la amazon-bedrock.
Folosiți o cheie API Bedrock dacă contul dvs. AWS acceptă chei API Bedrock. Folosiți acreditări AWS SDK dacă organizația dvs. gestionează accesul Bedrock prin IAM, AWS SSO, profiluri denumite sau identitate federată.
Opțiunea 1: Folosiți o cheie API Bedrock
Setați cheia API Bedrock în mediul pe care Codex îl va citi:
export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
Apoi asigurați-vă că configurația Codex include o Regiune Bedrock:
model = "openai.gpt-5.5"
model_provider = "amazon-bedrock"
[model_providers.amazon-bedrock.aws]
wire_api = "responses"
region = "us-west-2"
Regiunea este obligatorie când folosiți autentificarea cu cheie API Bedrock.
Opțiunea 2: Folosiți acreditări AWS SDK
Folosiți această metodă când doriți ca Codex să se autentifice cu acreditări AWS IAM.
Codex folosește lanțul de acreditări AWS SDK, astfel încât configurările standard de acreditări AWS pot funcționa, inclusiv fișiere de configurare AWS partajate, variabile de mediu, AWS SSO și profiluri denumite.
Acreditări AWS partajate
aws configure
Variabile de mediu
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>
Acreditări AWS Management Console
aws login
AWS SSO sau profil denumit
aws sso login --profile <profile-name>
export AWS_PROFILE=<profile-name>
De asemenea, puteți seta profilul direct în ~/.codex/config.toml:
model = "openai.gpt-5.5"
model_provider = "amazon-bedrock"
[model_providers.amazon-bedrock.aws]
profile = "codex-bedrock"
wire_api = "responses"
region = "us-west-2"
Codex folosește mai întâi model_providers.amazon-bedrock.aws.region când este setat. În caz contrar, pentru autentificarea SDK, Codex deleagă rezolvarea Regiunii către lanțul implicit de configurare AWS SDK, inclusiv AWS_REGION, AWS_DEFAULT_REGION și profilul AWS selectat.
~/.codex/config.tomlAWS_REGIONAWS_DEFAULT_REGIONProfilul AWS selectat
Setarea Regiunii în ~/.codex/config.toml este cea mai explicită opțiune.
Identitate federată cu credential_process
Pentru SSO corporativ sau federație OIDC, configurați profilul AWS în afara Codex și lăsați AWS SDK să rezolve acreditările.
Exemplu de intrare ~/.aws/config:
[profile codex-bedrock]
region = us-west-2
credential_process = /path/to/your/idp-helper --profile codex-bedrock
Apoi indicați-i Codex acel profil în ~/.codex/config.toml:
model = "openai.gpt-5.5"
model_provider = "amazon-bedrock"
[model_providers.amazon-bedrock.aws]
profile = "codex-bedrock" wire_api = "responses"
region = "us-west-2"
Aplicația desktop și extensia VS Code
Aplicațiile desktop și extensiile IDE pot să nu moștenească variabilele de mediu din shell.
Dacă Codex are nevoie de variabile de mediu precum AWS_BEARER_TOKEN_BEDROCK, adăugați-le în:
~/.codex/.env
Exemplu:
AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
AWS_REGION=us-west-2
După schimbarea ~/.codex/config.toml sau ~/.codex/.env, reporniți aplicația desktop Codex sau extensia VS Code.
Verificați configurarea
După configurare:
În Codex CLI, deschideți
/statusși confirmați că Codex folosește furnizorul de modeleamazon-bedrock.În aplicația desktop Codex sau extensia VS Code, începeți o sesiune nouă după repornirea aplicației.
Limitări cunoscute
Următoarele funcționalități nu sunt disponibile momentan în această configurație:
Generare de imagini
Transcriere vocală pentru intrare
Magazin de pluginuri cloud
Configurare și politici cloud
Agenți cloud, inclusiv agenți de revizuire, securitate și web
Disponibilitatea funcționalităților poate diferi între Codex cu autentificare ChatGPT, Codex cu o cheie API OpenAI și Codex cu o cheie API Amazon Bedrock.
Depanare
Dacă configurarea eșuează, verificați următoarele:
Versiunea Codex îndeplinește cerința minimă.
ID-ul modelului se potrivește exact cu un model acceptat.
Regiunea AWS este setată, iar modelul selectat este disponibil în acea Regiune.
Acreditările AWS sau cheia API Bedrock sunt valide și nu au expirat.
Identitatea dvs. AWS are permisiunea de a accesa modelul Bedrock selectat.
AWS_BEARER_TOKEN_BEDROCKnu este setat la o cheie expirată sau neintenționată.Dacă folosiți acreditări AWS SDK, profilul AWS selectat este valid.
Pentru utilizarea aplicației desktop sau a extensiei VS Code, variabilele de mediu necesare sunt prezente în
~/.codex/.env.Ați repornit aplicația sau extensia după schimbarea fișierelor de configurare sau de mediu.
Pentru acreditări AWS, permisiuni IAM, acces la modelul Bedrock, cote, facturare, disponibilitate regională sau erori ale serviciului Bedrock, contactați administratorul AWS sau AWS Support.
OpenAI Support vă poate ajuta cu configurarea clientului Codex, configurarea și comportamentul local al Codex.