ChatGPT 문서
한국어
문의 goolvyouyou@gmail.com

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 구현을 제공합니다.

시작하기 전에

다음 항목을 준비하세요.

  • 사용하려는 AWS 계정의 자격 증명.
  • Amazon Bedrock에서 지원되는 OpenAI 모델에 대한 액세스 권한.
  • 선택한 모델을 사용할 수 있는 AWS 리전에 대한 액세스 권한.
  • 선택한 모델 또는 추론 프로필을 호출할 수 있는 AWS 권한.

모델별 IAM 요구 사항을 확인하세요. 예를 들어 Runtime을 통해 GPT-6 Sol을 사용하려면 계정의 기본 프로젝트에 대한 bedrock:InvokeModel 권한도 필요합니다. AWS의 GPT-6 Sol 설정 안내를 참조하세요.

공급자 구성

Codex에서는 ~/.codex/config.toml에서 model_provider를 설정하여 공급자를 구성할 수 있습니다. ChatGPT 데스크톱 앱, Codex CLI, IDE 확장 프로그램 및 SDK는 동일한 로컬 구성 계층을 읽습니다.

사용하려는 Amazon Bedrock 엔드포인트의 공급자를 선택하세요. 교차 Region 추론(CRIS)에는 Bedrock Runtime을, Region 내 추론에는 Bedrock Mantle을 사용합니다.

새로 구성할 때는 Bedrock Runtime을 사용하세요:

model_provider = "amazon-bedrock-runtime"
web_search = "disabled"

호스팅 웹 검색에 Mantle 사용

Bedrock Mantle 엔드포인트의 경우:

model_provider = "amazon-bedrock"
web_search = "cached"

모델 선택

Codex는 구성된 model_provider를 사용하여 모델 선택기에 표시할 모델을 결정합니다. amazon-bedrock-runtime의 경우 Bedrock Runtime 엔드포인트에서 지원되는 모델이 표시되고, amazon-bedrock의 경우 Bedrock Mantle 엔드포인트에서 지원되는 모델이 표시됩니다.

필요에 따라 구성 파일에 지원되는 모델을 지정할 수 있습니다. 기본 제공 공급자는 자체 모델 카탈로그를 제공합니다. 엔드포인트를 전환할 때는 공급자와 명시적으로 지정한 모델 ID를 함께 변경하세요.

인증 옵션

로컬 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

Windows PowerShell에서는 다음을 사용하세요:

$env:AWS_BEARER_TOKEN_BEDROCK = "<your-bedrock-api-key>"
$env: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 login

AWS 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에 넣은 다음 앱이나 확장 프로그램을 다시 시작하세요. Windows의 기본 경로는 %USERPROFILE%\.codex\.env입니다.

export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
export AWS_REGION=us-east-2

설정 확인

  • Codex CLI에서 /status를 열고 모델 공급자가 사용 중인 엔드포인트와 일치하는지 확인합니다. 리전 내 Mantle 추론에는 amazon-bedrock를 사용하고, Runtime Global 또는 Geo 리전 간 추론에는 amazon-bedrock-runtime를 사용합니다.
  • ChatGPT 데스크톱 앱에서는 앱을 다시 시작한 후 Work 또는 Codex를 선택하고 새 작업을 시작합니다.
  • IDE 확장 프로그램에서는 확장 프로그램을 다시 시작한 후 새 세션을 시작합니다.
  • 선택한 모델을 구성된 AWS 리전에서 사용할 수 있고 AWS ID에 해당 모델에 액세스할 권한이 있는지 확인합니다.

그런 다음 새 작업에서 짧은 프롬프트를 보내세요:

Reply with exactly: bedrock-ok

예상 응답은 bedrock-ok입니다. 클라이언트에서 공급자와 모델을 확인하세요. 응답만으로는 요청 경로를 식별할 수 없습니다. 도입 적합성을 검증하려면 읽기 전용 권한이 설정된 임시 폴더를 사용하여 무해한 로컬 도구 작업과 후속 턴을 검증하세요.

지원되는 모델

Bedrock Runtime 공급자에는 추론 프로필 ID를 사용하고, Bedrock Mantle 공급자에는 모델 ID를 사용합니다. 선택한 모델 또는 프로필을 사용 중인 AWS 리전에서 사용할 수 있어야 하며 AWS ID로 액세스할 수 있어야 합니다.

Bedrock Runtime 엔드포인트를 사용하는 Global 및 Geo 리전 간 추론

Global CRIS는 전 세계에서 지원되는 상용 AWS 리전으로 요청을 라우팅할 수 있으며, Geo CRIS는 프로필의 지리적 범위 내에서 요청을 라우팅합니다. AWS 권한 및 데이터 상주 요구 사항을 충족하는 라우팅 범위를 선택하세요.

