Codex란 무엇인가요?

Codex는 코드 작성, 검토, 배포를 도와주는 AI 에이전트입니다.

시작하기

Codex를 ChatGPT 계정에 연결하는 방법

ChatGPT 요금제로 Codex를 사용하려면 다음 단계를 따르세요.

ChatGPT 계정으로 로그인합니다.

Codex는 Free와 Go를 비롯한 모든 ChatGPT 요금제에 포함되어 있습니다. 사용량 한도는 요금제에 따라 다릅니다.

개인용 고사용량 옵션과 비즈니스 사용자를 위한 Codex 크레딧 요금제 등 자세한 내용은 chatgpt.com/pricing에서 확인하세요.

원하는 Codex 클라이언트를 실행하고 안내에 따라 ChatGPT로 로그인하세요.

• ChatGPT 데스크톱 앱(Codex 모드)

• Codex CLI

• Codex IDE 확장 프로그램

• Codex 웹

• 선택한 클라이언트에 표시되는 설정 단계를 따르세요.

Windows에서 Codex 사용하기

Windows용 Codex에는 다음 도구가 포함되어 있습니다.

• Codex Doctor: Codex CLI에서 codex doctor를 실행하여 시작, 연결, 성능 문제를 진단합니다.

• 원격 제어: Windows 기기에서 다른 기기를 제어합니다. 워크스페이스 권한과 기기의 검색 및 제어 설정은 그대로 적용됩니다.

• WSL 배포판 선택: WSL(Windows Subsystem for Linux) 배포판이 여러 개 설치되어 있다면 Codex에서 사용할 Linux 배포판을 선택하세요.

조직에서 앱 업데이트를 관리하는 경우, 해당 빌드가 필요한 기능을 사용하려면 먼저 관리자가 MDM을 통해 승인된 빌드를 배포해야 합니다.

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

Sites는 지원 지역에서 Free와 Go를 제외한 ChatGPT 유료 요금제에 제공됩니다. 현재 유럽 경제 지역, 스위스, 영국에서는 Sites를 사용할 수 없습니다. 워크스페이스 관리자는 구성원이 Sites를 만들거나 공개적으로 게시할 수 있는지 제어합니다.

Codex에서 Sites를 사용할 수 있다면 만들고 싶은 것을 설명하고, 생성된 미리 보기를 검토한 다음, 제공되는 공유 제어를 사용하세요. 전체 빌드 및 배포 워크플로는 Codex Sites 개발자 가이드를 참조하세요.

워크스페이스 관리자는 요금제에서 제공하는 설정을 통해 Sites 생성 및 공개 게시를 제어할 수 있습니다.

• 사용 가능한 제어는 요금제와 워크스페이스 구성에 따라 달라집니다. 필요한 제어를 찾을 수 없다면 OpenAI 지원팀에 문의하세요.

브라우저 사용 및 인앱 브라우저용 개발자 모드

개발자 모드는 Chrome의 브라우저 사용 및 Codex 인앱 브라우저에서 작동합니다. 개발자 모드는 콘솔 출력, 네트워크 트래픽, 페이지 상태, JavaScript 성능 검사 등 심층적인 브라우저 디버깅을 위해 Codex에 Chrome DevTools Protocol(CDP)에 대한 제어된 액세스를 제공합니다.

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, Workspace Agents는 해당 기능이 요금제에서 제공되는 경우 할당량과 크레딧 풀을 공유합니다. 사용량은 모델, 작업 실행 위치, 작업 복잡성, 컨텍스트, 추론, 속도, 도구에 따라 달라집니다. 오래 실행되는 작업은 짧은 요청보다 훨씬 많은 사용량을 소비할 수 있습니다.

데스크톱의 Work 또는 Codex에서 ChatGPT 음성 대화로 시작한 작업도 동일한 할당량을 사용합니다. 탄력 요금제가 적용되는 경우 연결된 음성 대화 시간은 별도로 측정됩니다. 일반 Chat 음성 대화에는 별도 한도가 적용되며 Codex 사용량을 소비하지 않습니다.

지원되는 경우 ChatGPT Desktop에서 개별 Work 및 Codex 채팅의 크레딧 사용량을 확인할 수 있습니다. 일반 Chat 사용량은 포함되지 않습니다. 예상 금액은 워크스페이스에서 구성원 비용 공개를 활성화한 경우에만 표시됩니다. 이는 계획 수립용 추정치이며 청구서가 아닙니다.

