B컷전문 | 개발과 인생의 이야기

핵심 답: Codex CLI의 첫 실행 문제는 설치와 PATH, 로그인 방식, 작업 폴더와 실행 권한을 나눠 확인하면 된다. ChatGPT 로그인과 API 키는 같은 과금 경로가 아니며, Git 저장소 확인 오류를 없애려고 처음부터 안전장치를 끄는 것은 좋은 출발점이 아니다.

확인일: 2026-10-29. OpenAI 공식 문서와 저장소를 기준으로 정리한 안내다. 명령은 자기 환경에서 확인할 예시이며, 설치 성공 실습 후기가 아니다. 계정 로그인·모델 호출·Windows 및 WSL 실행은 직접 검증하지 않았다. macOS·Linux 셸 예시와 Windows 확인 방법은 구분해서 읽어야 한다.

1. 앱, IDE 확장, CLI부터 구분하자

Codex CLI는 터미널에서 codex 명령으로 실행하는 도구다. 데스크톱 앱이나 VS Code 확장을 설치했다고 해서 모든 터미널에서 codex 명령이 바로 인식된다고 가정하면 안 된다. 같은 제품군이라도 설치 경로와 실행 환경이 다르다. 이 글은 CLI 첫 실행에 범위를 한정한다.

• 설치 단계: 명령 파일을 내려받고 현재 셸에서 찾을 수 있는가?
• 인증 단계: ChatGPT 구독 접근으로 로그인할지, API 사용량 기반 접근으로 로그인할지 정했는가?
• 작업 단계: 어느 폴더를 읽게 할지, 쓰기와 명령 실행을 어디까지 허용할지 정했는가?

2. 설치 경로는 하나를 선택하고 버전을 확인한다

공식 메인 README는 macOS·Linux용 독립 설치 프로그램과 Windows PowerShell 설치 경로를 안내한다. npm과 Homebrew도 대안이다. 독립 설치 경로를 쓸 때 Node.js·npm 설치부터 무조건 시작할 필요는 없다. 여러 방법을 겹쳐 설치하면 서로 다른 실행 파일을 부를 수 있으므로, 먼저 현재 경로부터 확인한다.

command -v codex
codex --version

위 두 명령은 macOS·Linux 셸 예시다. command -v가 경로를 찾지 못하면 설치 여부와 PATH를 먼저 확인한다. Windows PowerShell에서는 Get-Command codex로 명령 인식 여부를 확인할 수 있다. Windows용 설치·네이티브 실행과 WSL은 별도 환경으로 구분해야 하며, 이 글에서 직접 실행한 것은 아니다.

macOS·Linux에서 공식 설치 스크립트를 사용할 때는 내용을 먼저 확인하는 절차를 둘 수 있다. 다음은 설치를 실제 수행하는 명령이므로, 출처와 내용을 검토한 뒤 자기 환경에서 실행한다.

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

npm을 사용하는 환경이라면 공식 대안은 npm install -g @openai/codex, Homebrew를 사용하는 Mac이라면 brew install --cask codex다. 이들을 모두 실행하라는 뜻이 아니다. 설치 후 새 터미널에서 경로와 버전을 다시 확인하고, 버전이 예상과 다르면 실제로 선택된 실행 파일부터 점검한다.

3. ChatGPT 로그인과 API 키는 비용 기준이 다르다

ChatGPT로 로그인하면 해당 플랜·워크스페이스의 이용 자격과 한도가 적용된다. 구독이 있다고 무제한으로 실행된다는 뜻은 아니다. 반면 API 키로 로그인하면 OpenAI Platform의 사용량 기반 API 과금이 적용되며, ChatGPT 플랜에 포함된 사용량과 같은 것으로 취급하면 안 된다.

codex login
codex login status

공식 CLI 참조는 codex login과 codex login status를 안내한다. 상태 확인은 Codex를 실제 실행할 것과 같은 터미널 환경에서 한다. 웹에서 ChatGPT에 로그인돼 있다는 사실만으로 CLI의 인증이 끝났다고 판단하지 않는다. 사용 가능한 명령과 옵션이 다르면 codex --help 및 codex login --help를 먼저 확인한다.

API 키를 글·댓글·로그에 붙여 넣지 않는다. 인증 캐시 파일에는 토큰이 들어갈 수 있으므로 내용을 공개하거나 저장소에 커밋하지 않는다. 조직 계정에서는 관리자 정책이 로그인 방식이나 사용 범위를 제한할 수 있다. 인증이 안 된다고 다른 과금 계정으로 즉시 바꾸기보다 현재 선택한 방식부터 확인한다.

4. 첫 작업은 민감정보가 없는 폴더에서 읽기 위주로

처음부터 회사 저장소 전체나 홈 폴더를 대상으로 작업하지 않는다. 개인 연습 폴더나 공개 가능한 작은 저장소를 선택하고, 그 위치가 맞는지 확인한다. 다음은 macOS·Linux에서 확인하는 예시다. 경로는 실제 연습 프로젝트로 바꿔야 한다.

cd /path/to/practice-project
pwd
git --version
git status --short

