GitHub Copilot CLI에서 Autopilot 모드 사용

Copilot CLI에 잘 정의된 작업을 주고 각 단계 후에 입력을 기다리지 않고 구현, 테스트 및 반복을 통해 작업하게 합니다.

이 기사에서

Autopilot 모드를 사용하는 시기와 작업을 전달하기 전에 고려해야 할 사항의 개요는 GitHub Copilot의 자율적 작동 허용을 참조하세요.

Autopilot 모드를 시작하거나 전환

대화형 Copilot CLI 세션에서 Autopilot 모드를 시작할 수 있습니다.

  1. 터미널에서 CLI를 시작합니다.

    Shell
    copilot

  2. 상태 줄에 Autopilot 모드가 표시될 때까지 Shift+Tab을 계속 누릅니다.

  3. CLI에서 사용 권한을 처리하는 방법을 묻는 경우 모든 사용 권한을 사용하도록 설정할지, 세션에 대해 수동 승인을 사용할지 또는 취소할지를 선택합니다.

  4. 예상하는 결과와 확인 사항을 포함하는 특정 프롬프트를 입력합니다. 다음은 그 예입니다.

    Add pagination to the users API. Preserve the existing response
fields, add tests for the first and final pages, and run the API
test suite.

슬래시 명령을 사용하여 Autopilot 모드를 /autopilot 시작하거나 다시 활성화할 수도 있습니다.

/autopilot Fix the failing API tests and verify the full test suite

Autopilot 모드를 벗어나려면 Shift+Tab을 눌러 다른 모드로 전환하세요.

계획에서 Autopilot 모드로 이동

복잡한 작업의 경우 자율 구현을 허용하기 전에 계획을 만들고 검토합니다.

  1. 대화형 세션에서 상태 줄에 계획 모드가 표시될 때까지 Shift+Tab 을 누릅니다.
  2. 변경, 제약 조건 및 필수 유효성 검사를 설명하는 프롬프트를 입력합니다.
  3. 계획을 검토하고 요구 사항에 부합할 때까지 Copilot에게 수정하도록 요청합니다.
  4. 계획 수락 및 Autopilot 실행 모드에서 계속을 선택합니다.
  5. 권한 선택 메시지가 표시되면 작업에 적합한 사용 권한을 선택합니다.
  6. 구현을 모니터링한 다음 결과 변경 내용을 검토하고 테스트 출력을 확인합니다.

명령줄에서 plan-then-Autopilot 세션을 시작하려면 다음을 입력합니다.

Shell
copilot --plan --mode autopilot

이 명령은 계획 모드가 준비되면 계획 모드에서 Autopilot 모드로 자동으로 이동합니다. 대화형 계획 승인을 기다리지 않습니다. 정확한 동작 및 호환 가능한 옵션은 GitHub Copilot CLI 명령 참조을 참조하세요.

사용 권한 구성

autopilot 모드로 전환할 때 아직 모든 권한을 부여 Copilot 하지 않은 경우 다음 세 가지 옵션 중에서 선택하라는 메시지가 표시됩니다.

1. Enable all permissions (recommended)
2. Use Manual Approval for this session
3. Cancel (Esc)

모든 권한을 사용하도록 설정하면 Autopilot 모드에서 최상의 결과를 얻을 수 있습니다. 수동 승인을 선택하는 경우 Copilot 승인이 필요한 도구 요청을 자동으로 거부하므로 특정 작업을 완료하지 못할 수 있습니다. 나중에 마음이 바뀌면 Autopilot 세션 중에 /allow-all 명령(또는 해당 별칭 /yolo)을 사용하여 전체 권한을 부여할 수 있습니다.

광범위한 권한을 부여 Copilot 하기 전에 로컬 샌드박싱을 사용하거나 클라우드 샌드박스에서 세션을 실행하여 액세스할 수 있는 권한을 제한하는 것이 Copilot 좋습니다.

Autopilot 모드를 사용하는 동안 로컬 샌드박싱을 사용하도록 설정하면 Copilot는 샌드박스 내에서 수행할 수 있는 모든 작업을 중단 없이 완료합니다. 그러나 샌드박스를 이스케이프해야 하는 단계(예: 현재 작업 디렉터리 외부의 파일에 쓰기)는 거부됩니다. 로컬 샌드박싱에 대한 자세한 내용은 클라우드 및 로컬 샌드박스에 대하여 GitHub Copilot을 참조하세요.

Autopilot 모드, --allow-all 및 --no-ask-user 비교

이러한 컨트롤은 Copilot CLI가 작동하는 방식의 개별적인 측면에 영향을 줍니다.

  • Autopilot 모드는 계속을 제어합니다. 에이전트는 다른 프롬프트를 기다리지 않고 AI 모델과의 추가 상호 작용이 필요한 연속 단계를 수행할 수 있습니다.
  • --allow-all 및 해당 별칭 --yolo은(는) 승인을 제어합니다. 에이전트는 권한을 요청하지 않고 모든 도구, 경로 및 URL을 사용할 수 있지만 자율적 계속 진행을 사용하도록 설정하지는 않습니다. 대화형 모드에서 에이전트는 추가 지시가 필요할 때 계속 중지됩니다.
  • **--no-ask-user**는 명확히 하기 위한 질문을 억제합니다. 에이전트는 입력을 요청하는 대신 결정을 내리지만 Autopilot 모드도 사용하도록 설정되지 않는 한 연속적인 모델 상호작용을 계속하지 않습니다.

