Codex CLI 세션 재개 방법: codex resume --last로 멈춘 작업 처음 이어가기

TL;DR

핵심 3줄 요약

이 글에서 다룰 내용

Codex CLI 세션 재개는 무엇이고 언제 쓰면 좋은가

터미널을 닫았거나 다른 일을 처리한 뒤, 앞서 조사한 파일과 결정 사항을 다시 설명하느라 시간이 들 때가 있습니다. 같은 Codex CLI 대화를 다시 열면 이전 흐름에서 후속 요청을 이어갈 수 있습니다.

Codex CLI의 resume 은 저장된 대화 세션을 선택해 계속하는 명령입니다. 공식 개발자 문서는 이 명령을 Stable로 표시하며 세션 ID를 지정하거나 가장 최근 채팅을 다시 열 수 있다고 설명합니다.

시작 전에 확인할 조건과 경계

Codex CLI가 설치되어 있고 로그인을 마쳤으며 한 번 이상 저장된 대화가 있어야 재개할 대상이 생깁니다. 공식 CLI 빠른 시작은 운영체제별 설치 안내를 나누고 첫 실행에서 ChatGPT 로그인 또는 현재 표시되는 다른 인증 방법을 선택하도록 안내합니다.

이 글의 명령은 Codex CLI용입니다. 공식 개발자 명령 문서는 Codex의 CLI 하위 명령과 slash command가 ChatGPT 웹에는 적용되지 않는다고 밝힙니다. 계정 플랜·지역·조직 정책 조건은 두 공식 문서에 별도로 정리되어 있지 않으므로 현재 로그인 화면과 조직 정책을 확인하세요.

codex resume –last로 최근 작업을 이어가는 순서

1. 원래 작업하던 프로젝트 폴더로 이동합니다

--last 는 기본적으로 현재 작업 폴더의 최근 세션을 대상으로 합니다. 먼저 터미널의 현재 경로가 작업을 중단했던 저장소인지 확인합니다.

cd ~/projects/my-app
pwd

다른 저장소에서 실행하면 기대한 세션이 바로 열리지 않을 수 있습니다. 폴더를 기억하지 못한다면 곧바로 --all 로 넓히기보다 기본 선택기에서 세션 정보를 먼저 확인합니다.

2. 선택기를 보려면 codex resume을 실행합니다

codex resume

인수를 붙이지 않은 codex resume 은 세션 선택기를 엽니다. 저장소 경로와 최근 작업을 확인하고 이어갈 대화를 직접 고를 때 사용합니다.

3. 같은 폴더의 최근 세션은 –last로 바로 엽니다

codex resume --last

--last 는 선택기를 건너뛰고 현재 작업 폴더의 가장 최근 채팅을 엽니다. 방금 중단한 작업이 확실할 때 적합합니다.

특정 세션을 알고 있다면 UUID 또는 세션 이름을 직접 지정할 수 있습니다.

codex resume <SESSION_ID>

4. 다른 폴더의 기록까지 찾을 때만 –all을 사용합니다

codex resume --all

공식 문서에 따르면 --all 은 현재 작업 폴더 밖의 세션까지 포함합니다. 목록이 넓어지므로 경로와 최근 작업 내용을 확인한 뒤 선택합니다. 비대화형 세션까지 포함해야 할 때는 --include-non-interactive 라는 별도 옵션이 있습니다.

5. 재개한 세션의 설정과 실제 파일 상태를 확인합니다

세션이 열리면 먼저 /status 로 현재 모델·작업 폴더·세션 설정을 확인합니다. 이어서 Codex에 읽기 중심 점검을 요청하고 실제 터미널 결과를 검토합니다.

git status
git diff

작업 중단 뒤 파일을 직접 고쳤거나 브랜치를 바꿨을 수 있습니다. 이전 대화의 마지막 설명과 현재 파일 상태가 다르면 차이를 먼저 정리하고 수정·명령 실행은 사람 승인 뒤 진행합니다.

6. 작은 검증 작업부터 다시 시작합니다

