將 ChatGPT Work 和 Codex 與 Amazon Bedrock 搭配使用
設定本機 ChatGPT Work 和 Codex 介面，以使用透過 Amazon Bedrock 提供的 OpenAI 模型。
設定本機 ChatGPT Work 和 Codex 介面，以使用透過 Amazon Bedrock 提供的 OpenAI 模型。在此設定中，本機客戶端使用 AWS 管理的身分驗證和 存取控制，將模型請求傳送到 Bedrock。
工作原理
將本機 ChatGPT Work 或 Codex 介面的模型供應商設定為 Amazon Bedrock 後，請求路徑不會經過 OpenAI 託管的 Responses API。 本機客戶端將模型請求傳送到 Amazon Bedrock；Bedrock 為受支援的 OpenAI 模型 提供相容 OpenAI 的 Responses API 實現。
開始之前
請確保你具備：
- 要使用的 AWS 帳戶的憑證。
- Amazon Bedrock 中受支援 OpenAI 模型的存取權限。
- 所選模型可用的 AWS 區域的存取權限。
- 呼叫所選模型或推理設定檔的 AWS 權限。
請檢查具體模型的 IAM 要求。例如，透過 Runtime 使用 GPT-6 Sol
還需要對帳戶的預設專案擁有 bedrock:InvokeModel 權限。請參閱 AWS 的 GPT-6 Sol 設定說明。
設定供應商
Codex 允許你在 ~/.codex/config.toml 中設定 model_provider 來設定供應商。ChatGPT 桌面應用程式、Codex CLI、IDE 擴充功能和 SDK 讀取相同的本機設定層。
根據要使用的 Amazon Bedrock 端點選擇供應商：Bedrock Runtime 用於跨區域推理（CRIS），Bedrock Mantle 用於區域內推理。
新設定請使用 Bedrock Runtime：
model_provider = "amazon-bedrock-runtime"
web_search = "disabled"使用 Mantle 進行託管網頁搜尋
對於 Bedrock Mantle 端點：
model_provider = "amazon-bedrock"
web_search = "cached"選擇模型
Codex 使用設定的 model_provider 決定在模型選擇器中顯示哪些模型：
amazon-bedrock-runtime 顯示 Bedrock Runtime 端點支援的模型，
amazon-bedrock 顯示 Bedrock Mantle 端點
支援的模型。
你可以選擇在設定檔中指定一個受支援的模型。 內建供應商自帶模型目錄。 切換端點時，請同時更改供應商和任何顯式指定的模型 ID。
身分驗證選項
本機 ChatGPT Work 和 Codex 介面支援兩種 Bedrock 身分驗證方式， 並按以下順序檢查：
- Bedrock API key。
- 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在 Windows PowerShell 中：
$env:AWS_BEARER_TOKEN_BEDROCK = "<your-bedrock-api-key>"
$env: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 loginAWS 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，然後重啟應用或
擴充功能。在 Windows 上，預設路徑為 %USERPROFILE%\.codex\.env。
export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
export AWS_REGION=us-east-2驗證設定
- 在 Codex CLI 中開啟
/status，確認模型供應商與 端點一致：Mantle 區域內推理使用amazon-bedrock， Runtime Global 或 Geo 跨區域推理使用amazon-bedrock-runtime。 - 在 ChatGPT 桌面應用程式中選擇 Work 或 Codex，並在 重啟應用後啟動新任務。
- 在 IDE 擴充功能中，重啟擴充功能後啟動新會話。
- 確認所選模型在設定的 AWS 區域中可用，且 AWS 身分具有存取權限。
然後在新任務中傳送一條簡短的提示詞：
Reply with exactly: bedrock-ok預期回覆為 bedrock-ok。請在客戶端確認供應商和模型；僅憑回覆
無法識別請求路由。驗證部署是否符合要求時，請使用具有唯讀權限的臨時資料夾，
驗證一個無害的本機工具任務和一輪後續
對話。
支援的模型
Bedrock Runtime 供應商使用推理設定檔 ID，Bedrock Mantle 供應商使用模型 ID。 所選模型或設定檔必須在你的 AWS 區域中可用，且你的 AWS 身分具有存取權限。
使用 Bedrock Runtime 端點進行 Global 和 Geo 跨區域推理
Global CRIS 可將請求路由到全球受支援的 商業 AWS 區域，Geo CRIS 則在設定檔指定的地理範圍內路由請求。 請選擇符合 AWS 權限和資料駐留要求的路由範圍。
使用 model_provider = "amazon-bedrock-runtime"，並可選擇將 model 設定為以下列表中的推理設定檔 ID。供應商使用
https://bedrock-runtime.{region}.amazonaws.com/openai/v1，其中 {region} 是
傳送請求所在的受支援來源 AWS 區域。Global 和 Geo CRIS 均使用此端點地址。
Global CRIS
受支援的模型和推理設定檔 ID：
- GPT-6 Astra:
global.openai.gpt-6-astra - GPT-6 Sol:
global.openai.gpt-6-sol - GPT-6 Luna:
global.openai.gpt-6-luna
例如，在 ~/.codex/config.toml 中設定使用 Global CRIS 的 Astra：
model_provider = "amazon-bedrock-runtime"
model = "global.openai.gpt-6-astra"美國 Geo CRIS
受支援的模型和推理設定檔 ID：
- GPT-6 Astra:
us.openai.gpt-6-astra - GPT-6 Sol:
us.openai.gpt-6-sol - GPT-6 Luna:
us.openai.gpt-6-luna
Codex 內建的 Runtime 模型選擇器列出美國 Geo 和 Global 變體。
模型和 CRIS 的可用性因來源 AWS 區域而異。請參閱 AWS 的推理設定檔支援的區域和模型，其中連結列出各模型的確切推理設定檔 ID 和區域 可用性；另請參閱 AWS 的各模型的區域可用性，再選擇供應商和模型。
使用 Bedrock Mantle 端點進行區域內推理
使用 model_provider = "amazon-bedrock"，並可選擇指定模型 ID。供應商使用
https://bedrock-mantle.{region}.api.aws/openai/v1。
受支援的模型和模型 ID：
- GPT-6 Astra:
openai.gpt-6-astra - GPT-6 Sol:
openai.gpt-6-sol - GPT-6 Luna:
openai.gpt-6-luna
GPT-6 Sol 和 Luna 可透過 us-east-1（北維吉尼亞）的 Mantle 使用。
模型可用性因 AWS 區域而異。請參閱 AWS 的各模型的區域可用性，再選擇供應商和模型。有關 GPT-6 Astra，請參閱 GPT-6 Astra 的 Bedrock 模型頁面。
功能可用性
此設定支援本機 ChatGPT Work 和 Codex 工作流程。目前不支援 託管的網頁版 ChatGPT Work、Codex 雲端，以及依賴 OpenAI 託管 雲服務或雲端管理的發現機制的 功能。Runtime 不支援託管網頁搜尋；如有需要，請使用 Mantle。
Codex Security CLI 使用自身的供應商設定。請按照其 Amazon Bedrock 設定中的說明操作，而非採用上述原生 客戶端設定。
詳細功能可用性
| 功能 | Amazon Bedrock |
|---|---|
| 存取方式和使用介面 | |
| 網頁版 ChatGPT Work | 不可用 |
| Codex 雲端 | 不可用 |
| ChatGPT 桌面應用程式中的 ChatGPT Work 或 Codex | 可用 |
| Codex CLI | 可用 |
| Codex Security CLI | 可用 |
| IDE 擴充功能 | 可用 |
Codex SDK、codex exec 和可指令碼化的工作流程 | 可用 |
| 模型和多模態 | |
| 透過 Bedrock 使用受支援的 OpenAI 模型進行推理 | 可用 |
| Fast 模式 | 不可用 |
| 影像生成與編輯 | 不可用 |
| 語音聽寫 | 不可用 |
| Runtime 上的託管網頁搜尋 | 不可用 |
| 本機功能 | |
| Codex Security 外掛和本機掃描 | 可用 |
使用 /review 進行本機程式碼審查 | 可用 |
| 核准請求的自動審查 | 可用 |
| 沙箱與權限控制 | 可用 |
| 專案與獨立定時任務 | 可用 |
| 定時任務 | 可用 |
| 工作樹和內建 Git 工具 | 可用 |
| 本機環境和可重複執行的操作 | 可用 |
| Appshots | 可用 |
| 瀏覽器與遠端控制 | |
| 內建瀏覽器預覽和評論 | 可用 |
| 瀏覽器中的 Computer Use | 受限* |
| 透過 Chrome 使用 ChatGPT | 受限* |
| Computer Use | 受限* |
| SSH 遠端連線 | 可用 |
| 行動端遠端控制 | 不可用 |
| 自訂與擴充功能 | |
使用 AGENTS.md 提供自訂指令 | 可用 |
| 技能 | 可用 |
| 外掛 | 受限† |
| 外掛共享 | 不可用 |
| 連接器 | 不可用 |
| MCP | 可用 |
| 子智能體和自訂智能體 | 可用 |
| 記憶 | 受限* |
| 電腦歷史記錄 | 不可用 |
| 雲端與整合 | |
| Codex 雲端對話 | 不可用 |
| Sites | 不可用 |
透過 @codex 委派 GitHub issue 和 PR | 不可用 |
| GitHub 程式碼審查和自動 PR 審查 | 不可用 |
| Slack 雲端整合 | 不可用 |
| Linear 雲端整合 | 不可用 |
| 管理、安全與分析 | |
| SAML SSO、MFA 和工作區使用者管理 | 不可用 |
requirements.toml 受管理設定 | 可用 |
| 雲端管理的設定策略 | 不可用 |
| ChatGPT 工作區 RBAC 和自訂角色 | 不可用 |
| SCIM、EKM 和網域驗證 | 不可用 |
| Enterprise 保留和駐留控制 | 不可用 |
| 預設不使用 API 或業務資料訓練模型 | 可用 |
| 分析儀表板 | 不可用 |
| Analytics API | 不可用 |
| Compliance API 和稽核日誌 | 不可用 |
| 針對已連線 GitHub 儲存庫的 Codex Security 雲端掃描 | 不可用 |
* 此功能目前僅在部分地區可用。有關地區限制，請查閱各功能的文件。
† 可以使用不需要 ChatGPT 身分驗證的本機外掛包和 OpenAI 精選外掛，包括 Codex Security。不支援需要 ChatGPT 身分驗證的外掛、連接器或雲端託管的共享功能。
故障排查
如果設定失敗，請檢查以下內容：
- 模型 ID 與受支援的模型完全一致。
- 使用與端點對應的模型供應商：Runtime 端點使用
amazon-bedrock-runtime，Mantle 端點使用amazon-bedrock。 - 指定了模型可用的 AWS 區域。
- Bedrock API key 或 AWS 憑證有效且未過期。
- AWS 身分具有存取所選 Bedrock 模型的權限。
AWS_BEARER_TOKEN_BEDROCK未設定為過期或非預期的金鑰。- 使用桌面應用程式或 IDE 擴充功能時，所需環境變數已
設定在
~/.codex/.env中。
使用 AWS SDK 設定檔進行身分驗證時，執行 aws sts get-caller-identity --profile codex-bedrock
確認所選設定檔的身分。將 codex-bedrock 替換為
你的設定檔名稱；使用預設憑證鏈時，可省略 --profile。
此命令檢查 AWS 身分，不檢查呼叫 Bedrock 模型的權限。請單獨檢查
AWS_BEARER_TOKEN_BEDROCK，避免非預期的 API key 選擇
不同的身分驗證方式。
支援邊界
OpenAI Support 可幫助處理 ChatGPT Work 和 Codex 客戶端的設定、 設定、本機 CLI 行為、桌面應用程式行為、IDE 擴充功能行為 和本機產品體驗問題。
有關 AWS 憑證、IAM 權限、Bedrock 模型存取權限、配額、計費、 區域可用性、Bedrock 請求失敗、AWS 服務日誌或 Bedrock 服務行為的問題，請聯絡客戶的 AWS 管理員或 AWS Support。