GitHub Copilot CLI 사용

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

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

GitHub Copilot 명령 줄 인터페이스 (CLI) 는 모든 Copilot 계획에서 사용할 수 있습니다. 조직으로부터 Copilot를 수신하는 경우, 조직의 설정에서 코파일럿 CLI 정책이 사용하도록 설정되어야 합니다.

이 기사에서

          GitHub Copilot용 명령줄 인터페이스(CLI)를 사용하면 터미널에서 Copilot을 직접 사용할 수 있습니다. 자세한 내용은 [AUTOTITLE](/copilot/concepts/agents/about-copilot-cli)을(를) 참조하세요.

전제 조건

          코파일럿 CLI를 설치합니다. 
          [AUTOTITLE](/copilot/how-tos/set-up/install-copilot-cli)을(를) 참조하세요.


          코파일럿 CLI 사용하기

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

  2.        `copilot`를 입력하여 코파일럿 CLI을 시작합니다.


       Copilot 는 이 폴더의 파일을 신뢰할 수 있는지 확인하라는 메시지가 표시됩니다.

    중요

    이 세션 GitHub Copilot 명령 줄 인터페이스 (CLI) 중에는 Copilot 이 폴더 및 아래의 파일을 읽고 수정하고 실행하려고 할 수 있습니다. 이 위치의 파일을 신뢰할 수 있을 경우에만 계속 진행해야 합니다. 신뢰할 수 있는 디렉터리에 대한 자세한 내용은 GitHub 코필로트 CLI 정보을(를) 참조하세요.

  3. 옵션 중 하나를 선택합니다.

           **1. 예, 계속합니다.**


       Copilot 는 이 세션에 대해서만 이 위치의 파일로 작업할 수 있습니다.


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

    이 폴더의 파일을 이번 세션과 향후 세션에서도 신뢰합니다. 이 폴더에서 코파일럿 CLI를 시작할 때 다시 묻지 않을 것입니다. Copilot가 이 위치의 파일을 항상 안전하게 작업할 수 있다고 확신하는 경우에만 이 옵션을 선택하십시오.

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


       코파일럿 CLI 세션을 종료하십시오.

  4. 로그인되어 있지 않은 경우 GitHub, /login 슬래시 명령어를 사용하라는 메시지가 표시됩니다. 이 명령을 입력하고 화면의 지시에 따라 인증을 완료하세요.

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

    이는 간단한 채팅 질문 또는 버그 수정, 기존 애플리케이션에 기능 추가 또는 새 애플리케이션 만들기와 같은 특정 작업을 수행하기 위한 Copilot 요청일 수 있습니다.

    프롬프트의 몇 가지 예를 보려면 GitHub 코필로트 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 새로운 프롬프트를 입력할 수 있습니다.

    도구 권한 요청을 거부할 때, 거부 이유에 대한 인라인 피드백을 제공하여 도구가 완전히 중지하지 않고 접근 방식을 조정할 수 있도록 할 수도 있습니다.

팁

다음 팁을 사용하여 코파일럿 CLI에서 경험을 최적화하세요.

현재 실행 중인 작업 중지

프롬프트를 입력한 다음 여전히 "생각 중"인 동안 작업을 완료하지 Copilot 않기로 결정한 경우 Esc 키를 누릅니다.

계획 모드 사용

계획 모드를 사용하면 코드를 작성하기 전에 구현 계획에서 Copilot 공동 작업할 수 있습니다. Shift+Tab을 눌러 계획 모드에 들어가거나 나옵니다.

프롬프트에 특정 파일 포함

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

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

다른 위치에서 파일 작업

작업을 Copilot 완료하려면 현재 작업 디렉터리 외부에 있는 파일로 작업해야 할 수 있습니다. 대화형 세션에 입력한 프롬프트에서 현재 위치 외부의 파일을 수정해야 하는 Copilot 경우 파일의 디렉터리에 대한 액세스를 승인하라는 메시지가 표시됩니다.

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

/add-dir /path/to/directory

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

/cwd /path/to/directory

셸 명령 실행

모델을 호출하지 않고 셸 명령을 직접 실행하기 위해 입력 ! 앞에 추가할 수 있습니다.

!git clone https://github.com/github/copilot-cli

대화형 세션 계속하기

