Codex /compact로 긴 세션 컨텍스트를 비우고 같은 작업을 이어가는 방법 | DAKER 커뮤니티

긴 Codex 세션에서는 대화가 쌓일수록 앞선 결정과 로그, 파일 경로까지 함께 컨텍스트를 차지합니다. 그러다 보면 같은 저장소에서 계속 작업하고 싶어도, 이미 합의한 내용을 다시 설명하는 데 시간이 들기 쉽습니다.

이럴 때 /compact는 새 채팅으로 갈아타지 않고도 흐름을 정리할 수 있게 돕습니다. 이전 대화를 요약으로 압축해 핵심은 남기고, 이후 작업에 쓸 컨텍스트 여유를 다시 확보하는 방식입니다.

긴 작업 중간에 /compact를 실행하면, Codex가 이전 턴을 요약으로 압축해 컨텍스트를 비우고 핵심만 유지합니다.

작업 전 모델·권한 확인은 Codex /status 사용법을, 긴 목표를 함께 관리하는 방법은 Codex /goal 사용법을 같이 보면 이해가 더 쉬워집니다.

왜 긴 세션에서는 컨텍스트가 빨리 차는가

마이그레이션, 다파일 리팩터링, 실패 로그 추적처럼 여러 턴에 걸친 작업은 대화 기록이 빠르게 길어집니다. 컨텍스트가 부족해지면 앞서 정한 제약이나 검증 명령, 파일 경로를 다시 설명해야 하고, 새 채팅으로 옮기면 맥락을 통째로 옮기는 부담이 생깁니다.

/compact는 이런 비용을 줄이기 위한 중간 정리 명령입니다. 작성 기준일(2026-09-09 KST) 기준 OpenAI Codex CLI 공식 문서의 slash commands 설명에 따르면, 긴 교환 뒤 /compact를 쓰면 Codex가 이전 턴을 요약으로 바꿔 컨텍스트를 확보하고 핵심 내용은 유지합니다.

/compact가 실제로 하는 일

/compact의 핵심은 대화를 짧게 줄이는 것이 아니라, 이후 작업에 필요한 정보만 남기고 세션을 계속 이어갈 수 있게 만드는 데 있습니다. 이전 턴은 요약으로 압축되고, 그만큼 이후 요청에 사용할 토큰 여유가 생깁니다. 중요한 결정, 결과, 제약은 요약에 남기면서도 같은 채팅과 같은 저장소 맥락을 유지할 수 있습니다.

/compact는 같은 세션을 유지한 채 이전 대화를 요약으로 바꿔 컨텍스트 여유를 확보하는 명령입니다.

명령	하는 일	언제 쓰나요
`/compact`	대화를 요약해 컨텍스트를 비웁니다.	긴 세션을 같은 채팅에서 이어갈 때
`/status`	모델·권한·남은 컨텍스트를 보여 줍니다.	작업 전·압축 전후 확인
`/new`	같은 CLI 안에서 새 채팅을 시작합니다.	맥락을 완전히 갈라야 할 때
`/clear`	터미널을 지우고 새 채팅을 시작합니다.	화면과 맥락을 함께 초기화할 때

단계별로 쓰는 방법

긴 작업이 한 구간 끝났거나 컨텍스트가 빠듯해졌다면, 작업 중인 곳에서 /compact를 입력하면 됩니다. Codex가 요약 제안을 보여 주면 내용을 확인한 뒤 진행하고, 요약이 끝난 다음에는 /status로 남은 컨텍스트와 세션 설정을 다시 확인하는 것이 좋습니다.

그다음에는 이어서 할 일을 한 문장으로 좁혀 적어 두면 흐름이 덜 흔들립니다. 예를 들어 요약된 제약 안에서 테스트 실패 2건만 고친다고 적는 식입니다. 검증 명령과 완료 조건까지 함께 남기면 압축 이후에도 목표가 흐려지지 않습니다.

작업이 Codex 실행 중인 상태라면, 슬래시 명령을 입력한 뒤 Tab으로 다음 턴에 대기열로 넣을 수 있습니다. 실행·오류 안내는 현재 턴이 끝난 뒤 처리됩니다.

실무에서 자주 쓰는 루틴

큰 작업을 시작하기 전에는 /status로 모델·권한·남은 컨텍스트를 먼저 확인하는 편이 좋습니다. 이후 탐색, 수정, 테스트처럼 한 구간이 끝날 때마다 /compact로 중간 정리를 하면 세션이 길어져도 흐름을 유지하기 쉽습니다.

압축 직후에는 꼭 남겨야 할 제약을 한 줄로 다시 적어 두는 것이 안전합니다. 예를 들어 공개 API 시그니처는 유지한다고 남겨 두면, 다음 구간에서 범위가 넓어지더라도 기준이 분명해집니다. 이후 요청은 다음 구간만 좁혀서 전달하고, 범위가 다시 커지면 한 번 더 압축하거나 /new로 분리하면 됩니다.

장기 목표가 필요한 작업이라면 /goal로 성공 조건을 붙여 두고, 구간마다 /compact를 반복하는 방식이 잘 맞습니다.

자주 헷갈리는 점

/compact는 파일을 수정하는가

아닙니다. 이 명령은 대화 기록을 요약해 컨텍스트를 확보하는 역할을 합니다. 작업 트리 변경은 별도 요청이 있을 때만 이뤄집니다.

요약하면 이전 세부 내용이 사라지는가

세부 로그나 긴 인용은 줄어들 수 있습니다. 꼭 남겨야 할 경로, 명령, 제약은 압축 직후 한 줄로 다시 적어 두는 편이 안전합니다.

/new, /clear와 차이는 무엇인가

/compact는 같은 채팅을 유지한 채 요약합니다. /new는 새 채팅을 시작하고, /clear는 터미널 화면까지 지운 뒤 새 채팅을 시작합니다.

작업 중에도 넣을 수 있는가

가능합니다. Codex가 실행 중일 때 슬래시 명령을 입력하고 Tab으로 대기열에 넣으면 현재 턴이 끝난 뒤 처리됩니다.

정리하며

/compact는 긴 세션을 버리지 않고 중간에 숨을 고르는 명령에 가깝습니다. 새 채팅으로 옮기지 않아도 핵심 맥락을 유지한 채 다음 작업에 필요한 여유를 다시 만들 수 있다는 점이 가장 큰 장점입니다.

참고 자료: OpenAI Codex CLI 공식 문서의 slash commands 설명

긴 Codex 작업을 할 때 여러분은 어느 시점에서 /compact를 가장 자주 쓰게 되는지 궁금합니다.