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대화를 요약해 컨텍스트를 비웁니다.긴 세션을 같은 채팅에서 이어갈 때
/status모델·권한·남은 컨텍스트를 보여 줍니다.작업 전·압축 전후 확인
/new같은 CLI 안에서 새 채팅을 시작합니다.맥락을 완전히 갈라야 할 때
/clear터미널을 지우고 새 채팅을 시작합니다.화면과 맥락을 함께 초기화할 때

단계별 사용법

  1. 긴 작업이 한 구간 끝난 뒤, 또는 컨텍스트가 빠듯해졌을 때 작곡기에서 /compact를 입력합니다.
  2. Codex가 요약 제안을 보이면 내용을 확인한 뒤 진행합니다.
  3. 요약이 끝나면 /status로 남은 컨텍스트와 세션 설정을 다시 봅니다.
  4. 이어서 할 일을 한 문장으로 적습니다. 예: 「요약된 제약 안에서 테스트 실패 2건만 고칩니다」.
  5. 검증 명령과 완료 조건을 같이 적으면, 압축 후에도 목표가 흐려지지 않습니다.
  6. 작업이 Codex 실행 중이라면, 슬래시 명령을 입력한 뒤 Tab으로 다음 턴에 대기열에 넣을 수 있습니다. 실행·오류 안내는 현재 턴이 끝난 뒤에 처리됩니다.

실무에서 바로 쓰는 루틴

  1. 큰 작업 전에 /status로 모델·권한·남은 컨텍스트를 확인합니다.
  2. 한 구간(탐색→수정→테스트)이 끝나면 /compact로 중간 정리를 합니다.
  3. 압축 직후, 남는 제약을 한 줄로 다시 적습니다. 예: 「공개 API 시그니처는 유지합니다」.
  4. 다음 구간만 좁혀 요청합니다. 범위가 넓어지면 다시 압축하거나 /new로 분리합니다.
  5. 장기 목표가 필요하면 /goal로 성공 조건을 붙인 뒤, 구간마다 /compact를 반복합니다.

자주 묻는 질문

/compact는 파일을 수정하나요?

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

요약하면 이전 세부 내용이 사라지나요?

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

/clear나 /new와 무엇이 다른가요?

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

작업 중에도 /compact를 넣을 수 있나요?

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

오늘 따라 할 순서

  1. 현재 세션에서 /status로 남은 컨텍스트를 확인합니다.
  2. 한 구간 작업이 끝났으면 /compact를 실행합니다.
  3. 요약 결과를 확인한 뒤, 남길 제약을 한 줄로 다시 적습니다.
  4. 다음 구간만 좁혀 요청하고 검증 명령까지 함께 적습니다.

관련 글: /status 사용법, /goal 사용법, DAKER 코덱스 디렉터리