크레딧 기반 청구를 사용하는 대상 Enterprise 워크스페이스의 구성원은 ChatGPT Desktop에서 설정 > 사용량 및 결제를 열 수 있습니다. 여기에서 월간 Work 및 Codex 할당량과 최근 크레딧 내역을 확인할 수 있습니다. 지원되는 경우 로컬에서 확인 가능한 사용량이 많은 Work 및 Codex 채팅과 각 채팅의 누적 크레딧 사용량도 검토할 수 있습니다. 탐색 방법, 데이터 최신 상태, 설정에 관해서는 Work 및 Codex 사용량 검토와 개인 분석 사용하기를 참조하세요.

다음으로 할 수 있는 작업

한도 알림에서 계정에 제공되는 옵션을 확인하세요. 크레딧 추가, 사용 가능한 재설정 적용, 업그레이드가 가능할 수 있으며, 표시된 재설정 시간까지 기다릴 수도 있습니다. 대상 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 및 데이터 비보관이 활성화된 고객을 비롯한 일부 조직에서는 이 설정을 사용할 수 없습니다.


피드백, 평가 및 미세 조정 데이터와 API 입력 및 출력을 OpenAI와 공유하기에 대해 자세히 알아보세요.

Pro 및 Plus

ChatGPT 데이터 제어에서 학습을 끄지 않으면 대화가 모델 개선에 사용될 수 있습니다. 자세한 내용은 모델 성능 개선에 데이터가 사용되는 방식을 참조하세요.

IDE에서 Codex를 실행할 수 있나요?

예. Codex VS Code 확장 프로그램은 대부분의 VS Code 포크와 호환됩니다. 다른 IDE에서는 IDE의 터미널에서 Codex CLI를 실행할 수도 있습니다.

워크스페이스 권한은 ChatGPT 데스크톱 앱의 Codex에 어떻게 적용되나요?

예. 관리형 워크스페이스에서는 Codex 로컬 사용과 Codex 클라우드 작업을 별도로 제어할 수 있습니다. Codex Local은 CLI, IDE 확장 프로그램, 데스크톱 워크플로를 포함하고, Codex Cloud는 위임된 클라우드 작업을 포함합니다. 원격 제어에는 워크스페이스 활성화 또는 RBAC 권한이 필요할 수도 있으며, ChatGPT 데스크톱 설정에서 기기의 검색 및 제어가 허용되어 있어야 합니다.

워크스페이스에서 Codex를 설정하고 운영하는 방법에 관한 자세한 안내는 다음 가이드를 참조하세요. Enterprise 관리자 가이드

ChatGPT 데스크톱 앱에서 Codex 문제 해결 도움말은 어디에서 찾을 수 있나요?

ChatGPT 데스크톱 앱에서 Codex를 사용하다 문제가 발생하면 플랫폼 가이드를 참조하세요. 추가 도움이 필요하면 문의해 주세요.

Codex Enterprise Analytics에 액세스하려면 어떻게 해야 하나요?

Codex Enterprise Analytics는 Codex가 활성화된 Enterprise 워크스페이스에서 사용할 수 있습니다. API를 사용하려면 워크스페이스 소유자 또는 관리자에게 codex.enterprise.analytics.read 권한이 있는 워크스페이스 범위의 관리자 키를 생성해 달라고 요청하세요.

관리자 콘솔에서 올바른 ChatGPT 워크스페이스를 선택하고 자격 증명 > 관리자 키를 연 다음, Codex 분석 API를 읽기로 설정하세요. API 플랫폼 조직 키로는 ChatGPT 워크스페이스 분석에 액세스할 수 없습니다.

설정 및 권한에 관해서는 관리자 콘솔에서 관리자 키 관리하기를 참조하세요.

엔드포인트 세부 정보는 Codex Enterprise Analytics API 참고 자료를 참조하세요.

ChatGPT의 파일 업로드, 이미지, 음성 한도와 관련된 사용률 제한이 Codex에도 적용되나요?

ChatGPT 파일 업로드, 이미지 생성, 음성에는 각각 별도의 사용 한도, 재설정 주기, 배너가 적용됩니다. 예를 들어 ChatGPT에서 파일을 업로드할 때 ‘지난 24시간 동안 이미지 50개’, ‘720시간 후 재설정’ 같은 배너가 표시되거나, 음성 한도에 도달하거나, 업로드 한도 배너가 표시되더라도 이러한 한도는 Codex에 적용되지 않습니다.

