영상에서 단테는 Codex CLI를 처음 쓰는 분을 위해 설치와 로그인, 세션 개념, 이전 세션 이어가기, 폴더 권한과 설정 파일까지 기본 사용법을 실습으로 보여줬습니다. 터미널 기반 코딩 에이전트를 처음 시작하는 분이나, Codex CLI를 쓰고 있지만 세션과 설정 파일 구조가 헷갈리는 분께 맞는 내용입니다. 요금제와 모델 정보는 영상 게시 시점(2025-10-04) 기준입니다.
왜 Codex CLI인가
실습은 iTerm에서 진행했지만, 맥의 기본 터미널을 써도 문제없습니다. 단테가 Codex CLI를 추천한 이유는 세 가지입니다. 가장 저렴한 ChatGPT Plus 요금제만 구독해도 쓸 수 있고, 오픈 소스로 공개돼 있어 직접 커스터마이징하거나 개발에 참여할 수 있으며, 커뮤니티가 빠르게 커지고 있다는 점입니다. VS Code나 Cursor의 확장으로도 쓸 수 있고, 컴퓨터를 쓰기 어려운 환경에서는 클라우드 버전으로 GitHub에 올린 작업을 이어갈 수도 있습니다.
Codex를 쓰려면 ChatGPT Plus, Pro, Team, Edu, Enterprise 중 하나에 가입돼 있어야 하고, 가장 저렴한 Plus는 월 20달러입니다. OpenAI는 Codex라는 이름으로 클라우드, CLI, 모델 등 여러 제품을 냈기 때문에, 영상에서 "코덱스"라고 하면 Codex CLI를 가리킵니다.
설치와 로그인
OpenAI 공식 문서의 Codex 페이지에 안내된 대로 npm으로 설치합니다.
npm i -g @openai/codex
이미 설치돼 있다면 최신 버전으로 갱신합니다.
npm install -g @openai/codex@latest
로그인은 다음 명령으로 합니다. 안내되는 링크로 들어가 구글 계정 등으로 로그인하면, 완료 화면이 뜬 뒤 터미널에 로그인 성공이 표시됩니다.
codex login
이후 codex를 입력하면 Codex UI가 열립니다.
세션과 컨텍스트 윈도우
codex 명령으로 들어온 이 대화 환경을 세션이라고 합니다. 터미널에서 명령을 입력하는 창과 Codex 안에서 프롬프트를 입력하는 창이 다르다는 점을 떠올리면 이해가 쉽습니다. 세션 안에서 /status를 입력하면 세션의 고유 ID, 현재 디렉터리, 모델 등을 볼 수 있습니다.
화면에 표시되는 컨텍스트 윈도우는 모델이 한 번에 기억할 수 있는 토큰의 양입니다. 사용자가 입력한 프롬프트와 모델의 응답이 모두 입력·출력 토큰으로 쌓이며, 영상 당시 GPT-5-Codex 기준 272K, 즉 27만 2천 토큰으로 표시됐습니다. 이 한도를 넘어서면 모델은 앞부분 대화를 기억하지 못할 수 있습니다. 컨텍스트 윈도우는 세션마다 새로 만들어지므로, 대화가 길어지거나 전혀 다른 주제를 다룰 때는 새 세션을 시작하는 편이 좋습니다.
이전 세션 이어가기
세션을 종료하면 이 세션을 계속하려면 실행하라는 안내와 함께 세션 ID가 표시됩니다. 이 ID는 /status에서 본 것과 같습니다. 예를 들어 한 세션에서 코딩을 하고 다른 세션에서 영어 공부를 하다가 다시 코딩으로 돌아가고 싶다면, 해당 세션 ID로 이어서 열면 이전 대화 내역을 그대로 가진 세션으로 돌아갑니다.
codex resume <세션 ID>
세션을 20개쯤 만들면 예전 ID는 잊어버리기 쉽습니다. Codex는 세션 정보를 홈 디렉터리의 ~/.codex/sessions 폴더에 날짜별로 저장합니다. 파일 이름 앞부분은 타임스탬프, 뒷부분은 세션 ID이고, 파일을 열어 보면 주고받은 대화와 사용자가 입력한 텍스트가 들어 있습니다. 시각을 보고 원하는 세션을 찾아 ID를 확인하면 됩니다.
폴더 권한과 config.toml
같은 codex 명령이라도 어느 디렉터리에서 실행했는지에 따라 동작이 달라집니다. 이전에 권한을 준 홈이나 데스크톱 폴더에서는 다시 묻지 않지만, 새로 만든 폴더에서 처음 실행하면 Codex에게 얼마나 권한을 줄지 고르는 화면이 나옵니다. 묻지 않고 이 폴더에서 작업하도록 허용하면, 이후 파일 생성이나 수정 때 별도 승인 요청을 하지 않습니다.
이 선택은 ~/.codex/config.toml에 저장됩니다. 영상에서는 새로 만든 테스트 폴더가 프로젝트로 등록되고 trust level이 trusted로 기록된 것을 확인했습니다. 기본 모델 값도 이 파일에 들어 있습니다.
설정은 양방향으로 반영됩니다. 세션 안에서 /model 명령으로 모델과 추론 강도를 바꾸면(예: GPT-5, low) config.toml에 그대로 기록됩니다. 반대로 config.toml에서 모델을 GPT-5-Codex, 추론 강도를 high로 바꾼 뒤 새 세션을 열고 /status를 보면 그 값이 적용돼 있습니다.
정리
- Codex CLI는 npm으로 설치하고
codex login으로 ChatGPT 계정에 로그인해 씁니다. /status로 세션 ID, 디렉터리, 모델을 확인하고, 주제가 바뀌거나 대화가 길어지면 새 세션을 여는 것이 좋습니다.- 이전 세션은
codex resume <세션 ID>로 이어가며, ID는~/.codex/sessions에서 찾을 수 있습니다. - 폴더 신뢰 여부와 모델·추론 강도는
~/.codex/config.toml에 저장되고, CLI와 파일 양쪽에서 바꿀 수 있습니다.