KB: 워크스페이스에 저장할 때 발생하는 Git 오류 "청크 헤더를 쓰지 못했습니다"
Updated: November 26, 2025
프로젝트를 워크스페이스에 커밋할 때 “Git 오류: 청크 헤더를 쓰지 못했습니다. 서버와의 연결이 비정상적으로 종료되었습니다”라는 오류가 발생하여 변경 사항을 저장하지 못할 수 있습니다. 이 문제는 일반적으로 상위 디렉터리에 숨겨진 Git 저장소가 있거나 WinHTTP 프록시가 잘못 구성되어 있을 때 발생합니다. 문제를 해결하려면 폴더 구조를 확인하여 충돌하는 Git 저장소가 있는지 살펴보고, 오래된 프록시 설정을 초기화해야 합니다. 임시 해결 방법으로 프로젝트를 깨끗한 디렉터리에 새로 체크아웃할 수도 있습니다.
해결 방법 상세 정보
오류 메시지 및 영향
프로젝트를 워크스페이스에 커밋할 때 다음 오류가 나타날 수 있습니다.

이 오류로 인해 변경 사항을 워크스페이스에 저장할 수 없습니다.
오류의 근본 원인
이 문제는 일반적으로 다음 중 하나의 원인으로 발생합니다.
- 실제 프로젝트 디렉터리 외부의 상위 디렉터리에 최상위 .git 폴더가 있습니다.
- 오래되었거나 숨겨진 WinHTTP 프록시 구성이 Git 작업을 방해하고 있습니다.
사용 가능한 해결 방법
- WinHTTP 재설정
- 상위 디렉터리의 Git 폴더
- 새로 체크아웃
WinHTTP 재설정
시스템의 WinHTTP 설정에 숨겨져 있거나 오래된 프록시 구성이 있으면 이 오류가 발생할 수 있습니다. 프록시를 확인하고 재설정하려면 다음을 수행하세요.
- 관리자 권한으로 명령 프롬프트를 엽니다.
- netsh를 입력하고 Enter 키를 누릅니다.
프롬프트에서 winhttp show proxy를 입력하여 현재 프록시 구성을 확인합니다.netsh>- 프록시가 표시되면 netsh winhttp reset proxy를 입력하여 지웁니다.

상위 디렉터리의 Git 폴더
프로젝트 디렉터리 외부에 .gitC:\Documents\Altium\Project_A
.gitProject_A.gitDocumentsAltiumC:\
새로 체크아웃
문제가 지속되면 프로젝트를 새로 체크아웃합니다.
- 파일 » 프로젝트 열기로 이동합니다.
- 워크스페이스를 선택합니다.
- 프로젝트를 선택하고 열기 버튼 옆의 드롭다운을 클릭합니다.
- 사용자 지정 체크아웃 경로를 선택하고 두 번째 사본 만들기를 선택합니다.
- 원래 디렉터리에서 수정된 파일을 새 체크아웃 폴더로 복사하여 기존 파일을 덮어씁니다.
- Altium Designer에서 새 폴더의 프로젝트를 엽니다.
- 파일을 하나씩 Commit하고 푸시합니다.
자세한 내용은 Altium Designer에서 프로젝트 열기를 참조하세요.
자동 다시 로드 활성화
수정된 파일에 대해 자동 다시 로드가 활성화되어 있는지 확인합니다.
- 환경설정 » 시스템 » 일반으로 이동합니다.
- Altium Designer 외부에서 수정된 문서 다시 로드를 활성화합니다.
IT 팀의 도움
위 단계로도 문제가 해결되지 않으면 IT 팀에 문의하여 프록시나 바이러스 백신의 간섭 가능성을 조사하세요.