git status가 저장소가 아니라고 알려주면 기존 프로젝트의 올바른 위치로 이동한다. 새 Git 저장소가 필요한 경우에도 의도적으로 만든 연습 폴더에서만 초기화한다. 오류를 없애기 위해 홈 폴더나 공유 폴더에서 무작정 git init을 실행하지 않는다. Git 자체가 실행되지 않으면 Codex 설정 이전에 운영체제의 개발 도구 문제부터 분리해서 해결해야 한다.

공식 보안 문서는 읽기 위주로 시작할 때 다음과 같은 실행 예시를 제시한다. 권한 체계는 버전과 조직 설정에 따라 달라질 수 있으므로 현재 도움말과 /permissions에서 실제 정책을 확인한다.

codex --sandbox read-only --ask-for-approval on-request

첫 요청은 “이 연습 폴더의 구조와 실행 방법을 설명해줘. 파일 수정·삭제·패키지 설치는 하지 마”처럼 좁게 잡는다. 프롬프트의 부탁은 샌드박스나 승인 정책을 대신하지 않는다. 또한 읽기 전용은 파일 쓰기를 제한하는 개념이지, 모델 요청에 코드가 전송되지 않거나 비용이 발생하지 않는다는 뜻은 아니다.

5. 작업 폴더 오류와 권한 승인은 다른 문제다

공식 비대화형 실행 문서는 codex exec의 Git 저장소 확인을 설명하고, 저장소 밖 실행을 허용하는 --skip-git-repo-check 옵션도 제공한다. 다만 이 옵션은 Git 검사 우회일 뿐, 인증·과금·샌드박스 오류를 한꺼번에 해결하는 기능이 아니다. 이 글의 기본 해결책으로 권하지 않는다.

Not inside a trusted directory 같은 메시지를 만나면 먼저 대화형 codex인지 비대화형 codex exec인지, 현재 경로가 맞는지, Git 저장소인지 확인한다. 승인 창이 뜨는 경우에는 어떤 파일 변경·명령·네트워크 접근을 요청하는지 읽는다. 같은 증상처럼 보여도 확인 순서가 다르다.

• 명령을 찾을 수 없음: 설치 방법, 실행 파일 경로, 새 셸의 PATH부터 확인.
• 로그인 필요·인증 실패: 같은 셸의 로그인 상태와 조직의 로그인 정책을 확인.
• 한도·결제 오류: ChatGPT 접근인지 API 키 접근인지 먼저 구분.
• 저장소·신뢰 폴더 오류: 실행 모드와 현재 디렉터리, Git 상태를 확인.
• 권한 승인·차단: 요청한 동작과 샌드박스 경계를 확인. 처음부터 전체 접근으로 바꾸지 않기.

6. 설치 확인, 인증 확인, 실제 작업 성공을 구분한다

codex --version이 버전을 보여주는 것, codex login status가 저장된 인증 상태를 보여주는 것, 실제 요청이 완료되는 것은 서로 다른 확인 단계다. 버전이 표시돼도 로그인이나 이용 한도가 준비됐다는 뜻은 아니다. 인증 상태가 표시돼도 모든 모델·조직 기능에 접근할 수 있거나 남은 한도가 충분하다는 뜻은 아니다.

문제가 계속되면 운영체제, 셸 종류, CLI 버전, 선택한 로그인 방식, 실패한 정확한 명령과 오류 문구를 기록한다. 계정 이름·API 키·토큰·회사 코드처럼 민감한 내용은 빼고 공유한다. 실제로 확인한 단계까지만 성공으로 기록하면 설치 오류와 인증·권한 문제를 다른 사람도 구분하기 쉬워진다.

7. 첫 실행 전 체크리스트

• CLI와 데스크톱 앱·IDE 확장을 구분했다.
• 설치 방법을 하나 선택하고 실행 파일 경로와 버전을 확인했다.
• ChatGPT 로그인과 API 키 중 선택한 방식, 적용 한도·과금을 확인했다.
• 민감정보를 제외한 연습 폴더와 Git 상태를 확인했다.
• 읽기 위주 권한으로 시작하고 승인 요청의 실제 동작을 읽었다.
• 인증 정보·토큰·사내 코드를 스크린샷이나 댓글에 공개하지 않았다.
• 성공하지 않은 단계를 성공했다고 기록하지 않았다.

결론: 설치, 계정, 폴더를 순서대로 분리하자

Codex CLI 첫 실행에서 중요한 것은 명령을 많이 복사하는 것이 아니라 어디서 막혔는지 좁히는 일이다. 실행 파일이 없으면 설치와 PATH, 인증이 없으면 로그인과 비용 기준, 작업이 막히면 폴더와 권한을 확인한다. 첫 실험은 작고 되돌릴 수 있게 시작하고, 정상 실행 뒤에만 실제 프로젝트와 재사용 스킬로 범위를 넓히자.

관련 글: Claude Code·Codex 스킬 활용법 1화

공식 참고자료

확인일: 2026-10-29. 설치 경로와 권한 체계는 바뀔 수 있으므로, 사용하는 버전의 공식 안내와 CLI 도움말을 함께 확인하자.

OpenAI Codex CLI 공식 안내

OpenAI Codex 공식 저장소와 설치 방법

OpenAI Codex 인증과 자격증명 보관

공식 비대화형 실행과 Git 저장소 확인

공식 승인 정책과 읽기 전용 실행 예시