이 문서에서는 세션의 Copilot CLI 원격 제어에 대한 개념을 설명합니다. 원격 제어를 사용하도록 설정하는 방법에 대한 지침은 다른 장치에서 세션 조정 GitHub Copilot CLI을 참조하세요.
원격 제어가 도움이 되는 경우
기본적으로 GitHub Copilot CLI 세션은 로컬 컴퓨터에서만 조종할 수 있습니다. 그러나 세션의 원격 제어를 사용하도록 설정할 수 있습니다. 원격 제어는 세션이 실행 중인 컴퓨터에 남아 있을 필요 없이 진행률을 보거나 프롬프트 및 권한 요청에 응답하려는 경우에 유용합니다. 다음은 그 예입니다.
- 워크스테이션에서 한 걸음 물러나면 세션이 실행 중인 컴퓨터로 Copilot 돌아가지 않고 휴대폰 또는 다른 장치에서 계속 상호 작용할 수 있습니다.
- 장기 실행 작업에는 사용자 입력이 필요합니다. 권한 요청을 승인하고 질문에 답변하면 작업이 차단되지 않습니다.
- 빠른 상태 검사를 원합니다. 다른 작업을 하는 동안의 세션 진행률을 GitHub Mobile 한눈에 볼 수 있습니다.
필수 조건
원격 제어에는 다음이 필요합니다.
- 정책 사용: 사용자 Copilot 자리가 조직에서 온 경우 엔터프라이즈 또는 조직 소유자는 "클라우드에 로컬 세션 저장" 정책을 "보기 및 제어"(기본적으로 구성되지 않음)로 설정해야 합니다. 이 문서의 뒷부분에서 원격 제어 관리를 참조하세요.
- 컴퓨터는 온라인 상태여야 합니다. CLI 세션은 인터넷 연결이 있는 컴퓨터의 터미널에서 적극적으로 실행되어야 합니다. 컴퓨터가 절전 모드로 이동하거나 연결이 끊어지면 컴퓨터가 다시 온라인 상태가 될 때까지 원격 제어를 사용할 수 없습니다. 이 문서의 뒷부분에서 다시 연결을 참조하세요.
- 대화형 세션: 원격 액세스는 대화형 세션에만 사용할 수 있습니다. 명령줄 옵션과 함께 프로그래밍 방식으로 CLI를
--prompt사용하는 경우(예: 스크립트에서 CLI를 사용하는 경우) 사용할 수 없습니다.
원격 제어는 작업 디렉터리에 호스트 GitHub.com된 Git 리포지토리를 포함할 필요가 없습니다. 사용자의 Copilot 시트가 엔터프라이즈 또는 조직에서 제공된 경우, 원격 제어를 사용할 수 있는지는 리포지토리 호스팅이 아니라 해당 엔터프라이즈 또는 조직의 정책에 따라 결정됩니다. 이 문서의 뒷부분에서 원격 제어 관리를 참조하세요.
원격으로 세션 액세스
세션에 대해 원격 제어를 Copilot CLI 사용하도록 설정하면 최근 에이전트 세션 목록으로 이동 GitHub.com 하거나 GitHub Mobile 세션을 찾을 수 있습니다. 원격 인터페이스는 실시간으로 업데이트되므로 세션에서 진행 중인 출력을 모니터링하고 들어오는 프롬프트 및 권한 요청에 응답할 수 있습니다.
로컬 터미널과 원격 인터페이스가 동시에 활성화됩니다. 두 인터페이스에서 명령을 입력할 수 있습니다. Copilot CLI 는 프롬프트 또는 권한 요청에 수신하는 첫 번째 응답을 사용합니다.
세션은 로컬 컴퓨터에서 계속 실행됩니다. 원격 인터페이스는 세션과 상호 작용하는 방법을 제공하지만 CLI 자체(그리고 실행되는 모든 도구, 셸 명령 및 파일 작업)는 세션을 시작한 컴퓨터에 남아 있습니다.
원격으로 수행할 수 있는 작업
원격에서 GitHub.com 또는 GitHub Mobile를 통해 세션에 연결된 경우, 다음을 수행할 수 있습니다.
- 권한 요청에 응답: 승인 또는 거부 도구, 파일 경로 및 URL 권한 요청.
- 질문에 응답: 더 많은 정보를 제공하거나 결정을 내리라는 메시지가 표시되면 답변 Copilot 합니다.
- 계획 승인 또는 거부: 계획 모드에 있는 경우 Copilot 계획 승인 프롬프트에 응답합니다.
- 새 프롬프트 제출: 터미널에서와 마찬가지로 질문이나 지침을 입력합니다.
- 스위치 모드: 세션 모드를 변경합니다(예: 대화형 모드와 계획 모드 간).
- 현재 작업 종료: 에이전트의 현재 작업을 취소합니다.
참고
슬래시 명령(예: /allow-all)은 현재 원격 인터페이스에서 사용할 수 없습니다.
재연결
로컬 컴퓨터 GitHub 간의 연결이 일시적으로 끊어지는 경우(예: 네트워크 중단으로 인해) 연결이 복원되는 즉시 원격으로 세션을 계속 사용할 수 있습니다.
슬래시 명령을 사용하여 컴퓨터가 /keep-alive 절전 모드로 들어가지 않도록 할 수 있습니다.
컴퓨터가 절전 모드로 들어가지 않도록 방지를 참조하세요.
CLI 세션에서 copilot --continue 또는 copilot --resume를 사용하여 원격 제어가 활성화된 세션을 재개하면, 원격 제어가 자동으로 다시 활성화됩니다.
보안 및 개인 정보
원격 제어는 CLI 세션을 시작한 동일한 계정으로 로그인 GitHub 한 사람만 사용할 수 있습니다. 다른 누구도 세션을 원격으로 보거나 상호 작용할 수 없습니다.
원격 제어를 사용하는 경우:
- 세션 이벤트(대화 메시지, 도구 실행 이벤트 및 권한 요청)는 로컬 컴퓨터에서 GitHub로 전송됩니다.
- 원격 명령은 Copilot CLI에서 GitHub로 폴링되어 로컬 세션에 삽입됩니다.
- CLI는 계속해서 로컬로 실행됩니다. 모든 셸 명령, 파일 작업 및 도구 실행은 컴퓨터에서 발생합니다. 원격 제어는 CLI 에이전트가 세션 내에서 수행할 수 있는 것 이상으로 컴퓨터에 대한 직접 액세스 권한을 부여하지 않습니다.
원격 제어 관리
엔터프라이즈 및 조직 소유자는 사용자가 "클라우드에 로컬 세션 저장" 정책을 사용하여 원격 제어를 사용하도록 설정할 수 있는지 여부를 제어합니다.
- 조직 수준 정책 (기본적으로 구성되지 않음): 조직 소유자는 이 정책을 "클라우드에서 보기"(동기화 전용) 또는 "보기 및 제어"(동기화 및 원격 제어)로 설정할 수 있습니다. 정책을 사용하지 않도록 설정하거나 구성하지 않은 경우 조직의 사용자가 세션 동기화 또는 원격 제어를 사용할 수 없습니다.
- 엔터프라이즈 수준 정책: 엔터프라이즈 소유자는 모든 조직에서 설정을 적용하거나 "조직이 결정하도록 허용"을 선택하여 각 조직이 자체 수준을 선택할 수 있도록 할 수 있습니다. 엔터프라이즈에서 "보기 및 제어"를 강제하면 그 아래의 모든 조직에 해당 설정이 적용됩니다.
원격 제어를 사용할 수 있게 하려면 해당 정책(엔터프라이즈 적용 또는 조직 수준)을 "보기 및 제어"로 설정해야 합니다.
엔터프라이즈 소유자는 "클라우드에 remoteControl 로컬 세션 저장" 정책 위에 적용되는 엔터프라이즈 관리 설정을 사용하여 원격 제어를 추가로 제한할 수 있습니다. 이 설정은 디바이스별로 적용되며 해당 디바이스에서 호스트 되는 세션을 원격으로 제어할 수 있는지 여부를 제어합니다. 제어 클라이언트가 특정 조직에 대해 SSO 권한을 부여받거나 해당 디바이스에서 호스트되는 세션의 원격 제어를 완전히 사용하지 않도록 설정할 수 있습니다. 다른 디바이스에서 호스트되는 세션을 원격으로 제어하는 동일한 사용자의 기능에는 영향을 주지 않습니다.
엔터프라이즈 관리 설정을(를) 참조하세요.
자세한 내용은 조직의 GitHub Copilot 대한 정책 및 기능 관리 및 엔터프라이즈용 Copilot CLI 관리을(를) 참조하세요.