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 कुंजी का उपयोग करें
अपनी 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"
सेट होने पर Codex पहले model_providers.amazon-bedrock.aws.region का उपयोग करता है. अन्यथा, 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 व्यवहार में मदद कर सकता है.
