codex archive 는 저장된 Codex CLI 대화형 세션을 세션 ID 또는 이름으로 보관하는 Stable 명령입니다. 다시 필요하면 같은 종류의 식별자를 codex unarchive 에 전달해 복원합니다. 두 명령은 삭제 명령이 아닙니다. 그렇다고 공식 문서가 세션 밖의 파일·Git 상태까지 되돌린다고 설명하는 것도 아닙니다. 첫 실행은 완료한 비민감 세션 하나를 사람이 확인하는 데서 시작하세요. 보관 직후 같은 식별자로 복원해 결과를 대조하면 됩니다.

• codex archive 와 codex unarchive 의 한 문장 정의
• 설치된 Codex CLI에서 두 명령을 찾는 위치
• 완료한 세션 하나를 보관하고 되돌리는 6단계
• 그대로 복사해 쓸 보관 전 확인 프롬프트
• resume , fork , delete 와 혼동하지 않는 기준

OpenAI Codex CLI 공식 레퍼런스는 codex archive 를 저장된 대화형 세션을 세션 ID 또는 이름으로 보관하는 명령으로 설명하고 Stable로 표시합니다. codex unarchive 는 보관된 대화형 세션을 세션 ID 또는 이름으로 복원하는 Stable 명령입니다.

두 명령은 Codex 대화 입력창에 넣는 slash action이 아닙니다. 터미널의 운영체제 셸에서 실행하는 CLI 하위 명령입니다. 설치된 codex-cli 0.144.6 의 도움말에서는 다음 구문을 확인했습니다.

codex archive SESSION_ID_OR_NAME
codex unarchive SESSION_ID_OR_NAME

SESSION_ID_OR_NAME 은 그대로 복사할 문구가 아닙니다. 사용자가 자기 환경에서 확인한 실제 세션 ID 또는 이름으로 바꿔야 하는 자리표시자입니다. 공식 레퍼런스가 별도의 보편적인 식별자 탐색 메뉴까지 설명하지는 않습니다. 이미 검증한 식별자가 없다면 추측해 넣지 말고 멈추는 편이 안전합니다.

인접 명령과의 경계도 분명합니다. codex resume 은 이전 대화형 세션을 계속합니다. codex fork 는 이전 세션에서 새 채팅을 만듭니다. codex delete 는 저장된 대화형 세션을 영구 삭제하는 별도 명령입니다. 보관을 이어 가기, 분기 또는 삭제와 같은 기능으로 설명하면 안 됩니다.

목표: 현재 Codex 세션을 보관 후보로 검토할 수 있도록 완료 여부와 남은 일을 읽기 전용으로 정리한다.

허용 입력: 현재 채팅에 보이는 사용자 요청, 응답, 명시된 결정, 언급된 파일명과 명령명만 사용한다.

제외 입력: 파일 읽기·수정, 셸 명령 실행, 네트워크 요청, 테스트, 커밋·푸시, 외부 전송, 세션 보관·삭제는 하지 않는다.

출력 형식: 1) 완료한 작업 2) 남은 작업 3) 확인하지 않은 결과 4) 사람이 대조할 파일·명령 이름 5) 보관 가능 여부를 ‘가능/보류/확인 필요’ 중 하나로 작성한다.

완료 기준: 각 판단의 근거가 현재 transcript에 있는지 표시하고, 근거가 없으면 ‘확인 필요’로 남긴다.

추정 금지: transcript에 없는 파일 내용, 실행 결과, Git 상태, 세션 ID·이름, 버전, 자격증명, 외부 시스템 상태를 만들지 않는다.

승인 지점: 요약을 출력한 뒤 멈춘다. 사람이 세션 식별자와 실제 업무 상태를 대조해 보관을 승인할 때까지 기다린다.

아래 프롬프트는 보관 후보 세션이 끝난 업무인지 확인하는 용도입니다. 대상 세션 안에서 실행하되, 읽기 전용 요약 뒤 멈추도록 범위를 고정합니다.

