GitHub Copilot CLI 사용

명령줄에서 GitHub Copilot을 사용하는 방법을 알아봅니다.

누가 이 기능을 사용할 수 있나요?

GitHub Copilot CLI는 GitHub Copilot Pro, GitHub Copilot Pro(프로)+, GitHub Copilot Business,GitHub Copilot Enterprise 플랜과 함께 사용할 수 있습니다.

조직에서 Copilot을 수신하는 경우 조직의 설정에서 Copilot CLI 정책을 활성화해야 합니다.

이 문서의 내용

GitHub Copilot용 CLI(명령줄 인터페이스)를 사용하면 터미널에서 직접 Copilot을 활용할 수 있습니다. 자세한 내용은 GitHub Copilot CLI 정보을(를) 참조하세요.

참고 항목

GitHub Copilot CLI는 현재 공개 미리 보기 상태이며 변경될 수 있습니다.

전제 조건

Copilot CLI를 설치합니다. GitHub Copilot CLI 설치을(를) 참조하세요.

Copilot CLI 사용

  1. 터미널에서 작업하려는 코드가 포함된 폴더로 이동합니다.

  2. copilot을 입력하여 Copilot CLI를 시작합니다.

    Copilot은 이 폴더의 파일을 신뢰할 수 있는지 확인하도록 요청합니다.

    중요

    이 GitHub Copilot CLI 세션 동안 Copilot은 이 폴더와 그 아래에 있는 파일을 읽고, 수정하고, 실행하려고 시도할 수 있습니다. 이 위치의 파일을 신뢰할 수 있을 경우에만 계속 진행해야 합니다. 신뢰할 수 있는 디렉터리에 대한 자세한 내용은 GitHub Copilot CLI 정보을(를) 참조하세요.

  3. 옵션 중 하나를 선택하십시오.

    1. 예, 계속합니다.

    Copilot은 이 위치의 파일을 이번 세션에서만 사용할 수 있습니다.

    2. 예, 이후 세션을 위해 이 폴더를 기억하세요.

    이 폴더의 파일을 이번 세션과 향후 세션에서도 신뢰합니다. 이 폴더에서 Copilot CLI를 시작할 때 다시 묻지 않습니다. Copilot이 이 위치의 파일을 사용하는 것이 항상 안전하다고 확신하는 경우에만 이 옵션을 선택하세요.

    3. 아니요, 종료(Esc):

    Copilot CLI 세션을 종료합니다.

  4. 현재 GitHub에 로그인하지 않은 경우 /login 슬래시 명령을 사용하라는 프롬프트가 표시됩니다. 이 명령을 입력하고 화면의 지시에 따라 인증을 완료하세요.

  5. CLI에서 프롬프트를 입력합니다.

    이는 간단한 채팅 질문이 될 수도 있고, 버그 수정, 기존 애플리케이션에 기능 추가, 새 애플리케이션 생성 등의 특정 작업을 Copilot에게 요청하는 것일 수도 있습니다.

    프롬프트의 몇 가지 예를 보려면 GitHub Copilot CLI 정보을(를) 참조하세요.

  6. Copilot이 파일을 수정하거나 실행할 수 있는 도구(예: touch, chmod, node, sed)를 사용하려고 할 때, 해당 도구 사용을 승인할지 묻습니다.

    옵션 중 하나를 선택하십시오.

    1. 예:

    Copilot이 이 도구를 사용하도록 허용합니다. 다음에 Copilot이 이 도구를 사용하려고 하면 다시 승인을 요청하게 됩니다.

    2. 예, 그리고 나머지 실행 중인 세션 동안 도구 사용 승인:

    현재 실행 중인 나머지 세션 동안 Copilot이 어떤 옵션이든 다시 묻지 않고 이 도구를 사용할 수 있도록 허용합니다. 앞으로의 세션에서는 다시 명령을 승인해야 합니다.

    이 옵션을 선택하면 동일한 세션에서 유사한 명령을 반복적으로 승인할 필요가 없으므로 여러 도구(예: chmod)에 유용합니다. 그러나 이 옵션의 보안에 미치는 영향을 알고 있어야 합니다. 예를 들어, rm 명령에 대해 이 옵션을 선택하면 Copilot은 사용자의 승인을 받지 않고도 현재 폴더 또는 그 아래에 있는 모든 파일을 삭제할 수 있습니다.

    3. 아니요, Copilot에게 다른 방법으로 수행할 작업 지시(Esc):

    Copilot은 명령을 실행하지 않습니다. 대신 현재 작업을 종료하고 다음 프롬프트를 기다립니다. Copilot에게 다른 접근 방식을 사용하여 작업을 계속하도록 지시할 수 있습니다.

    예를 들어, Copilot에게 Bash 스크립트를 생성하도록 요청했지만 Copilot에서 제안하는 스크립트를 사용하고 싶지 않은 경우 현재 작업을 중지하고 Continue the previous task but include usage instructions in the script와 같은 새 프롬프트를 입력할 수 있습니다.

팁

다음 팁을 활용하여 Copilot CLI 사용 환경을 최적화하세요.

현재 실행 중인 작업 중지

