繁體中文

通過 Amazon Bedrock 使用 ChatGPT Work 與 Codex

設定本機 ChatGPT Work 與 Codex 介面,使用 Amazon Bedrock 上可用的 OpenAI 模型。

設定完成後,本機客戶端會通過 AWS 管理的認證與存取控制,把模型請求傳送到 Bedrock。

工作方式

當你把 Amazon Bedrock 設定為本機 ChatGPT Work 或 Codex 介面的模型提供方時,OpenAI 託管的 Responses API 不在請求路徑中。本機客戶端會把模型請求傳送到 Amazon Bedrock,由 Bedrock 為受支援的 OpenAI 模型提供相容 OpenAI Responses API 的實現。

開始之前

請確認你已經具備:

  • Amazon Bedrock 中受支援 OpenAI 模型的存取權限。
  • 所選模型可用的 AWS Region。
  • 已為 AWS 賬戶設定 Amazon Bedrock Mantle 路徑的認證。

設定模型提供方

~/.codex/config.toml 中加入 Amazon Bedrock Mantle 路徑的 amazon-bedrock 模型提供方。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 認證時,必須指定 Region。

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 configcredentials 檔案:

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 或具名 profile

使用 AWS SSO 登入並選擇具名 profile:

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

聯合身份

對於企業 SSO 或 OIDC 聯合身份,請在本機客戶端之外使用 credential_process 設定聯合身份,讓 AWS SDK 解析憑據。瀏覽器登入、token 交換、快取和重新整理應放在 AWS profile 的 credential_process helper 中。

桌面應用與 IDE 擴充套件

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

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 Region 中可用,並且 AWS identity 有權存取該 Bedrock 模型。

支援的模型

使用精確模型 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 Region 而異。選擇模型前,請檢視 AWS Region 對模型的支援情況

功能可用性

此設定支援本機 ChatGPT Work 與 Codex 工作流程。Web 端託管的 ChatGPT Work、Codex 雲端,以及依賴 OpenAI 託管雲服務、託管工具或雲端管理發現能力的功能當前不可用。

Detailed feature availability(詳細功能可用性)

存取與使用介面

模型與多模態

能力 Amazon Bedrock
使用受支援 OpenAI 模型的 Bedrock-backed inference 可用
Fast Mode 不可用
圖片生成與編輯 不可用
語音聽寫 不可用
Web 搜尋 不可用

本機功能

瀏覽器與遠端控制

能力 Amazon Bedrock
內建瀏覽器預覽與評論 可用
瀏覽器中的 Computer Use 有限支援(*)
通過 Chrome 使用 ChatGPT 有限支援(*)
Computer Use 有限支援(*)
SSH 遠端連線 可用
移動端遠端控制 不可用

自定義與擴充套件

能力 Amazon Bedrock
通過 AGENTS.md 編寫自定義指令 可用
技能 可用
外掛 有限支援(†)
外掛共享 不可用
連接器 不可用
MCP 可用
子智能體與自定義智能體 可用
Memories 有限支援(*)
Chronicle 不可用

雲端與整合

管理、安全與分析

* 功能當前只在特定區域或特定能力範圍內可用。請檢視對應功能文件瞭解地域限制。

當能力不需要 ChatGPT 認證時,支援本機外掛包。OpenAI 精選外掛發現,以及依賴連接器或雲端託管共享的功能不可用。

故障排查

如果設定失敗,請檢查以下內容:

  • 模型 ID 與受支援模型完全匹配。
  • 你指定的是該模型可用的 AWS Region。
  • Bedrock API key 或 AWS 憑據有效且未過期。
  • AWS identity 有權存取所選 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。


來源:</zh-TW/docs/amazon-bedrock> 更新時間:2026-07-18(UTC)