GitHub Copilot CLI 정보

소개

          GitHub Copilot용 명령줄 인터페이스(CLI)를 사용하면 터미널에서 Copilot을 직접 사용할 수 있습니다. 이를 사용하여 질문에 답변하고, 코드를 작성 및 디버그하고, 상호 작용할 수 있습니다 GitHub.com. 예를 들어 프로젝트를 변경하고 끌어오기 요청을 만들도록 요청할 Copilot 수 있습니다.

          GitHub Copilot CLI 에서는 터미널을 떠나지 않고도 강력한 AI 에이전트에 빠르게 액세스할 수 있습니다. 대신 작업하여 작업을 더 빠르게 완료하는 데 도움이 될 수 있으며, 필요한 코드를 빌드하기 위해 반복적으로 GitHub Copilot CLI 작업할 수 있습니다.

지원되는 운영 체제

리눅스
macOS
Powershell 및 Linux용 Windows 하위 시스템 (WSL) 내에서 Windows

설치 지침은 GitHub Copilot CLI 설치을(를) 참조하세요.

사용 모드

          GitHub Copilot CLI 에는 대화형 및 프로그래밍 방식의 두 가지 사용자 인터페이스가 있습니다.

대화형 인터페이스

대화형 세션을 시작하려면 .를 입력합니다 copilot. 대화형 세션 Copilot 내에서 대화를 나눌 수 있습니다. 하나 이상의 작업을 수행하라는 메시지를 표시 Copilot 할 수 있으며 피드백을 제공하고 작업의 방향을 조정할 수 있습니다.

Copilot의 대화형 인터페이스에 표시되는 환영 메시지의 스크린샷.

대화형 인터페이스에는 두 가지 모드가 있습니다. 기본 요청/실행 모드 외에도 완료하려는 작업에 대한 구조화된 구현 계획을 빌드하는 계획 모드Copilot 도 있습니다.

          <kbd>Shift</kbd>+<kbd>Tab</kbd>을 눌러 모드 간을 순환합니다. 계획 모드 Copilot 에서 요청을 분석하고, 명확한 질문을 하여 범위 및 요구 사항을 이해하고, 코드를 작성하기 전에 계획을 작성합니다. 이렇게 하면 코드를 작성하기 전에 오해를 파악하고 복잡한 다단계 작업을 계속 제어할 수 있습니다.

프로그래밍 방식 인터페이스

명령줄에서 직접 단일 프롬프트를 CLI에 전달할 수도 있습니다. CLI는 작업을 완료한 다음 종료합니다.

CLI를 프로그래밍 방식으로 사용하려면 -p 또는 --prompt 명령줄 옵션을 명령에 포함하십시오. 파일을 수정하고 실행할 수 있도록 허용 Copilot 하려면 이 문서의 뒷부분에 설명된 승인 옵션 중 하나를 사용해야 합니다. 수동 승인 없이 도구를 사용할 수 있도록 허용 참조). 다음은 그 예입니다.

Bash

copilot -p "Show me this week's commits and summarize them" --allow-tool='shell(git)'

copilot -p "Show me this week's commits and summarize them" --allow-tool='shell(git)'

또는 스크립트를 사용하여 명령줄 옵션을 출력하고 이를 copilot에 파이프로 전달할 수 있습니다. 다음은 그 예입니다.

Bash

./script-outputting-options.sh | copilot

./script-outputting-options.sh | copilot

주의

같은 --allow-all-toolsCopilot 자동 승인 옵션을 사용하는 경우 컴퓨터의 파일과 동일한 액세스 권한을 가지며 사전 승인을 받지 않고 실행할 수 있는 모든 셸 명령을 실행할 수 있습니다. 이 문서의 뒷부분에 나오는 보안 고려 사항을 참조하세요.

에 대한 사용 사례 GitHub Copilot CLI

다음 섹션에서는 GitHub Copilot CLI로 완료할 수 있는 작업의 예를 제공합니다.

로컬 작업

프로젝트 디렉터리 내에서 프로젝트의 코드를 변경하도록 요청할 Copilot 수 있습니다. 다음은 그 예입니다.

Change the background-color of H1 headings to dark blue
```
        Copilot 는 H1 머리글이 정의된 CSS 파일을 찾아 색 값을 변경합니다.
```
파일의 변경 내용을 알려달라고 요청 Copilot 합니다.