명령줄 옵션 또는 --resume 슬래시 명령을 사용하여 /resume 대화형 CLI 세션을 선택하고 다시 시작할 수 있으므로 저장된 컨텍스트를 사용하여 중단한 위치를 바로 선택할 수 있습니다. Copilot 코딩 도우미에서 세션을 시작할 수 있으며, GitHub에서 세션을 가져와 GitHub Copilot 명령 줄 인터페이스 (CLI)로 로컬 환경에서 사용할 수 있습니다.

팁

가장 최근에 닫힌 로컬 세션을 신속하게 다시 시작하려면 터미널에 다음을 입력합니다.

copilot --continue

사용자 지정 지침 사용

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

          코파일럿 CLI에서 지원하는 기능:

* .github/copilot-instructions.md 파일에 있는 리포지토리 전체 지침

  • 경로별 지침 파일: .github/instructions/**/*.instructions.md
  • 에이전트 파일(예: AGENTS.md)

자세한 내용은 GitHub Copilot 명령 줄 인터페이스 (CLI)에 사용자 지정 지침을 추가하는 방법입니다.을(를) 참조하세요.

          사용자 지정 에이전트 사용

A 사용자 지정 에이전트 는 특수화된 버전의 Copilot. 사용자 지정 에이전트 는 고유한 워크플로, 특정 코딩 규칙 및 전문가 사용 사례를 처리하는 데 도움이 Copilot 됩니다.

          코파일럿 CLI 에는 일반적인 작업에 대한 기본 그룹이 사용자 지정 에이전트 포함되어 있습니다.
대리인 설명
탐험하다 빠른 코드베이스 분석을 수행하여 주 컨텍스트에 추가하지 않고 코드에 대해 질문할 수 있습니다.
과업 테스트 및 빌드와 같은 명령을 실행하여 성공에 대한 간략한 요약과 실패 시 전체 출력을 제공합니다.
범용 전체 도구 집합 및 고품질 추론이 필요한 복잡한 다단계 작업을 처리하여 기본 대화에 명확하게 집중하도록 별도의 컨텍스트에서 실행합니다.
코드 검토 변경 내용을 검토할 때 실제 문제만 노출하여 노이즈를 최소화하는 데 중점을 둡니다.

CLI에서 사용하는 AI 모델은 작업을 보다 효과적으로 완료할 수 있다고 판단할 경우 특정 전문 지식을 사용하여 사용자 지정 에이전트 작동하는 자회사 스바겐트 프로세스에 작업을 위임하도록 선택할 수 있습니다. 모델은 주 에이전트에서 직접 작업을 처리하도록 똑같이 선택할 수 있습니다.

Markdown 파일인 사용자 지정 에이전트을 사용하여 에이전트가 가져야 할 전문 지식, 사용할 수 있는 도구, 응답 방법에 대한 특정 지침을 정의하는 에이전트 프로필을 직접 설정할 수 있습니다.

사용자, 리포지토리 또는 조직/엔터프라이즈 수준에서 정의 사용자 지정 에이전트 할 수 있습니다.

유형위치Scope
사용자 수준 사용자 지정 에이전트로컬 ~/.copilot/agents 디렉터리모든 프로젝트
리포지토리 수준 사용자 지정 에이전트
          `.github/agents` 로컬 및 원격 리포지토리의 디렉터리 | 현재 프로젝트 |

| 조직 및 엔터프라이즈 수준 사용자 지정 에이전트 | /agents 조직 또는 엔터프라이즈의 .github-private 리포지토리에 있는 디렉터리 | 조직 및 엔터프라이즈 계정의 모든 프로젝트 |

명명 충돌이 발생할 경우 시스템 수준 에이전트는 리포지토리 수준 에이전트를 우선하고 리포지토리 수준 에이전트는 조직 수준 에이전트를 우선합니다.

          사용자 지정 에이전트 은 다음 세 가지 방법으로 사용할 수 있습니다.

  • CLI의 대화형 인터페이스에서 슬래시 명령을 사용하여 사용 가능한 사용자 지정 에이전트목록에서 선택합니다.

    /agent

  • 프롬프트에서 사용자 지정 에이전트를 직접 호출하기:

    Use the refactoring agent to refactor this code block

            Copilot 은 사용하려는 에이전트를 자동으로 유추합니다.

  •         사용자 지정 에이전트 명령줄 옵션과 함께 사용할 항목을 지정합니다. 다음은 그 예입니다.

    copilot --agent=refactor-agent --prompt "Refactor this code block"

