OpenAI의 코딩 에이전트 Codex를 터미널에서 바로 쓰고 싶다면 CLI 버전을 설치하면 돼요. 운영체제별로 설치 방법이 조금씩 다른데, 요즘은 스크립트 한 줄로 끝내는 방법이 가장 널리 쓰이고 있어요.
Codex CLI란 무엇인가
Codex CLI는 OpenAI가 만든 터미널 기반 AI 코딩 도구예요. 별도의 웹 브라우저나 에디터 플러그인 없이, 명령줄에서 바로 코드 작성과 수정을 요청할 수 있다는 게 특징이에요.
최근에는 GPT-5 기능이 연동되면서 별도의 API 키 없이도 ChatGPT 플랜 사용자라면 바로 사용할 수 있게 됐고, 프롬프트 처리나 승인 로직, 샌드박싱 영역에서도 성능이 꾸준히 개선되고 있어요.
macOS·Linux 설치 방법 (curl 스크립트)
가장 쉬운 설치 방법은 설치 스크립트를 한 줄로 실행하는 거예요. macOS나 Linux 터미널에서 아래 명령어를 입력하면 자동으로 설치가 진행돼요.
- 설치 명령어:
curl -fsSL https://chatgpt.com/codex/install.sh | sh - 실행 방식: 스크립트가 필요한 바이너리를 내려받고 실행 경로까지 자동으로 잡아줘요.
- 장점: 별도 패키지 매니저 없이 터미널만 있으면 바로 설치가 끝나요.
Windows 설치 방법 (PowerShell)
윈도우 사용자는 PowerShell을 열고 전용 설치 스크립트를 실행하면 돼요. 예전에는 윈도우 지원이 불안정하다는 이야기가 많았지만, OpenAI가 윈도우용 설치 스크립트를 따로 내놓으면서 설치 과정이 한층 간단해졌어요.
실행 명령어는 powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"예요. PowerShell에 이 한 줄만 붙여넣으면 설치가 자동으로 진행돼요.
npm과 Homebrew로 설치하기
Node.js 환경을 이미 쓰고 있다면 npm으로 설치하는 방법도 많이 쓰여요. 터미널에서 npm install -g @openai/codex를 실행하면 전역으로 Codex CLI가 설치돼요.
macOS에서 Homebrew를 쓰고 있다면 brew install codex 명령어로도 설치할 수 있어요. 이미 쓰고 있는 패키지 매니저가 있다면 이 방법이 버전 관리 측면에서 더 편할 수 있어요.
설치 후 로그인과 기본 사용법
설치가 끝나면 터미널에서 codex login 명령어로 ChatGPT 계정에 로그인해야 해요. 로그인이 완료되면 별도의 API 키 설정 없이도 ChatGPT 플랜에 포함된 사용량으로 바로 Codex를 쓸 수 있어요.
이후에는 작업할 저장소 폴더로 이동해 codex 명령어를 실행하면 대화형 세션이 시작돼요. 한국어로 요청해도 코드를 이해하고 수정, 생성 작업을 처리해줘서 별도의 영어 프롬프트 작성이 필요 없다는 점도 편리한 부분이에요.
정리하면 GPT 코덱스 다운로드는 운영체제에 맞는 설치 스크립트나 npm, Homebrew 중 편한 방법을 고르고, 설치 후 로그인 한 번만 해주면 끝나요. 복잡한 API 키 발급 과정 없이도 터미널에서 곧바로 코딩 작업을 맡길 수 있다는 게 가장 큰 장점이에요.