공개 저장소는 fast-jev-compaction이 도구 호출과 결과를 선별하거나 잘라내고 보존할 수 있다고 설명합니다(저장소의 압축 동작 설명). 따라서 문맥이 사라졌을 때 바로 압축 강도를 높이면 안 됩니다.
증상 → 가장 빠른 해결: 압축이 작동하지 않거나 결과가 비어 있으면 먼저 플러그인 로딩, Jev 요청, 압축 정책, Claude Code 자체 한계를 분리해 기록합니다. 핵심 파일과 테스트 결과를 고정 요약 파일에 저장한 뒤 자동 압축을 단계적으로 다시 켭니다.
이 글은 fast-jev-compaction이 갑자기 작동하지 않는 Claude Code 사용자에게 맞습니다.
장기 AI 코딩 작업에서 무엇을 남겨야 하는지, 원격 맥에서 어떻게 로그와 복구 지점을 관리할지 확인하려는 팀에도 유용합니다.
장애 범위 분리
작업이 최종적으로 실패했다는 사실만으로 압축 플러그인을 원인으로 단정할 수 없습니다. 아래처럼 서로 다른 증상을 먼저 나눠야 합니다.
| 관찰된 증상 | 우선 의심할 원인 | 먼저 남길 기록 | 다음 판단 |
|---|---|---|---|
| 압축 로그가 전혀 없음 | 플러그인 미로딩, 설정 경로 불일치 | 세션 시작 기록, 설정 경로 | 현재 작업 공간이 설정을 읽는지 확인 |
| 호출 기록은 있으나 결과가 없음 | Jev 인증, 네트워크, 응답 형식 | 요청 오류, 응답 상태 | 기본 압축 또는 수동 요약으로 전환 |
| 압축 뒤 오래된 결과만 사라짐 | 압축 정책의 선택·삭제 동작 | 압축 전후 요약 | 보존 목록을 고정 |
| 파일 설명과 테스트 상태가 함께 사라짐 | 핵심 정보가 요약 대상에 포함됨 | 파일 경로, 테스트 결과 | 새 요약 파일에서 상태 재구성 |
| 작업이 중단되지만 압축 기록은 정상 | Claude Code 자체 제한 또는 다른 도구 오류 | 도구 호출과 명령 결과 | 플러그인을 끄고 재현 |
압축 전후의 문맥 요약, 모델 응답, 도구 호출 결과를 같은 세션 식별자와 연결해 저장해야 합니다. 이 기록이 없으면 “압축이 실패했다”와 “압축은 성공했지만 필요한 내용이 버려졌다”를 구별하기 어렵습니다.
플러그인 로딩과 설정 경로
Claude Code는 실행 위치와 설정 계층에 따라 읽는 파일이 달라질 수 있습니다. 공식 설정 문서는 사용자 설정과 프로젝트 설정, 작업 공간에서만 적용되는 설정을 구분합니다(Claude Code 설정 파일과 적용 범위). 원격 맥이나 컨테이너에서는 호스트의 홈 경로와 작업 공간 내부 경로가 더 달라질 수 있습니다.
확인 순서는 다음과 같이 잡는 편이 안전합니다.
- 현재 셸에서 Claude Code를 시작한 위치를 기록합니다.
- fast-jev-compaction의 설치 위치와 현재 세션이 참조하는 플러그인 위치를 비교합니다.
- 설정 파일이 실제 작업 공간에 적용되는지 확인합니다.
- 플러그인 버전, 의존성, 실행 권한을 확인합니다.
- 세션 시작 로그에서 초기화 기록을 찾습니다.
- 압축 조건에 도달한 뒤 Jev 호출 기록이 생성되는지 확인합니다.
- 전역 설정과 프로젝트 설정이 같은 항목을 덮어쓰는지 비교합니다.
Claude Code의 실행 옵션은 명령줄 동작과 세션 시작 방식을 바꿀 수 있으므로, 평소의 셸 명령과 원격 자동 실행 명령을 따로 기록해야 합니다(Claude Code 명령줄 사용법). 터미널에서 직접 실행할 때는 작동하지만 원격 작업 관리자나 컨테이너에서만 실패한다면 플러그인 자체보다 환경 변수와 경로 차이를 먼저 의심해야 합니다.
실제 장기 작업에서 자주 생기는 혼동
예를 들어 로컬 터미널에서는 플러그인 초기화 로그가 보이는데 원격 맥의 작업 공간에서는 같은 로그가 보이지 않을 수 있습니다. 이때 설치 명령을 반복하기보다 다음을 비교해야 합니다.
- 로그인 셸과 비로그인 셸의 환경 변수
- 호스트 경로와 작업 공간 경로
- 수동 실행과 자동 실행의 사용자 권한
- 전역 설정과 프로젝트 설정
- 컨테이너 안에서 보이는 인증 변수
장점은 원인을 비교적 빠르게 좁힐 수 있다는 점입니다. 단점은 설정이 여러 위치에 흩어지면 “설치되어 있다”는 사실만으로 현재 세션의 로딩을 증명할 수 없다는 점입니다.
Jev 요청과 네트워크 경로
플러그인이 로드되어도 Jev 요청이 성공한다는 보장은 없습니다. 인증 변수 누락, 네트워크 출구 차단, 프록시 인증서, 요청 시간 초과, 예상과 다른 응답 형식이 각각 독립적인 원인이 될 수 있습니다. 공식 문서도 기업용 프록시와 인증서 문제를 별도 점검 대상으로 안내합니다(프록시와 인증서 점검 방법).
| 점검 항목 | 확인할 내용 | 실패 때의 대체 경로 |
|---|---|---|
| 인증 | 현재 세션에 필요한 변수가 전달됐는지 | 원격 압축을 끄고 기본 압축 사용 |
| 네트워크 | 원격 맥의 출구와 프록시가 요청을 허용하는지 | 고정 요약 파일로 수동 압축 |
| 응답 형식 | 플러그인이 기대하는 구조와 실제 응답이 일치하는지 | 오류 응답을 저장하고 새 세션으로 전환 |
| 권한 | 실행 사용자와 인증서 읽기 권한이 맞는지 | 같은 작업 공간에서 수동 재현 |
| 서비스 상태 | 요청이 도달했는지와 실패 지점 | 대화 상태를 별도 파일로 보존 |
여기서 중요한 점은 Jev 요청 실패가 Claude Code의 모든 기능 실패와 같지 않다는 것입니다. 압축 서비스에 의존하는 부분만 실패할 수 있으므로, 플러그인을 끄고 기본 압축이나 사람이 작성한 요약으로 작업을 계속할 수 있는지 먼저 확인해야 합니다.
실패율이나 처리 시간, 서비스 한도를 근거 없이 단정해서는 안 됩니다. 공개 자료나 실제 로그가 없는 상태에서 “항상 빠르다” 또는 “특정 비율로 실패한다”고 쓰는 것은 구매와 운영 판단에 도움이 되지 않습니다.
손실 문맥과 복구 순서
문맥 압축은 백업이 아닙니다. 정보를 다시 구성하는 과정이므로, 오래된 도구 결과나 반복 설명이 사라질 수 있습니다. Claude Code의 메모리 파일과 적용 범위도 별도로 확인해야 합니다(Claude Code 메모리 파일 안내).
장기 작업을 시작하기 전에 고정 요약 파일에 다음 내용을 기록하십시오.
- 변경 대상 파일의 전체 경로
- 이미 통과한 테스트와 실패한 테스트
- 아직 끝나지 않은 작업
- 외부 인터페이스와 입력 형식의 제약
- 사용자가 승인했거나 거부한 선택
- 되돌리면 안 되는 변경
- 다음 세션에서 먼저 실행할 확인 명령
복구는 아래 순서로 진행하는 것이 안전합니다.
- 현재 대화와 저장소의 변경 상태를 보존합니다.
- 마지막으로 정상인 세션 식별자와 압축 전 요약을 찾습니다.
- 고정 요약 파일과 실제 파일 내용을 다시 읽힙니다.
- 테스트를 다시 실행해 모델의 기억이 아닌 저장소 상태를 기준으로 판단합니다.
- 미완료 작업을 작은 단위로 다시 나눕니다.
- 같은 손실이 반복되면 fast-jev-compaction을 끄고 기본 압축이나 새 세션으로 이동합니다.
Claude의 긴 문맥 작업에서도 상태를 명시적으로 관리하는 방식이 권장됩니다(긴 문맥 작업과 상태 관리 안내). 특히 데이터베이스 변경, 권한 변경, 배포 설정처럼 되돌리기 어려운 작업은 자동 압축 결과만 믿지 말고 사람이 diff와 테스트 결과를 확인해야 합니다.
원격 맥 관찰 체계
원격 맥에서 장기 Claude Code 세션을 운영한다면 로그를 한곳에 모으기보다 다음 항목을 같은 작업 식별자 아래에 연결하십시오.
- 세션 시작과 종료 기록
- 플러그인 초기화 기록
- Jev 요청과 응답 오류
- 압축 전후의 요약
- 도구 호출과 명령 결과
- 저장소 변경 상태
- 사람이 승인한 체크포인트
| 작업 유형 | 자동 압축 운영 | 필수 체크포인트 | 중단 기준 |
|---|---|---|---|
| 개발 탐색 | 낮은 강도로 관찰 | 파일 경로와 조사 결론 | 같은 정보가 반복해서 사라짐 |
| 테스트 수정 | 핵심 상태를 자주 저장 | 테스트 결과와 실패 원인 | 테스트 기준이 대화마다 달라짐 |
| 배포에 가까운 작업 | 보수적으로 운영 | 변경 전후 설정과 승인 기록 | 원인 추적 없이 파일이 바뀜 |
| 권한·데이터 변경 | 자동 삭제를 피함 | 사람이 확인한 diff와 복구 지점 | 핵심 제약이 요약에서 누락됨 |
다음 조건이면 자동 압축을 멈추는 편이 낫습니다.
- 압축 전후 비교 기록을 만들 수 없습니다.
- 핵심 파일 목록이 요약에서 계속 사라집니다.
- Jev 요청 실패가 반복되지만 대체 경로가 준비되지 않았습니다.
- 모델이 이미 완료한 작업과 미완료 작업을 구분하지 못합니다.
- 고위험 쓰기 작업을 사람이 확인할 체크포인트가 없습니다.
작업 공간 자체의 권한과 원격 접속 로그도 함께 확인해야 합니다. Kvmjet의 인프라 운영 정보를 검토하면 원격 맥 환경을 선택할 때 접속 방식과 운영 조건을 비교하는 데 도움이 됩니다. 문제를 재현할 수 없거나 세션 기록이 부족하다면 도움말 센터에서 필요한 로그 항목을 먼저 정리하는 것이 좋습니다.
선택 기준 표
| 선택지 | 적합한 상황 | 장점 | 단점 |
|---|---|---|---|
| fast-jev-compaction 유지 | 로딩과 요청이 검증되고 요약 품질을 관찰할 수 있음 | 자동화된 문맥 정리 | 정책에 따라 오래된 결과가 사라질 수 있음 |
| 기본 압축 사용 | Jev 네트워크가 불안정하거나 인증이 불명확함 | 외부 요청 의존성 감소 | 직접 상태를 관리해야 함 |
| 수동 요약 파일 | 핵심 파일과 결정 사항을 반드시 보존해야 함 | 복구 기준이 명확함 | 작업자가 지속적으로 갱신해야 함 |
| 새 세션으로 전환 | 현재 대화의 상태가 오염되었거나 반복 손실이 발생함 | 깨끗한 작업 상태에서 재시작 | 초기 문맥을 다시 제공해야 함 |
결정 순서는 간단합니다. 플러그인 초기화 기록이 없으면 설정과 실행 경로를 고칩니다. 초기화 기록은 있지만 요청 오류가 있으면 네트워크와 인증을 확인합니다. 요청은 성공하지만 핵심 정보가 사라지면 보존 목록과 요약 파일을 강화합니다. 세 경로가 모두 정상인데도 작업이 흔들리면 플러그인을 끄고 Claude Code 기본 동작과 새 세션을 비교합니다.
현재 방식이 로컬 개발 장비나 일반 클라우드 셸에 의존한다면, 환경 변수 누락, 화면 세션 종료, 권한 차이 때문에 장기 작업을 재현하기 어렵다는 단점이 있습니다. 반면 Kvmjet의 원격 맥을 임시 작업 환경으로 사용하면 작업 공간을 분리하고 장기 세션의 로그와 체크포인트를 한 환경에 모으기 쉽습니다. 다만 물리 장비가 반드시 필요하거나 계속되는 고강도 작업이라면 직접 구매나 전용 운영 환경이 더 적합할 수 있습니다. 테스트용 원격 맥이 필요하거나 환경을 먼저 검증하려는 경우에는 Kvmjet 문의 안내에서 작업 조건을 설명하고 판단하는 편이 안전합니다.
자주 묻는 내용
FAQ는 위 메타데이터에 함께 제공합니다. 핵심은 자동 압축을 백업으로 취급하지 않고, 플러그인 로그와 고정 요약 파일을 별도로 보존하는 것입니다. 특히 고위험 코드 변경에서는 압축 결과보다 실제 파일 상태, 테스트 결과, 사람이 승인한 체크포인트를 우선해야 합니다.
오래 이어지는 개발 작업을 위한 원격 맥을 시작해 보세요
Kvmjet에서 필요한 성능의 맥을 대여해 문맥 압축 문제로 멈춘 작업을 안정적으로 이어갈 수 있습니다.
원격 접속 환경에서 핵심 파일과 테스트 결과를 관리하며 개발 흐름을 유지할 수 있습니다.