이 문서에서는 OpenAI의 코딩 에이전트인 Codex를 다룹니다. 더 긴 리서치와 결과물 작업을 위한 별도의 ChatGPT 경험인 ChatGPT Work에 관심이 있다면 ChatGPT Work 및 Codex를 참조하세요. 기술적인 Codex 세부 정보는 개발자 사이트의 Codex 페이지를 참조하세요. Codex는 ChatGPT 플랜 전반에 포함되어 있습니다.
Sora, ChatGPT 이미지 또는 음성 모드 같은 ChatGPT 기능에 대한 정보는 도움말 센터의 다른 문서를 참조하세요.
일반 Chat 음성 대화와 데스크톱의 Work 및 Codex 내 음성 대화를 포함한 ChatGPT 음성 대화에 대해 자세히 알아보세요.
Codex란 무엇인가요?
Codex는 코드 작성, 검토, 배포를 도와주는 AI 에이전트입니다.
시작하기
Codex를 ChatGPT 계정에 연결하는 방법
ChatGPT 요금제로 Codex를 사용하려면 다음 단계를 따르세요.
ChatGPT 계정으로 로그인합니다.
Codex는 Free 및 ChatGPT Go를 비롯한 모든 ChatGPT 요금제에 포함됩니다. 사용량 한도는 요금제에 따라 다릅니다.
개인용 사용량 확대 옵션과 비즈니스 사용자용 Codex 크레딧 요금제 등 자세한 내용은 chatgpt.com/pricing에서 확인하세요.
원하는 Codex 클라이언트를 실행하고 안내에 따라 ChatGPT로 로그인하세요.
선택한 클라이언트에 표시되는 설정 단계를 따르세요.
Codex 사용에는 어떤 약관이 적용되나요?
기존 ChatGPT 계정으로 Codex에 로그인하면 Codex와 ChatGPT 간에 공유되는 데이터에 ChatGPT 이용약관 및 개인정보 보호 정책이 적용됩니다. OpenAI API 및 ChatGPT Enterprise, Education 또는 Business 사용자에게는 이에 상응하는 온라인 서비스 계약이 적용됩니다.
Enterprise 설정 및 제어
Codex의 모델 기본값
워크스페이스 관리자와 소유자는 워크스페이스 설정 → 모델(모델 열기)에서 Codex의 시작 모델, 추론 수준, 속도, 빠른 모드 사용 가능 여부 및 새 채팅 동작을 구성할 수 있습니다. 빠른 모드는 기본적으로 활성화됩니다. 역할별 제어가 제공되는 경우 관리자는 선택한 역할에 대해 워크스페이스 기본값을 재정의할 수 있습니다. 이러한 설정은 구성원의 시작 환경을 정의할 뿐, 사용할 수 없는 모델을 활성화하거나 강제 적용되는 워크스페이스 요건을 재정의하지 않습니다.
둘 이상의 설정이 적용되면 강제 제어가 우선합니다. 관리형 requirements.toml 요건은 워크스페이스 시작 기본값보다 우선하며, 워크스페이스 시작 기본값은 구성원의 로컬 시작 선택보다 우선합니다. 구성원은 해당 모델을 계속 사용할 수 있고 강제 요건이 변경을 막지 않는 경우에만 시작 기본값에서 다른 모델로 전환할 수 있습니다.
설정
워크스페이스에서 Codex를 설정하고 실행하는 자세한 방법은 다음
가이드를 참조하세요. Enterprise 관리자 가이드
플러그인
플러그인 디렉터리는 모든 ChatGPT 요금제에서 볼 수 있습니다. 구성원의 플러그인 설치 또는 사용 가능 여부는 요금제, 워크스페이스 설정, 역할, 사용 환경 및 플러그인에 필요한 앱 권한에 따라 달라집니다. Business 및 Enterprise/Edu 워크스페이스의 관리자와 소유자는 워크스페이스 설정 > 플러그인에서 플러그인 설치를, 워크스페이스 설정 > 앱에서 기반 앱 액세스를 관리합니다.
플러그인에는 스킬, 앱 및 앱 템플릿이 포함될 수 있습니다. 플러그인에 앱이 필요한 경우 Codex가 앱 기반 기능을 사용하려면 먼저 해당 구성원의 역할에 그 앱이 활성화되어 있어야 합니다. 역할 액세스, 작업 제어, 승인 설정, 동기화 설정, 도메인 제한 및 제공업체 인증 등 기존 앱 설정은 계속 적용됩니다.
워크스페이스 플러그인 제어에서 대상 역할에 플러그인을 사용 가능 또는 설치됨 상태로 지정할 수 있습니다. 설치됨은 해당 역할에 플러그인을 기본 설치하고, 사용 가능은 구성원이 직접 설치할 수 있게 합니다. 플러그인을 해당 환경에서 사용할 수 있는 경우 이러한 제어는 ChatGPT 웹, ChatGPT 모바일, ChatGPT 데스크톱 및 Codex에 모두 적용됩니다. 관리자는 환경별로 별도의 앱 또는 플러그인 전환 설정을 지정하지 않습니다.
일부 로컬 또는 Codex 전용 플러그인은 Codex에서만 사용할 수 있습니다. 로컬에서 만든 플러그인은 워크스페이스 전체에서 사용하기 전에 관리자가 업로드하거나 가져오거나 사용 가능하도록 설정해야 할 수 있습니다.
Codex의 Sites
지원 지역에서는 Free 및 ChatGPT Go를 제외한 ChatGPT 유료 요금제로 Sites를 이용할 수 있습니다. 현재 유럽 경제 지역, 스위스 및 영국에서는 Sites를 이용할 수 없습니다. 워크스페이스 관리자는 구성원의 Sites 생성 및 공개 게시 가능 여부를 제어합니다.
Codex에서 Sites를 이용할 수 있다면 만들고 싶은 것을 설명하고, 생성된 미리보기를 검토한 후 제공되는 공유 제어 기능을 사용하세요. 전체 빌드 및 배포 워크플로는 Codex Sites 개발자 가이드를 참조하세요.
워크스페이스 관리자는 요금제에서 제공되는 설정을 통해 Sites 생성 및 공개 게시를 제어할 수 있습니다.
사용 가능한 제어 기능은 요금제와 워크스페이스 구성에 따라 다릅니다. 원하는 제어 기능을 찾을 수 없다면 OpenAI 지원팀에 문의하세요.
브라우저 사용 및 인앱 브라우저용 개발자 모드
개발자 모드는 Chrome의 브라우저 사용 기능 및 Codex 인앱 브라우저와 함께 작동합니다. 이 모드는 Codex에 Chrome DevTools Protocol(CDP)에 대한 제어된 액세스를 부여하여 콘솔 출력, 네트워크 트래픽, 페이지 상태 및 JavaScript 성능 검사 등 심층적인 브라우저 디버깅을 지원합니다.
ChatGPT 데스크톱 앱에서 설정 > 브라우저를 열고 개발자 모드 아래의 전체 CDP 액세스 활성화를 켜면 로컬에서 이 기능을 활성화할 수 있습니다. 전체 CDP 액세스를 사용하면 Codex가 데이터 위험을 초래할 수 있는 민감한 브라우저 내부 요소를 검사하고 제어할 수 있습니다. Codex는 전체 CDP 액세스로 웹사이트를 검사하기 전에 명시적인 승인을 요청합니다.
Codex 관리 권한이 있는 사용자는 관리형 구성에서 browser_use_full_cdp_access를 false로 설정하여 전체 CDP 액세스를 비활성화할 수 있습니다. 브라우저 사용 기능을 비활성화하면 CDP도 비활성화됩니다.
설정 및 승인에 관한 자세한 내용은 개발자 모드를 참조하세요. 관리자/소유자는 개발자 모드를 활성화하기 전에 먼저 인앱 브라우저를 활성화해야 합니다.
RBAC(역할 기반 액세스 제어)
특정 사용자 역할에 Codex 액세스 권한을 부여할 수 있습니다. RBAC 설정에 관한 자세한 내용은 다음 가이드를 참조하세요. RBAC
Compliance API
CLI 및 IDE 확장 프로그램 같은 로컬 클라이언트와 웹 또는 클라우드 위임 사용을 비롯한 Codex 사용량은 Compliance API에서 확인할 수 있습니다. 이 로그 인터페이스에는 클라우드 작업 전용 엔드포인트와 별도로 지원되는 Codex 클라이언트가 포함됩니다.
요금제별 사용량 한도
Codex 한도에 근접했거나 도달했다면 설정 또는 사용량 대시보드를 여세요. 어떤 허용량이 소진되었는지, 크레딧 잔액과 표시된 초기화 시간을 확인하세요. 진행 중인 Codex CLI 세션에서는 /status를 입력하세요.
현재 한도, 요율 및 크레딧 옵션은 요금 페이지에서 확인하세요.
사용량이 소진되는 이유
요금제에서 해당 기능이 제공되는 경우 Codex, ChatGPT Work, ChatGPT for Excel 및 워크스페이스 에이전트는 허용량과 크레딧 풀을 공유합니다. 사용량은 모델, 작업 실행 위치, 작업 복잡성, 컨텍스트, 추론, 속도 및 도구에 따라 달라집니다. 장시간 실행되는 작업은 짧은 요청보다 훨씬 많은 사용량을 소모할 수 있습니다.
데스크톱의 Work 또는 Codex에서 ChatGPT 음성 대화를 통해 시작한 작업은 동일한 허용량을 사용합니다. 유연한 요금제가 적용되는 경우 음성 연결 시간은 별도로 측정됩니다. 일반 Chat 음성 대화에는 별도의 한도가 적용되며 Codex 사용량을 소모하지 않습니다.
지원되는 경우 ChatGPT Desktop에서 개별 Work 및 Codex 채팅의 크레딧 사용량을 확인할 수 있습니다. 일반 Chat 사용량은 포함되지 않습니다. 예상 금액은 워크스페이스에서 구성원의 비용 확인을 활성화한 경우에만 표시됩니다. 이는 계획 수립용 예상치이며 청구서가 아닙니다.
크레딧 기반 청구를 사용하는 대상 Enterprise 워크스페이스의 구성원은 ChatGPT Desktop에서 설정 > 사용량 및 청구를 열 수 있습니다. 여기에서 월별 Work 및 Codex 허용량과 최근 크레딧 내역을 확인할 수 있습니다. 지원되는 경우 로컬에서 확인 가능한 사용량이 많은 Work 및 Codex 채팅과 각 채팅의 누적 크레딧 사용량도 검토할 수 있습니다. 메뉴 이동 방법, 데이터 최신성 및 설정에 관한 자세한 내용은 Work 및 Codex 사용량 검토 및 Personal Analytics 사용하기를 참조하세요.
다음 단계
한도 알림에서 계정에 제공되는 옵션을 확인하세요. 크레딧 추가, 사용 가능한 초기화 적용, 업그레이드 또는 표시된 초기화 시간까지 대기 등의 옵션을 이용할 수 있습니다. 대상 Plus 및 Pro 사용자는 요금제를 변경하지 않고 크레딧을 구매할 수 있습니다.
구매한 크레딧이 표시되지 않으면 먼저 올바른 계정 또는 워크스페이스에 있는지 확인하고 최근 사용량을 검토하세요. 크레딧 가이드에서는 마이너스 잔액이 이후 구매에 미치는 영향도 설명합니다.
수치가 여전히 잘못된 것으로 보이는 경우
OpenAI 지원팀에 문의하세요. 문의 시 확인이 필요한 한도 또는 크레딧 잔액, 표시된 초기화 시간, 스크린샷, Codex 클라이언트와 모델, 문제가 발생한 시점 및 시간대를 포함하세요. 스크린샷에서 민감한 정보는 삭제하세요.
컨텍스트 및 데이터 제어
일부 Codex 기능은 컨텍스트를 기억하고, 시간에 걸쳐 작업을 이어가고, 사용자가 선택한 도구에 연결하여 Codex가 더 유용하게 작동하도록 지원합니다. 여기에는 메모리, 예약 작업, Codex 인앱 브라우저 및 컴퓨터 사용이 포함됩니다. 이러한 기능이 저장하고 상호 작용하는 데이터를 관리하는 방법을 비롯해 이 기능들과 기타 기능에 관한 자세한 내용은 개발자 센터를 참조하세요.
기록 및 재생
기록 및 재생은 대상 사용자가 macOS용 ChatGPT 데스크톱 앱에서 Codex를 사용할 때 이용할 수 있습니다. 워크플로를 한 번 시연하면 재사용 가능한 스킬로 만들 수 있습니다. 설명보다 직접 보여 주기 쉬운 안정적이고 반복 가능한 워크플로에 유용합니다.
기록 및 재생을 사용하려면 컴퓨터 사용 기능을 이용할 수 있고 활성화되어 있어야 하며, 초기 제공 지역에서 유럽연합, 스위스 및 영국은 제외됩니다. 기록 중에는 Codex가 워크플로 학습에 필요한 작업과 창 콘텐츠를 관찰합니다. 녹화 내용은 작업에 집중되도록 하고, 녹화 중에는 비밀 정보나 민감한 데이터를 입력하지 마세요.
자세한 내용은 기록 및 재생 가이드를 참조하세요.
데이터 제어
ChatGPT 학습 데이터 제어는 컴퓨터 사용 기능으로 촬영한 스크린샷을 포함해 Codex에서 처리되는 콘텐츠에도 적용됩니다. 로컬 워크플로는 사용자의 기기에서 실행되고, 클라우드 작업은 OpenAI가 관리하는 환경에서 실행됩니다. 연결된 서비스는 지원되는 ChatGPT 및 Codex 환경 전반에서 이용할 수 있으며, 언제든지 연결을 해제할 수 있습니다.
자주 묻는 질문
Codex CLI 또는 IDE 확장 프로그램은 어떤 모델을 사용하나요?
Codex에서 기본으로 사용하는 모델은 CLI 또는 IDE 확장 프로그램의 버전과 구성에 따라 달라집니다. 사용 가능한 모델과 다른 모델을 구성하는 방법은 Codex 문서에서 확인하세요.
OpenAI는 제 Codex 사용 데이터를 학습에 사용하나요?
Business, Enterprise 및 Edu
OpenAI는 기본적으로 ChatGPT Business, ChatGPT Enterprise, API를 비롯한 비즈니스용 제품의 입력이나 출력을 모델 개선에 사용하지 않습니다. 다만 API 조직 소유자는 API 데이터를 OpenAI와 공유하도록 선택할 수 있습니다. Enterprise 조직 및 데이터 비보관을 사용 설정한 고객을 포함한 일부 조직에는 이 설정이 제공되지 않습니다.
자세한 내용은 OpenAI와 피드백, 평가 및 미세 조정 데이터, API 입력 및 출력 공유하기를 참조하세요.
Pro 및 Plus
ChatGPT 데이터 제어에서 학습을 끄지 않으면 대화가 모델 개선에 사용될 수 있습니다. 자세한 내용은 모델 성능 개선에 데이터가 사용되는 방식을 참조하세요.
IDE에서 Codex를 실행할 수 있나요?
예. Codex VS Code 확장 프로그램은 대부분의 VS Code 포크와 호환됩니다. 다른 IDE에서는 IDE의 터미널에서 Codex CLI를 실행할 수도 있습니다.
ChatGPT 데스크톱 앱의 Codex에는 워크스페이스 권한이 어떻게 적용되나요?
예. 관리형 워크스페이스에서는 Codex 로컬 사용과 Codex 클라우드 작업을 별도로 제어할 수 있습니다. Codex Local에는 CLI, IDE 확장 프로그램 및 데스크톱 워크플로가 포함되며, Codex Cloud에는 위임된 클라우드 작업이 포함됩니다. Remote Control에는 워크스페이스 활성화 또는 RBAC 권한이 필요할 수도 있으며, ChatGPT 데스크톱 설정에서 기기의 검색 및 제어가 허용되어 있어야 합니다.
워크스페이스에서 Codex를 설정하고 사용하는 방법을 자세히 알아보려면 다음 가이드를 참조하세요. Enterprise 관리자 가이드
ChatGPT 데스크톱 앱에서 Codex 문제를 해결하는 데 필요한 도움말은 어디에서 찾을 수 있나요?
ChatGPT 데스크톱 앱에서 Codex를 사용하다가 문제가 발생하면 플랫폼 가이드를 참조하세요. 추가 도움이 필요하면 문의해 주세요.
Codex Enterprise Analytics에 액세스하려면 어떻게 해야 하나요?
Codex가 활성화된 Enterprise 워크스페이스에서 Codex Enterprise Analytics를 이용할 수 있습니다. Codex Enterprise Analytics API를 사용하려면 Codex Enterprise Analytics 액세스 권한이 있는 조직 API 키를 사용하세요. 키에 액세스 권한이 없어 API 요청이 거부되면 워크스페이스 또는 조직 관리자에게 Codex Enterprise Analytics 액세스 권한이 있는 키를 요청하세요.
설정 및 API 액세스에 관한 자세한 내용은 API 문서를 참조하세요.
파일 업로드 한도, 이미지 한도, 음성 한도 등 ChatGPT 관련 사용량 한도가 Codex에도 적용되나요?
ChatGPT의 파일 업로드, 이미지 생성 및 음성에는 각각 별도의 사용량 한도, 초기화 주기, 알림 배너가 적용됩니다. 예를 들어 ChatGPT에서 파일을 업로드할 때 ‘지난 1일 동안 이미지 50개’, ‘720시간 후 초기화’ 같은 배너나 음성 한도 도달 또는 업로드 한도 배너가 표시되더라도 해당 한도는 Codex에 적용되지 않습니다.
이미지 및 동영상 한도와 음성 한도에 관한 자세한 내용은 이미지 및 동영상 생성 한도와 음성 사용량 한도를 참조하세요. ChatGPT 파일 업로드 한도 및 문제 해결에 관한 자세한 내용은 파일 업로드 FAQ를 참조하세요. 파일 업로드를 비롯한 여러 ChatGPT 서비스의 상태는 OpenAI 상태 페이지에서 확인하세요.
데스크톱의 Work 또는 Codex 내에서 사용하는 ChatGPT 음성 대화는 별도로 측정되지만, 음성 대화를 통해 시작한 작업은 Work 및 Codex와 동일한 에이전트 공유 풀을 사용합니다. 자세히 알아보기
Codex 추천 초대와 적립형 초기화는 어떻게 작동하나요?
대상 사용자에게는 프로필 메뉴에 Codex 추천 초대가 표시될 수 있습니다. 개인 요금제 사용자에게는 친구 초대가, 대상 Business 워크스페이스 구성원에게는 동료 초대가 표시될 수 있습니다. 초대 대화상자에는 현재 리워드, 초대 한도, 만료일, 적용되는 수신자 요건 등 현재 혜택의 세부 정보가 표시됩니다.
일부 Plus 및 Pro 프로모션에서는 추천에 성공하면 Codex 사용량 한도 초기화 1회를 적립할 수 있습니다. 적립된 초기화를 사용하려면 프로필 메뉴를 열고 사용 가능한 초기화 1회와 같이 사용 가능한 초기화 횟수가 표시된 사용량 요약을 선택하세요.
적립된 전체 초기화를 사용하면 5시간 및 주간 사용량 기간이 모두 초기화됩니다. 따라서 주간 초기화 날짜는 사용일로부터 약 7일 후로 변경됩니다.
추천 리워드는 혜택과 요금제에 따라 다릅니다. 현재 리워드, 한도 및 자격 요건에 관한 자세한 내용은 친구 및 동료 초대와 Codex 추천 프로모션을 참조하세요.
Codex에서 프로젝트 지침을 만들려면 어떻게 해야 하나요?
ChatGPT 데스크톱 앱에서 Codex를 사용하는 동안 /init을 실행하면 현재 프로젝트의 AGENTS.md 기본 구조가 생성됩니다. Codex CLI와 동일한 초기화 워크플로를 사용합니다. 다른 명령어는 앱 명령어를 참조하세요.
Codex가 작업 중일 때 사용량 한도에 도달하면 어떻게 되나요?
활성 턴 도중 사용량 한도에 도달해도 Codex는 공정 사용 한도 내에서 해당 턴의 작업을 계속할 수 있습니다. 해당 턴이 끝나면 Codex 사용량 페이지나 한도 배너에서 요금제에 제공되는 옵션을 확인하세요. 크레딧 추가, 사용 가능한 초기화 적용, 업그레이드 또는 한도 초기화까지 대기 등의 옵션이 제공될 수 있습니다.
자세한 내용은 Codex 사용량 한도를 참조하세요.
Codex의 GPT-5.4 및 GPT-5.4 mini는 어떻게 되나요?
2026년 8월 31일부터 ChatGPT 계정으로 로그인할 경우 Codex에서 GPT-5.4 및 GPT-5.4 mini를 더 이상 사용할 수 없습니다.
GPT-5.4를 GPT-5.6 Terra로 교체하세요.
GPT-5.4 mini를 GPT-5.6 Luna로 교체하세요.
8월 31일 전에 워크스페이스 기본값, 저장된 모델 설정, 관리형 구성 또는 자동화를 모두 업데이트하세요.
이 변경 사항은 OpenAI API 또는 자체 API 키로 Codex를 사용하는 경우에는 영향을 미치지 않습니다.
지원팀에서 사용량 한도를 초기화해 줄 수 있나요?
아니요. OpenAI 지원팀에서는 ChatGPT 또는 Codex 사용량 한도를 초기화하지 않습니다. 한도에 도달하면 초기화될 때까지 기다리거나 계정에 표시된 다른 옵션을 이용하세요.
사용량이 잘못 집계되었거나 안내된 초기화 시간이 지난 후에도 액세스가 복구되지 않았다면 지원팀에 문의해 주세요. 문제를 조사해 드리겠습니다.
일회성 사용량 한도 초기화는 어떻게 작동하나요?
OpenAI는 때때로 대상 사용자에게 Codex 또는 ChatGPT Work 사용량 한도를 일회성으로 초기화해 드릴 수 있습니다. 자격 요건, 초기화되는 한도, 사용 또는 만료 요건은 혜택에 따라 달라질 수 있습니다. 향후 초기화 제공은 보장되지 않습니다.
자동 초기화는 공지에 명시된 사용량 한도에 직접 적용됩니다. 자동 초기화 자체는 나중에 사용할 수 있도록 저장되지 않습니다. 적용 후의 사용량은 새로 갱신된 허용량에 포함됩니다. 일부 혜택에는 별도의 적립형 초기화가 포함될 수도 있습니다. 적립형 초기화를 받았다면 계정 또는 혜택 안내에서 사용 및 만료 세부 정보를 확인하세요.
일회성 초기화 대상이 아니었거나, 정상적으로 적용된 초기화를 알아차리지 못했거나, 적립형 초기화를 명시된 만료일 전에 사용하지 않았다는 이유만으로 추가 초기화, 크레딧, 환불 또는 기타 보상을 제공하지는 않습니다.
사용량이 잘못 표시되거나, 안내된 초기화 시간이 지난 후에도 액세스가 복구되지 않았거나, 받을 자격이 있는 초기화가 안내된 대로 적용되지 않았다고 생각되면 지원팀에 문의하세요.
