네. Ubuntu 24.04에서 Codex CLI를 처음 설치하는 사람 기준으로, 설치 → 로그인 → 프로젝트 연결 → 기본 사용 → 권한 모드 → 업데이트 → 문제 해결까지 순서대로 안내하겠습니다.

현재 OpenAI의 공식 Codex CLI는 Linux를 공식 지원하며, 가장 간단한 설치 방법은 공식 설치 스크립트입니다. npm으로 설치하는 방법도 있습니다. (GitHub)

1. 먼저 Codex가 무엇인지

Ubuntu 터미널에서 다음처럼 사용하는 프로그램입니다.

터미널
   ↓
codex
   ↓
내 프로젝트의 소스코드를 읽음
   ↓
내가 요청한 작업을 분석
   ↓
코드 수정 / 명령 실행 / 테스트

예를 들어 프로젝트가

~/Projects_Laptop/tarot_apps

에 있다면:

cd ~/Projects_Laptop/tarot_apps
codex

이렇게 실행합니다.

Codex CLI는 현재 디렉터리를 작업 공간으로 사용하면서 코드를 읽고, 수정하고, 필요한 명령을 실행하는 코딩 에이전트입니다. (OpenAI Help Center)

2. Ubuntu 24.04에서 설치 전 확인

터미널을 열고 먼저:

lsb_release -a

예를 들어:

Distributor ID: Ubuntu
Description:    Ubuntu 24.04.x LTS

이면 됩니다.

그리고 CPU 아키텍처도 확인해 보겠습니다.

uname -m

일반적인 Intel/AMD 64비트 Ubuntu라면:

x86_64

가 나옵니다.

현재 Codex 공식 릴리스에는 Linux x86_64와 ARM64용 바이너리가 제공됩니다. (GitHub)

3. 가장 추천하는 설치 방법

현재는 npm을 별도로 준비할 필요 없이 공식 설치 스크립트를 사용하는 방법을 가장 간단한 방법으로 볼 수 있습니다.

OpenAI 공식 문서의 Linux/macOS 설치 방법은 다음입니다. (GitHub)

터미널에서:

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

실행합니다.

중요한 점

이 명령은

인터넷
 ↓
OpenAI Codex 설치 스크립트
 ↓
현재 Linux에 맞는 Codex 실행 파일 다운로드
 ↓
Codex 설치

과정을 자동으로 수행합니다.

4. 설치가 제대로 되었는지 확인

설치가 끝나면:

codex --version

예를 들어:

codex-cli 0.xxx.x

와 같은 결과가 나오면 설치된 것입니다.

다음도 해보세요.

which codex

예를 들어:

/home/pion79/.local/bin/codex

처럼 나오면 정상입니다.

5. codex: command not found가 나오는 경우

초보자에게 상당히 중요한 부분입니다.

설치는 되었는데:

codex: command not found

가 나올 수도 있습니다.

먼저:

echo $PATH

를 확인합니다.

그리고:

ls ~/.local/bin/codex

를 해봅니다.

파일이 존재한다면 PATH 문제일 가능성이 있습니다.

일단 현재 터미널에서:

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

그리고:

codex --version

을 다시 실행합니다.

정상적으로 되면 영구적으로 적용하기 위해:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

그리고:

source ~/.bashrc

그 다음:

codex --version

입니다.

6. Codex 처음 실행

이제:

codex

를 실행합니다.

처음 실행하면 로그인 화면이 나옵니다.

현재 공식 Codex CLI에서는 ChatGPT 계정으로 로그인하는 방법과 API key를 사용하는 방법이 있습니다. ChatGPT 계정 로그인은 Plus, Pro, Business, Edu, Enterprise 등의 플랜에서 Codex를 사용할 수 있는 방식입니다. (GitHub)

따라서 일반적으로는:

codex
 ↓
Sign in with ChatGPT
 ↓
브라우저 열림
 ↓
ChatGPT 계정 로그인
 ↓
권한 승인
 ↓
