מדריך זה מסביר כיצד להגדיר את Codex לשימוש במודלים של OpenAI הזמינים דרך Amazon Bedrock.
בתצורה זו, Codex משתמש בפרטי גישה של Amazon Bedrock ושולח בקשות למודלים דרך המימוש של Responses API ב-Bedrock. הבקשות אינן עוברות דרך ה-API המתארח אצל OpenAI.
תצורה זו תומכת בתהליכי עבודה מקומיים של Codex באמצעות:
Codex CLI
אפליקציית Codex למחשב
הרחבת Codex ל-VS Code
מאמר זה אינו חל על Codex שמוגדר להתחברות באמצעות ChatGPT או באמצעות מפתח API של OpenAI.
לפני שמתחילים
ודאו שיש לכם:
Codex CLI בגרסה 0.128.0 ואילך
אפליקציית Codex למחשב או ההרחבה ל-VS Code בגרסה 26.429.30905 ואילך
גישה למודלים נתמכים של OpenAI ב-Amazon Bedrock
אזור AWS שבו המודל שנבחר זמין
שיטת אימות נתמכת ב-Bedrock שהוגדרה לחשבון ה-AWS שלכם
מודלים נתמכים
השתמשו באחד ממזהי המודלים הבאים, בדיוק כפי שהוא מופיע:
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:
מפתח API של Bedrock באמצעות
AWS_BEARER_TOKEN_BEDROCKשרשרת ספקי פרטי הגישה של AWS SDK לבקשות חתומות באמצעות IAM
Codex בודק את אפשרויות האימות בסדר הבא:
AWS_BEARER_TOKEN_BEDROCKשרשרת ספקי פרטי הגישה של AWS SDK
אם AWS_BEARER_TOKEN_BEDROCK מוגדר, Codex משתמש בו תחילה. אחרת, Codex פונה לשרשרת ספקי פרטי הגישה של AWS SDK.
אין להשתמש ב-OPENAI_API_KEY בתצורה זו. Codex משתמש בפרטי גישה של Amazon Bedrock כאשר model_provider מוגדר כ-amazon-bedrock.
השתמשו במפתח API של Bedrock אם חשבון ה-AWS שלכם תומך במפתחות API של Bedrock. השתמשו בפרטי גישה של AWS SDK אם הארגון שלכם מנהל את הגישה ל-Bedrock באמצעות IAM, AWS SSO, פרופילים בעלי שם או זהות מאוחדת.
אפשרות 1: שימוש במפתח API של Bedrock
הגדירו את מפתח ה-API של Bedrock בסביבה שממנה 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"
חובה להגדיר אזור כשמשתמשים באימות באמצעות מפתח API של Bedrock.
אפשרות 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
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 לפרופיל הזה בקובץ ~/.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
אפליקציות למחשב והרחבות לסביבות פיתוח לא תמיד יורשות משתני סביבה ממעטפת הפקודות שלכם.
אם 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, התחילו סשן חדש לאחר הפעלה מחדש של האפליקציה.
מגבלות ידועות
התכונות הבאות אינן זמינות כרגע בתצורה זו:
יצירת תמונות
תמלול קלט קולי
חנות תוספים בענן
תצורה ומדיניות בענן
סוכנים בענן, כולל סוכני סקירה, אבטחה ואינטרנט
זמינות התכונות עשויה להשתנות בין Codex עם התחברות באמצעות ChatGPT, Codex עם מפתח API של OpenAI ו-Codex עם מפתח API של Amazon Bedrock.
פתרון בעיות
אם ההגדרה נכשלת, בדקו את הדברים הבאים:
גרסת Codex שלכם עומדת בדרישת הגרסה המינימלית.
מזהה המודל שלכם תואם בדיוק למזהה של מודל נתמך.
אזור ה-AWS שלכם מוגדר, והמודל שנבחר זמין באזור הזה.
פרטי הגישה שלכם ל-AWS או מפתח ה-API של Bedrock תקינים ותוקפם לא פג.
לזהות שלכם ב-AWS יש הרשאה לגשת למודל שנבחר ב-Bedrock.
AWS_BEARER_TOKEN_BEDROCKאינו מוגדר למפתח שתוקפו פג או למפתח שלא התכוונתם להשתמש בו.אם אתם משתמשים בפרטי גישה של AWS SDK, פרופיל ה-AWS שבחרתם תקין.
בשימוש באפליקציה למחשב או בהרחבה ל-VS Code, משתני הסביבה הדרושים נמצאים בקובץ
~/.codex/.env.הפעלתם מחדש את האפליקציה או את ההרחבה לאחר שינוי בקובצי התצורה או הסביבה.
בנושאי פרטי גישה ל-AWS, הרשאות IAM, גישה למודלים ב-Bedrock, מכסות, חיוב, זמינות לפי אזור או שגיאות בשירות Bedrock, פנו למנהל ה-AWS בארגון שלכם או לתמיכה של AWS.
התמיכה של OpenAI יכולה לסייע בהתקנה ובהגדרה של לקוח Codex ובאופן הפעולה של Codex באופן מקומי.
