GitHub Copilot CLI 사용

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

전제 조건

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

Copilot CLI 사용

터미널에서 작업하려는 코드가 포함된 폴더로 이동합니다.
```
       `copilot`을 입력하여 Copilot CLI를 시작합니다.
```
Copilot은 이 폴더의 파일을 신뢰할 수 있는지 확인하도록 요청합니다.

중요

이 GitHub Copilot CLI 세션 동안 Copilot은 이 폴더와 그 아래에 있는 파일을 읽고, 수정하고, 실행하려고 시도할 수 있습니다. 이 위치의 파일을 신뢰할 수 있을 경우에만 계속 진행해야 합니다. 신뢰할 수 있는 디렉터리에 대한 자세한 내용은 GitHub 코필로트 CLI 정보을(를) 참조하세요.
옵션 중 하나를 선택합니다.
```
       **1. 예, 계속합니다.**
```
Copilot은 이 위치의 파일을 이번 세션에서만 사용할 수 있습니다.
```
       **2. 예, 이후 세션을 위해 이 폴더를 기억해 두세요.**
```
이 폴더의 파일을 이번 세션과 향후 세션에서도 신뢰합니다. 이 폴더에서 Copilot CLI를 시작할 때 다시 묻지 않습니다. Copilot이 이 위치의 파일을 사용하는 것이 항상 안전하다고 확신하는 경우에만 이 옵션을 선택하세요.
```
       **3. 아니요, 종료(Esc)**:
```
Copilot CLI 세션을 종료합니다.
현재 GitHub에 로그인하지 않은 경우 /login 슬래시 명령을 사용하라는 프롬프트가 표시됩니다. 이 명령을 입력하고 화면의 지시에 따라 인증을 완료하세요.
CLI에서 프롬프트를 입력합니다.

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

프롬프트의 몇 가지 예를 보려면 GitHub 코필로트 CLI 정보을(를) 참조하세요.
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 인라인 피드백을 제공할 수도 있습니다.

팁

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

현재 실행 중인 작업 중지

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

계획 모드 사용

계획 모드를 활용하면 코드 작성에 앞서 구현 전략을 수립하는 과정에서 Copilot과 긴밀히 협업할 수 있습니다. Shift+Tab을 눌러 계획 모드에 들어가거나 나옵니다.

프롬프트에 특정 파일 포함

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

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

다른 위치에서 파일 작업

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

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

/add-dir /path/to/directory

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

/cwd /path/to/directory

셸 명령 실행

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

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

대화형 세션 계속하기

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

팁

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

copilot --continue

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

Copilot CLI 지원:

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

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

자세한 내용은 GitHub Copilot CLI에 사용자 지정 지침을 추가하는 방법입니다.을(를) 참조하세요.

사용자 지정 에이전트 사용하기

사용자 지정 에이전트는 Copilot의 특화시킨 버전입니다. 사용자 지정 에이전트는 Copilot가 고유한 워크플로, 특정 코딩 규칙, 그리고 전문적인 사용 사례를 처리하도록 지원합니다.

Copilot CLI에는 일반적인 작업을 위한 기본 사용자 지정 에이전트 그룹이 포함되어 있습니다.

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

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

에이전트가 갖추어야 할 전문성, 사용할 수 있는 도구, 그리고 응답 방식에 대한 구체적인 지침을 지정하는 에이전트 프로필라는 Markdown 파일을 사용하여 고유한 사용자 지정 에이전트를 정의할 수 있습니다.

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

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

          `.github/agents` 로컬 및 원격 리포지토리의 디렉터리 | 현재 프로젝트 |

| 조직 및 Enterprise 수준 사용자 지정 에이전트 | /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 서버 추가

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

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

다음 슬래시 명령 사용:
```
/mcp add
```

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

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

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

콘텐츠 관리

Copilot CLI는 사용자의 컨텍스트 창 모니터링 및 관리에 도움이 되는 몇 가지 슬래시 명령을 제공합니다.

```
        `/usage`: 다음을 포함하여 세션 통계를 볼 수 있습니다.
```
- 현재 세션에서 사용되는 프리미엄 요청의 양
- 세션 기간
- 편집된 총 코드 줄
- 모델당 토큰 사용량 분석

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

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

GitHub Copilot CLI는 대화 내용이 토큰 한도의 95%에 도달하면 워크플로를 중단하지 않고 백그라운드에서 자동으로 대화 이력을 압축합니다.

모든 사용 권한 활성화

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

추론 표시 여부 전환

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

자세히 알아보기

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

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

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

```
        **구성 설정**:
```
copilot help config

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

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

copilot help environment

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

copilot help logging

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

copilot help permissions

피드백

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

다음 단계:

Copilot CLI은 대화형 도우미로 작동하여 사용자의 질문에 답변하고 대화형 방식으로 코드 작성을 지원합니다. 채팅 기능 외에도 Copilot CLI은 더 높은 수준의 자율성으로 작업을 위임할 수 있도록 다양한 에이전트 모드를 제공합니다.

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

        **자율적으로 작업 위임**: 각 단계마다 승인을 요구하지 않고 여러 단계 작업을 완료하려면 Copilot 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)을 참조하세요.

        **코드 검토 요청**: Copilot CLI를 사용하여 코드 변경 내용에 대한 AI 기반 검토를 가져옵니다. 
        [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/acp-server)

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

이 문서의 내용