GitHub Copilot 로컬 샌드박스, 실습 PC에서 켜기 전에 정할 것

수업용 PC에서 학생이 GitHub Copilot 에이전트에게 테스트 실행을 맡기면, 그 명령이 실습 폴더 밖의 파일이나 PC에 저장된 Git 로그인 정보까지 쓸 수 있는지가 먼저 걱정됩니다(예시). GitHub은 2026년 10월 7일 공식 변경 기록에서 GitHub Copilot의 로컬 샌드박스를 정식 제공(GA, 시험 단계를 마친 정식 버전)한다고 발표했습니다. 로컬 샌드박스는 에이전트가 실행하는 명령이 PC 안에서 접근할 수 있는 범위를 제한하는 기능이며, 추가 비용은 없습니다. 다만 공식 문서는 이 기능이 기본으로 꺼져 있다고 적었습니다. 실습 PC를 관리한다면 켜는 방법과 함께 운영체제 조건, 샌드박스가 막지 못하는 범위를 먼저 확인해야 합니다. 아래 내용은 공식 자료의 문장을 근거로 정리했고, 기능을 직접 실행해 보지는 않았습니다.

1. 변경 기록이 밝힌 내용

GitHub 변경 기록은 "Local sandboxing for GitHub Copilot is now generally available in GitHub Copilot CLI, the GitHub Copilot app, and VS Code sessions using Agent Host."라고 적었습니다. 정식 제공 대상은 Copilot CLI(터미널에서 쓰는 명령줄 도구), GitHub Copilot 앱, Agent Host를 쓰는 VS Code 세션입니다. 비용은 "Local sandboxing is included with GitHub Copilot at no additional cost."라고 밝혔습니다.

변경 기록은 제한할 수 있는 범위로 "Limit the files and directories that agent-run commands can read or modify."와 "Control access to the internet, local networks, Git credentials, and GitHub CLI credentials."를 들었습니다. 에이전트가 실행한 명령이 읽거나 고칠 수 있는 파일·폴더를 정하고, 인터넷, 로컬 네트워크(같은 건물이나 사무실 안의 네트워크), Git 자격 증명, GitHub CLI 자격 증명(로그인 정보) 접근을 조절할 수 있다는 뜻입니다.

변경 기록은 "Model execution and tool isolation are separate concerns."라고도 적었습니다. 어떤 모델이 답을 만드는지와 명령을 어디까지 실행하게 할지는 별개로 다룬다는 설명입니다. 작성자 판단으로는 실습에서 쓰는 모델을 바꾸더라도 샌드박스 설정은 따로 확인해야 합니다.

2. 기본값은 꺼져 있습니다

날짜가 표시되지 않은 GitHub 공식 문서는 "Local sandboxing is turned off by default."라고 적었습니다. 공식 문서에 따르면 Copilot CLI 세션 안에서는 /sandbox enable 명령으로 켭니다. Copilot 앱에서는 프로젝트 설정이 새 로컬 세션의 기본값을 정하고, 진행 중인 세션에서도 바꿀 수 있다고 문서가 적었습니다. CLI와 앱의 설정은 따로 관리되어 한쪽을 켜도 다른 쪽은 바뀌지 않습니다. VS Code 세션에서 켜는 방법은 이 글의 근거 자료 범위에서 확인하지 못했습니다.

작성자는 실습을 준비할 때 이 기본값부터 확인하시길 권합니다. Copilot을 설치했다고 샌드박스가 적용된 것은 아니기 때문입니다. 실습 PC 준비 점검표에 '샌드박스 켜짐 확인'을 별도 항목으로 넣어 두십시오. 문서에 날짜가 없어 문서 내용이 10월 7일 발표 이후 기준인지는 확인하지 못했습니다.

3. 실습 PC에서 허용할 범위 정하기

아래 도식은 변경 기록이 밝힌 제한 항목을 실습 PC 1대 안에 배치해 본 것입니다.

제한 항목과 운영체제 조건은 GitHub 변경 기록(2026년 10월 7일)과 GitHub 공식 문서(날짜 표시 없음)의 내용을 작성자가 한국어로 옮겼습니다. '실습 폴더'는 작성자가 든 예시이며, 상자 배치와 연결선은 작성자가 구성했습니다.

