Codex CLI 세션 분기 방법: codex fork --last로 원본 대화를 남기는 법
TL;DR
codex fork
는 이전 Codex CLI 세션을 새 채팅으로 분기하면서 원본 transcript를 보존하는 Stable 명령입니다. 가장 최근에 기록된 세션을 선택 화면 없이 분기하려면 운영체제 셸에서
codex fork --last
를 실행합니다. 다만 보존되는 것은 대화 transcript입니다. 파일·Git 상태를 같은 시점으로 되돌리는 기능으로 해석하면 안 됩니다.
핵심 3줄 요약
codex fork
는 이전 대화에서 새 채팅을 만들고 원본 transcript를 남깁니다.--last
는 최근에 기록된 세션을 선택 화면 없이 분기합니다. 설치된 CLI의
codex fork --help
로 먼저 확인하는 것이 안전합니다.이 글에서 다룰 내용
-
codex fork의 한 문장 정의와codex resume과의 차이 - 설치된 Codex CLI에서 명령을 찾는 위치
- 최근 세션을 새 채팅으로 분기하는 6단계
- 그대로 복사해 쓸 읽기 전용 첫 검증 프롬프트
- transcript, 현재 파일, Git 이력을 혼동하지 않는 검수 기준
codex fork
는 무엇이고 언제 쓰면 좋은가
OpenAI의 Codex CLI 공식 레퍼런스는
codex fork
를 이전 대화형 세션을 새 채팅으로 분기하면서 원본 transcript를 보존하는 명령으로 정의하고 Stable로 표시합니다. 같은 세션을 계속하는
codex resume
과 출발점부터 다릅니다.
앞선 대화의 결정과 조사 맥락은 필요하지만 다음 시도는 별도 채팅으로 나누고 싶을 때 쓰는 기능입니다. 기존 분석을 남겨 둔 채 다른 수정 방향을 검토하는 상황이 한 예입니다.
공식 설명에서 보장하는 범위는 transcript 보존입니다.
codex fork
를 실행했다고 해서 Git 브랜치, 파일 사본 또는 과거 파일 상태가 자동으로 만들어졌다고 가정하지 않습니다.
또한 이 명령은 ChatGPT 웹의
Branch in new chat
메뉴가 아니라 Codex CLI 하위 명령입니다. Codex 대화창 안에 입력하는 slash command도 아닙니다. 터미널의 운영체제 셸에서 실행해야 합니다.
시작 전에 확인할 네 가지
- 설치 표면: 현재 터미널에서
codex --version과codex fork --help가 성공해야 합니다. 이번 검증 환경에서는codex-cli 0.144.6이codex fork를 인식했습니다. - 대상 세션: 분기할 기록이 있어야 합니다. 가장 최근 세션이 확실하지 않다면
--last대신codex fork의 선택 화면에서 직접 고릅니다. - 현재 작업 위치: 설치된 CLI 도움말은 기본 선택 화면에 현재 작업 폴더 필터가 적용되고
--all이 이 필터를 해제한다고 설명합니다. 여러 저장소를 오갔다면 폴더와 대상 세션을 함께 확인합니다. - 첫 완료 경계: 첫 요청은 transcript 요약으로 제한합니다. 파일 수정, 셸 명령, 커밋, 푸시, 외부 전송, 운영 환경 변경은 검수 뒤 별도로 승인합니다.
공식 레퍼런스에는 보편적인 최소 버전, 요금제, 지역, 언어 또는 운영체제 조건이 적혀 있지 않습니다. 특정 조건을 추정하기보다 현재 설치된 CLI 도움말과 로그인된 계정 화면을 확인합니다.
최근 세션을 새 대화로 분기하는 6단계
1. 운영체제 셸인지 확인합니다
codex fork
는 터미널 셸에서 실행하는 하위 명령입니다. Codex 대화 입력창에 일반 프롬프트처럼 넣지 않습니다. 명령을 입력하기 전에 기존 Codex 대화형 화면을 종료하고 셸 프롬프트로 돌아옵니다.
2. 설치된 명령 표면을 확인합니다
codex --version
codex fork --help
도움말에
Usage: codex fork [OPTIONS] [SESSION_ID] [PROMPT]
와
--last
가 보이는지 확인합니다. 이번 환경의
--help
에는 세션 ID, 선택적 첫 프롬프트,
--last
,
--all
이 표시됐습니다. 이 확인이 실패한다면 문서만 보고 명령을 추측해 실행하지 않습니다.
3. 최근 세션이 확실한지 판단합니다
방금 작업한 세션을 나누려는 상황이라면
--last
를 사용할 수 있습니다. 다른 프로젝트도 함께 다뤘거나 대상이 불분명하다면 선택 화면을 우선합니다.
codex fork
설치된 도움말에 따르면 인수 없이 실행하면 기본적으로 선택 화면을 사용합니다.
--all
은 현재 작업 폴더 필터를 해제하고 작업 폴더 열을 보여 줍니다. 기본 목록에서 대상을 찾지 못했을 때만 범위를 넓히는 옵션입니다.
4. 최근 세션을 새 채팅으로 분기합니다
codex fork --last
이 명령은 가장 최근에 기록된 세션을 선택 화면 없이 분기합니다. 새 채팅이 열려도 곧바로 파일 수정을 요청하지 않습니다. 이어받은 transcript가 기대한 작업인지 먼저 확인합니다.
5. 읽기 전용 첫 프롬프트로 맥락을 검수합니다
아래 프롬프트는 이전 대화에서 확정된 내용과 아직 확인하지 않은 내용을 나누게 합니다. 새 사실을 만들거나 파일을 변경하지 않도록 범위를 먼저 고정합니다.
6. 현재 저장소와 대조한 뒤 다음 행동을 승인합니다
요약에 나온 파일명, 결정, 미확인 항목을 현재 저장소와 대조합니다. transcript가 남아 있다는 사실만으로 파일 상태가 보존됐다고 판정하지 않습니다. 대조가 끝난 뒤에도 첫 승인 범위는 작은 검사 하나로 제한합니다. 수정·실행·커밋은 각각 필요한 시점에 승인합니다.
그대로 복사해 쓸 첫 실행 검증 프롬프트
목표: 이 분기 채팅이 이어받은 transcript를 읽기 전용으로 검수한다.
허용 입력: 현재 채팅에 보이는 이전 메시지, 명시된 결정, 언급된 파일명과 명령명만 사용한다.
제외 입력: 파일 수정, 셸 명령 실행, 네트워크 요청, 커밋·푸시, 외부 전송, 운영 환경 변경은 하지 않는다.
출력 형식: 1) 확정된 결정 2) 아직 확인하지 않은 가정 3) 언급된 파일·명령 4) 현재 저장소에서 대조할 항목 5) 다음에 제안할 작은 검사 한 가지 순서로 작성한다.
완료 기준: 각 항목의 근거가 transcript에 있는지 표시한다. 현재 파일 상태와 대조가 필요한 내용은 ‘확인 필요’로 남긴다.
추정 금지: transcript에 없는 파일 내용, 실행 결과, Git 상태, 버전, 자격증명, 외부 시스템 상태를 만들지 않는다.
승인 지점: 요약을 출력한 뒤 멈춘다. 사람이 현재 저장소와 대조해 다음 검사를 승인할 때까지 기다린다.
실전 활용 팁
가장 빠른 명령이 항상 가장 안전한 선택은 아닙니다. 최근 세션이 명확하면
codex fork --last
가 빠릅니다. 여러 저장소를 오갔다면
codex fork
선택 화면에서 대상을 직접 확인하는 편이 낫습니다. 기본 목록에 대상이 없을 때만
codex fork --all
로 범위를 넓힙니다.
세션 분기와 코드 분리는 별도로 판단합니다.
codex fork
는 transcript 흐름을 나누는 기능입니다. 현재 파일의 변경 이력은 저장소의 기존 검수 절차로 확인해야 합니다. 새 채팅의 첫 응답을 읽은 다음 현재
git status
나 팀에서 승인한 상태 확인 방법을 사람이 직접 선택하세요. 이 글의 첫 완료 기준에는 그 명령 실행 자체도 포함하지 않습니다.
선택적 첫 프롬프트를 명령 인수로 붙일 수 있는지는 설치된
codex fork --help
에서 확인할 수 있습니다. 이번 0.144.6 도움말은
[PROMPT]
를 지원합니다. 이를 어떤 버전에도 동일하다고 일반화하지 않습니다.
주의할 점
-
codex fork --last의last를 “현재 폴더의 최근 세션”이라고 단정하지 않습니다. 이번 설치 표면은--last를 가장 최근 세션으로 설명합니다. 현재 폴더 필터 해제는--all설명에 따로 적었습니다. - 원본 transcript 보존과 파일 복제는 다른 주장입니다. 분기 뒤에도 현재 작업 폴더의 파일·프로세스·Git 상태는 별도로 확인합니다.
- 새 채팅이 이전 판단을 이어받아도 그 판단이 사실이라는 보장은 없습니다. 출처, 테스트 결과, 파일 내용을 현재 상태에서 다시 대조합니다.
- 과거 transcript에 민감한 내용이 있었는지 이 기능 설명만으로 판정할 수 없습니다. 조직 정책과 현재 계정의 데이터 처리 지침을 확인하세요. 공개하면 안 되는 입력은 새 프롬프트에 넣지 않습니다.
- 이 글은 설치된
codex-cli 0.144.6의 명령 발견 결과를 함께 기록했지만 보편적인 최소 버전을 제시하지 않습니다.codex fork --help가 실패하면 업데이트나 설정 변경을 추측하지 말고 현재 공식 문서와 조직의 설치 절차를 확인합니다.
자주 묻는 질문
codex resume --last
와
codex fork --last
는 무엇이 다른가요?
resume
은 이전 대화형 세션을 계속합니다.
fork
는 이전 세션에서 새 채팅을 만들면서 원본 transcript를 보존합니다. 기존 작업을 그대로 이어 가는지, 같은 맥락에서 별도 시도를 시작하는지가 선택 기준입니다.
codex fork
를 실행하면 Git 브랜치도 생기나요?
공식 레퍼런스가 설명하는 범위는 새 채팅 생성과 원본 transcript 보존입니다. Git 브랜치나 파일 사본이 자동으로 생긴다고 보지 말고 현재 저장소 상태를 따로 확인하세요.
--last
로 잘못된 세션이 열릴까 걱정되면 어떻게 하나요?
codex fork
만 실행해 선택 화면에서 대상을 확인합니다. 기본 목록에서 찾지 못했고 다른 작업 폴더의 세션까지 확인해야 할 때는 설치된 도움말의
--all
동작을 확인한 뒤 범위를 넓힙니다.
분기 직후 바로 코드를 수정해도 되나요?
먼저 읽기 전용 요약으로 이어받은 맥락을 확인하고 현재 저장소와 대조하는 편이 안전합니다. 파일 수정, 명령 실행, 커밋·푸시는 사람이 범위를 확인한 뒤 별도로 승인하세요.
출처
- OpenAI Codex CLI 공식 레퍼런스 —
codex fork의 Stable 상태, 새 채팅 생성, 원본 transcript 보존 정의를 확인했습니다. 요청 URL은 현재https://learn.chatgpt.com/docs/developer-commands?surface=cli로 이동합니다.
마무리
codex fork
를 시작하는 첫 행동은 운영체제 셸에서 설치된 도움말을 확인하는 것입니다. 최근 세션이 확실하면
codex fork --last
로 새 채팅을 엽니다. 불확실하면 선택 화면에서 대상을 직접 고릅니다.
분기 뒤의 첫 성공 기준은 코드 생성이 아닙니다. 이전 transcript의 확정 사항과 미확인 가정을 나눈 요약을 받는 데서 시작합니다. 그 내용을 현재 저장소와 대조한 뒤 다음 작은 검사를 승인하세요. 이 경계를 지키면 원본 대화를 남겨 둔 채 다른 작업 방향을 더 분명하게 시작할 수 있습니다.
