GitHub Copilot CLI 명령 참조

명령줄 명령어

Command	목적
`copilot`	대화형 사용자 인터페이스를 시작합니다.
`copilot help [topic]`	도움말 정보를 표시합니다. 도움말 항목에는 다음이 포함됩니다: `config`, `commands`, `environment`, `logging`, 및 `permissions`.
`copilot init`	이 리포지토리에 대한 Copilot 사용자 지정 지침을 초기화합니다.
`copilot update`	최신 버전을 다운로드하고 설치합니다.
`copilot version`	버전 정보를 표시하고 업데이트를 확인합니다.
`copilot login`	OAuth 디바이스 플로우를 사용하여 Copilot로 인증합니다.

          `--host HOST`를 허용하여 GitHub 호스트 URL(기본값: `https://github.com`)을 지정합니다. |

대화형 인터페이스 내 전역 단축키

Shortcut	목적
`@ FILENAME`	컨텍스트에 파일 내용을 포함합니다.

          <kbd>Ctrl</kbd>+<kbd>그런 다음 X</kbd>`/`  | 프롬프트 입력을 시작한 후에는 프롬프트를 다시 입력하지 않고도 모델을 변경하려는 경우 슬래시 명령을 실행할 수 있습니다. |

대화형 인터페이스의 타임라인 바로 가기

Shortcut	목적
Ctrl+o	프롬프트에 입력된 내용이 없더라도, Copilot의 응답 시간표에서 최근 항목을 확장하여 더 많은 세부 정보를 표시합니다.
Ctrl+e	프롬프트 입력란에 아무 내용도 없을 때, 이 동작은 Copilot의 응답 타임라인에 있는 모든 항목을 확장합니다.
Ctrl+t	응답에서 추론 표시를 확장/축소합니다.

Shortcut	목적

          <kbd>Ctrl</kbd>+<kbd>A</kbd>        | 입력할 때 줄의 시작 부분으로 이동합니다. |

대화형 인터페이스의 슬래시 명령

Command	목적
`/add-dir PATH`	파일 액세스를 위해 허용된 목록에 디렉터리를 추가합니다.
`/agent`	사용 가능한 에이전트(있는 경우)를 찾아 선택합니다.

          `/allow-all`, `/yolo`                               | 모든 권한(도구, 경로 및 URL)을 사용하도록 설정합니다. |

사용 가능한 슬래시 명령의 전체 목록을 보려면 CLI의 대화형 인터페이스에 입력 /help 합니다.

명령줄 옵션

Option	목적
`--acp`	에이전트 클라이언트 프로토콜 서버를 시작합니다.
`--add-dir PATH`	파일 액세스를 위해 허용된 목록에 디렉터리를 추가합니다(여러 번 사용할 수 있습니다).
`--add-github-mcp-tool TOOL`	기본 CLI 하위 집합 대신 GitHub MCP 서버에 사용하도록 설정하는 도구를 추가합니다(여러 번 사용할 수 있음). 모든 도구에 `*`을 사용하십시오.
`--add-github-mcp-toolset TOOLSET`	기본 CLI 하위 집합 대신 GitHub MCP 서버에 사용하도록 설정할 도구 집합을 추가합니다(여러 번 사용할 수 있음). 모든 도구 집합에 `all` 을 사용합니다.
`--additional-mcp-config JSON`	이 세션에 대해서만 MCP 서버를 추가합니다. 서버 구성은 JSON 문자열 또는 파일 경로(접두사 포함)로 `@`제공할 수 있습니다.

          `~/.copilot/mcp-config.json`에서 구성을 확장합니다. 동일한 이름으로 설치된 모든 MCP 서버 구성을 재정의합니다. |

명령 및 옵션의 전체 목록을 보려면 다음을 실행 copilot help합니다.

