1. 개요
Codex는 OpenAI가 제공하는 에이전트형 코딩 도구입니다. 사용자의 자연어 요청을 바탕으로 코드베이스를 탐색하고 파일을 수정하며, 로컬 개발 도구와 테스트를 실행하고 결과를 검토할 수 있게 합니다. 과거의 코드 생성 모델 이름과 같지만 현재 제품은 데스크톱·웹·CLI·IDE·클라우드 환경을 잇는 작업 시스템에 가깝습니다.
ChatGPT 데스크톱 앱에서는 Codex 작업을 별도 공간에서 열고 여러 프로젝트와 장기 작업을 관리할 수 있습니다. 공식 문서는 현재 데스크톱 앱을 macOS·Windows·Linux에서 제공한다고 안내합니다. CLI는 프로젝트 폴더의 터미널에서 파일을 읽고 편집하며 권한과 명령 실행 범위를 사용자가 조절할 수 있고, 반복 작업이나 CI에서는 비대화형 실행도 가능합니다. IDE 확장은 VS Code·Cursor·Windsurf 같은 VS Code 계열 편집기뿐 아니라 Xcode와 JetBrains 통합 경로도 안내합니다.
Codex cloud는 GitHub 또는 GitLab 저장소를 연결해 격리된 클라우드 환경에서 여러 작업을 병렬 실행하고, 결과의 요약과 diff를 검토한 뒤 후속 요청이나 풀 리퀘스트로 이어 가는 방식입니다. 웹, CLI, IDE와 데스크톱은 같은 계정으로 연결되지만 로컬 작업과 클라우드 작업의 실행 위치·연결 기능·권한은 서로 다를 수 있습니다. 회사 저장소에서는 조직의 데이터 처리 정책과 연결 권한을 먼저 확인해야 합니다.
Codex는 별도 단독 구독이 아니라 ChatGPT Free·Go·Plus·Pro·Business·Edu·Enterprise 플랜에 포함됩니다. 각 플랜은 제공 사용량과 일부 모델·연동 범위가 다르며 ChatGPT Work와 Codex가 사용량을 공유합니다. CLI·SDK·IDE는 API 키로 연결해 사용한 토큰만큼 별도로 결제할 수도 있지만, API 키 방식에는 GitHub 코드 리뷰나 Slack 같은 클라우드 기반 기능이 포함되지 않습니다. 플랜 이름, 가격, 모델과 한도는 바뀔 수 있으므로 결제 전 공식 OpenAI Docs 요금 페이지를 확인하세요.
사용 전 확인할 점
무료·Go·Plus·Pro는 기능과 사용량이 계속 조정될 수 있어 특정 메시지 수나 초기화 주기를 고정해서 예상하기 어렵습니다. 먼저 작은 저장소와 되돌릴 수 있는 작업으로 권한·diff 검토 흐름을 익히고, 실제 사용량을 본 뒤 플랜을 선택하는 편이 안전합니다. 업무 저장소는 클라우드 연결, API 키와 조직 데이터 정책을 함께 확인하세요.
2. 주요 기능
- 저장소 탐색·파일 편집·명령 실행·테스트와 코드 리뷰
- ChatGPT 데스크톱 앱 — 프로젝트와 장기 작업을 한 화면에서 관리
- Codex CLI — 로컬 터미널의 대화형 작업과 자동화
- IDE 통합 — VS Code 계열, Xcode·JetBrains 지원 경로
- Codex cloud — 격리 환경에서 병렬 작업하고 diff 검토
- GitHub·GitLab 저장소와 코드 리뷰·Slack 등 클라우드 연동
- ChatGPT 플랜 로그인 또는 API 키 종량제 선택
3. 시스템 요구사항
- 계정
- 지원되는 ChatGPT 플랜 또는 API 키 결제 계정
- 데스크톱
- ChatGPT 데스크톱 앱 — macOS·Windows·Linux
- CLI
- macOS·Linux·Windows 설치 경로 제공
- IDE
- VS Code 계열, Xcode·JetBrains 공식 통합 경로 안내
- 네트워크
- 로그인, 모델 처리와 클라우드 작업에 인터넷 연결 필요
4. 설치 방법
- 1.
그래픽 환경은 이 페이지의 [데스크톱 앱] 버튼에서 ChatGPT 앱을 설치하거나 [Codex 웹에서 사용] 버튼을 엽니다.
- 2.
ChatGPT 계정으로 로그인하고 프로젝트 또는 저장소를 선택해 작은 작업부터 시작합니다.
- 3.
터미널 작업은 [Codex CLI] 버튼의 공식 설치 안내에서 운영체제에 맞는 방법을 선택합니다.
- 4.
CLI 설치 후 프로젝트 폴더에서 codex를 실행하고 권한·모델 설정을 확인합니다.
- 5.
작업 전 Git 체크포인트를 만들고 완료 후 요약, diff와 테스트 결과를 검토합니다.
5. 자주 발생하는 문제
ChatGPT 계정으로 로그인했는데 Codex를 사용할 수 없을 때
앱과 CLI를 최신 버전으로 업데이트하고 같은 ChatGPT 계정인지 확인하세요. 조직 계정은 관리자의 Codex 사용 정책과 지원 지역·플랜 조건도 확인해야 합니다.
CLI 명령을 찾지 못할 때
공식 CLI 설치 문서에서 현재 운영체제용 설치 방법을 다시 확인하고 터미널을 재시작하세요. 설치 후 codex 명령이 PATH에 등록됐는지 점검합니다.
API 키로 로그인했는데 클라우드 코드 리뷰가 보이지 않을 때
API 키 방식은 CLI·SDK·IDE의 종량제 사용을 위한 경로이며 GitHub 코드 리뷰·Slack 같은 클라우드 기능은 제공되지 않습니다. 해당 기능은 지원 ChatGPT 플랜으로 로그인해 확인하세요.
6. Codex과 비슷한 프로그램 비교
- Claude Code
- Anthropic의 에이전트형 코딩 도구입니다. Claude Code는 지원 Claude 구독 또는 API 종량제를 사용하고, Codex는 지원 ChatGPT 플랜 또는 OpenAI API 키를 사용합니다.
- GitHub Copilot
- IDE 자동완성 중심에서 에이전트로 확장 중. GitHub·VS Code 생태계와의 결합이 강점입니다.
- Cursor
- AI를 내장한 독립 코드 에디터. 에이전트를 별도로 설치하는 대신 에디터 자체를 갈아타는 접근입니다.
- 오픈코드(opencode)
- 모델에 묶이지 않는 MIT 오픈소스 코딩 에이전트입니다. 소스를 직접 고치거나 다른 회사 모델로 바꿔 쓸 수 있습니다.
7. 자주 묻는 질문
Codex는 무료인가요?
+
네. 공식 OpenAI Docs 기준 Codex는 ChatGPT Free·Go·Plus·Pro·Business·Edu·Enterprise 플랜에 포함됩니다. 플랜별 사용량과 기능 범위가 다르며 가격·한도는 바뀔 수 있으므로 현재 요금 페이지를 확인하세요.
Codex가 뜻하는 게 뭔가요? 예전 Codex와 같은 건가요?
+
이름은 같지만 다른 제품입니다. 과거 Codex는 GitHub Copilot 초기에 쓰인 코드 생성 모델이었고, 현재의 Codex는 파일 수정·명령 실행까지 하는 AI 코딩 에이전트로 다시 출시된 것입니다.
Codex 앱을 따로 받아야 하나요?
+
현재 공식 안내는 ChatGPT 데스크톱 앱 안에서 Codex 작업을 시작하는 방식입니다. 터미널용 Codex CLI와 IDE 통합은 데스크톱 앱과 별도로 설치하거나 활성화합니다.
ChatGPT랑 뭐가 다른가요?
+
ChatGPT는 대화창에 코드를 써 주는 방식이라면, Codex는 실제 코드베이스에 접근해 파일을 수정하고 테스트를 돌리고 커밋까지 하는 에이전트입니다. 같은 계정·같은 구독으로 둘 다 사용합니다.
모바일에서도 쓸 수 있나요?
+
공식 요금 문서는 Codex를 iOS에서도 제공한다고 안내합니다. 모바일에서는 클라우드 작업을 확인하고 이어 가는 용도로 사용할 수 있으며, Android 제공 범위는 현재 공식 앱 안내에서 다시 확인하세요.
코드가 OpenAI 서버로 전송되나요?
+
CLI로 로컬 작업을 하더라도 모델 처리는 OpenAI 서버에서 이루어지므로 코드 일부가 전송됩니다. 회사 코드에 적용할 때는 소속 조직의 보안 정책과 Business·Enterprise 플랜의 데이터 처리 조건을 확인하는 것이 좋습니다.
8. 참고 자료
관련 가이드
관련 프로그램
