코덱스 CLI 설치 방법: 맥에서 명령어 한 줄이면 끝

"codex 설치"라고 검색해 보신 적 있으신가요? 결과가 두 갈래로 섞여 나옵니다. 하나는 chatgpt.com/codex에서 돌아가는 클라우드 버전(Codex Web)입니다. 다른 하나는 내 컴퓨터에 까는 Codex CLI(코덱스 CLI)입니다. 이 글이 다루는 쪽은 후자입니다. 맥 기준 Codex CLI 설치입니다. 결론부터 말하면 터미널에 아래 한 줄을 치면 끝입니다.

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

터미널을 한 번도 안 열어보셨어도 괜찮습니다. 이 글은 다섯 단계를 그대로 따라 하도록 만들었습니다. 터미널 실행, 설치 명령어 입력, 설치 확인, 로그인, 첫 부탁까지입니다. 단계마다 "이렇게 보이면 성공"을 함께 적어 두었으니 화면과 비교하며 내려가시면 됩니다. 설치 명령어는 유통기한이 짧은 정보입니다. 막히면 공식 문서를 한 번 더 확인해 보세요.

준비물: 계정과 macOS 12 이상

준비물은 세 가지입니다. 평소 쓰는 ChatGPT(챗지피티) 계정, macOS 12 이상의 맥, 메모리 4GB 이상(8GB 권장)입니다. 최근 몇 년 안에 산 맥이라면 메모리는 신경 쓰지 않아도 됩니다.

계정은 유료가 아니어도 됩니다. 공식 요금 안내는 Codex(코덱스)가 무료(Free) 플랜을 포함해 ChatGPT 전 플랜에 들어 있다고 명시합니다. 무료 플랜은 "빠른 코딩 작업으로 Codex를 맛보는" 용도로 소개돼 있습니다. 쓸 수 있는 양이 적다는 뜻입니다.

솔직하게 한 가지 덧붙이겠습니다. 같은 문서에서 터미널용 Codex CLI를 기능으로 콕 집어 나열한 건 Plus 플랜 카드부터입니다. 무료 플랜에서 CLI 로그인까지 되는지는 문서만으로 확정되지 않습니다. 그렇다고 안 된다고 적혀 있지도 않습니다. 설치는 명령어 한 줄이고 되돌리기도 쉬우니, 궁금하시면 그냥 깔아서 로그인해 보시는 게 문서를 더 읽는 것보다 빠릅니다. 막히면 그때 판단하시면 됩니다.

윈도우를 쓰고 계시다면 설치 명령어가 다릅니다. 윈도우 편은 별도 글로 정리했습니다.

스텝 1: 터미널 실행

키보드에서 Command와 스페이스 바를 같이 눌러 스포트라이트 검색을 엽니다. 여기에 "터미널"을 입력하고 Enter를 누릅니다. 응용 프로그램 폴더의 유틸리티 안에서 Terminal을 찾아 열어도 같습니다.

이렇게 보이면 성공입니다. 흰(또는 검은) 창이 뜨고 커서가 깜박입니다. 이 창이 오늘 작업대입니다. 터미널이라는 환경 자체가 궁금하시더라도 지금은 넘어가셔도 됩니다. 이 글은 창을 열고 명령어를 붙여넣는 것만으로 끝나게 만들었습니다. 터미널을 처음부터 익히고 싶으시면 터미널 첫 설정 레슨이 따로 있습니다.

스텝 2: 설치 명령어 입력

아래 한 줄을 그대로 복사해 터미널 창에 붙여넣고 Enter를 누릅니다.

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

이 명령어가 하는 일은 하나입니다. OpenAI의 공식 설치 스크립트를 내려받아 실행합니다. 스크립트는 Codex 본체를 ~/.codex 폴더에 내려받습니다. 그리고 어느 창에서든 codex라고만 쳐도 실행되도록 셸 설정 파일에 위치를 등록(PATH 등록)합니다. 가구를 주문했더니 기사님이 조립까지 마치고 가는 셈입니다.