도구 사용 권한 패턴

          `--allow-tool` 및 `--deny-tool` 옵션은 사용 권한 패턴을 형식`Kind(argument)`으로 허용합니다. 인수는 선택 사항이며, 이를 생략하면 해당 종류의 모든 도구와 일치하게 됩니다.

Kind	Description	예제 패턴
`shell`	셸 명령 실행

          `shell(git push)`, `shell(git:*)`, `shell` |

| write | 파일 만들기 또는 수정 | write, write(src/*.ts) | | read | 파일 또는 디렉터리 읽기 | read, read(.env) | | SERVER-NAME | MCP 서버 도구 호출 | MyMCP(create_issue), MyMCP | | url | 웹 페치 또는 셸을 통한 URL 액세스 | url(github.com), url(https://*.api.com) | | memory | 에이전트 메모리에 팩트 저장 | memory |

          `shell` 규칙의 경우, `:*` 접미사는 명령어의 어간 뒤에 공백을 추가하여 부분적인 일치를 방지합니다. 예를 들어 `shell(git:*)`는 `git push` 및 `git pull`와 일치하지만 `gitea`와는 일치하지 않습니다.

거부 규칙은 설정된 경우에도 --allow-all 항상 허용 규칙보다 우선합니다.

# Allow all git commands except git push
copilot --allow-tool 'shell(git:*)' --deny-tool 'shell(git push)'

# Allow a specific MCP server tool
copilot --allow-tool 'MyMCP(create_issue)'

# Allow all tools from a server
copilot --allow-tool 'MyMCP'

환경 변수

변수	Description
`COPILOT_MODEL`	AI 모델을 설정합니다.
`COPILOT_ALLOW_ALL`	모든 권한을 자동으로 허용하도록 `true` 설정합니다(해당 `--allow-all`).
`COPILOT_AUTO_UPDATE`	자동 업데이트를 비활성화하려면 `false`로 설정하세요.
`COPILOT_CUSTOM_INSTRUCTIONS_DIRS`	사용자 지정 지침에 대한 쉼표로 구분된 추가 디렉터리 목록입니다.
`COPILOT_SKILLS_DIRS`	기술에 대한 쉼표로 구분된 추가 디렉터리 목록입니다.
`COPILOT_EDITOR`	대화형 편집을 위한 편집기 명령(명령 `$VISUAL` 및 `$EDITOR` 검사 후). 설정되지 않은 경우 기본값은 `vi`로 설정됩니다.
`COPILOT_GITHUB_TOKEN`	인증 토큰입니다.

          `GH_TOKEN` 및 `GITHUB_TOKEN`보다 우선합니다. |

구성 파일 설정

사용자 설정은 에 ~/.copilot/config.json저장됩니다. 프로젝트 수준 설정은 .copilot/settings.json (리포지토리에 커밋) 또는 .copilot/settings.local.json (개인 재정의—.gitignore에 추가)에 배치할 수 있습니다. 설정은 사용자에서 프로젝트, 그리고 로컬로 계단식으로 내려가며, 보다 구체적인 범위가 보다 일반적인 범위를 우선시합니다. 명령줄 플래그 및 환경 변수는 항상 가장 높은 우선 순위를 사용합니다.

암호키	유형	기본값	Description
`allowed_urls`	`string[]`	`[]`	URL 또는 도메인은 프롬프트 없이 허용됩니다.
`alt_screen`	`boolean`	`false`	터미널 대체 화면 버퍼를 사용합니다.
`auto_update`	`boolean`	`true`	CLI 업데이트를 자동으로 다운로드합니다.
`banner`

          `"always"`
          \|
          `"once"`
          \|
          `"never"`
         | `"once"` | 애니메이션 배너 표시 빈도입니다. |

후크 레퍼런스

후크는 세션 중에 특정 수명 주기 지점에서 실행되는 외부 명령으로, 사용자 지정 자동화, 보안 제어 및 통합을 사용하도록 설정합니다. 후크 구성 파일은 리포지토리의 .github/hooks/*.json에서 자동으로 로드됩니다.

후크 구성 형식

후크 구성 파일은 버전 1과 함께 JSON 형식을 사용합니다.

{
  "version": 1,
  "hooks": {
    "preToolUse": [
      {
        "type": "command",
        "bash": "your-bash-command",
        "powershell": "your-powershell-command",
        "cwd": "optional/working/directory",
        "env": { "VAR": "value" },
        "timeoutSec": 30
      }
    ]
  }
}

분야	유형	필수	Description
`type`	`"command"`	네

          `"command"`이어야 합니다. |

| bash | 문자열 | 다음 중 하나 bash/powershell | Unix에 대한 셸 명령입니다. | | powershell | 문자열 | 다음 중 하나 bash/powershell | Windows용 셸 명령입니다. | | cwd | 문자열 | 아니오 | 명령에 대한 작업 디렉터리입니다(리포지토리 루트 또는 절대를 기준으로). | | env | 객체 | 아니오 | 설정할 환경 변수(변수 확장 지원). | | timeoutSec | 숫자 | 아니오 | 초 단위의 시간 제한입니다. 기본값: 30. |

후크 이벤트

Event	발생하는 경우	처리된 출력
`sessionStart`	새 세션 또는 다시 시작된 세션이 시작됩니다.	아니오
`sessionEnd`	세션이 종료됩니다.	아니오
`userPromptSubmitted`	사용자가 프롬프트를 제출합니다.	아니오
`preToolUse`	각 도구를 실행하기 전에.	예 - 허용, 거부 또는 수정할 수 있습니다.
`postToolUse`	각 도구가 완료된 후	아니오
`agentStop`	주 에이전트가 턴을 완료합니다.	예 - 연속을 차단하고 강제 적용할 수 있습니다.
`subagentStop`	서브에이전트가 완료됩니다.	예 - 연속을 차단하고 강제 적용할 수 있습니다.
`errorOccurred`	실행하는 동안 오류가 발생합니다.	아니오

          `preToolUse` 의사 결정 제어

          `preToolUse` 후크는 stdout에 JSON 개체를 작성하여 도구 실행을 제어할 수 있습니다.

분야	가치들	Description
`permissionDecision`

          `"allow"`, `"deny"`, `"ask"` | 도구가 실행되는지 여부입니다. 빈 출력은 기본 동작을 사용합니다. |

          `agentStop`
           / 
          `subagentStop` 의사 결정 제어

분야	가치들	Description
`decision`

          `"block"`, `"allow"` | 
          `"block"` 는 `reason` 를 프롬프트로 사용하여 다른 에이전트의 차례를 강제합니다. |

| reason | 문자열 | decision가 "block"일 때 다음 턴에 대한 프롬프트. |

후크 일치를 위한 도구 이름

도구 이름	Description
`bash`	셸 명령 실행(Unix).
`powershell`	셸 명령을 실행합니다(Windows).
`view`	파일 내용을 읽습니다.
`edit`	파일 내용을 수정합니다.
`create`	새 파일을 만듭니다.
`glob`	패턴별로 파일을 찾습니다.
`grep`	파일 콘텐츠를 검색합니다.
`web_fetch`	웹 페이지를 가져옵니다.
`task`	서브에이전트 작업을 실행합니다.

동일한 형식의 여러 후크가 구성된 경우 순서대로 실행됩니다. 의 경우 preToolUse후크가 반환 "deny"되면 도구가 차단됩니다. 후크 오류(0이 아닌 종료 코드 또는 시간 초과)는 로그에 기록되며 건너뜁니다. 이러한 오류는 에이전트 실행을 절대 차단하지 않습니다.

MCP 서버 구성

MCP 서버는 CLI 에이전트에 추가 도구를 제공합니다. ~/.copilot/mcp-config.json에서 영구 서버를 구성하십시오. 단일 세션에 대한 서버를 추가하는 데 사용합니다 --additional-mcp-config .

전송 형식

유형	Description	필수 필드
`local` / `stdio`	stdin/stdout을 통해 통신하는 로컬 프로세스입니다.

          `command`, `args` |

| http | 스트리밍 가능한 HTTP 전송을 사용하는 원격 서버입니다. | url | | sse | Server-Sent 이벤트 전송을 사용하는 원격 서버입니다. | url |

로컬 서버 구성 필드

분야	필수	Description
`command`	네	서버를 시작하는 명령입니다.
`args`	네	명령 인수(배열).
`tools`	네	사용하도록 설정할 도구: `["*"]` 모두 또는 특정 도구 이름 목록
`env`	아니오	환경 변수입니다.

          `$VAR`, `${VAR}`, 및 `${VAR:-default}` 확장을 지원합니다. |

| cwd | 아니오 | 서버에 대한 작업 디렉터리입니다. | | timeout | 아니오 | 도구 호출 시간 제한(밀리초)입니다. | | type | 아니오 | "local" 또는 "stdio". 기본값: "local". |

원격 서버 구성 필드

분야	필수	Description
`type`	네

          `"http"` 또는 `"sse"`. |

필터 매핑

MCP 도구 출력이 처리되는 방법을 서버 구성의 filterMapping 필드를 사용하여 제어합니다.

모드	Description
`none`	필터링이 없습니다.
`markdown`	출력의 서식을 Markdown으로 지정합니다.
`hidden_characters`	숨겨진 문자 또는 컨트롤 문자를 제거합니다. Default.

기본 제공 MCP 서버

CLI에는 추가 설정 없이 사용할 수 있는 기본 제공 MCP 서버가 포함되어 있습니다.

서버	Description
`github-mcp-server`	GitHub API 통합: 문제, 풀 리퀘스트, 커밋, 코드 검색 및 GitHub Actions.
`playwright`	브라우저 자동화: 탐색, 클릭, 입력, 스크린샷 및 양식 처리
`fetch`	HTTP 요청은 `fetch` 도구를 통해 이루어집니다.
`time`	시간 유틸리티: `get_current_time` 및 `convert_time`.

모든 기본 제공 서버를 사용하지 않도록 설정하거나 --disable-builtin-mcps 특정 서버를 사용하지 않도록 설정하는 데 사용합니다--disable-mcp-server SERVER-NAME.

기술 참조

기술은 CLI에서 수행할 수 있는 작업을 확장하는 Markdown 파일입니다. 각 기술은 SKILL.md 파일이 포함된 자체 디렉터리에 있습니다. 에이전트를 통해 /SKILL-NAME 또는 자동으로 호출되면 기술의 콘텐츠가 대화에 삽입됩니다.

기술 프런트매터 필드

분야	유형	필수	Description
`name`	문자열	네	스킬의 고유 식별자입니다. 문자, 숫자 및 하이픈만 해당됩니다. 최대 64자
`description`	문자열	네	기술이 수행하는 기능 및 사용 시기. 최대 1024자
`allowed-tools`	string 또는 string[]	아니오	기술이 활성 상태일 때 자동으로 허용되는 쉼표로 구분된 목록 또는 YAML 도구 배열입니다. 모든 도구에 `"*"`을 사용하십시오.
`user-invocable`	부울	아니오	사용자가 `/SKILL-NAME`를 사용하여 기술을 호출할 수 있는지 여부입니다. 기본값: `true`.
`disable-model-invocation`	부울	아니오	에이전트가 이 기술을 자동으로 호출하지 않도록 합니다. 기본값: `false`.

기술 위치

스킬은 우선순위에 따라 이 위치에서 로드됩니다(중복 이름의 경우, 먼저 발견된 것이 우선합니다).

위치	Scope	Description
`.github/skills/`	프로젝트	프로젝트별 기술.
`.agents/skills/`	프로젝트	대체 프로젝트 위치입니다.
`.claude/skills/`	프로젝트	클로드 호환 위치입니다.
부모 `.github/skills/`	Inherited	Monorepo 부모 디렉터리 지원.
`~/.copilot/skills/`	개인적인	모든 프로젝트에 대한 개인 기술.
`~/.claude/skills/`	개인적인	Claude와 호환되는 사용자의 위치.
플러그 인 디렉터리	플러그 인	설치된 플러그인에서 제공하는 기능입니다.
`COPILOT_SKILLS_DIRS`	Custom	추가 디렉터리(쉼표로 구분).

에이전트	기본 모델	Description
`explore`	claude-haiku-4.5	빠른 코드베이스 탐색. 파일을 검색하고, 코드를 읽고, 질문에 답변합니다. 300단어 미만의 포커스가 있는 답변을 반환합니다. 병렬로 실행해도 안전합니다.
`task`	claude-haiku-4.5	명령 실행(테스트, 빌드, 린트). 성공, 실패의 전체 출력에 대한 간략한 요약을 반환합니다.
`code-review`	claude-sonnet-4.5	높은 신호 대 잡음비 코드 검토 버그, 보안 문제 및 논리 오류에 대한 변경사항을 분석합니다.
`general-purpose`	claude-sonnet-4.5	복잡한 다단계 작업에 대한 전체 기능 에이전트입니다. 별도의 컨텍스트 창에서 실행됩니다.

사용자 지정 에이전트 프런트매터 필드

분야	유형	필수	Description
`name`	문자열	아니오	표시 이름입니다. 기본값은 파일 이름입니다.
`description`	문자열	네	에이전트 목록 및 `task` 도구에 표시된 설명입니다.
`model`	문자열	아니오	이 에이전트에 대한 AI 모델입니다. 설정되지 않은 경우 외부 에이전트의 모델을 상속합니다.
`tools`	문자열[]	아니오	에이전트에서 사용할 수 있는 도구입니다. 기본값: `["*"]` (모든 도구).
`mcp-servers`	객체	아니오	연결할 MCP 서버입니다. 와 동일한 스키마를 `~/.copilot/mcp-config.json`사용합니다.
`infer`	부울	아니오	주 에이전트에서 자동 위임을 허용합니다. 기본값: `true`.

사용자 지정 에이전트 위치

Scope	위치
프로젝트

          `.github/agents/` 또는 `.claude/agents/` |

프로젝트 수준 에이전트는 사용자 수준 에이전트보다 우선합니다. 플러그 인 에이전트의 우선 순위가 가장 낮습니다.

사용 권한 승인 응답

CLI에서 작업을 실행할 수 있는 권한을 묻는 메시지가 표시되면 다음 키로 응답할 수 있습니다.

암호키	영향
`y`	이 특정 요청을 한 번 허용합니다.
`n`	이 특정 요청을 한 번 거부합니다.
`!`	세션의 나머지 부분에 대해 유사한 모든 요청을 허용합니다.
`#`	세션의 나머지 부분에 대해 유사한 모든 요청을 거부합니다.
`?`	요청에 대한 자세한 정보를 표시합니다.

새 세션을 실행 /clear 하거나 시작할 때 세션 승인이 다시 설정됩니다.

Flag	티어	Description
`AUTOPILOT_MODE`	`experimental`	자율 작업 모드입니다.
`BACKGROUND_AGENTS`	`staff`	백그라운드에서 에이전트를 실행합니다.
`QUEUED_COMMANDS`	`staff`	에이전트가 실행되는 동안 명령을 큐에 추가합니다.
`LSP_TOOLS`	`on`	언어 서버 프로토콜 도구.
`PLAN_COMMAND`	`on`	대화형 계획 모드입니다.
`AGENTIC_MEMORY`	`on`	세션 간 영구 메모리입니다.
`CUSTOM_AGENTS`	`on`	사용자 지정 에이전트 정의입니다.