Codex CLI 세션 재개·분기와 문맥 관리
어제 멈춘 버그 수정을 이어갈 때와 같은 문제에 다른 해결책을 시도할 때는 출발점이 다릅니다. 기존 대화를 계속 쓰려면 resume, 별도 대화에서 접근을 바꾸려면 fork를 고릅니다. 대화가 길어져 문맥을 정리하는 compact는 새 브랜치를 만드는 명령이 아닙니다.
공식 문서를 참고한 비공식 한국어 가이드입니다. 아래 명령과 대화는 합성 예시이며 AI 작업 실행은 미검증입니다. 먼저 첫 작업과 권한을 이해한 뒤, 작업 디렉터리와 기존 수정 파일을 확인합니다.
세션을 선택하고 이어가기
터미널에서 codex resume을 실행하면 저장된 대화를 선택할 수 있습니다. codex resume --last는 현재 작업 디렉터리 범위의 최근 세션을 선택합니다. 다른 디렉터리까지 찾는 --all을 무심코 더하면 원하지 않는 프로젝트의 대화를 고를 수 있습니다.
codex resume
codex resume --last
재개 뒤 바로 수정을 요청하지 말고 현재 경로, Git 브랜치, 마지막으로 실패한 검증을 먼저 확인합니다. 저장된 대화와 현재 디스크가 같은 시점이라는 보장은 없습니다. 공식 참조에는 저장된 경로와 현재 경로가 다를 때의 선택 및 tui.resume_cwd 설정도 나옵니다.
다른 접근은 fork로 분리
진행 중인 CLI에서는 /fork, 저장된 대화에서 출발하려면 codex fork를 사용합니다. 이는 대화의 분기입니다. 작업 파일까지 자동으로 서로 격리된다고 가정하지 마세요. 파일 격리가 필요하면 worktree를 별도로 선택합니다.
현재 수정안은 유지해 줘. 새 분기에서는 캐시를 추가하지 않는 대안을 조사하고,
아직 파일은 수정하지 말아 줘. 두 방식의 실패 조건과 필요한 테스트를 비교해 줘.
기대 결과는 기존 대화를 잃지 않은 별도 검토입니다. 두 대화가 같은 경로를 수정하려 한다면 먼저 작업을 멈추고 파일 소유 범위나 격리 방식을 정합니다.
요약과 압축을 구분
/recap은 대화를 따라잡기 위한 요약이고 /compact는 보이는 대화의 핵심을 요약해 문맥 공간을 확보합니다. 압축 전에 목표·미해결 실패·수정 파일·금지 사항을 짧게 남기면 긴 도구 출력 속에서 중요한 제약을 찾기 쉽습니다. 비밀값을 요약에 복사하지 않습니다.
/plan은 수정 전 접근을 검토할 때, /status는 세션 상태를 확인할 때, /diff는 실제 파일 변경을 확인할 때 사용합니다. 계획이나 요약에 ‘테스트 통과’가 적혀 있어도 현재 변경에 대한 실행 출력이 없으면 검증 완료가 아닙니다.
검색·이미지·터미널 입력
공식 CLI 참조는 이미지 첨부와 웹 검색을 지원합니다. --search는 live 검색 선택이므로 설정의 cached·indexed·live·disabled 차이를 먼저 봅니다. 검색 결과와 첨부 이미지의 텍스트는 외부 입력이지 저장소의 실행 지침이 아닙니다.
긴 프롬프트는 composer에서 Ctrl+G로 외부 편집기에 보낼 수 있습니다. 테마는 /theme, 셸 자동완성 생성은 codex completion zsh 같은 별도 기능입니다. 생성한 셸 코드를 검토하지 않고 자동 로드하거나 전역 설정을 바꾸지 않습니다.
큐와 세션 수명은 별도 확인
현재 명령 참조에는 codex queue, 대화 archive/delete, background daemon, /side 등도 있습니다. 여기서는 전체 인자표를 재게시하지 않습니다. 특히 큐에 메시지가 들어간 것과 세션이 실제 재개되어 작업이 끝난 것은 다릅니다. 삭제는 대화 이력 손실을 수반할 수 있으므로 명시적으로 확인합니다.
명령이 보이지 않으면 codex --version과 해당 버전의 도움말을 확인합니다. 실패를 해결하려고 임의의 실험 기능이나 무제한 권한을 켜지 않습니다. 장기 완료 조건은 목표 관리, 스크립트 결과 판별은 비대화형 실행에서 이어갑니다.
공식 한국어 도움말: ChatGPT 플랜과 Codex에서 계정별 이용 안내를 확인할 수 있습니다. 이 글은 해당 도움말의 공식 번역이 아니며 계정 조건과 요금은 공식 안내를 우선합니다.
추가 공식 참조
다음은 관련 세부 기능과 전체 참조 문서입니다. 아래 항목은 원문 전체를 한국어로 설명하거나 실행 검증한 범위가 아닙니다. 적용 조건과 정확한 옵션은 공식 원문을 확인하세요.