AWS가 2026년 11월 12일 공식 블로그에서 Codex가 Amazon Bedrock의 OpenAI 모델로 추론하도록 연결하는 방법과 기업 도입 절차를 소개했다. Codex는 개발자 PC에서 그대로 실행되고, 모델 요청만 Bedrock으로 보내는 구조다. 조직은 이미 쓰는 AWS 인증, IAM, 리전, 관측 체계를 그대로 적용할 수 있다.
AWS는 지원 모델 가운데 Sol, Terra, Luna를 언급하며, 쓰려는 리전과 추론 경로에서 이 모델이 제공되는지 Amazon Bedrock의 'Supported models by AWS Region' 문서에서 먼저 확인하라고 안내했다. 예시는 GPT-5.6 Sol을 기준으로 한다.
세 가지 접속 경로
AWS가 권하는 기본값은 Native AWS Access로 시작하는 소규모 최소 권한 시범 운영이다. AWS 관리형 게이트웨이로 라우팅하거나 Amazon Bedrock Guardrails를 쓰려면 Amazon Bedrock AgentCore의 기능인 AgentCore Gateway를 고른다. 플랫폼 팀이 요청 경로에서 직접 통제하려면 LLM 게이트웨이를 쓴다. 맞춤 통합은 LLM 게이트웨이 방식의 고급형이어서 빠른 시작용이 아니라고 AWS는 밝혔다.
예시 구성은 오픈소스 저장소 Guidance for Codex on AWS에서 가져왔다. 이 저장소에는 Native AWS Access, AgentCore Gateway, LiteLLM on ECS, Portkey, AWS Distro for OpenTelemetry(ADOT), Amazon CloudWatch 설정용 빠른 시작 자료가 들어 있다.
Native AWS Access 시범 운영
예시에서는 Okta가 SAML로 인증하고 SCIM으로 사용자와 그룹을 IAM Identity Center에 등록한다. IAM Identity Center가 Codex에 쓰일 임시 AWS 자격 증명을 발급하며, 인증 서비스는 Codex에 설정하지 않는다. 시범 사용자는 전용 그룹에 넣고, 모델 추론과 검증 명령, 관측 대상에 필요한 권한만 준다. 비운영 저장소와 롤백 담당자도 미리 정한다.
설정은 세 단계다. 먼저 AWS CLI의 IAM Identity Center 프로필로 로그인해 Bedrock Runtime을 직접 호출하고, 다음에 Codex가 승인된 모델을 가리키게 하며, 마지막으로 안전한 작업을 실행한다. 직접 호출은 AWS 접근 문제를 분리해 보는 단계이고, 마지막 단계가 Codex 설정을 확인한다. 예시는 us-east-2 리전에서 us.openai.gpt-5.6-sol 모델을 호출한다. Codex 설정 파일에는 model_provider를 amazon-bedrock, model을 openai.gpt-5.6-sol로 두고 프로필(codex-bedrock)과 리전을 지정한다. 저장소가 제공자를 바꾸지 못하도록 이 설정은 사용자 수준 또는 관리형 설정에 둔다.
- 신원: aws sts get-caller-identity가 기대한 IAM Identity Center 역할 세션을 반환해야 한다.
- 모델 접근: 시범 프로필이 선택한 API와 리전에서 승인된 모델을 호출해야 한다.
- Codex 접근: 비운영 저장소에서 읽기 전용 작업을 마치고 요청 경로의 증거가 남아야 한다.
- 증거와 롤백: 신원, 호출, 감사 기록과 선택적 텔레메트리 기록이 있는지 확인한다. 설정이나 IAM Identity Center 할당을 제거한 뒤 진행 중인 세션은 절차대로 처리하거나 만료를 기다리고, 새 호출이 거부되는지 확인한다.
사용자 두 명으로 신원 분리도 시험해야 한다. 한 명은 로그인이 되는지만 보여 주고, 두 번째 사용자가 있어야 기록이 구분되는지 알 수 있다. 두 사람이 따로 로그인해 같은 무해한 작업을 하면 역할 세션과 감사 기록, 텔레메트리를 구성한 경우 텔레메트리 기록도 서로 구분되어야 한다.
게이트웨이 경로를 택하면 시범 사용자에게 열기 전에 Codex 요청 형식 수용 여부를 확인하고, 게이트웨이 팀이 정한 로그인이나 토큰 방식을 쓰며, 모델 라우팅, 모니터링, 장애 처리, 롤백을 시험해야 한다. 맞춤 통합은 다른 세 경로로 요구를 채울 수 없을 때만 고려하라고 AWS는 밝혔다. 직접 설계하고 보안을 챙기며 운영해야 하는 서비스가 하나 더 생기기 때문이다.
관측과 비용 배분
Codex OpenTelemetry는 클라이언트 활동을 보여 주고, Bedrock 서비스 지표와 모델 호출 로그는 활성화했을 때 서비스 쪽 활동을 보여 준다. AWS 신원 기록과 비용 및 사용량 보고서(CUR)는 신원과 청구 사용량의 근거가 된다. AWS는 이들을 경로별로 대조하라고 했고, 토큰량을 비용 보고서처럼 제시하지 말라고 당부했다.
| 구분 | 예시 | 귀속 범위 |
|---|---|---|
| Codex OpenTelemetry 지표 | 토큰 사용량, 턴, API 요청, 요청 시간, 도구 호출, 세션 출처 | 로컬 수집기가 검증된 신원 속성을 붙인 뒤에야 사용자·팀별 묶음 가능 |
| Bedrock 서비스 지표 | 호출 수, 지연 시간, 입력·출력 토큰, 클라이언트·서버 오류 | 선택한 Runtime, Mantle, AgentCore 경로의 문서화된 네임스페이스와 차원 사용 |
| AWS 신원 증거, 호출 로그, CUR | 역할 가정 SSO 주체와 청구된 Bedrock 항목 | Native 접근은 호출자 신원 배분을 켠 CUR 2.0이 SSO 주체를 드러낼 수 있고, 게이트웨이 경로는 게이트웨이 텔레메트리와 지출 기록이 필요 |
ADOT 수집기 설정과 CloudWatch 대시보드는 저장소의 모니터링 안내를 따른다. 예시는 Codex 설정의 otel 항목에서 환경을 pilot으로 두고 log_user_prompt를 false로 하며, 로컬 127.0.0.1:4318로 지표를 내보낸다. 안전한 작업을 실행해 CloudWatch 대시보드에 운영 지표가 나타나는지 확인한다. 이 대시보드는 클라이언트 활동용이므로 귀속이나 비용 증거는 AWS 신원, 감사, 청구 기록을 따로 써야 한다.
하드 예산이나 속도 제한처럼 요청 경로에서 강제해야 하면 게이트웨이 정책을 쓴다. 경보는 탐지용이고 접근과 행동의 경계는 IAM과 관리형 클라이언트 통제가 맡는다. 비용은 청구 데이터로 실제 금액을 보고, 추정 배분은 추정이라고 표시해야 한다.
Codex가 선택한 모델 경로로 보낼 수 있는 코드, 프롬프트, 파일, 도구 출력의 범위도 정해야 한다. 조직이 승인하지 않았다면 비밀 정보와 제한 데이터는 제외한다. 생성된 변경은 병합 전에 개발자가 검토하고 시험해야 하며, 텔레메트리가 정확성이나 안전을 보증하지는 않는다.
팀 표준과 설정 위치
조직이 소유한 플러그인은 공유 스킬, 훅, 승인된 MCP 연동을 배포하는 방법이다. 플러그인마다 담당자와 버전을 두고, 배포 전 변경을 검토하며, 승인된 경로로만 게시한다. 업데이트는 시범 그룹에서 시험하고 제거 절차를 문서로 남긴다. 플러그인에 MCP 서버 설정이 들어 있어도 묶인 도구가 모두 승인된 것은 아니다.
훅은 hooks.json이나 설정 파일에 선언하며 PreToolUse, PostToolUse, SessionStart를 필요할 때 쓴다. 예시는 Bash 호출 전에 회사 정책 명령(제한 시간 30초)을 실행한다. 넓게 배포하기 전에 허용, 거부, 시간 초과, 엔드포인트 연결 끊김 동작을 시험해야 한다. MCP 서버는 각각 별도의 신뢰 경계이므로 필요한 사용자와 도구에만 열고, 자격 증명은 승인된 OAuth나 비밀 관리 절차로 다루며, 외부 시스템을 바꾸는 도구는 확인을 요구한다. MCP 자격 증명은 모델 제공자 설정과 분리한다.
| 설정 | 권장 위치 | 이유 |
|---|---|---|
| 모델 제공자, 자격 증명, 리전 | 사용자 수준 또는 관리형 설정 | 저장소 기본값이 아니라 엔드포인트와 기업의 선택이다 |
| OpenTelemetry 내보내기 | 사용자 수준 또는 관리형 설정 | 텔레메트리 목적지와 데이터 처리는 조직 통제 사항이다 |
| 저장소 지침 | AGENTS.md | 지속적인 안내를 담지만 강제 경계는 아니다 |
| 권한 요구사항 | 조직 관리형 requirements.toml | 지원되는 보안 민감 클라이언트 선택을 제한한다 |
저장소 안의 .codex/config.toml은 코드처럼 검토하되 기업 강제 경계로 보면 안 된다. 롤아웃은 준비, 시범, 확장, 조직 전체 표준화 순으로 단계마다 범위와 증거를 확인하며 넓힌다. 시범이 끝나면 Codex 제공자와 텔레메트리 설정, IAM Identity Center 할당이나 게이트웨이 접근, 시범 토큰과 비밀 정보를 회수하고 ADOT 수집기와 시범 대시보드·경보를 정리한다. 마지막으로 새 모델 호출이 거부되는지 확인한다.
출처
이 기사는 아래 자료를 바탕으로 정리했습니다. 제목을 누르면 원문이 새 창으로 열립니다.
- OpenAI Codex on Amazon Bedrock | Amazon Web Services aws.amazon.com