로컬 샌드박싱 사용

운영 체제 샌드박스 내에서 사용자 대신 호출하는 명령 및 도구를 실행하도록 코파일럿 CLI 로컬 샌드박싱을 사용하도록 설정합니다.

이 기사에서

참고

로컬 샌드박스가 GitHub Copilot 있으며 공개 미리 보기 변경될 수 있습니다.

중요

Windows 로컬 샌드박싱에는 Windows 참가자 빌드가 필요합니다.

로컬 샌드박싱 정보

샌드박싱은 현재 실험적 기능입니다. 이 기능을 사용하려면 코파일럿 CLI 명령줄 옵션으로 ‑‑experimental을 시작하거나, 세션 중에 /experimental on를 입력하세요.

로컬 샌드박싱을 코파일럿 CLI 사용하도록 설정하면 운영 체제 샌드박스 내에서 사용자 대신 호출하는 대부분의 명령과 도구를 실행합니다. 로컬 샌드박싱을 사용하도록 설정한 후에는 사용하지 않도록 설정하거나 특정 세션에 대해 해제할 때까지 모든 코파일럿 CLI 세션에 사용됩니다.

기본적으로 샌드박스 명령 및 도구는 현재 작업 디렉터리 및 임시 폴더 내에서 작성할 수 있습니다. 시스템 및 도구 위치와 함께 사용자 프로필(홈) 디렉터리가 읽기 전용입니다. 다른 디스크 위치가 차단됩니다. Git 리포지토리에서 현재 작업 디렉터리 위의 액세스는 운영 체제에 따라 다릅니다. 아웃바운드 인터넷 액세스와 마찬가지로 로컬 및 프라이빗 네트워크에 대한 액세스가 허용됩니다.

기본적으로 인증된 Git 및 GitHub CLI (gh) 작업은 샌드박스 내에서 계속 작동합니다. 샌드박스 코파일럿 CLI 명령에서 자격 증명을 사용할 수 있기 GitHub 때문입니다. 이렇게 하면 성공과 gh pr create 같은 git push 작업을 수행할 수 있습니다. 샌드박스 설정에서 이 기능을 해제할 수 있습니다.

샌드박싱 코파일럿 CLI에 대한 개념적 개요는 클라우드 및 로컬 샌드박스 정보 GitHub Copilot을 참조하세요.

로컬 샌드박스 활성화

로컬 샌드박싱을 사용하도록 설정하려면 대화형 코파일럿 CLI 세션에서 다음 명령을 입력합니다.

Shell
/sandbox enable

샌드박싱은 현재 세션에 즉시 사용되기 시작합니다.

로컬 샌드박싱을 사용하도록 설정하면 현재 및 향후 대화형 세션 및 프로그래밍 방식 세션에 계속 사용됩니다.

참고

입력 /sandbox enable할 때 다른 세션이 열려 있는 경우 샌드박싱은 해당 세션에서 즉시 사용되지 않습니다. 이미 열려 있는 세션에서 샌드박싱을 사용하려면 해당 세션에서 다음 중 하나를 수행합니다.

  • 세션을 닫고 다시 시작합니다(예: 를 실행하여) copilot --continue.

/sandbox enable를 입력합니다.

로컬 샌드박싱 사용 안 함으로 설정

로컬 샌드박싱 사용을 중지하려면 대화형 코파일럿 CLI 세션에서 다음 명령을 입력합니다.

Shell
/sandbox disable

샌드박싱은 현재 세션이나 새 세션 및 다시 시작한 세션에서 더 이상 사용되지 않습니다.

로컬 샌드박싱을 사용할지 여부는 CLI에 대한 개인 설정 파일의 설정으로 sandbox.enabled 저장됩니다(~/.copilot/settings.json 기본적으로).

단일 세션에 샌드박싱 사용

명령줄 옵션을 사용하여 다른 세션에 샌드박싱을 사용하도록 설정하지 않고 단일 세션에 샌드박싱을 사용할 --sandbox 수 있습니다. 샌드박싱을 이미 사용하도록 설정한 경우 이 옵션을 사용하여 --no-sandbox 단일 세션에 대해 사용하지 않도록 설정할 수 있습니다.

이러한 옵션을 명령줄 옵션과 -p 결합하여 CLI의 프로그래밍 방식으로 사용할 샌드박싱을 제어할 수 있습니다. 다음은 그 예입니다.

Shell
copilot --sandbox -p "PROMPT"

샌드박스 외부에서 단일 명령 실행

명령에 샌드박스가 허용하는 Copilot 것보다 더 광범위한 액세스 권한이 필요한 경우 샌드박스 외부에서 해당 단일 명령을 실행하도록 요청할 수 있습니다. 명령을 설명하는 확인 프롬프트가 표시되고 승인한 경우에만 샌드박스 외부에서 실행됩니다. 그렇지 않으면 샌드박스로 유지됩니다. 세션의 나머지 부분도 어느 쪽이든 샌드박스로 유지됩니다.

이 동작은 기본적으로 사용하도록 설정되며 샌드박스 설정에서 해제할 수 있습니다.

샌드박싱 사용 여부 확인

샌드박싱이 현재 세션에 사용되고 있는지 확인하려면 상태 줄을 확인합니다. 샌드박싱을 사용하는 경우 상태 줄에 포함됩니다 sandbox enabled.

상태 줄의 샌드박스 정보 표시는 기본적으로 설정되어 있습니다. 꺼져 있는 경우 다시 켤 수 있습니다.

  1. /statusline를 입력합니다.
  2. 선택 영역을 샌드박스로 옵션 목록 아래로 이동합니다.
  3. Enter 키를 눌러 확인 표시가 표시되도록 설정을 전환합니다.

추가 읽기