Show me the last 5 changes made to the CHANGELOG.md file. Who changed the file, when, and give a brief summary of the changes they made
프로젝트에서 코드 또는 설명서를 개선하는 데 사용합니다 Copilot .
- Suggest improvements to content.js
- Rewrite the readme in this project to make it more accessible to newcomers
Git 작업을 수행하는 데 도움이 되는 Copilot를 사용하세요.
- Commit the changes to this repo
- Revert the last commit, leaving the changes unstaged
애플리케이션을 처음부터 만들도록 요청 Copilot 합니다(예: 개념 증명).

Use the create-next-app kit and tailwind CSS to create a next.js app. The app should be a dashboard built with data from the GitHub API. It should track this project's build success rate, average build duration, number of failed builds, and automated test pass rate. After creating the app, give me easy to follow instructions on how to build, run, and view the app in my browser.

        Copilot 변경 내용이 예상대로 작동하지 않는 이유를 설명하거나 마지막으로 변경한 문제를 해결하도록 요청 Copilot 합니다. 다음은 그 예입니다.

You said: "The application is now running on http://localhost:3002 and is fully functional!" but when I browse to that URL I get "This site can't be reached"

대화 조정

생각하는 동안 Copilot와 상호 작용하여 대화를 조정할 수 있습니다.

        **추가 메시지 큐에 넣기**: 후속 메시지를 보내 대화를 다른 방향으로 조정하거나, Copilot이 현재 응답을 완료한 후에 처리할 추가 지침을 큐에 추가합니다. 이렇게 하면 대화가 더 자연스럽게 느껴지고 제어할 수 있습니다.

        **거부에 대한 인라인 피드백**: 도구 권한 요청을 거부할 때 완전히 중지하지 않고도 접근 방식을 조정할 수 있도록 거부에 대한 인라인 피드백을 제공할 Copilot 수 있습니다. 이렇게 하면 특정 작업에서 벗어나려는 경우 대화 흐름이 Copilot 더 자연스럽게 진행됩니다.

자동 컨텍스트 관리

          GitHub Copilot CLI 는 대화 컨텍스트를 자동으로 관리합니다.

* 자동 압축: 대화가 토큰 제한 Copilot 의 95% 가까워지면 워크플로를 중단하지 않고 백그라운드에서 기록을 자동으로 압축합니다. 이렇게 하면 사실상 무한 세션이 가능합니다. * 수동 제어: 언제든지 컨텍스트를 수동으로 압축하는 데 사용합니다 /compact . 마음이 바뀌면 이스케이프 를 눌러 취소합니다. * 사용량 시각화: 이 /context 명령은 컨텍스트 창이 사용되는 방식을 이해할 수 있도록 자세한 토큰 사용 현황 분석을 보여 줍니다.

사용자 정의 GitHub Copilot CLI

