Amazon Bedrock에서 Codex 사용하기

생성형 AI 코딩 에이전트 Codex는 이제 Amazon Bedrock을 모델 공급자로 사용할 수 있습니다. 기존 Bedrock Runtime과 달리 Codex는 Bedrock Mantle의 OpenAI-compatible Responses API를 통해 GPT-5.6 모델에 접근하며, 이는 인증과 비용 처리 방식에 중요한 차이를 만듭니다.

기존 bedrock-runtime 예제에서 사용하던 InvokeModel API나 bedrock:InvokeModel 권한은 Codex 연동에 적용되지 않습니다. Codex는 bedrock-mantle:CreateInference 권한과 bedrock-mantle.<region>.api.aws 엔드포인트를 요구하므로, 기존 구성을 그대로 복사하면 오류가 발생합니다.

GPT-5.6 모델은 sol, terra, luna 등 용도에 따라 세분화되어 있으며, 현재는 us-east-1 등 특정 리전에서만 지원됩니다. 서울 리전(ap-northeast-2)은 아직 지원 목록에 포함되지 않았습니다. 모델별 컨텍스트 윈도우는 1M 토큰까지 제공되며, 리전 설정과 PrivateLink 엔드포인트가 일치해야 합니다.

인증 방식은 Bedrock API key 또는 AWS SDK credential chain을 지원합니다. 운영 환경에서는 만료되는 자격 증명을 가진 IAM role이나 SSO를 권장하며, AWS_BEARER_TOKEN_BEDROCK 환경 변수가 우선적으로 읽히므로 주의가 필요합니다. CI 환경에서는 OIDC나 워크로드 role처럼 짧은 수명의 자격 증명을 사용하는 것이 안전합니다.