대화형 세션 중에는 /allow-all 또는 /yolo로 모든 권한을 활성화할 수 있습니다.

참고

/allow-all 및 /yolo 명령은 현재 세션에 대한 모든 권한을 부여합니다. 두 명령 중 하나를 다시 입력해도 사용 권한이 비활성화되지는 않습니다.

사용 권한에 사용할 수 있는 명령 옵션에 대한 자세한 내용은 GitHub Copilot CLI 명령 참조을 참조하세요.

자율 작업 제한하기

제한을 사용하여 작업이 예상보다 오래 계속되거나 예상보다 더 많은 AI credits 리소스를 소비하지 않도록 합니다.

  • --max-autopilot-continues=COUNT를 사용하여 자동 연속 메시지를 제한합니다.
  • 프로그래밍 방식으로 사용하기 위한 AI credit 소프트 --max-ai-credits=CREDITS 제한을 설정하는 데 사용합니다.
  • 대화형 세션에서는 AI credit를 사용하여 /limits 제한을 검사하거나 변경합니다.

현재 기본값 및 허용되는 값은 GitHub Copilot CLI 명령 참조을 참조하세요. AI credit 제한 절차는 AI credit에서 GitHub Copilot CLI 세션 제한 설정을 참조하세요.

작업을 중지하고 검토

  1. 실행 중인 작업을 중단하려면 Esc 키를 두 번 누릅니다.

  2. 다음 프롬프트가 Autopilot 모드에서 실행되지 않도록 하려면 Shift+Tab을 눌러 다른 모드를 선택하세요.

  3. 에이전트가 변경한 파일을 검토하세요. CLI에서 다음 명령으로 diff 보기를 열 수 있습니다.

    /diff

  4. 변경 내용을 커밋하거나 푸시하기 전에 관련 테스트, linter 및 보안 검사를 실행하세요.

모든 중단 및 검토 컨트롤은 GitHub Copilot CLI 명령 참조을 참조하세요.

다음 작업에 대한 모드 선택

기본적으로 Autopilot 모드는 유지됩니다. Copilot CLI에서 작업이 완료된 것으로 판단하면 Copilot은 Autopilot 모드로 유지되므로 입력한 다음 프롬프트도 Autopilot 모드에서 처리됩니다. 언제든지 Shift+Tab 키를 눌러 표준 대화형 모드로 다시 전환할 수 있습니다.

각 작업이 완료된 후 Copilot CLI가 자동으로 대화형 모드로 다시 전환되도록 하려면 stayInAutopilot을 false(으)로 설정하여 이 동작을 비활성화할 수 있습니다. 다음 방법 중 하나를 사용하여 이 작업을 수행할 수 있습니다.

  • 대화형 세션 중에 .를 입력합니다 /settings stayInAutopilot false.
  • 사용자 구성 파일("stayInAutopilot": false)에 ~/.copilot/settings.json을 추가합니다. 자세한 내용은 GITHUB COPILOT CLI 구성 디렉터리을(를) 참조하세요.

이 설정을 사용하지 않도록 설정하면 작업이 완료되면 Copilot 자동으로 표준 대화형 모드로 다시 전환됩니다. Autopilot 모드에서 다른 작업을 실행하려면 Shift+을 누르고 Autopilot 모드로 다시 돌아갈 때까지 사용 가능한 모드를 순환한 다음 다음 프롬프트를 입력합니다.

참고

이 설정은 작업이 완료된 후에 어떤 모드로 전환되는지만 제어합니다. Copilot가 작업이 완료되었다고 판단한 후에도 계속 작동하게 하지는 않습니다. 작업이 완료되거나, 문제가 발생할 때, Ctrl+를 누를 때 또는 연속 제한에 도달하면 Autopilot이 계속 중지됩니다.

프로그래밍 방식으로 Autopilot 모드 사용

초기 프롬프트 이후에도 CLI가 계속 실행되어야 하는 스크립트 또는 기타 비대화형 워크플로에는 프로그래밍 방식의 Autopilot 모드를 사용합니다.

  1. 태스크에 필요한 권한을 결정합니다.

  2. 작업에 적합한 연속 제한 또는 AI credit 제한을 설정합니다.

  3. -p 및 --autopilot를 사용하여 프롬프트를 실행합니다. 다음은 그 예입니다.

    Shell
    copilot --autopilot --yolo --max-autopilot-continues 10 -p "여기에 프롬프트 입력"

    특정 작업으로 대체 YOUR PROMPT HERE 합니다. 다음은 모든 사용 권한을 부여하고 최대 자동 연속 횟수를 10로 설정하는 예제입니다.

프로그래밍 방식 옵션의 전체 목록은 GitHub Copilot CLI 프로그래밍 방식 참조 및 GitHub Copilot CLI 명령 참조을 참조하세요.