마지막 테스트가 성공했다고 가정하지 않습니다. 현재 브랜치와 변경 파일을 확인한 뒤 관련 린트나 테스트를 다시 실행합니다. 설치, 마이그레이션, 서버 실행처럼 중간 상태가 남을 수 있는 작업은 현재 상태에서 재현 여부를 확인합니다.

그대로 복사해 쓸 프롬프트

목표: 재개한 Codex CLI 세션의 이전 목표와 현재 저장소 상태가 일치하는지 확인하고 승인된 다음 작업만 이어간다.
허용 입력: 재개된 세션의 대화 기록, 현재 작업 폴더, git status와 git diff 결과, 저장소 안의 코드·테스트·문서.
제외 입력: 다른 저장소, 현재 세션과 무관한 홈 디렉터리 파일, API 키·토큰·.env, 승인하지 않은 외부 네트워크 접근.
출력 형식: 1) 이전 목표 2) 완료된 작업 3) 미완료 작업 4) 대화와 실제 파일 상태의 차이 5) 다시 실행할 검증 명령 6) 승인받을 다음 행동.
완료 기준: 현재 작업 폴더와 브랜치를 확인하고 변경 파일과 테스트 상태를 실제 명령 결과로 제시하며 불일치 항목을 해결 전 상태로 표시한다.
추정 금지: 실행하지 않은 테스트 결과, 확인하지 않은 파일 변경, 종료된 프로세스 상태, 다른 세션의 결정을 만들어 내지 않는다.
승인 지점: 파일 수정, 패키지 설치, 마이그레이션, 외부 네트워크 접근, 커밋·푸시 전에 변경안과 명령을 보여 주고 사람의 승인을 기다린다.

이 프롬프트는 세션 열기와 작업 재개를 나눕니다. 맥락과 현재 상태부터 맞춘 뒤 실행하도록 요구하므로, 오래된 대화 설명만 믿고 수정을 계속하는 실수를 줄입니다.

실전 활용 팁

세션을 재개하면서 모델이나 sandbox 옵션을 바꿀 수 있지만 처음에는 이전 설정부터 확인하는 편이 안전합니다. 공식 문서는 codex resume 이 모델과 sandbox를 포함한 Codex의 전역 옵션을 받을 수 있다고 설명합니다. 변경이 필요하면 /status 와 /permissions 로 현재 값을 확인하고 이유와 범위를 기록합니다.

codex exec resume 은 자동화나 비대화형 작업을 계속하는 별도 흐름입니다. 이번 글의 codex resume 은 대화형 TUI 세션을 다시 여는 방법이므로 두 명령을 섞지 않습니다.

주의할 점

• codex resume --last 는 현재 작업 폴더의 최근 세션을 고릅니다. 저장소가 다르면 먼저 올바른 폴더로 이동합니다.
• --all 은 다른 폴더의 세션까지 보여 줍니다. 경로를 확인하지 않고 비슷한 이름의 세션을 고르지 않습니다.
• 세션 재개와 파일 복원은 같은 작업이 아닙니다. 현재 브랜치, git status , git diff 를 다시 확인합니다.
• 종료된 서버·테스트·가상환경이 그대로 살아 있다고 가정하지 않습니다. 필요한 검증을 현재 터미널에서 다시 실행합니다.
• 재개할 때 sandbox나 승인 정책을 완화하지 않습니다. 변경이 필요하면 현재 설정과 실행할 명령을 먼저 검토합니다.
• CLI에 표시되는 옵션이 공식 문서와 다르면 codex --version 과 codex resume --help 를 현재 설치본의 기준으로 확인합니다.

자주 묻는 질문

출처

마무리

멈춘 작업이 같은 프로젝트의 최근 세션이라면 해당 폴더에서 codex resume --last 를 실행합니다. 세션을 직접 고르려면 codex resume , 다른 경로까지 확인하려면 codex resume --all 을 사용합니다.

대화를 다시 여는 것만으로 작업 검수가 끝나지는 않습니다. /status , git status , git diff 로 설정과 파일 상태를 확인하고 작은 테스트부터 다시 실행한 뒤 사람이 승인한 다음 행동만 이어가세요.