Օգտագործեք այս ուղեցույցը՝ 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-ի կողմից աջակցվող վավերացում
Աջակցվող մոդելներ
Օգտագործեք այս ճշգրիտ մոդելի ID-ներից մեկը՝
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-ի վավերացման երկու ուղու՝
Bedrock API բանալի՝ օգտագործելով
AWS_BEARER_TOKEN_BEDROCKAWS SDK հավատարմագրերի շղթա՝ IAM-ով ստորագրված հարցումների համար
Codex-ը ստուգում է վավերացումը հետևյալ հերթականությամբ՝
AWS_BEARER_TOKEN_BEDROCKAWS SDK հավատարմագրերի շղթա
Եթե AWS_BEARER_TOKEN_BEDROCK-ը սահմանված է, Codex-ն այն օգտագործում է առաջինը։ Հակառակ դեպքում Codex-ն անցնում է AWS SDK հավատարմագրերի շղթային։
Մի օգտագործեք OPENAI_API_KEY-ը այս կազմաձևման համար։ Codex-ն օգտագործում է Amazon Bedrock-ի հավատարմագրերը, երբ model_provider-ը սահմանված է որպես amazon-bedrock։
Օգտագործեք Bedrock API բանալի, եթե ձեր AWS հաշիվն աջակցում է Bedrock API բանալիներին։ Օգտագործեք AWS SDK հավատարմագրեր, եթե ձեր կազմակերպությունը կառավարում է Bedrock-ի հասանելիությունը IAM-ի, AWS SSO-ի, անվանված պրոֆիլների կամ ֆեդերացված ինքնության միջոցով։
Տարբերակ 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-ի ընդհանուր կազմաձևման ֆայլերը, միջավայրի փոփոխականները, AWS SSO-ն և անվանված պրոֆիլները։
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-ը ուղղեք այդ պրոֆիլին ~/.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"
Աշխատասեղանի հավելված և VS Code ընդլայնում
Աշխատասեղանի հավելվածներն ու IDE ընդլայնումները կարող են չժառանգել միջավայրի փոփոխականները ձեր shell-ից։
Եթե 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-ը և հաստատեք, որ Codex-ն օգտագործում էamazon-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-ի տեղային վարքագծի հարցերում։
