체크포인트 (Checkpoint)

체크포인트(Checkpoint)는 작업을 다시 이어가거나 이전 상태로 돌아가기 위해 특정 시점의 상태를 저장한 기록입니다. AI 학습에서는 모델 가중치와 학습 진행 정보를, 코딩 도구에서는 편집한 파일이나 대화 상태를 저장하는 데 쓰입니다. 무엇을 복구할 수 있는지는 체크포인트에 실제로 포함한 데이터에 따라 달라집니다.

학습을 이어가기 위한 상태 저장

AI 모델을 오래 학습하다가 실행이 중단되면 마지막으로 저장한 상태에서 다시 시작할 수 있습니다. PyTorch의 모델 저장·불러오기 문서는 학습 재개용 체크포인트에 모델의 state_dict뿐 아니라 옵티마이저 상태와 에포크 등의 정보를 저장하는 예시를 제시합니다. 가중치는 그때까지 학습한 수치를, 나머지 상태는 다음 갱신을 이어갈 조건을 담습니다.

추론에 사용할 모델 파일과 학습을 중단 지점부터 재개할 파일은 필요한 정보가 다릅니다. 모델의 출력만 계산하려면 학습 중 갱신 규칙이 기억한 상태가 필요하지 않은 경우가 많지만, 학습을 이어가려면 그 상태가 중요합니다. 가중치만 저장한 파일을 불러와 새 옵티마이저로 시작하면 같은 가중치에서 출발하더라도 원래 학습의 연속과는 조건이 달라집니다.

어느 시점의 체크포인트를 사용할지도 별도의 선택입니다. 마지막에 저장한 파일과 검증 결과가 가장 좋았던 파일은 다를 수 있습니다. 학습이 끝났다는 이유만으로 마지막 파일을 최선의 모델로 부르면 선택 기준이 빠집니다. 저장 시각, 학습 단계, 검증 지표, 사용한 설정을 연결해 두면 모델을 다시 불러왔을 때 어떤 실험의 결과인지 확인하기 쉽습니다.

저장된 수치와 실행 코드의 구분

TensorFlow의 체크포인트 안내는 체크포인트가 변수 값을 저장하며, 모델이 수행하는 연산의 설명을 포함하는 것은 아니라고 구분합니다. 저장된 수치를 사용하려면 이에 맞는 모델 구조와 코드가 필요합니다. 체크포인트 파일 하나만 복사하면 어떤 환경에서도 같은 모델을 바로 실행할 수 있다고 가정하면 필요한 의존성이나 구성을 빠뜨릴 수 있습니다.

변수의 이름과 모양이 달라진 모델에 예전 가중치를 불러오면 일부가 맞지 않을 수 있습니다. 구조를 확장하면서 일부 가중치만 재사용하는 경우에는 무엇을 불러왔고 무엇을 새로 초기화했는지 구분합니다. 로딩 명령이 오류 없이 끝났다는 사실만 확인하면 원하는 파라미터가 실제로 복원됐는지 놓칠 수 있습니다. 경고와 누락 정보를 확인한 뒤 대표 입력으로 동작을 비교합니다.

학습을 같은 조건으로 재개하려면 데이터 처리 순서와 난수 상태처럼 모델 밖의 정보도 검토 대상이 됩니다. 어느 정보를 저장하는지는 학습 코드와 프레임워크에 달려 있습니다. 동일한 결과 재현이 필요한 실험에서는 체크포인트 목록과 함께 코드 버전, 의존성, 입력 데이터의 식별 정보를 보관합니다. 저장한 상태의 범위를 명시해야 단순 재개와 결과 재현을 구별할 수 있습니다.

코딩 도구에서 되돌릴 수 있는 범위

코딩 도구의 체크포인트는 학습 가중치 대신 작업 중인 파일을 대상으로 할 수 있습니다. 2026년 10월 11일 UTC에 확인한 Claude Code의 체크포인트 문서는 편집 도구로 바꾼 파일을 추적하고 /rewind에서 코드나 대화를 복원하는 방법을 설명합니다. 대화만 되돌릴지 파일도 되돌릴지에 따라 결과가 달라지므로 복원 대상을 구분합니다.

같은 문서는 Bash 명령으로 바꾼 파일을 체크포인트가 추적하지 않는다고 설명합니다. 셸에서 파일을 옮기거나 삭제한 동작까지 편집 도구의 되돌리기로 복구된다고 기대하면 범위를 잘못 이해하게 됩니다. 원격 데이터베이스 수정이나 이미 보낸 요청도 로컬 파일의 과거 상태를 불러오는 것만으로 취소되지 않습니다. 작업의 부작용이 파일 밖에 있는지 함께 확인합니다.

체크포인트는 빠른 복구를 돕는 기능이며 보관 기한과 지원 범위가 제품별로 다릅니다. 장기 이력과 협업에는 Git 같은 버전 관리 기록을 함께 사용합니다. 파일 내용을 특정 커밋으로 남기는 일, 원격 저장소에 백업하는 일, 도구 안에서 잠시 되돌릴 지점을 만드는 일은 보존 범위가 다릅니다. 복구가 필요한 시점에는 저장된 기록의 이름보다 실제 파일과 외부 상태가 어디까지 남았는지가 기준이 됩니다.