다음과 같은 다양한 방법으로 사용자 지정할 GitHub Copilot CLI 수 있습니다.

        **사용자 지정 지침**: 사용자 지정 지침을 사용하면 프로젝트에 대한 추가 컨텍스트와 변경 내용을 빌드, 테스트 및 유효성 검사하는 방법을 제공할 Copilot 수 있습니다. 이제 모든 사용자 지정 명령 파일이 우선 순위 기반 대체를 사용하는 대신 결합됩니다. 자세한 내용은 [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions)을(를) 참조하세요.

        **MCP(모델 컨텍스트 프로토콜) 서버**: MCP 서버를 사용하면 다양한 데이터 원본 및 도구에 액세스할 수 Copilot 있습니다. 자세한 내용은 [AUTOTITLE](/copilot/how-tos/use-copilot-agents/use-copilot-cli#add-an-mcp-server)을(를) 참조하세요.

        **
        사용자 지정 에이전트
        **: 사용자 지정 에이전트 다양한 작업별로 특수한 버전을 Copilot 만들 수 있습니다. 예를 들어 팀의 지침에 따라 전문가 프런트 엔드 엔지니어로 사용자 지정할 Copilot 수 있습니다. 
        GitHub Copilot CLI 에는 공통 작업을 자동으로 위임하는 특수화된 사용자 지정 에이전트가 포함되어 있습니다. 자세한 내용은 [AUTOTITLE](/copilot/how-tos/use-copilot-agents/use-copilot-cli#use-custom-agents)을(를) 참조하세요.

        **후크: 후**크를 사용하면 에이전트를 실행하는 동안 키 지점에서 사용자 지정 셸 명령을 실행할 수 있으므로 유효성 검사, 로깅, 보안 검사 또는 워크플로 자동화를 추가할 수 있습니다. 
        [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-hooks)을(를) 참조하세요.

        **기술**: 기술을 사용하면 지침, 스크립트 및 리소스를 사용하여 특수 작업을 수행하는 기능을 Copilot 향상시킬 수 있습니다. 자세한 내용은 [AUTOTITLE](/copilot/concepts/agents/about-agent-skills)을(를) 참조하세요.

        **
        Copilot 메모리
        **: Copilot 메모리는 "기억"을 저장하여 당신의 리포지토리에 대한 지속적인 이해를 구축할 수 있게 Copilot 해줍니다. 이 "기억"은 Copilot가 작업하면서 추론하는 코딩 규칙, 패턴, 그리고 선호 사항에 관한 정보입니다. 이렇게 하면 프롬프트에서 컨텍스트를 반복적으로 설명할 필요가 줄어들고 향후 세션의 생산성이 향상됩니다. 자세한 내용은 [AUTOTITLE](/copilot/concepts/agents/copilot-memory)을(를) 참조하세요.

보안 고려 사항

사용하는 Copilot CLICopilot 경우 파일 실행 또는 수정 또는 셸 명령 실행과 같은 작업을 대신 수행할 수 있습니다.

따라서 파일을 직접 작업하거나 터미널에서 직접 명령을 실행할 때와 마찬가지로 사용할 Copilot CLI때 항상 보안 고려 사항을 염두에 두어야 합니다. 승인을 요청할 때 Copilot CLI 항상 제안된 명령을 신중하게 검토해야 합니다.

신뢰할 수 있는 디렉터리

신뢰할 수 있는 디렉터리에서는 파일을 읽고 수정하고 실행할 수 있는 위치를 Copilot CLI 제어합니다.

신뢰할 수 있는 디렉터리에서만 Copilot CLI를 시작해야 합니다. 신뢰할 수 없는 실행 파일을 포함할 수 있는 디렉터리에서 사용하면 Copilot CLI 안 됩니다. 마찬가지로, 중요하거나 기밀인 데이터나 변경하고 싶지 않은 파일이 들어 있는 디렉터리에서 CLI를 실행하면 의도치 않게 해당 파일이 위험에 노출될 수 있습니다. 일반적으로 홈 디렉터리에서 시작 Copilot CLI 해서는 안 됩니다.

사용 권한 범위 지정은 추론적이며 GitHub 신뢰할 수 있는 디렉터리 외부의 모든 파일이 보호되도록 보장하지는 않습니다. 위험 완화를 참조하세요.

          GitHub Copilot CLI 세션을 시작할 때, CLI를 실행한 디렉터리와 그 하위에 있는 파일을 신뢰하는지 확인해야 합니다. 
          [AUTOTITLE](/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli#setting-trusted-directories)을(를) 참조하세요.

허용된 도구

파일을Copilot 수정하거나 실행하는 데 사용할 수 있는 도구를 처음 예: touch, chmod, node, sed 사용해야 하는 경우 해당 도구를 사용하도록 허용할지 묻는 메시지가 표시됩니다.

일반적으로 다음 세 가지 옵션 중에서 선택할 수 있습니다.

1. Yes
2. Yes, and approve TOOL for the rest of the running session
3. No, and tell Copilot what to do differently (Esc)

          **옵션 1** 에서는 Copilot 이 특정 명령을 실행할 수 있습니다. 이번에는 이 명령만 실행할 수 있습니다. 다음에 이 도구를 사용해야 할 때 다시 묻게 됩니다.

          **옵션 2** 를 Copilot 사용하면 현재 실행 중인 세션 동안 권한을 요청하지 않고 이 도구를 다시 사용할 수 있습니다. 새로운 세션에서 또는 나중에 현재 세션을 다시 시작할 경우에는 다시 승인을 요청합니다. 이 옵션을 선택하면 Copilot가 적절하다고 생각하는 방식으로 이 도구를 사용할 수 있도록 허용하게 됩니다. 예를 들어 Copilot 명령을 `rm ./this-file.txt`실행할 수 있도록 허용하라는 메시지가 표시되고 옵션 2 Copilot 를 선택하면 승인을 요청하지 않고 이 세션의 현재 실행 중에 명령 `rm` (예 `rm -rf ./*`: )을 실행할 수 있습니다.

          **옵션 3** 은 제안된 명령을 취소하고 다른 방법을 시도하도록 지시 Copilot 할 수 있습니다.

수동 승인 없이 도구를 사용할 수 있도록 허용

대화형 또는 프로그래밍 방식 세션에서 승인을 요청하지 않고 사용할 수 있는 도구를 결정하는 데 사용할 수 있는 Copilot 세 가지 명령줄 옵션이 있습니다.

--allow-all-tools
```
        Copilot 승인을 요청하지 않고 도구를 사용할 수 있습니다.
```
예를 들어 CLI의 프로그래밍 방식 호출과 함께 이 옵션을 사용하여 모든 명령을 실행할 수 있습니다 Copilot . 다음은 그 예입니다.
```
copilot -p "Revert the last commit" --allow-all-tools
```
--deny-tool
```
        Copilot가 특정 도구를 사용하지 못하도록 방지합니다.
```
이 옵션은 --allow-all-tools 및 --allow-tool 옵션보다 우선 적용됩니다.

--allow-tool

        Copilot 승인을 요청하지 않고 특정 도구를 사용할 수 있습니다.

승인 옵션 사용하기

          `--deny-tool` 및 `--allow-tool` 옵션에는 다음 인수 중 하나가 필요합니다.

'shell(COMMAND)'

예를 들어, copilot --deny-tool='shell(rm)'가 Copilot이(가) 어떠한 rm 명령도 사용하지 못하게 합니다.
```
        `git` 및 `gh` 명령의 경우, 특정 1차 하위 명령을 지정하여 허용하거나 거부할 수 있습니다. 다음은 그 예입니다.
```
```
copilot --deny-tool='shell(git push)'
```
도구 사양은 선택 사항입니다. 예를 들어 copilot --allow-tool='shell'은 Copilot이 개별 승인 없이 모든 셸 명령을 사용할 수 있게 합니다.
'write'

이 인수는 셸 명령 이외의 도구에서 파일을 수정할 수 있는 권한을 허용하거나 거부합니다.

예를 들어 copilot --allow-tool='write'은 개별적인 승인 없이 Copilot 파일을 편집할 수 있습니다.
'MCP_SERVER_NAME'

이 인수는 지정된 MCP 서버의 도구를 허용하거나 거부합니다. 여기서 MCP_SERVER_NAME은 사용자가 구성한 MCP 서버의 이름입니다. 서버에서 제공하는 도구는 MCP 서버에 등록된 도구 이름을 사용하여 괄호로 지정됩니다. 도구를 지정하지 않고 서버 이름을 사용하면 해당 서버의 모든 도구를 허용하거나 거부할 수 있습니다.

예를 들어 copilot --deny-tool='My-MCP-Server(tool_name)'는 Copilot라는 MCP 서버에서 tool_name라는 도구를 My-MCP-Server가 사용하지 못하도록 합니다.

CLI의 대화형 인터페이스에 입력 /mcp 한 다음, 표시되는 목록에서 서버를 선택하여 MCP 서버의 이름을 찾을 수 있습니다.

승인 옵션 결합하기

승인 옵션의 조합을 사용하여 승인을 요청하지 않고 사용할 수 있는 도구를 Copilot 정확하게 결정할 수 있습니다.

예를 들어 Copilot가 rm 및 git push 명령을 사용하지 못하도록 하면서 다른 모든 도구는 자동으로 허용하려면 다음을 사용합니다.

copilot --allow-all-tools --deny-tool='shell(rm)' --deny-tool='shell(git push)'

MCP Copilot서버에서 도구를 tool_name 사용하지 못하도록 하지만 My-MCP-Server 해당 서버의 다른 모든 도구를 개별 승인 없이 사용할 수 있도록 하려면 다음을 사용합니다.

copilot --allow-tool='My-MCP-Server' --deny-tool='My-MCP-Server(tool_name)'

자동 도구 승인의 보안 영향

승인 명령줄 옵션 사용 시 보안에 미치는 영향을 알고 있어야 합니다. 이러한 옵션을 사용하면 Copilot 명령을 실행하기 전에 검토하고 승인할 수 있는 기회를 제공하지 않고 요청을 완료하는 데 필요한 명령을 실행할 수 있습니다. 이렇게 하면 워크플로를 간소화하고 CLI를 헤드리스로 작동할 수 있도록 하지만 데이터 손실, 손상 또는 기타 보안 문제가 발생할 수 있는 의도하지 않은 작업이 수행될 위험이 커집니다.

도구를 Copilot CLI 제어하려면 Copilot이(가) 도구를 사용하려 시도할 때 승인 프롬프트에 응답하거나, 명령줄 플래그로 사용 권한을 지정하거나, 대화형 세션에서 슬래시 명령(예: /allow-all 및 /yolo)을 사용할 수 있습니다. GitHub Copilot CLI 구성을(를) 참조하세요.

위험 완화

엄격하게 제어된 권한 및 네트워크 액세스를 사용하여 가상 머신, 컨테이너 또는 전용 시스템과 같은 제한된 환경에서 실행 Copilot CLI 하여 자동 승인 옵션을 사용하는 것과 관련된 위험을 완화할 수 있습니다. 검토 및 확인하지 않은 명령을 Copilot에서 실행할 때 발생할 수 있는 잠재적인 손상을 제한합니다.

알려진 MCP 서버 정책 제한 사항

          Copilot CLI 에서는 현재 다음과 같은 조직 수준 MCP 서버 정책을 지원할 수 없습니다.

* Copilot. * MCP 레지스트리 URL- MCP 서버를 사용할 수 있는 MCP 레지스트리 Copilot 를 제어합니다.

이러한 정책에 대한 자세한 내용은 회사의 MCP 서버 사용량을 참조하세요.

모델 사용

사용되는 GitHub Copilot CLI 기본 모델은 .입니다 클로드 소넷 4.5. GitHub 는 이 모델을 변경할 수 있는 권한을 보유합니다.

          GitHub Copilot CLI에서 사용하는 모델은 `/model` 슬래시 명령 또는 `--model` 명령줄 옵션을 사용하여 변경할 수 있습니다. 이 명령을 입력한 다음 목록에서 모델을 선택합니다.

대화형 인터페이스에서 Copilot에 프롬프트를 Copilot CLI에 제출할 때마다, 그리고 Copilot CLI를 프로그래밍 방식으로 사용할 때마다, Copilot 프리미엄 요청의 월별 할당량이 1씩 감소하며, 이는 모델 목록에 괄호로 표시된 승수로 곱해집니다. 예를 들어 이 Claude Sonnet 4.5 (1x) 모델을 사용하면 프롬프트를 제출할 때마다 프리미엄 요청 할당량이 1씩 감소한다는 것을 나타냅니다. 프리미엄 요청에 관한 내용은 GitHub Copilot 요청을(를) 참조하세요.

사용자 고유의 모델 공급자 사용

사용자 고유의 모델 공급자를 사용하도록 Copilot CLI를 구성하고 GitHub에서 호스팅된 모델 대신 사용할 수 있습니다. 이를 통해 Ollama와 같은 로컬 실행 모델을 포함하여 OpenAI 호환 엔드포인트, Azure OpenAI 또는 Anthropic에 연결할 수 있습니다. 환경 변수를 사용하여 모델 공급자를 구성합니다.

환경 변수	설명
`COPILOT_PROVIDER_BASE_URL`	모델 공급자의 API 엔드포인트의 기본 URL입니다.
`COPILOT_PROVIDER_TYPE`	공급자 유형( `openai` 기본값), `azure`또는 `anthropic`. 이 형식은 `openai` Ollama 및 vLLM을 포함하여 OpenAI 호환 엔드포인트에서 작동합니다.
`COPILOT_PROVIDER_API_KEY`	공급자를 인증하기 위한 API 키입니다. 로컬 Ollama 인스턴스와 같이 인증을 사용하지 않는 공급자에는 필요하지 않습니다.
`COPILOT_MODEL`	사용할 모델입니다(사용자 지정 공급자를 사용하는 경우 필요). 명령줄 옵션을 사용하여 `--model` 설정할 수도 있습니다.

함께 Copilot CLI 사용되는 모델은 도구 호출 (함수 호출) 및 스트리밍을 지원해야 합니다. 모델이 이러한 기능을 Copilot CLI 지원하지 않으면 오류가 반환됩니다. 최상의 결과를 얻으려면 모델에 최소 128k 토큰의 컨텍스트 창이 있어야 합니다.

모델 공급자를 구성하는 방법에 대한 자세한 내용은 터미널에서 copilot help providers를 실행합니다.

          Copilot CLI를 ACP를 통해 사용해보세요

ACP(에이전트 클라이언트 프로토콜)는 AI 에이전트와 상호 작용하기 위한 개방형 표준입니다. 이를 통해 이 프로토콜을 지원하는 타사 도구, IDE 또는 자동화 시스템에서 에이전트로 사용할 Copilot CLI 수 있습니다.

자세한 내용은 COPILOT CLI ACP 서버을(를) 참조하세요.

피드백

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

추가 읽기

        [AUTOTITLE](/copilot/how-tos/set-up/install-copilot-cli)

        [AUTOTITLE](/copilot/how-tos/use-copilot-agents/use-copilot-cli)

        [AUTOTITLE](/enterprise-cloud@latest/copilot/responsible-use/copilot-cli)