OpenAI
הדף הזה תורגם באופן אוטומטי. לצפייה במאמר המקורי באנגלית.

הגדרת Codex עם Amazon Bedrock

הגדרת Codex עם Amazon Bedrock, כולל מודלים נתמכים, פרטי גישה ל-AWS והגדרות לקוח מקומי.

עודכן: 26 days ago

מדריך זה מסביר כיצד להגדיר את 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:

  1. מפתח API של Bedrock באמצעות AWS_BEARER_TOKEN_BEDROCK

  2. שרשרת ספקי פרטי הגישה של AWS SDK לבקשות חתומות באמצעות IAM

Codex בודק את אפשרויות האימות בסדר הבא:

  1. AWS_BEARER_TOKEN_BEDROCK

  2. שרשרת ספקי פרטי הגישה של 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.toml

  • AWS_REGION

  • AWS_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 באופן מקומי.

האם המאמר הזה היה מועיל?