프롬프트를 입력한 후 Copilot이 아직 "생각 중"인 동안 작업을 멈추고 싶다면 Esc를 누르세요.

프롬프트에 특정 파일 포함

프롬프트에 특정 파일을 추가하려면 @ 뒤에 파일의 상대 경로를 사용합니다. 예를 들어 Explain @config/ci/ci-required-checks.yml 또는 Fix the bug in @src/app.js입니다. 이렇게 하면 파일의 내용이 Copilot 프롬프트의 컨텍스트로 추가됩니다.

파일 경로를 입력하기 시작하면 프롬프트 상자 아래에 일치하는 경로가 표시됩니다. 화살표 키를 사용하여 경로를 선택하고 Tap을 눌러 프롬프트에서 경로를 완성합니다.

다른 위치에서 파일 작업

작업을 완료하려면 Copilot이 현재 작업 디렉터리 외부에 있는 파일을 사용해야 할 수도 있습니다. 대화형 세션에서 Copilot이 현재 위치 밖의 파일을 수정해야 한다면, Copilot은 해당 디렉터리에 액세스를 승인하도록 요청합니다.

슬래시 명령을 사용하여 언제든지 신뢰할 수 있는 디렉터리를 수동으로 추가할 수도 있습니다.

/add-dir /path/to/directory

작업하려는 모든 파일이 다른 위치에 있는 경우 새로운 Copilot CLI 세션을 시작하지 않고도 슬래시 명령을 사용하여 현재 작업 디렉터리를 전환할 수 있습니다.

/cwd /path/to/directory

대화형 세션 계속하기

--resume 명령줄 옵션을 사용하여 표시된 목록에서 계속 진행하려는 세션을 선택하면, 이전 대화형 세션으로 돌아가 Copilot과의 대화를 이어갈 수 있습니다.

사용자 지정 지침 사용

작업 중인 리포지토리에 사용자 지정 지침을 추가하여 Copilot의 성능을 향상시킬 수 있습니다. 사용자 지정 지침은 리포지토리의 Markdown 파일에 저장된 자연어 설명입니다. 해당 리포지토리에서 작업하는 동안 입력하는 프롬프트에 자동으로 포함됩니다. 이를 통해 Copilot은 프로젝트의 컨텍스트를 더 잘 이해하고 프롬프트에 응답하는 방법을 익히는 데 도움이 됩니다.

Copilot CLI 지원:

  • .github/copilot-instructions.md 파일에 있는 리포지토리 전체 지침
  • 경로별 지침 파일: .github/copilot-instructions/**/*.instructions.md
  • 에이전트 파일(예: AGENTS.md)

자세한 내용은 GitHub Copilot에 대한 리포지토리 사용자 지정 지침 추가을(를) 참조하세요.

MCP 서버 추가

Copilot CLI는 이미 구성된 GitHub MCP 서버와 함께 제공됩니다. 이 MCP 서버를 사용하면 GitHub.com 리소스와 상호 작용할 수 있습니다. 예를 들어, CLI에서 끌어오기 요청을 병합할 수 있습니다.

Copilot CLI에서 사용할 수 있는 기능을 확장하려면 MCP 서버를 더 추가하세요.

  1. 다음 슬래시 명령 사용:

    /mcp add

  2. Tab 키를 사용하여 필드 간에 이동하면서 추가하려는 MCP 서버의 세부 정보를 입력합니다.

  3. Ctrl+S를 눌러 세부 정보를 저장하세요.

구성된 MCP 서버의 세부 정보는 mcp-config.json 파일에 저장됩니다. 이 파일은 기본적으로 ~/.config 디렉터리에 위치합니다. XDG_CONFIG_HOME 환경 변수를 설정하여 이 위치를 변경할 수 있습니다. 서버 정의의 JSON 구조에 대한 정보는 MCP(모델 컨텍스트 프로토콜)를 사용하여 GitHub Copilot 코딩 에이전트 확장을(를) 참조하세요.

자세히 알아보기

Copilot CLI에서 사용할 수 있는 명령줄 옵션과 슬래시 명령의 전체 목록은 다음 중 하나를 수행하여 확인할 수 있습니다.

  • 대화형 세션의 프롬프트 상자에 ? 입력
  • 터미널에서 copilot help 입력

터미널에서 다음 명령 중 하나를 사용하세요.

  • 구성 설정:

    copilot help config

    기본적으로 ~/.config 디렉터리에 있는 config.json 파일을 편집하여 구성 설정을 조정할 수 있습니다. XDG_CONFIG_HOME 환경 변수를 설정하여 이 위치를 변경할 수 있습니다.

  • Copilot CLI에 영향을 미치는 환경 변수:

    copilot help environment

  • 사용 가능한 로깅 수준:

    copilot help logging

  • 도구 사용을 허용하거나 거부하는 권한:

    copilot help permissions

피드백

GitHub Copilot CLI에 대한 피드백이 있다면 대화형 세션에서 /feedback 슬래시 명령을 사용하여 옵션 중 하나를 선택하여 알려주세요. 프라이빗 피드백 설문 조사를 완료하거나 버그 보고서를 제출하거나 새 기능을 제안할 수 있습니다.