자세한 내용은 Copilot 코딩 도우미용 사용자 지정 에이전트 만들기을(를) 참조하세요.

기술 사용

명령, 스크립트 및 리소스를 사용하여 특수 작업을 수행하는 기능을 Copilot 향상시키는 기술을 만들 수 있습니다.

자세한 내용은 GitHub Copilot 명령 줄 인터페이스 (CLI)용 에이전트 기술 생성을(를) 참조하세요.

MCP 서버 추가

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

사용 가능한 코파일럿 CLI기능을 확장하려면 MCP 서버를 더 추가할 수 있습니다.

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

    /mcp add

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

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

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

콘텐츠 관리

          코파일럿 CLI 에서는 컨텍스트 창을 모니터링하고 관리하는 데 도움이 되는 여러 슬래시 명령을 제공합니다.

* /usage: 다음을 포함하여 세션 통계를 볼 수 있습니다.

  • 현재 세션에서 사용되는 프리미엄 요청의 양

  • 세션 기간

  • 편집된 총 코드 줄

  • 모델당 토큰 사용량 분석

  •         `/context`: 현재 토큰 사용량에 대한 시각적 개요를 제공합니다.

  •         `/compact`: 대화 기록을 수동으로 압축하여 컨텍스트 공간을 확보합니다.

        GitHub Copilot 명령 줄 인터페이스 (CLI) 는 워크플로를 중단하지 않고 대화가 토큰 제한의 95% 가까워지면 백그라운드에서 기록을 자동으로 압축합니다.

모든 사용 권한 활성화

신뢰할 수 있는 경우에는 Copilot를 자유롭게 실행하도록 하거나 --allow-all 또는 --yolo 플래그를 사용하여 모든 권한을 한 번에 활성화할 수 있습니다.

추론 표시 여부 전환

          <kbd>Ctrl</kbd>+<kbd>T</kbd>를 눌러 응답을 생성하는 동안 모델의 추론 프로세스를 표시하거나 숨깁니다. 이 설정은 세션 간에 유지되므로 Copilot을(를) 통해 복잡한 문제에서 작동 방식을 관찰할 수 있습니다.

자세히 알아보기

사용할 수 있는 코파일럿 CLI의 명령줄 옵션 및 슬래시 명령의 전체 목록을 보려면 다음 작업 중 하나를 수행하십시오.

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

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

  •         **구성 설정**:

    copilot help config

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

  • 영향을 **** 주는 코파일럿 CLI:

    copilot help environment

  •         **사용 가능한 로깅 수준**:

    copilot help logging

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

    copilot help permissions

피드백

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

다음 단계:

          코파일럿 CLI 는 대화형 도우미로 작동하여 질문에 답변하고 코드를 대화형으로 작성하는 데 도움을 줍니다. 채팅 코파일럿 CLI 외에도 더 큰 자율성으로 작업을 위임할 수 있는 다양한 에이전트 모드를 지원합니다.

에이전트와 코파일럿 CLI 협력하여 작업 위임에서 결과 검토에 이르기까지 전체 작업 수명 주기를 지원할 수 있습니다.

  •         **작업을 자율적으로 위임**: autopilot 모드에서 실행 코파일럿 CLI 하여 각 단계에서 승인을 요구하지 않고 다단계 작업을 완료합니다. 
        [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/delegate-tasks-to-cca)을(를) 참조하세요.

  •         **사용자 지정 에이전트 호출**: 코드 검토, 설명서 또는 보안 감사와 같은 특정 작업에 맞게 조정된 특수 에이전트를 호출합니다. 
        [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/invoke-custom-agents)을(를) 참조하세요.

  •         **조향 에이전트**: 작업 실행 중에 에이전트 동작을 안내하고 구체화하여 작업을 계속 진행합니다. [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/steer-agents)을 참조하세요.

  •         **코드 검토 요청**: 코드 변경 내용에 대한 AI 기반 검토를 가져오는 데 사용합니다 코파일럿 CLI . 
        [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/agentic-code-review)을(를) 참조하세요.

추가 읽기

  •         [AUTOTITLE](/copilot/how-tos/copilot-cli/cli-best-practices)

  •         [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-command-reference)

  •         [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-config-dir-reference)

  •         [AUTOTITLE](/copilot/reference/copilot-cli-reference/acp-server)