GitHub Copilot CLI 프로그래밍 방식 참조

대화형으로 실행하는 코파일럿 CLI 것 외에도 대화형 세션을 입력하지 않고 단일 명령으로 CLI에 직접 프롬프트를 전달할 수 있습니다. 이렇게 하면 스크립트, CI/CD 파이프라인 및 자동화 워크플로에서 프로그래밍 방식으로 사용할 Copilot 수 있습니다. 자세한 내용은 프로그래밍 방식으로 실행 GitHub Copilot 명령 줄 인터페이스 (CLI)을(를) 참조하세요.

이 문서에서는 프로그래밍 방식으로 실행할 코파일럿 CLI 때 특히 관련된 명령줄 옵션 및 환경 변수에 대해 설명합니다.

사용 가능한 옵션의 전체 목록을 보려면 GitHub Copilot CLI 명령 참조 을 참조하거나 터미널에서 다음 명령을 입력합니다.

copilot help

copilot help

명령줄 옵션

프로그래밍 방식으로 실행할 코파일럿 CLI 때 특히 유용한 여러 명령줄 옵션이 있습니다.

--allow-tool 옵션에 대한 도구

옵션을 사용하여 다양한 종류의 도구를 --allow-tool 지정할 수 있습니다.

도구 필터

shell, write및 urlMCP 서버 도구 종류를 사용하면 필터를 괄호로 지정하여 허용되는 특정 도구를 제어할 수 있습니다.

환경 변수

환경 변수를 사용하여 프로그래밍 방식으로 실행할 때 CLI 동작의 다양한 측면을 구성할 수 있습니다. 이는 명령줄에서 특정 옵션을 직접 지정하지 않으려는 CI/CD 워크플로 또는 기타 자동화된 환경에서 구성을 설정하는 데 특히 유용합니다.

터미널에서 코파일럿 CLI 명령을 사용하여 copilot help environment의 환경 변수 전체 내용을 확인하십시오.

모델 선택

비대화형 모드로 프롬프트를 코파일럿 CLI 보내면 CLI가 응답을 생성하는 데 사용하는 모델이 응답 출력에 표시됩니다(또는 , -s옵션이 사용되지 않는 경우--silent).

이 옵션을 사용하여 CLI에서 --model 사용해야 하는 AI 모델을 지정할 수 있습니다. 이를 통해 프롬프트에 가장 적합한 모델을 선택하고 속도, 비용 및 기능과 같은 요인을 분산할 수 있습니다.

예를 들어 일부 코드를 설명하거나 요약을 생성하는 등의 간단한 작업의 경우 Claude Haiku 모델과 같은 빠르고 저렴한 비용 모델을 선택할 수 있습니다.

copilot -p "What does this project do?" -s --model claude-haiku-4.5

copilot -p "What does this project do?" -s --model claude-haiku-4.5

코드 디버깅 또는 리팩터링과 같은 심층적인 추론이 필요한 더 복잡한 작업의 경우 GPT Codex 모델과 같은 보다 강력한 모델을 선택할 수 있습니다.

copilot -p "Fix the race condition in the worker pool" \
  --model gpt-5.3-codex \
  --allow-tool='write, shell'

copilot -p "Fix the race condition in the worker pool" \
  --model gpt-5.3-codex \
  --allow-tool='write, shell'

또는 환경 변수를 COPILOT_MODEL 설정하여 셸 세션 기간 동안 모델을 지정할 수 있습니다.

셸 세션에서 모델 선택을 유지하려면 CLI 구성 파일에서 키를 설정할 model 수 있습니다. 이 파일은 ~/.copilot/settings.json에 위치해 있습니다 (또는 $COPILOT_HOME/settings.json 환경 변수를 설정한 경우 COPILOT_HOME에 위치해 있습니다). 또한 일부 모델을 사용하면 추론 작업 수준을 설정하여 모델이 응답하기 전에 생각하는 데 소요되는 시간을 제어할 수 있습니다.

{
  "model": "gpt-5.3-codex",
  "effortLevel": "low"
}

{
  "model": "gpt-5.3-codex",
  "effortLevel": "low"
}

모델 우선 순위

지정된 프롬프트에 사용할 모델을 결정할 때 CLI는 다음 우선 순위(가장 높음에서 가장 낮은 수준)로 모델 사양을 확인합니다.

• 사용자 지정 에이전트가 사용되는 위치: 사용자 지정 에이전트 정의에 지정된 모델(있는 경우)입니다.
• --model 명령줄 옵션입니다.
• COPILOT_MODEL 환경 변수입니다.
• model 구성 파일(~/.copilot/settings.json또는$COPILOT_HOME/settings.json)의 키입니다.
• CLI의 기본 모델입니다.

사용자 지정 에이전트 사용

이 옵션을 사용하여 특수 에이전트에 작업을 위임할 --agent 수 있습니다. 자세한 내용은 사용자 지정 에이전트 만들기 및 사용 GitHub Copilot 명령 줄 인터페이스 (CLI)을(를) 참조하세요.

이 예제에서는 에이전트가 code-review 사용됩니다. 이렇게 하려면 이 이름으로 사용자 지정 에이전트를 만들어야 합니다.

copilot -p "Review the latest commit" \
  --allow-tool='shell' \
  --agent code-review

추가 읽기

• GitHub Copilot 명령 줄 인터페이스 (CLI)
• GitHub Copilot CLI 명령 참조
• GitHub Copilot CLI 플러그 인 참조