Codex의 config.toml에 2줄 추가로 장기 작업용 컨텍스트 관리 활성화하기 (0.152 이전은 오류, 0.153.0부터 인식)
요약
Codex CLI를 사용하여 `context_management` 실험 기능을 활성화하는 방법을 안내합니다. 이 기능은 대화 요약 대신 메모와 기록 검색을 통해 컨텍스트를 관리하여, 장기 작업 시 조건 누락 문제를 개선합니다. 0.153.0 버전부터 설정 파일(`config.toml`)에 추가해야 정상적으로 인식됩니다.
핵심 포인트
- `context_management` 활성화는 `~/.codex/config.toml`에 2줄 추가로 가능합니다.
- 이 기능은 대화 요약 방식이 아닌, 메모와 기록 검색을 통한 컨텍스트 관리입니다.
- 0.153.0 버전 이상에서만 설정 파일 인식이 정상적으로 이루어집니다.
- 토큰 예산 및 기록/메모 기능을 통해 장기 작업의 조건 누락 문제를 개선합니다.
제가 직접 검증한 내용은 2026년 10월 14일입니다. npm을 사용하여 Codex CLI 0.149.1~0.153.0 및 0.161.0 버전을 설치하고, 실제로 codex features list를 실행한 결과입니다. 실험 기능이므로 사양은 향후 변경될 수 있습니다.
결론 (먼저)
~/.codex/config.toml에 2줄을 추가하면, 실험 기능인context_management가true로 설정됩니다. -
0.149.1~0.152.0에서는 설정 로드 시 오류가 발생했습니다. 0.153.0과 0.161.0에서는 인식되었습니다.- 이는 할인(discount) 기능이 아닙니다. 대화를 계속 요약하는 대신, 메모와 기록 검색을 통해 컨텍스트를 관리하는 방식입니다. 효과를 볼 수 있는 경우는 '긴 작업에서 조건이 빠져서 다시 해야 하는' 횟수일 것입니다.
설정 (2줄)
[features.context_management]
experimental_mode = true
이미 [features] 등의 섹션이 있는 경우, 다른 섹션 아래에 묻히지 않도록 주의해야 합니다.
활성화 여부 확인하기
codex --version
codex features list | grep context_management
제가 직접 실행한 결과입니다 (설정 파일은 위의 2줄만 적용).
| Codex CLI | 실행 결과 |
|---|---|
| 0.149.1 | Error: failed to load bootstrap configuration / invalid type: map, expected a boolean |
| 0.150.0 / 0.151.0 / 0.152.0 | 동일한 오류 |
| 0.153.0 | context_management under development true |
| 0.161.0 | context_management under development true |
설정을 작성하지 않은 경우, 0.153.0에서는 under development false가 표시됩니다 (기본값은 OFF). 구형 버전에서 오류가 발생하면, 설정 파일의 작성을 의심하기 전에 CLI를 업데이트하는 것이 좋습니다. 오래된 버전에서는 전체 설정 파일을 로드할 수 없어 Codex 자체가 실행되지 않습니다.
원래대로 되돌리기
true를 false로 변경하거나 2줄을 삭제하면 OFF 상태로 돌아갑니다. 0.153.0에서 experimental_mode = false로 설정했을 때, features list 표시가 false로 돌아오는 것을 확인했습니다. 반영하려면 Codex를 재시작하고 새로운 작업을 시작해야 합니다.
변경되는 기능이란?
0.153.0의 변경점 설명에 따르면, 대상 세션에서 다음 3가지가 활성화됩니다.
- 토큰 예산 (Token budget): 활성 컨텍스트를 정해진 크기 안에 유지합니다.
- 기록과 메모 (History and memo): 요점을 메모로 남기고, 오래된 대화도 필요할 때 검색하여 가져올 수 있습니다.
new_context:
요약하지 않고 새로운 컨텍스트 창으로 전환하며, 메모와 기록을 계승합니다.
기존의 압축 방식은 상한선에 가까워질수록 전체 대화를 요약하는 방식이었습니다. 따라서 초반의 세부 조건이 누락되기 쉬웠다는 것이 개선 포인트입니다.
대상이 되는 사람 / 아닌 사람
대상: ChatGPT의 Plus / Pro / Pro Lite로 로그인하여 일반 Codex 백엔드를 사용하는 세션.
대상 외: API 키 인증, 독자 프로바이더, 임시 구조화 스레드 등.
주의할 점은, features list가 true여도 해당 세션에서 실제로 작동한다고 보장할 수는 없다는 것입니다. 플랜이나 인증 방식의 판별은 세션을 시작할 때 이루어지기 때문입니다. 이번 검증 환경에서는 기능을 활성화하는 것까지만 확인했으며, 장시간 작업에서의 효과는 측정하지 못했습니다.
'저렴해진다'고 말할 수 있을까?
| 주장 | 판정 | 근거 |
|---|---|---|
| 설정이 실재하며 0.153.0 이후 인식됨 | ◎ | 직접 실행하여 확인 |
| ... |
자신의 환경에서 측정하기 (기록용 템플릿)
같은 종류의 작업을, 설정을 ON/OFF로 각각 3번 정도 비교하는 것이 가장 쉽습니다.
date,task_id,context_management,codex_version,re_explain_count,fix_due_to_lost_context,elapsed_min,usage_note
,,off,,,,,
,,on,,,,,
API 요청, 정액 플랜 이용 한도, 사람이 재작업에 쓴 시간은 혼합하지 말고 기록하세요.
요약
- 설정은 2줄입니다.
0.153.0부터 인식하며, 0.152.0 이전에는 오류가 발생하여 실행되지 않습니다 (직접 확인). - 대상은 ChatGPT Plus / Pro / Pro Lite에서 Codex 백엔드를 사용하는 경우입니다. API 키 이용은 대상에서 제외됩니다. - 판단의 기준은 '저렴해지는가'가 아니라 '재작업이 줄어드는가'입니다. 측정하려면 자신의 작업으로 전후 비교를 해보세요.
CauchyE ASIA는 싱가포르에 기반을 둔 IT 및 AI 솔루션을 제공합니다. AI 도입 상담은 여기로 문의하세요.
추가 로그
- 2026-10-14: 초안. Codex CLI 0.149.1~0.153.0과 0.161.0으로 실행하여 확인.
토론

AI 자동 생성 콘텐츠
본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기