터미널 Codex 인증 완료

순서입니다.

7. 브라우저가 자동으로 열리지 않는 경우

이 부분이 최근 질문하신 상황과 특히 관련 있습니다.

터미널에 다음과 같은 내용이 나타날 수 있습니다.

Finish signing in via your browser

If the link doesn't open automatically,
open the following link to authenticate:

https://auth.openai.com/...

이 경우 당황하지 마세요.

방법

터미널에 표시된 긴 URL을 복사합니다.

예:

https://auth.openai.com/oauth/authorize?...

Chrome에 붙여넣습니다.

그리고 Codex를 사용하려는 동일한 ChatGPT 계정으로 로그인합니다.

인증이 끝나면 터미널의 Codex가 로그인 상태를 확인합니다.

8. 로그인 후 가장 먼저 해야 할 것

Codex를 아무 디렉터리에서 실행하지 않는 것이 좋습니다.

예를 들어 GitHub 프로젝트가:

~/Projects_Laptop/tarot_apps

라면:

cd ~/Projects_Laptop/tarot_apps

먼저 이동합니다.

현재 위치 확인:

pwd

그리고:

ls

합니다.

예:

package.json
src
app
components
README.md
...

이런 것이 보이면 프로젝트 디렉터리입니다.

그 다음:

codex

9. 첫 번째 Codex 명령

처음부터

코드를 전부 수정해줘

라고 하는 것은 추천하지 않습니다.

먼저 아주 안전한 질문을 해보세요.

이 프로젝트의 구조를 분석하고 초보자가 이해할 수 있도록 설명해줘.
아직 파일을 수정하지 마.

그러면 Codex가 프로젝트를 살펴보고:

프로젝트 구조
├── src
├── components
├── ...
│
├── package.json
└── ...

같은 형태로 설명해줄 수 있습니다.

10. Codex의 가장 중요한 특징

Codex는 단순한 ChatGPT 채팅과 조금 다릅니다.

예를 들어 여러분이:

로그인 화면에서 오류가 발생한다.
원인을 찾아줘.

라고 하면 Codex가 프로젝트 파일을 직접 조사할 수 있습니다.

예를 들어:

package.json
src/
components/
app/
...

를 읽고 관련 코드를 찾아갑니다.

필요하다면:

npm test
npm run build
git diff

등의 명령을 실행하면서 문제를 조사할 수도 있습니다.

공식 문서에서도 Codex CLI가 로컬에서 파일을 읽고, 수정하고, 명령을 실행할 수 있는 coding agent라고 설명합니다. (OpenAI Help Center)

11. 그런데 처음에는 "승인"을 사용하는 것이 좋습니다

Codex에는 작업 방식에 따라 권한 수준이 있습니다.

대표적으로:

공식 문서에서도 이러한 승인 모드를 제공하며, 기본 모드는 제안한 변경이나 명령을 사용자가 승인하는 방식입니다. (OpenAI Help Center)

컴퓨터 초보라면 처음에는 기본 승인 모드를 강력하게 추천합니다.

12. 왜 승인 모드가 좋은가?

예를 들어 Codex가:

rm ...

또는

npm install ...

같은 명령을 실행하려 할 수 있습니다.

초보자라면 무슨 의미인지 모를 수 있습니다.

따라서 처음에는:

Codex
 ↓
"이 명령을 실행할까요?"
 ↓
내용 확인
 ↓
Yes / No

방식으로 사용하는 것이 안전합니다.

13. 프로젝트를 Git으로 관리하는 것을 강력 추천

특히 Codex로 개발한다면 Git을 반드시 익혀두는 것을 추천합니다.

예를 들어:

git status

먼저 확인합니다.

그리고 작업 전에:

git add .
git commit -m "before codex work"

해두면 좋습니다.

그러면 Codex가 여러 파일을 수정해도 문제가 생겼을 때 Git을 이용해서 변경 사항을 확인하거나 되돌릴 수 있습니다.