프롬프트가 ‘가능’이라고 답해도 자동 승인은 아닙니다. 실제 식별자와 업무 상태는 사람이 확인합니다. 판단 근거가 부족하면 ‘보류’ 또는 ‘확인 필요’를 유지합니다.

세션 이름보다 식별자와 실제 출력의 짝을 남기는 편이 좋습니다. 같은 이름이 반복될 수 있습니다. 사람마다 세션을 부르는 표현도 다릅니다. 첫 실행 기록에는 설치 버전, 사용한 ID 또는 이름, archive 결과, unarchive 결과만 적어도 다음 검토가 쉬워집니다.

보관 여부와 작업 완료 여부도 분리하세요. 세션을 보관했다고 코드가 병합되거나 배포된 것은 아닙니다. 반대로 세션을 복원했다고 과거의 파일·브랜치·패키지 상태가 돌아온 것도 아닙니다. 세션 상태와 저장소 상태는 각각의 근거로 확인해야 합니다.

식별자를 확실히 찾지 못했다면 기능을 억지로 시험하지 마세요. 공식 레퍼런스가 확인한 입력은 ID 또는 이름입니다. 별도 탐색 경로를 공식 출처에서 확인하지 못했다면 ‘알 것 같은 값’보다 중단 기록이 더 안전합니다.

• archive 를 delete 의 완곡한 표현으로 이해하지 않습니다. 공식 레퍼런스는 두 기능을 따로 두며, delete 를 영구 삭제로 설명합니다.
• 세션 보관을 저장소 백업으로 설명하지 않습니다. 파일, Git 이력, 환경 변수, 설치 의존성, 외부 서비스 상태는 별도 범위입니다.
• unarchive 가 성공해도 이전 실행 환경이 완전히 같다고 단정하지 않습니다. 공식 설명은 보관된 대화형 세션의 복원까지입니다.
• ID나 이름이 불명확하면 명령을 실행하지 않습니다. 첫 시험은 중요한 세션이 아닌 완료한 비민감 세션으로 제한합니다.
• 보편적인 최소 버전·요금제·지역·언어·운영체제 조건을 추정하지 않습니다. 현재 CLI 도움말과 조직 절차를 확인합니다.
• 오류가 모호하면 반복 실행, 다른 식별자 추측 또는 영구 삭제로 넘어가지 않습니다. 출력과 승인 범위를 먼저 검토합니다.

codex archive 와 codex delete 는 같은 기능인가요?

아닙니다. 공식 레퍼런스는 archive 를 저장된 대화형 세션의 보관으로, delete 를 저장된 대화형 세션의 영구 삭제로 설명합니다. 첫 보관 시험에서는 delete 를 사용하지 않습니다.

어떤 값을 SESSION_ID_OR_NAME 자리에 넣어야 하나요?

사용자가 자기 환경에서 확인한 저장 세션의 ID 또는 이름입니다. 설치된 codex archive --help 와 codex unarchive --help 는 UUID인 세션 ID 또는 세션 이름을 받는다고 설명했습니다. 확인하지 못한 값은 추측하지 마세요.

codex unarchive 를 실행하면 파일도 과거 상태로 돌아오나요?

공식 설명은 보관된 대화형 세션을 복원하는 범위입니다. 파일, Git 브랜치, 미커밋 변경, 패키지 또는 외부 서비스가 과거 상태로 돌아온다고 가정하지 않습니다. 필요한 상태는 각 시스템에서 별도로 확인하세요.

보관한 뒤 바로 복원하면 기능을 제대로 시험한 것인가요?

첫 시작 검증으로는 적절합니다. 검증한 같은 식별자에 archive 와 unarchive 를 차례로 실행하고 실제 결과를 기록하면 되돌리는 경로까지 확인할 수 있습니다. 장기 보관, 세션 재개, 분기 또는 삭제는 다음 승인 단계로 남깁니다.

• OpenAI Codex CLI 공식 레퍼런스 — codex archive , codex unarchive , codex delete 의 Stable 상태, 세션 ID·이름 입력, 보관·복원·영구 삭제의 구분을 확인했습니다. 요청 URL은 현재 https://learn.chatgpt.com/docs/developer-commands?surface=cli 로 이동합니다.