codex
무엇인가
Codex CLI는 OpenAI의 코딩 에이전트를 터미널에서 쓰는 진입점이다. 사용자 컴퓨터에서 로컬 프로세스로 돌면서 작업 디렉터리의 파일을 읽고 고치고 명령을 실행하는 부류에 속한다. 같은 저장소가 에디터 확장, 데스크톱 앱, 클라우드 에이전트를 함께 다루며, 그중 터미널 실행 형태를 맡는다.
어떻게 동작하나
구현 언어는 Rust이고 실행 파일 이름은 `codex`다. 인증은 ChatGPT 계정 로그인 또는 API 키 두 갈래다. 배포는 독립 설치 스크립트가 기본으로 `https://releases.openai.com/codex`에서 내려받고, 메타데이터나 자산 다운로드가 실패하면 GitHub Releases로 폴백한다. `CODEX_INSTALLER_USE_RELEASES_OPENAI_COM`을 `false`로 두면 GitHub Releases를 강제한다(`0`, `no`도 허용). GitHub Release 아카이브는 플랫폼 이름이 박힌 실행 파일 하나를 담는다. 예를 들어 `codex-x86_64-unknown-linux-musl`이다.
무엇과 다른가
같은 에이전트가 실행 위치별로 나뉜다. 에디터 확장은 VS Code, Cursor, Windsurf 안에서 돌고, `codex app`은 데스크톱 앱을 띄우며, Codex Web은 `chatgpt.com/codex`의 클라우드 에이전트다. CLI는 이들과 달리 별도 호스트 없이 로컬 터미널 프로세스로 동작한다.
어떻게 쓰나
설치는 macOS·Linux용 스크립트, Windows용 스크립트, 또는 패키지 매니저를 쓴다. 설치 후 `codex`를 실행하고 **Sign in with ChatGPT**를 고르면 Plus, Pro, Business, Edu, Enterprise 플랜에 포함된 형태로 쓸 수 있다. API 키 방식도 있으나 추가 설정이 필요하다. GitHub Release에서 플랫폼별 아카이브를 직접 받아 압축을 풀고 이름을 `codex`로 바꿔 쓰는 경로도 있다.
전제와 한계
전제는 ChatGPT 유료 플랜 로그인이나 API 키다. 바이너리는 macOS arm64·x86_64, Linux x86_64·arm64(musl)용이 배포되고 Windows는 별도 설치 스크립트를 쓴다. 아카이브 안 실행 파일 이름에 플랫폼 문자열이 들어 있어 그대로는 `codex`로 호출되지 않는다. 라이선스는 Apache-2.0이다.
관련 논문 2
유사 도구
- Codewhale터미널에서 프로젝트를 읽고 파일을 고치고 명령을 실행하는 Rust 기반 코딩 에이전트다. 호스티드·로컬 모델을 골라 붙인다.
- gptme터미널에서 실행되는 개인 AI 에이전트 CLI다. 셸·Python·브라우저·비전 도구를 갖추고 여러 LLM 제공자와 로컬 llama.cpp를 지원한다.
- warp터미널에서 출발한 에이전트 개발 환경으로, 내장 코딩 에이전트와 Claude Code·Codex·Gemini CLI 등 외부 CLI 에이전트를 같은 창에서 실행한다.
- opencode터미널에서 동작하는 오픈소스 AI 코딩 에이전트다. build와 plan 두 에이전트를 Tab 키로 전환하며 코드 편집과 탐색을 나눠 수행한다.
- shell_gpt터미널에서 자연어 프롬프트로 셸 명령·코드·문서를 생성하는 Python CLI다. OS와 $SHELL을 인식해 명령을 만들고 대화 세션을 파일로 보관한다.
- herdr코딩 에이전트가 돌아가는 터미널을 백그라운드 서버가 소유해 분리·재접속을 가능하게 하는 Rust 단일 바이너리 런타임이다.