특히 공식 문서에서도 자동화 수준이 높은 모드를 사용할 때 버전 관리 여부가 중요하다고 설명합니다. (OpenAI Help Center)

14. Codex에게 작업을 시킬 때 좋은 방법

처음에는 다음과 같은 형태가 좋습니다.

나쁜 요청

로그인 기능 고쳐줘

좋은 요청

로그인 기능에서 오류가 발생하고 있다.

1. 먼저 관련 코드를 조사해줘.
2. 오류의 원인을 설명해줘.
3. 수정하기 전에 어떤 파일을 변경할 것인지 알려줘.
4. 내가 승인하면 수정해줘.
5. 수정 후 테스트까지 실행해줘.

이렇게 하면 Codex를 개발자 + 조사원처럼 사용할 수 있습니다.

15. 아주 중요한 Codex 사용법

제가 특히 추천하는 작업 순서는 이것입니다.

① 조사
   ↓
② 원인 설명
   ↓
③ 수정 계획
   ↓
④ 사용자 승인
   ↓
⑤ 코드 수정
   ↓
⑥ 테스트
   ↓
⑦ git diff 확인

예를 들어:

먼저 이 프로젝트를 분석해줘.
파일은 수정하지 마.
현재 구조와 주요 기능을 설명해줘.

↓

좋아. 이제 로그인 오류의 원인을 찾아줘.
아직 수정하지 말고 원인만 설명해줘.

↓

좋아. 수정해줘.

↓

수정한 내용을 테스트해줘.

이렇게 단계적으로 사용하는 것이 좋습니다.

16. 현재 사용 중인 GitHub 프로젝트와 함께 사용

예를 들어 GitHub 프로젝트가:

pioneerwing/tarot_web

이라면 Ubuntu에서:

cd ~/Projects_Laptop

그리고 이미 clone되어 있다면:

cd tarot_web

확인:

git status

그리고:

codex

입니다.

Codex에게:

이 프로젝트의 전체 구조를 분석해줘.
나는 이 프로젝트의 초보 개발자다.
폴더와 주요 파일의 역할을 쉽게 설명해줘.
파일은 아직 수정하지 마.

라고 하면 아주 좋은 첫 번째 작업입니다.

17. Codex가 현재 프로젝트를 제대로 보고 있는지 확인

Codex에게 다음을 입력해 보세요.

현재 작업 디렉터리가 어디인지 알려줘.
그리고 현재 프로젝트의 최상위 파일과 디렉터리를 설명해줘.
파일은 수정하지 마.

그러면 현재 작업 위치를 확인할 수 있습니다.

18. Codex 종료 방법

Codex 세션을 끝내려면 보통:

Ctrl + C

또는 종료 명령을 사용할 수 있습니다.

터미널로 돌아온 후:

pion79@lap79:~/Projects_Laptop/tarot_apps$

같은 프롬프트가 다시 나오면 종료된 것입니다.

19. Codex 다시 실행

다음날 다시 개발하려면 매우 간단합니다.

cd ~/Projects_Laptop/tarot_apps
codex

끝입니다.

20. Codex 업데이트

현재 설치된 Codex를 최신 버전으로 업데이트하려면 공식 설치 방법을 다시 실행할 수 있습니다. 공식 문서에서는 codex --upgrade 방식도 안내하고 있습니다. (OpenAI Help Center)

따라서 먼저:

codex --upgrade

를 시도하면 됩니다.

설치 스크립트 방식으로 다시 설치하는 것도 공식적으로 지원됩니다.

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

(GitHub)

21. npm으로 설치하는 방법도 있음

Ubuntu에서 Node.js/npm을 이미 사용하고 있다면:

npm install -g @openai/codex

로 설치할 수도 있습니다.

공식 Codex 저장소와 npm 패키지 모두 이 방법을 안내하고 있습니다. (GitHub)

설치 후:

codex --version

확인합니다.

어떤 방법을 추천하느냐?

현재 상황에서는:

① 공식 설치 스크립트

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