이미지 및 동영상 한도와 음성 한도에 관한 자세한 내용은 이미지 및 동영상 생성 한도와 음성 사용 한도를 참조하세요. ChatGPT 파일 업로드 한도 및 문제 해결에 관한 정보는 파일 업로드 FAQ를 참조하세요. 파일 업로드를 비롯한 여러 ChatGPT 서비스의 상태는 OpenAI 상태 페이지에서 확인하세요.

데스크톱의 Work 또는 Codex에서 사용하는 ChatGPT 음성 대화는 별도로 측정되지만, 음성 대화를 통해 시작한 작업은 Work 및 Codex와 동일한 공유 에이전트 풀을 사용합니다. 자세히 알아보세요.

Codex 추천 초대와 저장된 재설정은 어떻게 작동하나요?

대상 사용자의 프로필 메뉴에 Codex 추천 초대가 표시될 수 있습니다. 개인 요금제 사용자에게는 친구 초대가, 대상 Business 워크스페이스 구성원에게는 동료 초대가 표시될 수 있습니다. 초대 대화 상자에는 현재 보상, 초대 한도, 만료일, 적용되는 수신자 요건 등 현재 혜택의 세부 정보가 표시됩니다.

일부 Plus 및 Pro 프로모션에서는 추천이 성사되면 저장 가능한 Codex 사용률 한도 재설정이 추가될 수 있습니다. 저장된 재설정을 사용하려면 프로필 메뉴를 열고 사용 가능한 재설정 1회처럼 사용 가능한 재설정 횟수가 표시된 사용량 요약을 선택하세요.

저장된 전체 재설정을 사용하면 Codex의 5시간 및 주간 사용 기간이 갱신되고 주간 재설정 날짜가 변경됩니다. 설정 → 사용량에서 업데이트된 재설정 시간을 확인하세요.

추천 보상은 혜택과 요금제에 따라 다릅니다. 현재 보상, 한도, 대상 자격에 관한 자세한 내용은 친구 및 동료 초대와 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 사용 한도의 일회성 재설정을 제공할 수 있습니다. 대상 자격, 영향을 받는 한도, 사용 또는 만료 요건은 혜택마다 다를 수 있습니다. 향후 재설정은 보장되지 않습니다.

자동 재설정은 공지에서 지정한 사용 한도에 직접 적용됩니다. 자동 재설정 자체를 나중에 사용하도록 저장할 수는 없습니다. 적용 후의 사용량은 새로 갱신된 할당량에 포함됩니다. 일부 혜택에는 별도로 저장되는 재설정이 포함될 수도 있습니다. 이를 받은 경우 계정 또는 혜택 안내에서 사용 및 만료 세부 정보를 확인하세요.

일회성 재설정 대상이 아니었거나, 올바르게 적용된 재설정을 확인하지 못했거나, 저장된 재설정을 명시된 만료일 전에 사용하지 않았다는 이유만으로 추가 재설정, 크레딧, 환불 또는 기타 보상을 제공하지 않습니다.

사용량이 잘못된 것 같거나, 명시된 재설정 시간이 지난 뒤에도 액세스가 복구되지 않았거나, 받을 자격이 있는 재설정이 설명대로 적용되지 않았다고 생각되면 지원팀에 문의하세요.

approval_policy = "untrusted" 설정에서 Codex가 시작되지 않는 이유는 무엇인가요?

Codex는 더 이상 untrusted 승인 정책을 지원하지 않습니다. 구성에서 이 정책을 계속 사용하면 다음 오류와 함께 Codex가 시작되지 않을 수 있습니다. approval_policy = "untrusted" is no longer supported; remove this setting.

이 변경 사항은 Codex CLI 버전 0.149.0 이상, macOS, Windows, Linux용 Codex 데스크톱 앱 버전 26.818.31338 이상, Codex VS Code 확장 프로그램 버전 26.818.31338 이상에 적용됩니다.

문제를 해결하려면 macOS 또는 Linux에서는 ~/.codex/config.toml을, Windows에서는 %USERPROFILE%\.codex\config.toml을 열고 approval_policy = "untrusted"를 삭제하세요.

활성 프로필, 조직에서 관리하는 구성, allowed_approval_policies, --ask-for-approval untrusted를 사용하는 명령에도 지원되지 않는 정책에 대한 참조가 있는지 확인하세요.

제한적인 대안으로 sandbox_mode = "read-only" 및 approval_policy = "on-request"를 설정하세요.

구성을 업데이트한 후 Codex를 다시 시작하세요. 프로젝트 수준의 trust_level = "untrusted" 설정은 별개이며 계속 지원됩니다.