원격 액세스를 사용하면 모든 브라우저에서 또는 GitHub Mobile을 통해 실행 중인 Copilot CLI 세션에 연결할 수 있습니다. 세션 출력을 보고, 사용 권한 요청에 응답하고, 세션이 실행 중인 머신에 없으면 세션에서 작업을 계속할 수 있습니다.
이 문서에서는 원격 액세스를 사용하도록 설정하고 사용하는 방법을 설명합니다. 자세한 개념 정보는 GitHub Copilot CLI 세션에 대한 원격 액세스 정보을 참조하세요.
참고
* Copilot CLI 세션에 대한 원격 액세스는 공개 미리 보기 중이며 변경될 수 있습니다.
- 모바일 액세스는 현재 최신 베타 릴리스 GitHub Mobile에서만 사용할 수 있습니다. iOS용 GitHub MobileApple TestFlight 및 Android용 Google Play를 통해 테스트 프로그램에 참가할 수 있습니다.
사전 요구 사항
-
CLI 세션이 실행되는 컴퓨터는 온라인 상태여야 하며 세션은 터미널에서 활발하게 실행됩니다.
팁
`/keep-alive` 슬래시 명령을 사용하여 사용자가 자리를 비움 상태에서 머신이 절전 모드로 들어가지 않도록 합니다.[컴퓨터가 절전 모드로 들어가지 않도록 방지를 참조하세요](#preventing-your-machine-from-going-to-sleep). -
작업 디렉터리에 호스트 GitHub.com되는 Git 리포지토리가 포함되어야 합니다. 리포지토리에 GitHub 없는 경우 CLI는 "원격 세션 사용 안 함: 리포지토리에 없음"을 GitHub 표시합니다.
세션에 대한 원격 액세스 사용
다음 세 가지 방법으로 원격 액세스를 사용하도록 설정할 수 있습니다.
- 인터랙티브 세션에서 슬래시 명령어를 사용하다.
-
Copilot CLI를 시작할 때 명령줄 옵션을 사용합니다. - 모든 대화형 세션에 대해 기본적으로 원격 액세스를 사용하도록 CLI를 구성합니다.
`/remote` 슬래시 명령 사용
대화형 세션에 이미 있고 원격 액세스를 사용하도록 설정하려면 다음을 입력합니다.
/remote
/remote
CLI가 GitHub.com에 연결되고 원격으로 세션에 액세스하기 위한 세부 정보를 표시합니다. 이 문서의 뒷부분에서 GitHub.com로부터 세션에 액세스하기 및 GitHub Mobile로부터 세션에 액세스하기를 참조하십시오.
`--remote` 명령줄 옵션 사용
원격으로 세션에 액세스하려는 경우 명령줄 옵션을 사용하여 CLI를 --remote 시작할 수 있습니다. 이렇게 하면 세션 중에 슬래시 명령을 기억할 /remote 필요가 없습니다.
copilot --remote
copilot --remote
세션에 원격으로 액세스하기 위한 세부 정보는 대화형 세션이 시작될 때 표시되며 슬래시 명령을 사용하여 /remote 언제든지 다시 표시할 수 있습니다.
항상 사용하도록 원격 액세스 구성
대화형 CLI 세션에 항상 원격으로 접근할 수 있도록 하려면, ~/.copilot/config.json에 위치한 구성 파일에 다음을 추가하세요: Copilot.
{
"remoteSessions": true
}
{
"remoteSessions": true
}
특정 세션에 대해 이 설정을 재정의하려면 세션을 시작할 때 --no-remote 옵션을 사용하세요.
copilot --no-remote
copilot --no-remote
참고
명령줄 옵션 --remote 이며 --no-remote 항상 구성 파일의 remoteSessions 설정보다 우선합니다.
GitHub.com에서 세션에 액세스
원격 액세스를 사용하도록 설정하면 CLI는 다음과 같은 형식의 링크를 표시합니다.
https://github.com/OWNER/REPO/tasks/TASK_ID
웹 브라우저에서 세션에 액세스하려면 이 링크를 사용합니다. CLI 세션을 시작한 동일한 계정으로 로그인 GitHub 해야 합니다.
또한 다음의 최근 에이전트 세션 목록에서 세션에 액세스할 수 있습니다.GitHub.com
- 왼쪽 위 모서리의 GitHub에서 을 클릭합니다.
- 를 클릭합니다 Copilot.
- "최근 에이전트 세션"에서 Copilot CLI 세션을 클릭하여 엽니다.
중요
세션은 사용자 고유의 세션입니다. 사용자 고유 Copilot CLI 의 세션에만 액세스할 수 있습니다. 다른 GitHub 사용자는 세션에 액세스할 수 없습니다.
GitHub Mobile에서 세션에 액세스하기
Copilot CLI세션은 원격 액세스를 사용하도록 설정하자마자GitHub Mobile 사용할 수 있습니다. 세션을 GitHub Mobile에서 찾으려면:
-
화면의 Copilot 오른쪽 아래 모서리에 있는 단추를 탭합니다.
세션은 "에이전트 세션" 아래에 나열됩니다.
-
세션을 탭하여 엽니다.
QR 코드를 사용하여 휴대폰에서 세션을 빠르게 엽니다.
-
대화형 세션에서 슬래시 명령을 입력
/remote하여 원격 세션 세부 정보를 다시 표시합니다. -
<kbd>Ctrl</kbd>+<kbd>E</kbd>를 눌러 QR 코드 표시를 설정/해제합니다.참고
이 바로 가기 키는 QR 코드뿐만 아니라 세션 대화의 모든 세부 정보를 확장/축소합니다. 입력 필드가 현재 비어 있는 경우에만 작동합니다.
-
휴대폰으로 QR 코드를 스캔하여 세션 GitHub Mobile으로 직접 이동합니다.
컴퓨터가 절전 모드로 들어가지 않도록 설정하기
슬래시 명령을 사용하여 컴퓨터가 /keep-alive 절전 모드로 들어가지 않도록 할 수 있습니다. 이렇게 하면 원격 연결을 유지하고 GitHub.com 또는 GitHub Mobile에서 세션과 계속 상호 작용할 수 있습니다.
대화형 세션에서 /keep-alive OPTION를 입력하고, 여기서 OPTION는 다음 중 하나입니다:
-
`on`: CLI 세션이 활성화된 동안 컴퓨터가 절전 모드로 전환되지 않도록 합니다. -
`off`: 컴퓨터가 정상적으로 절전 모드로 이동하도록 허용합니다. -
`busy`: Copilot가 작업을 수행할 때만 컴퓨터가 절전 모드로 들어가지 않도록 합니다. 에이전트가 작업을 완료하면 컴퓨터가 정상적으로 절전 모드로 돌아갈 수 있습니다. 입력 요청에 응답하기를 기다리는 경우 Copilot 컴퓨터가 절전 모드로 이동하지 않습니다. -
`NUMBERm`, `NUMBERh`또는 `NUMBERd` (예: `30m`, , `8h``1d`): 컴퓨터가 특정 시간, 시간 또는 일 수 동안 절전 모드가 되도록 방지합니다. 숫자에 접미사가 붙어 있지 않으면 분으로 처리됩니다.
명령을 OPTION``/keep-alive 전달하지 않으면 현재 연결 유지 상태가 표시됩니다.
원격 액세스를 사용하여 세션 다시 시작하는 중
원격 액세스가 활성화된 세션을 종료하면 CLI는 다음을 포함하는 --remote다시 시작 명령을 표시합니다.
copilot --resume=SESSION_ID --remote
이 명령을 사용하여 원격 액세스를 사용하도록 설정된 세션을 다시 시작합니다.
마찬가지로 명령에 추가 --remote``copilot --continue 하면 원격 액세스를 사용하도록 설정된 최신 세션이 다시 시작됩니다.
구성 파일에 "remoteSessions": trueCopilot가 있는 경우, 다시 시작된 세션은 원격 액세스가 자동으로 활성화되어 --remote 옵션을 사용할 필요가 없습니다.
원격 액세스 방지
원격 액세스는 기본적으로 사용하지 않도록 설정되지만 구성 파일에서 Copilot 사용하도록 설정할 수 있습니다. 다음을 통해 세션에 원격으로 액세스할 수 없도록 할 수 있습니다.
-
**단일 세션의 경우**: 구성 파일 설정에 `--no-remote` 관계없이 해당 세션에 대한 원격 액세스를 방지하기 위해 CLI를 시작합니다. -
**영구적으로**: Copilot 구성 파일에서 `"remoteSessions": true` 설정을 제거하거나 `false`로 설정합니다.