Gunakake pandhuan iki kanggo ngonfigurasi Codex supaya nggunakake model OpenAI sing kasedhiya liwat Amazon Bedrock.
Ing konfigurasi iki, Codex nggunakake kredensial Amazon Bedrock lan ngirim panjaluk model liwat implementasi Responses API saka Bedrock. API sing dihosting OpenAI ora ana ing jalur panjaluk.
Persiyapan iki ndhukung alur kerja Codex lokal ing:
Codex CLI
Aplikasi desktop Codex
Ekstensi Codex VS Code
Artikel iki ora ditrapake kanggo Codex sing dikonfigurasi nganggo mlebu ChatGPT utawa kunci API OpenAI.
Sadurunge miwiti
Priksa manawa sampeyan duwe:
Codex CLI versi 0.128.0 utawa luwih anyar
Aplikasi desktop Codex utawa ekstensi VS Code versi 26.429.30905 utawa luwih anyar
Akses menyang model OpenAI sing didhukung ing Amazon Bedrock
Region AWS ing ngendi model sing dipilih kasedhiya
Autentikasi sing didhukung Bedrock wis dikonfigurasi kanggo akun AWS sampeyan
Model sing didhukung
Gunakake salah siji ID model sing persis iki:
openai.gpt-5.6-sol
openai.gpt-5.6-terra
openai.gpt-5.6-luna
openai.gpt-5.5
openai.gpt-5.4
Gawan sing disaranake:
openai.gpt-5.6-sol
Konfigurasi Codex
Tambahna ing ngisor iki menyang:
~/.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"
Gentena us-west-2 nganggo AWS Region panggonan model sing sampeyan pilih kasedhiya.
Opsi autentikasi
Codex ndhukung rong jalur autentikasi Amazon Bedrock:
Kunci API Bedrock nganggo
AWS_BEARER_TOKEN_BEDROCKRantai kredensial AWS SDK kanggo panjaluk sing ditandatangani IAM
Codex mriksa autentikasi miturut urutan iki:
AWS_BEARER_TOKEN_BEDROCKRantai kredensial AWS SDK
Yen AWS_BEARER_TOKEN_BEDROCK disetel, Codex nggunakake kuwi dhisik. Yen ora, Codex bali nganggo rantai kredensial AWS SDK.
Aja nganggo OPENAI_API_KEY kanggo konfigurasi iki. Codex nggunakake kredensial Amazon Bedrock nalika model_provider disetel dadi amazon-bedrock.
Gunakake kunci API Bedrock yen akun AWS sampeyan ndhukung kunci API Bedrock. Gunakake kredensial AWS SDK yen organisasi sampeyan ngatur akses Bedrock liwat IAM, AWS SSO, profil sing dijenengi, utawa identitas federasi.
Pilihan 1: Gunakake kunci API Bedrock
Setel kunci API Bedrock sampeyan ing lingkungan sing bakal diwaca Codex:
export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
Banjur pesthekna konfigurasi Codex sampeyan ngemot Region Bedrock:
model = "openai.gpt-5.6-sol"
model_provider = "amazon-bedrock"
[model_providers.amazon-bedrock.aws]
wire_api = "responses"
region = "us-west-2"
Region dibutuhake nalika nganggo autentikasi kunci API Bedrock.
Opsi 2: Gunakake kredensial AWS SDK
Gunakake jalur iki nalika sampeyan pengin Codex autentikasi nganggo kredensial AWS IAM.
Codex nggunakake rantai kredensial AWS SDK, mula persiyapan kredensial AWS standar bisa mlaku, kalebu file konfigurasi AWS bareng, variabel lingkungan, AWS SSO, lan profil sing dijenengi.
Kredensial AWS bareng
aws configure
Variabel lingkungan
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>
Kredensial AWS Management Console
aws login
AWS SSO utawa profil sing dijenengi
aws sso login --profile <profile-name>
export AWS_PROFILE=<profile-name>
Sampeyan uga bisa nyetel profil langsung ing ~/.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 luwih dhisik nganggo model_providers.amazon-bedrock.aws.region yen wis disetel. Yen ora, kanggo autentikasi SDK, Codex masrahake pamastèn Region menyang ranté konfigurasi gawan AWS SDK, kalebu AWS_REGION, AWS_DEFAULT_REGION, lan profil AWS sing dipilih.
~/.codex/config.tomlAWS_REGIONAWS_DEFAULT_REGIONProfil AWS sing dipilih
Nyetel Region ing ~/.codex/config.toml kuwi pilihan sing paling cetha.
Identitas federasi nganggo credential_process
Kanggo SSO perusahaan utawa federasi OIDC, konfigurasi profil AWS ing njaba Codex lan pasrahna AWS SDK supaya ngrampungake kredensial.
Tuladha entri ~/.aws/config:
[profile codex-bedrock]
region = us-west-2
credential_process = /path/to/your/idp-helper --profile codex-bedrock
Banjur arahna Codex menyang profil kuwi ing ~/.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"
Aplikasi desktop lan ekstensi VS Code
Aplikasi desktop lan ekstensi IDE bisa uga ora marisi variabel lingkungan saka shell sampeyan.
Yen Codex mbutuhake variabel lingkungan kayata AWS_BEARER_TOKEN_BEDROCK, tambahake menyang:
~/.codex/.env
Conto:
AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
AWS_REGION=us-west-2
Sawise ngganti ~/.codex/config.toml utawa ~/.codex/.env, wiwiti maneh aplikasi desktop Codex utawa ekstensi VS Code.
Verifikasi persiyapan
Sawise konfigurasi:
Ing Codex CLI, bukak
/statuslan konfirmasi manawa Codex nggunakake panyedhiya modelamazon-bedrock.Ing aplikasi desktop Codex utawa ekstensi VS Code, wiwiti sesi anyar sawise miwiti maneh aplikasi.
Watesan sing dingerteni
Fitur ing ngisor iki saiki durung kasedhiya ing konfigurasi iki:
Generasi gambar
Transkripsi swara kanggo input
Toko plugin cloud
Konfigurasi lan kabijakan cloud
Agen cloud, kalebu agen review, keamanan, lan web
Kasedhiyan fitur bisa beda antarane Codex nganggo mlebu ChatGPT, Codex nganggo kunci API OpenAI, lan Codex nganggo kunci API Amazon Bedrock.
Ngatasi masalah
Yen persiyapan gagal, priksa ing ngisor iki:
Versi Codex sampeyan nyukupi syarat minimal.
ID model sampeyan cocog persis karo model sing didhukung.
Region AWS sampeyan wis disetel lan model sing dipilih kasedhiya ing Region kuwi.
Kredensial AWS utawa kunci API Bedrock sampeyan sah lan durung kedaluwarsa.
Identitas AWS sampeyan duwe idin kanggo ngakses model Bedrock sing dipilih.
AWS_BEARER_TOKEN_BEDROCKora disetel menyang kunci sing kedaluwarsa utawa ora dikarepake.Yen nggunakake kredensial AWS SDK, profil AWS sing sampeyan pilih sah.
Kanggo panggunaan aplikasi desktop utawa ekstensi VS Code, variabel lingkungan sing dibutuhake ana ing
~/.codex/.env.Sampeyan wis miwiti maneh aplikasi utawa ekstensi sawise ngganti file konfigurasi utawa lingkungan.
Kanggo kredensial AWS, idin IAM, akses model Bedrock, kuota, tagihan, kasedhiyan regional, utawa kesalahan layanan Bedrock, hubungi administrator AWS utawa AWS Support sampeyan.
OpenAI Support bisa mbantu persiyapan klien Codex, konfigurasi, lan prilaku Codex lokal.
