Codex CLI의 /compact 는 길어진 현재 채팅의 이전 turn을 간결한 요약으로 바꾸어 남은 context를 확보하는 명령입니다. 긴 대화가 끝나면 composer에 /compact 를 입력합니다.

현재 화면에 확인 단계가 나타나면 내용을 살핀 다음 진행합니다. 완료 표시는 Context compacted 입니다. 다만 요약은 원문 transcript 자체가 아니므로 압축 전에는 목표와 제약을 적고, 압축 후에는 요약을 실제 파일·Git diff·테스트 결과와 대조해야 합니다.

이 글은 /compact 를 어디서 입력하는지, 첫 실행에서 무엇을 기록하고 무엇을 확인하는지에 집중합니다. 파일 수정, 배포, 새 세션 생성, exact token 절약량은 다루지 않습니다. 공식 문서가 밝히지 않은 플랜·지역·언어·운영체제·최소 버전도 추정하지 않습니다.

Codex CLI에서 작업을 오래 이어가면 요구사항, 시도한 방법, 명령 출력과 검토 결과가 한 채팅에 쌓입니다. 지금 필요한 결정과 끝난 탐색 과정이 한 transcript에 섞이면, 다음 요청의 기준을 찾는 데 시간이 걸립니다.

/compact 는 이때 쓰는 slash command입니다. OpenAI 공식 Developer commands 문서는 이 기능을 Summarize the visible chat to free tokens라고 설명합니다.

실행이 끝나면 이전 turn은 간결한 summary로 대체됩니다. 핵심 내용을 남긴 채 context를 확보하는 것이 기대 결과입니다.

여기서 중요한 경계가 있습니다. 압축은 이전 문장을 원문 그대로 보관하는 작업이 아닙니다.

또한 summary가 실제 파일 상태나 테스트 통과를 증명하지도 않습니다. 압축 결과는 다음 작업을 이어가기 위한 맥락입니다. 사실 확인은 저장소와 실행 기록에서 따로 해야 합니다.

목표: 압축된 현재 채팅에서 다음 작업에 필요한 상태만 검토한다.

허용 입력: 내가 아래에 붙인 승인된 checkpoint와 현재 채팅의 압축 요약

제외 입력: 자격증명, 개인정보, 고객 데이터, 승인하지 않은 파일·폴더, 외부 웹·커넥터

출력 형식: 목표 / 확정된 제약 / 변경됐다고 요약된 파일 / 실행 완료로 요약된 테스트 / 미완료 항목 / 확인 필요 항목을 각각 표로 작성

완료 기준: checkpoint의 모든 항목이 표에 대응되고, 누락·충돌은 확인 필요로 남아 있다

사실 제약: 실제 파일·Git diff·terminal 출력으로 확인하지 않은 내용은 사실로 만들지 말고 요약상 주장이라고 표시한다

승인 지점: 파일 열기, 명령 실행, 수정, 삭제, 외부 전송은 하지 말고 내가 표를 검토해 승인할 때까지 멈춘다

압축 후 답변을 받으면 한 주장씩 출처를 붙입니다. 파일 변경은 git status 와 git diff 에서, 테스트 결과는 terminal의 실제 명령과 종료 상태에서 확인합니다. 요구사항은 승인된 issue, 작업 지시서나 checkpoint와 비교합니다.

상태는 확인 완료 , 상충 , 확인 필요 세 가지면 충분합니다. summary와 실제 파일이 다르면 summary를 맞다고 처리하지 않습니다. 미확인 항목을 보존한 채 사람이 다음 행동을 정합니다.

첫 시험에서 남겨야 할 결과물은 source-traceable 내부 검토표입니다. 압축, 검토표 작성, 파일 수정, 배포는 서로 다른 단계입니다.

첫 실행은 검토표 승인에서 끝냅니다. 수정과 외부 전송은 별도 승인 뒤에 둡니다.

첫째, /compact 를 완전한 백업이나 transcript export로 소개하면 안 됩니다. 공식 문서는 이전 turn을 concise summary로 대체한다고 설명합니다. 원문 기록 보존이 필요한 업무는 별도 정책과 저장 절차를 따라야 합니다.

둘째, Context compacted 는 내용이 모두 정확하다는 표시가 아닙니다. 목표·수치·파일 경로·테스트 상태가 자연스럽게 보이더라도 실제 근거와 다시 맞춥니다.

셋째, exact token 절감량이나 언제 반드시 실행해야 하는지는 공식 섹션에서 확인되지 않습니다. 남은 context 숫자만 보고 자동 실행 규칙을 만들지 않습니다.

넷째, 압축 후 곧바로 배포·삭제·덮어쓰기 같은 결과가 큰 작업을 맡기지 않습니다. read-only 확인과 사람의 검토를 통과한 뒤에 다음 단계로 이동합니다.

/compact는 운영체제 shell에서 실행하나요?

아닙니다. Codex TUI의 composer 안에서 입력하는 slash command입니다. Enter를 누르기 전에 completion에서 명령이 인식되는지 확인합니다.

짧은 채팅에서도 사용할 수 있나요?

공식 문서는 긴 exchange 뒤 실행하라고 안내하지만 최소 turn 수나 exact token 기준은 밝히지 않습니다. 현재 채팅의 작업 경계가 끝났고 요약이 필요한지 판단합니다.

확인창이 나오지 않아도 정상인가요?

공식 문서는 요약 제안이 보이면 확인하라고 설명합니다.

다만 codex-cli 0.144.6 격리 검증에서는 별도 확인창 없이 Context compacted 가 표시됐습니다. 현재 버전에서는 Enter를 누르기 전에 checkpoint를 끝냅니다. 그런 다음 완료 marker를 확인합니다.

압축 뒤 summary만 믿고 작업을 계속해도 되나요?

아닙니다. summary는 다음 대화를 위한 맥락입니다. 중요한 제약, 파일 변경과 테스트 상태는 checkpoint, 실제 파일, Git diff와 terminal 출력에 대조하고 사람이 승인해야 합니다.

• OpenAI 공식 Developer commands: Keep transcripts lean with /compact