이렇게 보이면 성공입니다. ==>로 시작하는 진행 줄이 몇 개 지나갑니다. 진행률 막대는 나오지 않으니 화면이 조용해도 정상입니다. 그다음 Codex CLI 0.149.0 installed successfully. 같은 완료 안내가 뜹니다. 이어서 Start Codex now? [y/N]이라고 물어보면 그냥 Enter를 눌러 넘어갑니다. 다음 스텝에서 새 창을 열어 확인할 차례입니다. 독(Dock)이나 런치패드에 아이콘은 생기지 않습니다. 원래 안 생기는 게 정상입니다.

스텝 3: 새 창에서 설치 확인

지금 열려 있는 터미널 창을 완전히 닫고 스텝 1과 같은 방법으로 새 창을 엽니다. 방금 한 등록이 새로 여는 창부터 적용되기 때문입니다. 새 창에 아래를 입력합니다.

codex --version

이렇게 보이면 성공입니다.

codex-cli 0.149.0

위 출력은 이 글을 쓰며 제 맥에서 직접 확인한 결과입니다. 버전 숫자는 설치 시점마다 다르게 나옵니다. 이 글을 쓴 2026년 8월 21일 기준 최신 버전은 0.149.0입니다. 숫자는 달라도 괜찮습니다. codex-cli라는 문구가 뜨면 설치는 정상입니다.

스텝 4: ChatGPT 계정 로그인

같은 창에 이번엔 이렇게만 입력합니다.

codex

로그인 방법을 고르는 화면이 뜨면 Sign in with ChatGPT를 선택합니다. 브라우저가 자동으로 열립니다. 평소 쓰는 ChatGPT 계정으로 로그인하면 창이 다시 터미널로 이어집니다. 한 번 로그인하면 컴퓨터에 저장되니 다음부터는 이 단계가 없습니다.

이렇게 보이면 성공입니다. 터미널 안에 Codex의 대화 입력창이 뜹니다.

스텝 5: 첫 부탁 한 문장

입력창에 코드가 아니라 그냥 말을 적으면 됩니다. 이렇게 물어보세요.

이 폴더에 어떤 파일이 있는지 정리해 줘

Codex가 폴더를 읽고 정리해 답하는 걸 보셨다면 오늘 할 일은 끝났습니다. 나중에 버전을 올리고 싶을 때는 codex update 한 줄이면 됩니다. 터미널 환경 자체를 기초부터 쌓고 싶으시면 AI CLI 트랙이 여섯 편으로 준비돼 있습니다.

command not found와 중복 설치 정리

codex를 쳤는데 "command not found"가 뜹니다. 대부분 창 때문입니다. 등록은 새로 여는 창부터 적용되므로 설치할 때 쓰던 창에서는 못 찾습니다. 터미널을 완전히 닫고 새 창을 열어 다시 쳐보세요. 급하다면 지금 창에서 아래를 친 뒤 바로 실행할 수도 있습니다.

export PATH="$HOME/.local/bin:$PATH"
codex

설치가 두 번 된 것 같습니다. 예전에 npm이나 Homebrew라는 개발 도구로 Codex를 설치한 적이 있을 수 있습니다. 그 컴퓨터에서 이 글의 방법으로 또 설치하면 같은 이름의 codex가 두 개가 됩니다. 이때는 PATH에 먼저 등록된 쪽이 실행됩니다. 설치 스크립트도 이 상황을 만나면 어느 쪽이 실행될지 모호하다는 경고를 띄웁니다. which codex를 치면 지금 실행되는 쪽의 위치가 나옵니다. 한쪽만 남기고 정리하는 편이 안전합니다. npm 쪽을 지우려면 npm uninstall -g @openai/codex를 실행하면 됩니다.

원인을 모르겠습니다. codex doctor를 치면 설치, 설정, 로그인 상태를 점검해 줍니다.