Amazon Bedrock ద్వారా అందుబాటులో ఉన్న OpenAI మోడల్లను ఉపయోగించడానికి Codexను కాన్ఫిగర్ చేయడానికి ఈ గైడ్ను ఉపయోగించండి.
ఈ కాన్ఫిగరేషన్లో, 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 ప్రమాణీకరణ మార్గాలకు మద్దతు ఇస్తుంది:
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 కీని ఉపయోగించండి. మీ సంస్థ IAM, AWS SSO, పేరున్న ప్రొఫైల్లు లేదా ఫెడరేటెడ్ ఐడెంటిటీ ద్వారా Bedrock యాక్సెస్ను నిర్వహిస్తే AWS SDK క్రెడెన్షియల్స్ను ఉపయోగించండి.
ఎంపిక 1: Bedrock API కీని ఉపయోగించండి
Codex చదివే ఎన్విరాన్మెంట్లో మీ Bedrock API కీని సెట్ చేయండి:
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 ప్రామాణీకరణ వివరాలను ఉపయోగించండి
AWS IAM ప్రామాణీకరణ వివరాలతో Codex ప్రామాణీకరించుకోవాలనుకున్నప్పుడు ఈ పద్ధతిని ఉపయోగించండి.
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 నిర్వహణ కన్సోల్ ప్రామాణీకరణ వివరాలు
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 ప్రవర్తనలో సహాయం చేయగలదు.
