Бұл нұсқаулықты Codex-ті Amazon Bedrock арқылы қолжетімді OpenAI модельдерін пайдалануға конфигурациялау үшін қолданыңыз.
Бұл конфигурацияда Codex Amazon Bedrock тіркелгі деректерін пайдаланады және модель сұрауларын Bedrock-тағы Responses API іске асырылымы арқылы жібереді. OpenAI орналастырған API сұрау жолында болмайды.
Бұл баптау жергілікті Codex жұмыс процестерін мына жерлерде қолдайды:
Codex CLI
Codex десктоп қолданбасы
Codex VS Code кеңейтімі
Бұл мақала ChatGPT арқылы кірумен немесе OpenAI API кілтімен конфигурацияланған Codex-ке қолданылмайды.
Бастамас бұрын
Мыналардың бар екеніне көз жеткізіңіз:
Codex CLI 0.128.0 немесе одан кейінгі нұсқасы
Codex десктоп қолданбасының немесе VS Code кеңейтімінің 26.429.30905 немесе одан кейінгі нұсқасы
Amazon Bedrock ішіндегі қолдау көрсетілетін OpenAI модельдеріне қолжетімділік
Таңдалған модель қолжетімді AWS аймағы
AWS есептік жазбаңыз үшін конфигурацияланған Bedrock қолдайтын аутентификация
Қолдау көрсетілетін модельдер
Осы нақты модель идентификаторларының бірін пайдаланыңыз:
openai.gpt-5.6-sol
openai.gpt-5.6-terra
openai.gpt-5.6-luna
openai.gpt-5.5
openai.gpt-5.4
Ұсынылатын әдепкі нұсқа:
openai.gpt-5.6-sol
Codex-ті конфигурациялау
Келесіні мына жерге қосыңыз:
~/.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"
us-west-2 мәнін таңдалған модель қолжетімді AWS аймағымен ауыстырыңыз.
Аутентификация опциялары
Codex Amazon Bedrock үшін екі аутентификация жолын қолдайды:
AWS_BEARER_TOKEN_BEDROCKарқылы Bedrock API кілтіIAM қолтаңбасы қойылған сұрауларға арналған AWS SDK тіркелгі деректері тізбегі
Codex аутентификацияны мына ретпен тексереді:
AWS_BEARER_TOKEN_BEDROCKAWS SDK тіркелгі деректері тізбегі
Егер AWS_BEARER_TOKEN_BEDROCK орнатылса, Codex алдымен соны пайдаланады. Әйтпесе, Codex AWS SDK тіркелгі деректері тізбегіне ауысады.
Бұл конфигурация үшін OPENAI_API_KEY пайдаланбаңыз. model_provider мәні amazon-bedrock болып орнатылғанда, Codex Amazon Bedrock тіркелгі деректерін пайдаланады.
AWS есептік жазбаңыз Bedrock API кілттерін қолдаса, Bedrock API кілтін пайдаланыңыз. Ұйымыңыз Bedrock қолжетімділігін IAM, AWS SSO (бірыңғай кіру), атаулы профильдер немесе федеративті сәйкестік арқылы басқарса, AWS SDK тіркелгі деректерін пайдаланыңыз.
1-нұсқа: Bedrock API кілтін пайдалану
Bedrock API кілтін Codex оқитын ортада орнатыңыз:
export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
Содан кейін Codex конфигурациясында Bedrock аймағы бар екеніне көз жеткізіңіз:
model = "openai.gpt-5.6-sol"
model_provider = "amazon-bedrock"
[model_providers.amazon-bedrock.aws]
wire_api = "responses"
region = "us-west-2"
Bedrock API кілтімен аутентификациялау кезінде аймақ міндетті түрде қажет.
2-нұсқа: AWS SDK тіркелгі деректерін пайдалану
Codex қолданбасын AWS IAM тіркелгі деректері арқылы аутентификациялау үшін осы әдісті пайдаланыңыз.
Codex AWS SDK тіркелгі деректері тізбегін пайдаланады, сондықтан ортақ AWS конфигурация файлдары, орта айнымалылары, AWS SSO (бірыңғай кіру) және атаулы профильдер сияқты стандартты AWS тіркелгі деректерінің конфигурациялары жарайды.
Ортақ AWS тіркелгі деректері
aws configure
Орта айнымалылары
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 Console тіркелгі деректері
aws login
AWS SSO (бірыңғай кіру) немесе атаулы профиль
aws sso login --profile <profile-name>
export AWS_PROFILE=<profile-name>
Профильді ~/.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"
Егер model_providers.amazon-bedrock.aws.region орнатылса, Codex алдымен соны пайдаланады. Әйтпесе SDK аутентификациясы кезінде Codex аймақты анықтауды AWS SDK әдепкі конфигурация тізбегіне тапсырады. Оған AWS_REGION, AWS_DEFAULT_REGION және таңдалған AWS профилі кіреді.
~/.codex/config.tomlAWS_REGIONAWS_DEFAULT_REGIONТаңдалған AWS профилі
Аймақты ~/.codex/config.toml файлында орнату — ең нақты әдіс.
credential_process арқылы федеративтік идентификация
Корпоративтік SSO (бірыңғай кіру) немесе OIDC федерациясы үшін AWS профилін Codex-тен тыс конфигурациялап, тіркелгі деректерін AWS SDK өзі анықтайтындай етіңіз.
~/.aws/config жазбасының мысалы:
[profile codex-bedrock]
region = us-west-2
credential_process = /path/to/your/idp-helper --profile codex-bedrock
Содан кейін ~/.codex/config.toml ішінде Codex-ті сол профильге бағыттаңыз:
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"
Десктоп қолданба және VS Code кеңейтімі
Десктоп қолданбалар мен IDE кеңейтімдері қабығыңыздан орта айнымалыларын мұраламауы мүмкін.
Codex-ке AWS_BEARER_TOKEN_BEDROCK сияқты орта айнымалылары қажет болса, оларды мына жерге қосыңыз:
~/.codex/.env
Мысал:
AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
AWS_REGION=us-west-2
~/.codex/config.toml немесе ~/.codex/.env өзгерткеннен кейін Codex десктоп қолданбасын немесе VS Code кеңейтімін қайта іске қосыңыз.
Баптауды тексеру
Конфигурациядан кейін:
Codex CLI ішінде
/statusашып, Codexamazon-bedrockмодель провайдерін пайдаланып тұрғанын растаңыз.Codex десктоп қолданбасында немесе VS Code кеңейтімінде қолданбаны қайта іске қосқаннан кейін жаңа сеанс бастаңыз.
Белгілі шектеулер
Бұл конфигурацияда келесі функциялар қазір қолжетімді емес:
Суретті генерациялау
Енгізу үшін дауысты транскрипциялау
Бұлттық плагин дүкені
Бұлттық конфигурация және саясаттар
Шолу, қауіпсіздік және веб агенттерді қоса алғанда, бұлттық агенттер
Функциялардың қолжетімділігі ChatGPT арқылы кіруі бар Codex, OpenAI API кілті бар Codex және Amazon Bedrock API кілті бар Codex арасында әртүрлі болуы мүмкін.
Ақауларды жою
Баптау сәтсіз болса, мыналарды тексеріңіз:
Codex нұсқаңыз ең төменгі талапқа сай.
Модель ID-іңіз қолдау көрсетілетін модельге дәл сәйкес келеді.
AWS аймағыңыз орнатылған және таңдалған модель сол аймақта қолжетімді.
AWS тіркелгі деректеріңіз немесе Bedrock API кілтіңіз жарамды және мерзімі өтпеген.
AWS сәйкестігінде таңдалған Bedrock моделіне қол жеткізуге рұқсат бар.
AWS_BEARER_TOKEN_BEDROCKмерзімі өткен немесе арналмаған кілтке орнатылмаған.AWS SDK тіркелгі деректерін пайдалансаңыз, таңдалған AWS профиліңіз жарамды.
Десктоп қолданбаны немесе VS Code кеңейтімін пайдалану үшін қажетті орта айнымалылары
~/.codex/.envішінде бар.Конфигурация немесе орта файлдарын өзгерткеннен кейін қолданбаны не кеңейтімді қайта іске қостыңыз.
AWS тіркелгі деректері, IAM рұқсаттары, Bedrock моделіне қолжетімділік, квоталар, биллинг, аймақтық қолжетімділік немесе Bedrock қызметі қателері бойынша AWS әкімшісіне немесе AWS Support қызметіне хабарласыңыз.
OpenAI Support Codex клиентін баптау, конфигурациялау және жергілікті Codex әрекеті бойынша көмектесе алады.