model_provider = "amazon-bedrock-runtime"를 사용하고, 선택 사항인 model 구성은 다음 목록에 있는 추론 프로필 ID로 설정합니다. 공급자는 https://bedrock-runtime.{region}.amazonaws.com/openai/v1를 사용하며, 여기서 {region}은 요청을 보내는 데 사용할 수 있는 지원되는 소스 AWS 리전입니다. Global CRIS와 Geo CRIS 모두 이 엔드포인트 주소를 사용합니다.

Global CRIS

지원되는 모델 및 추론 프로필 ID:

  • GPT-6 Astra: global.openai.gpt-6-astra
  • GPT-6 Sol: global.openai.gpt-6-sol
  • GPT-6 Luna: global.openai.gpt-6-luna

예를 들어 ~/.codex/config.toml에서 Global CRIS를 사용하도록 Astra를 구성하려면 다음과 같이 설정합니다.

model_provider = "amazon-bedrock-runtime"
model = "global.openai.gpt-6-astra"

미국 Geo CRIS

지원되는 모델 및 추론 프로필 ID:

  • GPT-6 Astra: us.openai.gpt-6-astra
  • GPT-6 Sol: us.openai.gpt-6-sol
  • GPT-6 Luna: us.openai.gpt-6-luna

Codex에 내장된 Runtime 모델 선택기에는 미국 Geo 및 Global 변형이 표시됩니다.

사용 가능한 모델과 CRIS는 소스 AWS 리전에 따라 다릅니다. 각 모델의 정확한 추론 프로필 ID 및 리전별 가용성으로 연결되는 AWS 추론 프로필에 지원되는 리전 및 모델과 AWS 모델별 리전 가용성을 확인한 후 공급자와 모델을 선택하세요.

Bedrock Mantle 엔드포인트를 사용하는 리전 내 추론

model_provider = "amazon-bedrock"를 선택적인 모델 ID와 함께 사용합니다. 공급자는 https://bedrock-mantle.{region}.api.aws/openai/v1를 사용합니다.

지원되는 모델 및 모델 ID:

  • GPT-6 Astra: openai.gpt-6-astra
  • GPT-6 Sol: openai.gpt-6-sol
  • GPT-6 Luna: openai.gpt-6-luna

GPT-6 Sol 및 Luna는 Mantle을 통해 us-east-1(N. Virginia)에서 사용할 수 있습니다. 모델 사용 가능 여부는 AWS 리전에 따라 다릅니다. 공급자와 모델을 선택하기 전에 AWS 모델별 리전 가용성을 참조하세요. GPT-6 Astra의 경우 GPT-6 Astra용 Bedrock 모델 페이지를 참조하세요.

기능 제공 여부

이 구성은 로컬 ChatGPT Work 및 Codex 워크플로를 지원합니다. 웹에서 호스팅되는 ChatGPT Work, Codex cloud, OpenAI가 호스팅하는 클라우드 서비스나 클라우드에서 관리하는 검색 기능에 의존하는 기능은 현재 사용할 수 없습니다. Runtime에서는 호스팅 웹 검색을 사용할 수 없습니다. 이 기능이 필요하면 Mantle을 사용하세요.

Codex Security CLI는 자체 공급자 구성을 사용합니다. 위의 네이티브 클라이언트 설정 대신 Amazon Bedrock 설정 안내에 따르세요.

