Context left가 측정하는 것
모든 Codex 채팅에는 context window가 있습니다. 이는 모델이 한 번에 고려할 수 있는 대화, 도구 출력 및 지침의 양입니다. Codex의 구성 참조 문서에서는 이 창 설정을 "활성 모델이 사용할 수 있는 컨텍스트 창 토큰"으로 설명합니다.
Context left 수치는 현재 채팅에서 해당 창의 얼마나 많은 부분이 아직 사용되지 않았는지를 보여줍니다. 채팅이 길어질수록 수치는 내려갑니다. 채팅이 압축되거나 새 채팅을 시작하면 다시 올라갑니다.
이것은 채팅별 숫자입니다. 다른 터미널의 두 번째 채팅은 자체 수치를 가지며, 새 채팅을 시작하면 신선한 창을 얻게 됩니다.
이것이 아닌 것
이것은 귀하의 계정 사용량이 아닙니다. Codex는 이를 별도로 추적하며, 명령 참조 문서에는 /usage를 통해 "계정 토큰 사용량을 확인하거나 속도 제한 리셋을 사용"하도록 되어 있습니다. 상태 표시줄에는 속도 제한을 위한 별도의 항목이 있습니다. 계정이 제한에 가까워도 채팅 공간은 남아 있을 수 있으며, 그 반대의 경우도 마찬가지입니다.
Codex가 숫자를 계산하는 방식
Codex의 터미널 클라이언트는 오픈 소스이며, 계산 방식은 코드에 공개되어 있습니다. 두 가지 세부 사항이 왜 이 수치가 혼란스러울 수 있는지 설명해 줍니다.
고정된 기준선(Baseline) 제외
계산 시 12,000 토큰의 고정된 기준선을 따로 떼어 둡니다. Codex는 백분율을 산출하기 전에 전체 창과 사용 중인 토큰에서 이 수치를 뺍니다. 결과적으로 채팅의 첫 12,000 토큰은 수치에 변화를 주지 않습니다.
이것이 새 채팅이 첫 메시지를 보내기 전에도 무언가를 포함하고 있음에도 불구하고 상단(100%)에서 시작하는 이유입니다. Codex는 작업을 시작하기 전에 AGENTS.md 파일과 자체 지침을 읽습니다. 문서에 따르면 "Codex는 작업을 수행하기 전에 AGENTS.md 파일을 읽습니다." 이 자료들은 공간을 차지하지만, 기준선 내에 있기 때문에 사용된 것으로 표시되지 않습니다.
따라서 이 숫자는 상대적입니다. 전체 창의 원시 비율이 아니라, 기준선 위의 창 부분에 남은 공간을 측정합니다.
활성 모델의 창을 따름
백분율은 사용 중인 모델의 context window를 기준으로 측정됩니다. 창이 클수록 동일한 대화가 차지하는 비중이 작아집니다. 모델을 전환하거나 기본값이 변경된 후 수치가 다르게 보일 수 있는 이유가 바로 이것입니다.
클라이언트에 표시할 백분율이 없는 경우, 대신 사용된 토큰 수를 보여줍니다.
무엇이 창을 채우는가
직접 입력하지 않은 항목을 포함하여 채팅에 새로운 내용이 들어올 때마다 수치가 떨어집니다.
- 도구 출력: 테스트 실행, 로그, 파일 읽기 및 명령 출력은 모두 컨텍스트에 쌓입니다. 긴 디버깅 세션은 본인의 메시지보다 도구 출력에서 더 많은 양을 추가할 수 있습니다.
- Codex가 읽는 파일: Codex가 코드를 이해하기 위해 여는 각 파일은 공간을 차지합니다.
- 대화 내용: 귀하의 메시지와 계획을 포함한 Codex의 답변.
- 추론(Reasoning): 추론 기능을 가진 모델은 추론을 위해 토큰을 사용하며, 이 역시 회계에 포함됩니다.
수치가 떨어지면 일어나는 일
압축 (Compaction)
채팅이 한계에 가까워지면 Codex는 이를 압축합니다. 즉, 채팅을 계속할 수 있도록 이전 대화 내용을 요약합니다. 직접 실행할 수도 있습니다. 명령 참조 문서에서는 /compact를 "가시적인 채팅을 요약하여 토큰을 확보함"으로 설명하며, 예상 결과는 "Codex가 이전 대화를 간결한 요약으로 대체하여 중요한 세부 사항을 유지하면서 컨텍스트를 확보함"입니다.
압축 후에는 수치가 다시 올라갑니다. 이전 대화들은 이제 요약본이 됩니다.
바닥에 닿기 전에 압축이 올 수 있음
자동 압축이 실행되는 지점은 창 설정과는 별개의 설정입니다. Codex의 구성 참조 문서에서는 model_auto_compact_token_limit을 "자동 기록 압축을 트리거하는 토큰 임계값(설정되지 않은 경우 모델 기본값 사용)"으로 설명합니다.
문서에는 이 임계값이 바닥글의 0 지점과 일치한다고 명시되어 있지 않습니다. 이 수치를 압축까지의 정확한 카운트다운이 아니라 남은 공간에 대한 가이드로 취급하세요. 숫자가 바닥을 칠 때까지 기다렸다가 조치를 취하려 한다면, 이미 압축이 일어났을 수도 있습니다.
임계값이 계산되는 방식에 대한 관련 설정도 있습니다. 참조 문서에 따르면 model_auto_compact_token_limit_scope는 "자동 압축 임계값이 전체 활성 컨텍스트(total, 기본값)를 계산할지, 아니면 전달된 압축 창 접두사 이후의 증가분만 계산할지(body_after_prefix)를 제어합니다."
최근 회계 방식 수정
2026년 10월 29일에 릴리스된 Codex 0.166.0에는 이 영역의 수정 사항이 포함되어 있습니다. 릴리스 노트에 따르면 "조기 압축을 방지하기 위해 resume 및 fork 시 추론 토큰 회계를 보존함"이라고 되어 있습니다. 이전 버전에서 재개하거나 포크한 채팅이 예상보다 빨리 압축되는 것을 보았다면 업데이트가 첫 번째 단계입니다.
수치를 더 자세히 확인하기
/status
바닥글은 하나의 숫자를 제공하지만, /status는 더 많은 정보를 줍니다. 명령 참조 문서에 따르면 이는 "세션 구성 및 토큰 사용량"을 보여주며, "활성 모델, 승인 정책, 쓰기 가능한 루트 및 남은 컨텍스트 용량"을 확인하는 용도로 나열되어 있습니다.
바닥글의 수치가 의아할 때 실행해 보세요. 또한 어떤 모델이 활성화되어 있는지 확인해 주므로 수치의 갑작스러운 변화를 설명해 줍니다.
/statusline
바닥글에 표시할 항목을 선택할 수 있습니다. /statusline 명령은 선택기를 열며, 문서에는 다음과 같은 항목이 나열되어 있습니다: "사용 가능한 상태 표시줄 항목에는 모델, 모델+추론, 컨텍스트 통계, 속도 제한, git 브랜치, 토큰 카운터, 세션 ID, 현재 디렉토리/프로젝트 루트 및 Codex 버전이 포함됩니다." 선택 사항은 config.toml의 tui.status_line에 저장됩니다.
긴 세션에서 작업하는 경우 컨텍스트 통계 항목과 모델 항목을 나란히 두세요. 그러면 수치가 급변할 때 그 옆에서 바로 이유를 찾을 수 있습니다.
수치가 낮아지기 전에 해야 할 일
수치가 떨어지는 것 자체가 문제는 아닙니다. 위험한 것은 채팅이 압축될 때 요약되어 사라지는 것들, 즉 기록해 두지 않은 세부 사항들입니다.
채팅에서 파악한 내용을 기록하세요
결정 사항, 그 이면의 이유, 발견한 제약 조건 등은 요약 과정에서 압축될 수 있는 항목들입니다. 긴 채팅이 압축되기 전에, 저장소에 적용되는 내용이라면 AGENTS.md에, 그렇지 않다면 다른 곳에 보관하는 노트에 필요한 내용을 적어 두세요.
복사본 내보내기
/export는 대화 내용을 저장합니다. 문서에 따르면 "Codex는 전체 대화를 Markdown으로 내보냅니다." 클립보드에 복사하거나 파일로 저장할 수 있습니다. Codex 채팅 내보내기 가이드에서 스크립트를 내보낸 후 무엇을 해야 하는지 확인하세요.
압축 없이 요약하기
채팅 내용을 변경하지 않고 본인만을 위한 요약이 필요하다면 /recap을 사용하세요. 명령 참조 문서에서는 이를 "컨텍스트를 압축하지 않고 채팅 내용을 파악하는 방법"으로 설명합니다.
자연스러운 중단점에서 압축하기
단계 중간에 자동으로 압축되게 두는 것보다 단계가 끝날 때 직접 /compact를 실행하는 것이 좋습니다. 중요한 부분이 이미 정리된 시점을 직접 선택할 수 있기 때문입니다.
브랜치 생성 또는 새로 시작하기
새로운 방향으로 나아가려면 /fork를 통해 채팅을 새 채팅으로 복사하세요. Codex 채팅 포크 가이드에서 무엇이 인계되는지 다룹니다. 메인 채팅에 추가하고 싶지 않은 간단한 질문은 /side를 통해 일시적인 사이드 채팅을 시작하세요. 관련 없는 작업은 /new로 새 채팅을 시작하세요.
긴 작업을 추적 중이라면 /goal을 사용하여 채팅이 진행되는 동안 목표를 유지할 수 있습니다. Codex goal mode 가이드에서 그 내용을 설명합니다.
사람들이 흔히 하는 실수
수치를 사용량 제한으로 읽는 것. 이것은 현재 채팅 창의 공간입니다. 계정 사용량은 /usage에서 확인하세요.
새 채팅에서 지침 비용이 표시되기를 기대하는 것. 기준선이 첫 12,000 토큰을 숨기므로 새 채팅은 상단에서 시작됩니다.
조치를 취하기 전에 0이 될 때까지 기다리는 것. 압축은 자체 임계값에서 실행됩니다. 여유가 있을 때 조치를 취하세요.
모델 간에 숫자를 비교하는 것. 각 모델의 창을 기준으로 측정되므로 동일한 채팅이라도 모델에 따라 다르게 읽힙니다.
모든 것을 하나의 채팅에 담아두는 것. 작업당 하나의 채팅을 유지해야 수치가 의미 있고 요약이 집중된 상태로 유지됩니다.
해결책: Context left를 작업 저장 알림으로 활용하기
1단계: 컨텍스트 통계를 보이는 곳에 배치하기
/statusline을 실행하여 바닥글에 컨텍스트 통계와 모델 항목을 유지하세요. 숫자가 예기치 않게 움직이면 /status를 확인하세요.
2단계: 압축 전에 결정 사항 저장하기
수치가 낮아지거나 단계가 끝날 때, 채팅에서 확정된 결정, 이유, 제약 조건을 기록하세요. 저장소 규칙은 AGENTS.md에 넣으세요. 전체 기록이 필요할 것 같다면 채팅을 내보내세요.
3단계: 의도적으로 압축하거나 새로 시작하기
자동 압축을 기다리지 말고 자연스러운 중단점에서 /compact를 실행하세요. 새로운 작업의 경우 새 채팅을 시작하세요. 각 채팅은 하나의 작업 단위로 유지하세요.
MemoryLake에서 설정하기
Context left 수치는 하나의 채팅을 측정합니다. 채팅이 압축되거나 종료될 때 남는 것은 귀하가 기록한 내용뿐입니다. 단일 저장소를 넘어서 적용되거나 다른 도구에서 필요할 결정 사항은 채팅 외부 및 개별 AGENTS.md 외부의 장소가 필요합니다.
MemoryLake는 이러한 결정 사항을 직접 관리하는 하나의 리스트로 유지하여 Codex 및 ChatGPT, Claude Code와 같이 연결된 다른 어시스턴트에서 사용할 수 있게 해주는 메모리 레이어입니다.
항목은 본인의 언어로 직접 작성합니다. Codex 채팅, AGENTS.md 파일, Codex의 로컬 메모리 또는 벤더의 저장소에서 아무것도 읽거나 쓰거나 삭제하지 않습니다. 압축 및 context left 수치는 OpenAI가 설명한 방식 그대로 계속 작동합니다.
1단계: API 키 생성
로그인하고 대시보드에서 키를 생성합니다. 이 키는 MemoryLake 워크스페이스에 속하며 ChatGPT 및 Codex 로그인과는 별개입니다.
2단계: 첫 번째 메모리 업로드
해결책 2단계에서 기록한 내용 중 단일 저장소를 넘어서 적용되는 결정, 이유, 제약 조건부터 시작하세요. 항목당 하나의 포인트를 날짜와 함께 기록합니다.
3단계: AI 및 에이전트 연결
Codex와 사용하는 다른 어시스턴트를 연결하세요. 결정 사항은 다음 채팅, 압축 이후, 그리고 다른 도구에서도 사용할 수 있습니다.
Codex memories v2 가이드는 Codex 자체가 머신에 보관하는 내용을 다루며, 이는 귀하가 유지 관리하는 리스트와 함께 작동합니다.
실제 작업에서의 변화
첫 번째 차이점은 숫자가 더 이상 불안하게 느껴지지 않는다는 것입니다. 이것이 활성 모델의 창을 기준으로 기준선 위에서 하나의 채팅 공간을 측정한다는 것을 알기 때문입니다.
두 번째는 압축으로 인해 결정 사항을 잃어버리지 않게 된다는 것입니다. 자연스러운 중단점에서 중요한 내용을 저장하므로 요약본이 이를 억지로 짊어질 필요가 없습니다.
세 번째는 더 짧고 집중된 채팅입니다. 채팅당 하나의 작업을 유지하면 수치가 의미 있게 유지되고 작업을 다시 시작하기가 쉬워집니다.
Codex의 Context Left 모범 사례
바닥글에 컨텍스트 통계 표시. /statusline을 사용하세요.
수치가 급변할 때 /status 확인. 모델 변경 여부를 가장 먼저 확인해야 합니다.
사용량과 혼동하지 말 것. 계정 제한은 /usage에서 확인합니다.
수치가 낮아지기 전에 조치. 자동 압축은 자체 임계값을 가집니다.
자연스러운 중단점에서 결정 사항 저장. 저장소 규칙은 AGENTS.md에, 나머지는 노트에 저장하세요.
나중에 필요한 긴 채팅은 내보내기. /export는 전체 대화를 Markdown으로 저장합니다.
Codex 업데이트. 0.166.0 버전은 resume 또는 fork 후 조기 압축을 유발할 수 있는 회계 문제를 수정했습니다.
결론
Codex의 context left는 현재 채팅의 context window에 남은 공간의 추정치입니다. 오픈 소스 클라이언트는 고정된 기준선을 제외한 후 활성 모델의 창을 기준으로 이를 측정하므로, 새 채팅은 상단에서 시작하고 모델마다 수치가 다르게 나타납니다.
수치가 떨어질수록 압축이 가까워지며, 자동 압축은 0이 아닌 자체 임계값에서 실행됩니다. 이 숫자를 알림으로 취급하세요. 채팅에서 내린 결정 사항을 저장하고, 기록이 필요하면 내보내고, 원하는 시점에 압축하거나 새로 시작하세요.