Codex

제품 정체성과 사용 대상

제공된 GitHub 주소와 터미널 소개에 해당하는 제품은 Codex CLI다. 개발자와 유지보수 담당자가 기존 저장소를 파악하고 버그 수정, 테스트 보강, 반복적인 코드 정리를 진행할 때 활용한다. 데스크톱 앱·IDE 확장·클라우드 서비스도 있으므로 설치형 CLI와 구분해야 한다.

로컬 파일과 명령을 다룬다는 뜻이지, OpenAI 모델 이용이 완전히 오프라인으로 이루어진다는 뜻은 아니다.

지원 OS와 버전 검토

2026-10-07 확인한 공식 저장소는 macOS·Linux·Windows 설치 방법을 제공한다. 따라서 제공 데이터의 macOS 전용 표기는 보완이 필요하다. Mac용 직접 다운로드는 Apple Silicon과 Intel용 파일을 구분한다. Windows에서는 네이티브 샌드박스를 사용할 수 있으며 Linux 도구 중심 작업에는 WSL을 선택할 수 있다.

공식 배포 페이지에서 0.160.1이 Latest로 표시됨을 확인했다. 이 버전은 원격 MCP 서버 실행 시 Windows 환경 변수 보존 문제를 수정했다. 확인한 자료에서 제품 전체의 지원 종료 공지는 발견하지 않았다.

설치와 첫 작업 순서

macOS에서는 공식 안내에 따라 Homebrew의 brew install --cask codex를 사용하거나, npm 환경이 있다면 npm install -g @openai/codex로 설치할 수 있다. 직접 파일을 받는 경우 CPU에 맞는 배포 파일을 고른다.

이후 프로젝트 폴더로 이동해 codex를 실행하고 Sign in with ChatGPT를 선택해 브라우저 인증을 마친다. 첫 요청은 '이 프로젝트의 진입점과 테스트 실행 방법을 설명해 줘'처럼 범위를 좁힌다. /permissions에서 권한을 확인하고, 수정 작업 전에는 되돌릴 수 있는 Git 상태를 확보한다. 이는 공식 절차를 정리한 것으로 직접 설치·사용한 후기는 아니다.

주요 기능과 실무 예시

코드 탐색부터 수정, 로컬 명령 실행, 변경 검토까지 같은 대화에서 이어갈 수 있다. /review는 작업 트리를 수정하지 않고 변경 사항의 문제를 우선순위별로 보고한다. codex exec는 정해진 작업을 스크립트나 CI에서 반복 실행할 때 사용한다.

실무 요청 예시는 '블로그 글 목록의 페이지 이동 오류를 재현하는 테스트를 추가하고, 원인을 찾아 최소한으로 수정한 뒤 관련 테스트 결과와 변경 파일을 보고해 줘'다. 재현 조건과 완료 기준을 함께 주면 결과를 검토하기 쉽다. 담당자는 실제 변경 내용과 테스트 출력을 확인한 후 반영 여부를 판단한다.

무료·유료와 이용 제약

CLI 저장소는 Apache-2.0 라이선스로 공개되어 있지만 모델 이용 비용은 별도 조건을 따른다. 공식 요금 문서는 Free를 월 0달러, Plus를 월 20달러, Pro를 월 100달러부터 안내한다. Free 설명은 데스크톱 앱의 GPT-6 Luna와 순차 제공 조건을 명시하므로 무료 CLI 이용을 무제한으로 단정할 수 없다.

Plus에는 CLI 이용이 명시되어 있다. 사용량은 모델, 작업 규모와 문맥에 따라 달라지고 주간 제한도 적용될 수 있다. 잔여량은 /status와 사용량 대시보드에서 확인한다. API 키 방식은 OpenAI Platform에서 사용량에 따라 별도 청구되며 일부 클라우드 기능을 제공하지 않는다.

문제 발생 시 확인 순서

명령을 찾지 못하면 설치 경로와 PATH, 선택한 OS·CPU 배포 파일을 먼저 확인한다. 로그인 문제는 codex login status로 인증 방식을 확인하고 계정·워크스페이스 제한을 살핀다. 원격 환경이나 localhost 인증 연결이 막힌 환경에서는 공식 문서의 기기 코드 인증 조건을 확인한다. 회사망에서는 프록시와 인증서 설정도 점검 대상이다.

파일 접근이나 명령 실행이 거부되면 /permissions의 작업 폴더 경계와 네트워크 허용 범위를 확인한다. Windows에서 특정 폴더를 읽지 못하는 경우 공식 문서의 /sandbox-add-read-dir 안내를 검토한다. 사용량 오류는 대시보드의 제한과 초기화 시간을 확인한다.

다른 도구와 선택 기준

터미널 명령과 로컬 테스트를 중심으로 작업하거나 스크립트에 연결하려면 CLI가 적합하다. 열린 파일·선택 영역을 보면서 수정안을 검토하려면 VS Code 등에서 사용하는 Codex IDE 확장이 편리하다. 일반적인 코드 개념 설명은 ChatGPT 웹에서도 진행할 수 있으며, 클라우드 환경에 작업을 맡기려면 Codex Cloud를 검토한다.

선택할 때는 사용하는 편집기, 로컬 의존성, 파일 접근 범위, 결과 검토 방식과 계정별 비용을 함께 비교한다. 터미널 사용 경험이 적다면 IDE 확장에서 작은 수정부터 시작하는 편이 이해하기 쉽다.

공식 안내

• openai/codex — README · 확인 2026-10-07
• Release 0.160.1 · openai/codex · 확인 2026-10-07
• Codex CLI · 확인 2026-10-07
• Windows sandbox · 확인 2026-10-07
• Pricing · 확인 2026-10-07
• Authentication · 확인 2026-10-07
• Permissions · 확인 2026-10-07
• Codex IDE extension · 확인 2026-10-07