將 ChatGPT Work 和 Codex 與 Amazon Bedrock 搭配使用

設定本機 ChatGPT Work 和 Codex 介面，以使用通過 Amazon Bedrock 提供的 OpenAI 模型。在此設定中，本機客戶端使用 AWS 管理的身份驗證和存取控制 向 Bedrock 傳送模型請求。

工作原理

將本機 ChatGPT Work 或 Codex 介面的模型提供商設定為 Amazon Bedrock 後， 請求路徑將不經過由 OpenAI 託管的 Responses API。本機客戶端向 Amazon Bedrock 傳送模型請求，而 Bedrock 會為受支援的 OpenAI 模型提供 與 OpenAI 相容的 Responses API 實現。

開始之前

請確保你具備：

• Amazon Bedrock 中受支援 OpenAI 模型的存取權限。
• 所選模型可用的 AWS 區域。
• 已為 AWS 帳號設定 Amazon Bedrock Mantle 路徑的身份驗證。

設定提供商

將 Amazon Bedrock Mantle 路徑的 amazon-bedrock 模型提供商新增到 ~/.codex/config.toml。ChatGPT 桌面應用、Codex CLI、IDE 擴充套件和 SDK 讀取相同的本機設定層。模型為可選設定。 需要時，請明確選擇受支援的模型。

model_provider = "amazon-bedrock"

身份驗證選項

本機 ChatGPT Work 和 Codex 介面支援兩種 Bedrock 身份驗證路徑。 它們會按以下順序檢查：

1. Bedrock API key。
2. AWS SDK 憑據鏈。

選項 1：Bedrock API key

在本機客戶端讀取的環境中設定 Bedrock API key。使用 API key 身份驗證時， 必須指定區域。

export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
export AWS_REGION=us-east-2

選項 2：AWS SDK 憑據

當你的組織通過 AWS SDK 憑據鏈管理 Bedrock 存取權限時，請使用此路徑。 本機客戶端可以使用以下標準 AWS SDK 憑據來源：

共享 AWS 設定檔

設定共享 AWS config 和 credentials 檔案：

aws configure

環境變數

設定標準 AWS SDK 憑據環境變數：

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 Management Console 憑據登入：

aws login

AWS SSO 或命名設定檔

使用 AWS SSO 登入並選擇命名設定檔：

aws sso login --profile codex-bedrock
export AWS_PROFILE=codex-bedrock

聯合身份

對於企業 SSO 或 OIDC 聯合，請在本機客戶端之外使用 credential_process 設定聯合身份，並讓 AWS SDK 解析 憑據。將瀏覽器登入、令牌交換、快取和重新整理邏輯放入 AWS 設定檔的 credential_process 輔助程式中。

桌面應用和 IDE 擴充套件

桌面應用和 IDE 擴充套件可能不會繼承 shell 中的環境變數。 請將必需的值放入 ~/.codex/.env，然後重啟應用或 擴充套件。

export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
export AWS_REGION=us-east-2

驗證設定

• 在 Codex CLI 中，開啟 /status 並確認 Codex 正在使用 amazon-bedrock 模型提供商。
• 在 ChatGPT 桌面應用中，選擇 Work 或 Codex，並在 重啟應用後開始新任務。
• 在 IDE 擴充套件中，重啟擴充套件後開始新會話。
• 確認所選模型在設定的 AWS 區域中可用，並且 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

模型可用性因 AWS 區域而異。選擇模型前，請參閱按 AWS 區域劃分的模型 支援情況。

功能可用性

此設定支援本機 ChatGPT Work 和 Codex 工作流程。目前不支援 Web 上託管的 ChatGPT Work、Codex cloud，以及依賴 OpenAI 託管的 雲服務、託管工具或雲端管理的發現功能。

問題排查

如果設定失敗，請檢查以下各項：

• 模型 ID 與受支援的模型完全匹配。
• 你指定了模型可用的 AWS 區域。
• Bedrock API key 或 AWS 憑據有效且未過期。
• AWS 身份有權存取所選 Bedrock 模型。
• AWS_BEARER_TOKEN_BEDROCK 未設定為已過期或非預期的 key。
• 使用桌面應用或 IDE 擴充套件時，所需的環境變數 存在於 ~/.codex/.env 中。

支援範圍

OpenAI Support 可以協助處理 ChatGPT Work 和 Codex 客戶端設定、 設定、本機 CLI 行為、桌面應用行為、IDE 擴充套件行為 以及本機產品體驗。

如需處理 AWS 憑據、IAM 權限、Bedrock 模型存取權限、配額、計費、 區域可用性、Bedrock 請求失敗、AWS 服務日誌或 Bedrock 服務行為，請聯絡客戶的 AWS 管理員或 AWS Support。