OpenAI
หน้านี้แปลด้วยระบบอัตโนมัติ ดูต้นฉบับภาษาอังกฤษ.

กำหนดค่า Codex ด้วย Amazon Bedrock

กำหนดค่า Codex ให้ใช้ Amazon Bedrock รวมถึงโมเดลที่รองรับ ข้อมูลประจำตัว AWS และการตั้งค่าไคลเอนต์ภายในเครื่อง

อัปเดตล่าสุด: 12 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 ของคุณแล้ว

โมเดลที่รองรับ

ใช้หนึ่งใน 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 สองแบบ:

  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 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.toml

  • AWS_REGION

  • AWS_DEFAULT_REGION

  • โปรไฟล์ AWS ที่เลือก

การตั้งค่ารีเจี้ยนใน ~/.codex/config.toml เป็นตัวเลือกที่ระบุค่าได้ชัดเจนที่สุด

ข้อมูลประจำตัวแบบ Federated ด้วย credential_process

สำหรับ SSO ขององค์กรหรือการทำ federation ผ่าน 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 อาจไม่รับช่วงตัวแปรสภาพแวดล้อมจากเชลล์ของคุณ

หาก 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 ของคุณตรงตามข้อกำหนดขั้นต่ำ

  • ID โมเดลของคุณตรงกับโมเดลที่รองรับทุกประการ

  • มีการตั้งค่ารีเจียน AWS ของคุณแล้ว และโมเดลที่เลือกพร้อมใช้งานในรีเจียนนั้น

  • ข้อมูลประจำตัว AWS หรือคีย์ API ของ Bedrock ของคุณถูกต้องและยังไม่หมดอายุ

  • ข้อมูลประจำตัว AWS ของคุณมีสิทธิ์เข้าถึงโมเดล Bedrock ที่เลือก

  • AWS_BEARER_TOKEN_BEDROCK ไม่ได้ตั้งค่าเป็นคีย์ที่หมดอายุหรือไม่ตั้งใจใช้

  • หากใช้ข้อมูลประจำตัว AWS SDK โปรไฟล์ AWS ที่คุณเลือกต้องถูกต้อง

  • สำหรับการใช้งานแอปเดสก์ท็อปหรือส่วนขยาย VS Code ตัวแปรสภาพแวดล้อมที่จำเป็นต้องมีอยู่ใน ~/.codex/.env

  • คุณได้รีสตาร์ทแอปหรือส่วนขยายหลังจากเปลี่ยนไฟล์กำหนดค่าหรือไฟล์สภาพแวดล้อมแล้ว

สำหรับข้อมูลประจำตัว AWS, สิทธิ์ IAM, การเข้าถึงโมเดล Bedrock, โควตา, การเรียกเก็บเงิน, ความพร้อมใช้งานตามรีเจียน หรือข้อผิดพลาดของบริการ Bedrock โปรดติดต่อผู้ดูแลระบบ AWS หรือ AWS Support ของคุณ

OpenAI Support สามารถช่วยเหลือเกี่ยวกับการตั้งค่าไคลเอนต์ Codex การกำหนดค่า และลักษณะการทำงานของ Codex ในเครื่องได้

บทความนี้มีประโยชน์หรือไม่