을 추천합니다.

이미 Node.js/npm 환경을 잘 관리하고 있고 모든 CLI 도구를 npm으로 관리하고 싶다면:

② npm

npm install -g @openai/codex

도 좋습니다.

22. API Key 방식은 당장 필요하지 않음

Codex 로그인에는 크게 두 가지 방법이 있습니다.

                 Codex
                   │
          ┌────────┴────────┐
          ↓                 ↓
   ChatGPT 계정 로그인     API Key

일반적인 ChatGPT 사용자는 ChatGPT 계정으로 로그인하는 방법을 먼저 추천합니다.

API Key 방식은 API 사용량/비용 관리가 필요한 개발자 환경에서 별도로 고려하면 됩니다. 공식 Codex 저장소에서도 ChatGPT 계정 로그인과 API key 방식 모두 지원한다고 설명합니다. (GitHub)

23. 특히 중요한 것: ChatGPT와 Codex CLI의 관계

헷갈리기 쉬운 부분입니다.

ChatGPT
   │
   ├── 웹/앱에서 대화
   │
   └── Codex 사용
          │
          └── Ubuntu 터미널의 Codex CLI

즉 Ubuntu에서:

codex

를 실행한다고 해서 별도의 완전히 다른 OpenAI 계정을 만드는 것은 아닙니다.

ChatGPT 계정으로 로그인해서 사용할 수 있습니다.

현재 공식 문서 역시 ChatGPT Plus, Pro, Business, Edu, Enterprise 플랜에서 Codex를 사용할 수 있다고 안내합니다. (GitHub)

24. Ubuntu에서 제가 추천하는 최종 구성

현재 사용자 환경이라면 다음처럼 구성하는 것을 추천합니다.

Ubuntu 24.04
│
├── Git
│   └── 소스코드 버전 관리
│
├── VS Code
│   └── 코드 직접 확인/편집
│
├── Terminal
│   └── Codex CLI
│
└── Codex
    ├── 프로젝트 분석
    ├── 코드 작성
    ├── 코드 수정
    ├── 오류 분석
    ├── 테스트
    └── Git diff 검토

그리고 실제 개발 작업은:

VS Code
   ↕
Codex
   ↕
Git
   ↕
GitHub

구조로 사용하는 것이 좋습니다.

25. 지금 바로 따라 한다면

Ubuntu 터미널에서 아래 순서 그대로 실행하면 됩니다.

① Ubuntu 확인

lsb_release -a

② Codex 설치

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

③ 설치 확인

codex --version

④ 프로젝트 이동

예:

cd ~/Projects_Laptop/tarot_apps

⑤ Git 상태 확인

git status

⑥ Codex 실행

codex

⑦ ChatGPT로 로그인

Sign in with ChatGPT

선택 → 브라우저 인증.

⑧ 첫 명령

이 프로젝트의 구조를 분석해줘.
나는 컴퓨터 초보자다.
주요 폴더와 파일의 역할을 쉽게 설명해줘.
아직 파일은 수정하지 마.

여기까지 성공하면 Codex 설치와 기본 사용 준비는 완료입니다.

⚠️ 한 가지 중요한 점

최근 질문에서 Ubuntu에서 codex를 실행했는데 브라우저 인증 URL이 나온 뒤 error로 끝나는 상황을 겪고 계셨습니다.

그 경우에는 무조건 재설치부터 할 필요가 없습니다. Codex 자체 설치 문제인지, OAuth 브라우저 인증 문제인지 먼저 구분하는 것이 중요합니다.

현재 터미널에서:

codex --version

과

which codex

를 실행하고, 다시:

codex

했을 때 나오는 마지막 20~30줄 정도의 화면을 그대로 보여주시면, 제가 그 화면을 기준으로 ① 설치 문제 → ② PATH 문제 → ③ 브라우저 OAuth 문제 → ④ ChatGPT 계정 인증 문제 중 어디인지 단계별로 같이 해결해 드릴 수 있습니다.