오픈AI 코덱스 CLI, 터미널서 도는 오픈소스 코딩 에이전트

이미지: GitHub Copilot 제공

요약

오픈AI가 2025년 4월 GitHub에 공개한 터미널용 오픈소스 코딩 에이전트 '코덱스 CLI'가 최근 깃허브 트렌딩에 다시 올랐어요
curl·파워셸·npm·홈브루 등 여러 방법으로 설치할 수 있고, 챗GPT 유료 플랜이나 API 키로 로그인해 써요
같은 코덱스 브랜드 아래 IDE 확장판, 데스크톱 앱, 브라우저용 '코덱스 웹'이 각각 다른 방식으로 존재해요

프로젝트명: openai/codex (Codex CLI)
저장소 설명: Lightweight coding agent that runs in your terminal
실행 방식: 터미널에서 로컬 파일·명령을 다룸; 사용 시 ChatGPT 로그인 또는 API 키 필요
라이선스: Apache-2.0
지원 플랫폼: macOS(Apple Silicon/x86_64), Linux(x86_64/arm64)
로그인 방식: ChatGPT 계정 또는 API 키

터미널에 앉은 코딩 에이전트

오픈AI가 2025년 4월 오픈소스로 공개한 코딩 에이전트 코덱스(Codex)의 커맨드라인 버전 '코덱스 CLI'가 최근 깃허브 트렌딩에 다시 올랐어요. 저장소 설명은 "터미널에서 실행되는 경량 코딩 에이전트"로 짧게 적혀 있어요.

코덱스 CLI 프로그램은 개발자의 터미널에서 실행되고 로컬 파일과 명령을 직접 다뤄요. 사용하려면 ChatGPT 계정으로 로그인하거나 API 키를 설정해야 해요. 오픈AI는 같은 코덱스 이름 아래 코드 편집기용 확장판, 데스크톱 앱, 브라우저로 접속하는 클라우드 버전까지 여러 형태를 함께 운영하고 있어요.

설치는 네 가지 방법으로

저장소 문서에는 운영체제별 설치 명령이 정리돼 있어요. 맥과 리눅스는 아래 curl 스크립트로 설치해요.

curl -fsSL https://chatgpt.com/codex/install.sh | sh

윈도우는 파워셸 명령을 써요.

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

이 설치 스크립트는 기본적으로 releases.openai.com/codex 에서 파일을 받아오고, 문제가 생기면 깃허브 릴리스로 자동 전환돼요. 환경변수 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM 값을 false로 두면 처음부터 깃허브 릴리스만 쓰도록 강제할 수도 있어요.

저장소의 공식 README에는 npm과 Homebrew 설치 명령도 함께 나와 있어요.

npm install -g @openai/codex

brew install --cask codex

실행 파일을 직접 내려받고 싶다면 깃허브 릴리스 페이지에서 macOS는 애플 실리콘용(codex-aarch64-apple-darwin.tar.gz)과 인텔용(codex-x86_64-apple-darwin.tar.gz), 리눅스는 x86_64용과 arm64용 압축 파일을 고르면 돼요. 압축을 풀면 안에 플랫폼 이름이 붙은 실행 파일 하나만 들어 있어서, 쓰기 편하게 codex로 이름을 바꿔주는 걸 저장소는 권장하고 있어요.

GitHub 오픈AI codex 저장소 코드 탭과 폴더 및 파일 목록 화면 — 이미지: GitHub · OpenAI

어떻게 써보나

위 네 가지 방법 중 하나로 설치를 마치면 터미널에 codex 명령이 등록돼요.
터미널에 codex라고 입력해 실행하면 로그인 방식을 고르는 화면이 떠요.
'Sign in with ChatGPT'를 선택하면 계정으로 로그인할 수 있어요. 오픈AI는 ‘Sign in with ChatGPT’와 API 키 방식 두 가지를 안내해요.
챗GPT 구독이 없다면 API 키를 연결해 쓰는 방법도 있는데, 이 경우 별도 설정이 더 필요하다고 저장소는 밝히고 있어요.
로그인을 마치면 코드를 고쳐 달라거나 새 파일을 만들어 달라고 자연어로 요청하면서 바로 작업을 시킬 수 있어요.

코덱스 CLI·IDE·앱·웹, 뭐가 다른가

같은 코덱스 브랜드 안에서도 실행 위치와 접속 경로가 저마다 달라요.

형태	실행 위치	접속 경로
코덱스 CLI	로컬 터미널	curl·npm·brew 설치
코덱스 IDE	VS Code·Cursor·Windsurf 내부	IDE용 설치 페이지
코덱스 앱	데스크톱	`codex app` 명령 또는 앱 소개 페이지
코덱스 웹	브라우저(클라우드)	chatgpt.com/codex

코드 편집기 안에서 바로 쓰고 싶으면 IDE용 페이지에서 확장 프로그램을 설치하면 되고, 터미널을 열지 않고 별도 창으로 쓰고 싶으면 데스크톱 앱을 받으면 돼요. 로컬 환경 없이 브라우저에서만 작업을 맡기고 싶을 때는 클라우드 기반 코덱스 웹으로 가면 되는데, 이건 컴퓨터 자원 대신 오픈AI 서버에서 작업이 돌아간다는 점이 CLI와 다른 지점이에요.