기능별 사용 가능 여부
기능Amazon Bedrock
접근 및 사용 환경
웹의 ChatGPT Work사용 불가
Codex cloud사용 불가
ChatGPT 데스크톱 앱의 ChatGPT Work 또는 Codex사용 가능
Codex CLI사용 가능
Codex Security CLI사용 가능
IDE 확장 프로그램사용 가능
Codex SDK, codex exec 및 스크립트로 실행할 수 있는 워크플로사용 가능
모델 및 멀티모달
지원되는 OpenAI 모델을 사용한 Bedrock 기반 추론사용 가능
Fast mode사용 불가
이미지 생성 및 편집사용 불가
음성 받아쓰기사용 불가
Runtime의 호스팅 웹 검색사용 불가
로컬 기능
Codex Security 플러그인 및 로컬 스캔사용 가능
로컬 코드 리뷰: /review사용 가능
승인 요청 자동 검토사용 가능
샌드박싱 및 권한 제어사용 가능
프로젝트 예약 작업 및 독립 실행형 예약 작업사용 가능
예약 작업사용 가능
작업 트리 및 내장 Git 도구사용 가능
로컬 환경 및 반복 실행 가능한 작업사용 가능
Appshots사용 가능
브라우저 및 원격 제어
내장 브라우저 미리 보기 및 댓글사용 가능
브라우저의 Computer Use제한적 사용 가능*
Chrome에서 ChatGPT 사용제한적 사용 가능*
Computer Use제한적 사용 가능*
SSH 원격 연결사용 가능
모바일 원격 제어사용 불가
맞춤 설정 및 확장
사용자 지정 지침: AGENTS.md사용 가능
스킬사용 가능
플러그인제한적 사용 가능†
플러그인 공유사용 불가
커넥터사용 불가
MCP사용 가능
하위 에이전트 및 사용자 지정 에이전트사용 가능
메모리제한적 사용 가능*
Computer History사용 불가
클라우드 및 연동
Codex cloud 채팅사용 불가
Sites사용 불가
GitHub 이슈 및 PR 위임: @codex사용 불가
GitHub 코드 리뷰 및 자동 PR 리뷰사용 불가
Slack 클라우드 연동사용 불가
Linear 클라우드 연동사용 불가
관리, 보안 및 분석
SAML SSO, MFA 및 워크스페이스 사용자 관리사용 불가
requirements.toml 관리형 구성사용 가능
클라우드에서 관리하는 구성 정책사용 불가
ChatGPT 워크스페이스 RBAC 및 사용자 지정 역할사용 불가
SCIM, EKM 및 도메인 확인사용 불가
엔터프라이즈 데이터 보존 및 저장 위치 제어사용 불가
기본적으로 API 또는 비즈니스 데이터를 학습에 사용하지 않음사용 가능
분석 대시보드사용 불가
Analytics API사용 불가
Compliance API 및 감사 로그사용 불가
연결된 GitHub 저장소용 Codex Security cloud사용 불가

* 현재 특정 지역에서만 사용할 수 있는 기능입니다. 지역 제한에 관한 자세한 내용은 각 기능의 문서를 확인하세요.

† 로컬 플러그인 번들과 Codex Security를 비롯해 ChatGPT 인증이 필요하지 않은 OpenAI 선정 플러그인은 사용할 수 있습니다. ChatGPT 인증, 커넥터 또는 클라우드 호스팅 공유가 필요한 플러그인은 사용할 수 없습니다.

문제 해결

설정에 실패하면 다음 항목을 확인하세요.

  • 모델 ID가 지원되는 모델과 정확히 일치하는지 확인하세요.
  • 엔드포인트에 맞는 모델 공급자를 사용하는지 확인하세요. Runtime 엔드포인트에는 amazon-bedrock-runtime, Mantle 엔드포인트에는 amazon-bedrock을 사용합니다.
  • 모델을 사용할 수 있는 AWS 리전을 지정했는지 확인하세요.
  • Bedrock API key 또는 AWS 자격 증명이 유효하며 만료되지 않았는지 확인하세요.
  • AWS 자격 증명에 해당하는 주체에 선택한 Bedrock 모델에 접근할 권한이 있는지 확인하세요.
  • AWS_BEARER_TOKEN_BEDROCK에 만료되었거나 의도하지 않은 키가 설정되어 있지 않은지 확인하세요.
  • 데스크톱 앱이나 IDE 확장 프로그램을 사용하는 경우, 필요한 환경 변수가 ~/.codex/.env에 있는지 확인하세요.

AWS SDK 프로필 인증을 사용하는 경우 aws sts get-caller-identity --profile codex-bedrock을 실행하여 선택한 프로필의 자격 증명에 해당하는 주체를 확인하세요. codex-bedrock을 프로필 이름으로 바꾸거나, 기본 자격 증명 체인을 사용하는 경우 --profile를 생략하세요. 이 명령은 AWS 자격 증명의 주체를 확인하며, Bedrock 모델 호출 권한을 확인하지는 않습니다. AWS_BEARER_TOKEN_BEDROCK을 별도로 확인하여 의도하지 않은 API key로 인해 다른 인증 경로가 선택되지 않도록 하세요.

지원 범위

OpenAI Support는 ChatGPT Work 및 Codex 클라이언트 설정, 구성, 로컬 CLI 동작, 데스크톱 앱 동작, IDE 확장 프로그램 동작 및 로컬 제품 환경과 관련된 문제를 지원할 수 있습니다.

AWS 자격 증명, IAM 권한, Bedrock 모델 액세스, 할당량, 결제, 지역별 제공 여부, Bedrock 요청 실패, AWS 서비스 로그 또는 Bedrock 서비스 동작과 관련해서는 고객의 AWS 관리자나 AWS Support에 문의하세요.