이 가이드를 사용하여 Codex가 Amazon Bedrock을 통해 제공되는 OpenAI 모델을 사용하도록 구성하세요.
이 구성에서 Codex는 Amazon Bedrock 자격 증명을 사용하고 Bedrock의 Responses API 구현을 통해 모델 요청을 보냅니다. OpenAI 호스팅 API는 요청 경로에 포함되지 않습니다.
이 설정은 다음에서 로컬 Codex 워크플로를 지원합니다.
Codex CLI
Codex 데스크톱 앱
Codex VS Code 확장
이 문서는 ChatGPT 로그인 또는 OpenAI API 키로 구성된 Codex에는 적용되지 않습니다.
시작하기 전에
다음을 갖추었는지 확인하세요.
Codex CLI 버전 0.128.0 이상
Codex 데스크톱 앱 또는 VS Code 확장 버전 26.429.30905 이상
Amazon Bedrock에서 지원되는 OpenAI 모델에 대한 액세스
선택한 모델을 사용할 수 있는 AWS 리전
AWS 계정에 구성된 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
권장 기본값:
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 인증 경로를 지원합니다.
AWS_BEARER_TOKEN_BEDROCK를 사용하는 Bedrock API 키IAM 서명 요청을 위한 AWS SDK 자격 증명 체인
Codex는 다음 순서로 인증을 확인합니다.
AWS_BEARER_TOKEN_BEDROCKAWS SDK 자격 증명 체인
AWS_BEARER_TOKEN_BEDROCK가 설정되어 있으면 Codex는 이를 먼저 사용합니다. 그렇지 않으면 Codex는 AWS SDK 자격 증명 체인으로 대체합니다.
이 구성에는 OPENAI_API_KEY를 사용하지 마세요. model_provider가 amazon-bedrock으로 설정되면 Codex는 Amazon Bedrock 자격 증명을 사용합니다.
AWS 계정에서 Bedrock API 키를 지원하는 경우 Bedrock API 키를 사용하세요. 조직에서 IAM, AWS SSO, 명명된 프로필 또는 페더레이션 ID를 통해 Bedrock 액세스를 관리하는 경우 AWS SDK 자격 증명을 사용하세요.
옵션 1: Bedrock API 키 사용
Codex가 읽을 환경에 Bedrock API 키를 설정합니다.
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"
Bedrock API 키 인증을 사용할 때는 리전이 필요합니다.
옵션 2: AWS SDK 자격 증명 사용
Codex에서 AWS IAM 자격 증명으로 인증하려면 이 방법을 사용하세요.
Codex는 AWS SDK 자격 증명 체인을 사용하므로 공유 AWS 구성 파일, 환경 변수, AWS SSO, 명명된 프로필 등 표준 AWS 자격 증명 설정을 사용할 수 있습니다.
공유 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"
model_providers.amazon-bedrock.aws.region이 설정되어 있으면 Codex는 이를 우선 사용합니다. 그렇지 않으면 SDK 인증 시 Codex는 리전 확인을 AWS SDK 기본 구성 체인에 위임합니다. 여기에는 AWS_REGION, AWS_DEFAULT_REGION, 선택한 AWS 프로필이 포함됩니다.
~/.codex/config.tomlAWS_REGIONAWS_DEFAULT_REGION선택한 AWS 프로필
~/.codex/config.toml에서 리전을 설정하는 것이 가장 명시적인 방법입니다.
credential_process를 사용한 페더레이션 자격 증명
기업 SSO 또는 OIDC 페더레이션의 경우 Codex 외부에서 AWS 프로필을 구성하고 AWS SDK가 자격 증명을 확인하도록 합니다.
예시 ~/.aws/config 항목:
[profile codex-bedrock]
region = us-west-2
credential_process = /path/to/your/idp-helper --profile codex-bedrock
그런 다음 ~/.codex/config.toml에서 Codex가 해당 프로필을 사용하도록 지정합니다.
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 확장에서는 앱을 다시 시작한 후 새 세션을 시작하세요.
알려진 제한 사항
현재 이 구성에서는 다음 기능을 사용할 수 없습니다.
이미지 생성
입력용 음성 전사
클라우드 플러그인 스토어
클라우드 구성 및 정책
검토, 보안, 웹 에이전트를 포함한 클라우드 에이전트
기능 사용 가능 여부는 ChatGPT 로그인으로 사용하는 Codex, OpenAI API 키로 사용하는 Codex, Amazon Bedrock API 키로 사용하는 Codex 간에 다를 수 있습니다.
문제 해결
설정에 실패하면 다음을 확인하세요.
Codex 버전이 최소 요구 사항을 충족합니다.
모델 ID가 지원되는 모델과 정확히 일치합니다.
AWS 리전이 설정되어 있고 선택한 모델을 해당 리전에서 사용할 수 있습니다.
AWS 자격 증명 또는 Bedrock API 키가 유효하며 만료되지 않았습니다.
AWS ID에 선택한 Bedrock 모델에 액세스할 권한이 있습니다.
AWS_BEARER_TOKEN_BEDROCK가 만료되었거나 의도하지 않은 키로 설정되어 있지 않습니다.AWS SDK 자격 증명을 사용하는 경우 선택한 AWS 프로필이 유효합니다.
데스크톱 앱 또는 VS Code 확장을 사용하는 경우 필요한 환경 변수가
~/.codex/.env에 있어야 합니다.구성 또는 환경 파일을 변경한 후 앱이나 확장을 다시 시작했습니다.
AWS 자격 증명, IAM 권한, Bedrock 모델 액세스, 할당량, 결제, 리전 가용성 또는 Bedrock 서비스 오류는 AWS 관리자나 AWS Support에 문의하세요.
OpenAI Support는 Codex 클라이언트 설정, 구성 및 로컬 Codex 동작에 대해 도움을 줄 수 있습니다.