아래 표의 '실습 PC 예시 설정' 열은 작성자가 만든 교육 예시입니다. 실제 설정 항목의 이름과 지정 방법은 공식 문서에서 확인하십시오.

제한 항목	변경 기록에 적힌 내용	실습 PC 예시 설정
파일·폴더	명령이 읽거나 수정할 수 있는 파일과 디렉터리 제한	그날 쓰는 실습 폴더만 읽기·수정 허용
인터넷	인터넷 접근 조절	패키지 설치가 필요한 실습에서만 허용
로컬 네트워크	로컬 네트워크 접근 조절	교육장 공유 폴더와 내부 서버 접근 차단
Git 자격 증명	Git 자격 증명 접근 조절	교육장 공용 계정 정보는 쓰지 못하게 설정
GitHub CLI 자격 증명	GitHub CLI 자격 증명 접근 조절	실습에 필요 없으면 차단

로컬 네트워크와 자격 증명을 표에 따로 둔 이유가 있습니다. 실습실 PC는 여러 사람이 번갈아 쓰기 때문에, 이전 수업에서 로그인한 계정 정보나 교육장 공유 폴더 연결이 그대로 있을 수 있습니다. 작성자 판단으로는 이런 PC일수록 파일 범위보다 자격 증명과 내부 네트워크 접근을 먼저 막는 편이 안전합니다.

4. 운영체제마다 조건이 다릅니다

공식 문서는 운영체제별 조건을 따로 적었습니다. macOS는 15 이상을 권장하고, Linux는 bubblewrap(리눅스에서 프로그램을 격리해 실행하는 도구) 0.5.0 이상이 필요하며, Windows는 최신 Windows 11이 필요하다고 했습니다. Windows 11의 어느 업데이트부터 쓸 수 있는지는 이 글의 근거 자료 범위에서 확인하지 못했습니다.

여러 기종이 섞인 실습실이라면 PC마다 운영체제 버전을 적은 목록부터 만드십시오. 공식 문서에 따르면 지원하지 않는 PC에서는 저장해 둔 켜기 설정이 그 세션에서 꺼지고 /sandbox enable도 거부됩니다. 조건에 맞지 않는 PC에는 '샌드박스 미적용'이라고 표시해 두고, 그 PC에서는 에이전트에게 명령 실행을 맡기는 실습을 빼는 편이 안전합니다.

5. 샌드박스가 해 주지 않는 일

공식 문서는 로컬 샌드박스가 "it does not run your commands inside a separate virtual machine or container"라고 적었습니다. 가상 머신(PC 안에 만든 별도의 가상 컴퓨터)이나 컨테이너 안에서 명령을 실행하는 방식은 쓰지 않는다는 뜻입니다. 공식 문서는 이 방식을 가벼운 격리로 설명합니다.

그래서 작성자는 샌드박스만으로 실습 PC의 자료를 보호할 수 있다고 보지 않으시길 권합니다. 시험 문제, 성적 파일, 다른 수강생의 결과물처럼 노출되면 안 되는 자료는 처음부터 실습 PC에 두지 마십시오. 샌드박스는 그렇게 정리한 PC에서 에이전트 명령의 범위를 한 번 더 좁히는 용도로 쓰면 됩니다.

또 하나 알아 둘 점이 있습니다. 공식 문서는 Copilot CLI의 내장 파일 도구가 CLI 안에서 직접 실행되어 운영체제 샌드박스가 제한하지 못하고, 도구가 샌드박스 정책을 스스로 확인해 "best-effort"(최선을 다하는 수준)로 따른다고 적었습니다. 셸 명령과 같은 강도의 차단을 기대하지 않는 편이 좋습니다.

6. 이번 주에 해 볼 일

실습실 PC 1대를 골라 운영체제 버전이 4번의 조건에 맞는지 확인하십시오. 조건이 맞으면 Copilot CLI 세션에서 /sandbox enable로 샌드박스를 켜고, 3번 표처럼 그날 실습 폴더만 허용하는 범위를 적어 봅니다. 그다음 허용하지 않은 폴더의 파일을 셸 명령으로 읽어 달라는 요청을 에이전트에게 보내 실제로 막히는지 확인합니다. 결과를 PC 기종, 운영체제 버전, 막힌 항목, 막히지 않은 항목으로 기록해 두면 다음 수업의 실습 PC 준비 점검표에 그대로 옮길 수 있습니다.