Amazon Bedrock에서 ChatGPT Work 및 Codex 사용하기
Amazon Bedrock을 통해 제공되는 OpenAI 모델을 사용하도록 로컬 ChatGPT Work 및 Codex 환경을 구성합니다.
Amazon Bedrock을 통해 제공되는 OpenAI 모델을 사용하도록 로컬 ChatGPT Work 및 Codex 환경을 구성합니다. 이 설정에서는 로컬 클라이언트가 AWS에서 관리하는 인증 및 액세스 제어를 사용하여 Bedrock으로 모델 요청을 보냅니다.
작동 방식
로컬 ChatGPT Work 또는 Codex 환경의 모델 제공자로 Amazon Bedrock을 구성하면 OpenAI에서 호스팅하는 Responses API는 요청 경로에 포함되지 않습니다. 로컬 클라이언트가 Amazon Bedrock으로 모델 요청을 보내며, Bedrock은 지원되는 OpenAI 모델을 위한 OpenAI 호환 Responses API 구현을 제공합니다.
시작하기 전에
다음 사항을 확인하세요.
- Amazon Bedrock에서 지원되는 OpenAI 모델에 액세스할 수 있어야 합니다.
- 선택한 모델을 사용할 수 있는 AWS Region이 있어야 합니다.
- 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 인증 경로를 지원합니다. 다음 순서로 확인합니다.
- Bedrock API key.
- 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 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페더레이션 ID
기업 SSO 또는 OIDC 페더레이션의 경우 로컬 클라이언트 외부에서
credential_process을 사용하여 페더레이션 ID를 구성하고 AWS SDK가 자격 증명을
확인하도록 합니다. 브라우저 로그인, 토큰 교환, 캐싱 및 갱신은
AWS 프로필의 credential_process 도우미에 설정합니다.
데스크톱 앱 및 IDE 확장 프로그램
데스크톱 앱과 IDE 확장 프로그램은 셸의 환경 변수를 상속하지 않을 수
있습니다. 필요한 값을 ~/.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 Region에서 사용할 수 있고 AWS ID에 해당 모델에 액세스할 권한이 있는지 확인합니다.
지원되는 모델
정확한 모델 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 워크플로를 지원합니다. 웹에서 호스팅되는 ChatGPT Work, Codex cloud, 그리고 OpenAI에서 호스팅하는 클라우드 서비스, 호스팅 도구 또는 클라우드 관리형 검색에 의존하는 기능은 현재 사용할 수 없습니다.
문제 해결
설정에 실패하면 다음을 확인하세요.
- 모델 ID가 지원되는 모델과 정확히 일치하는지 확인합니다.
- 모델을 사용할 수 있는 AWS 리전을 지정했는지 확인합니다.
- Bedrock API key 또는 AWS 자격 증명이 유효하고 만료되지 않았는지 확인합니다.
- AWS ID에 선택한 Bedrock 모델에 액세스할 권한이 있는지 확인합니다.
AWS_BEARER_TOKEN_BEDROCK이 만료되었거나 의도하지 않은 키로 설정되어 있지 않은지 확인합니다.- 데스크톱 앱 또는 IDE 확장 프로그램을 사용하는 경우 필수 환경 변수가
~/.codex/.env에 있는지 확인합니다.
지원 범위
OpenAI Support는 ChatGPT Work 및 Codex 클라이언트 설정, 구성, 로컬 CLI 동작, 데스크톱 앱 동작, IDE 확장 프로그램 동작, 로컬 제품 사용 환경에 관한 문제를 지원할 수 있습니다.
AWS 자격 증명, IAM 권한, Bedrock 모델 액세스, 할당량, 청구, 리전별 가용성, Bedrock 요청 실패, AWS 서비스 로그 또는 Bedrock 서비스 동작에 관한 문제는 고객의 AWS 관리자나 AWS Support에 문의하세요.