GitHub Copilot CLI 명령 참조

명령줄 명령어

Command	목적
copilot	대화형 사용자 인터페이스를 시작합니다.
copilot help [topic]	도움말 정보를 표시합니다. 도움말 항목에는 다음이 포함됩니다: , , , , 및 .
copilot init	이 리포지토리에 대한 Copilot 사용자 지정 지침을 초기화합니다.
copilot update	최신 버전을 다운로드하고 설치합니다.
copilot version	버전 정보를 표시하고 업데이트를 확인합니다.
copilot login	OAuth 디바이스 플로우를 사용하여 Copilot로 인증합니다. 를 허용하여 GitHub 호스트 URL(기본값: )을 지정합니다.
copilot logout	GitHub에서 로그아웃하고 저장된 자격 증명을 제거합니다.
copilot plugin	플러그 인 및 플러그 인 마켓플레이스를 관리합니다.

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

Shortcut	목적
@ FILENAME	컨텍스트에 파일 내용을 포함합니다.
Ctrl그런 다음 X	프롬프트 입력을 시작한 후에는 프롬프트를 다시 입력하지 않고도 모델을 변경하려는 경우 슬래시 명령을 실행할 수 있습니다.
Esc	현재 작업을 취소합니다.
! COMMAND	Copilot을(를) 우회하여 로컬 셸에서 명령을 실행합니다.
Ctrl 키C	작업 취소/입력 지우기 종료하려면 두 번 누릅니다.
CtrlD	종료.
CtrlL	화면을 지웁다.
Shift탭	표준, 계획 및 autopilot 모드 간을 순환합니다.

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

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

대화형 인터페이스의 탐색 바로 가기

Shortcut	목적
CtrlA	입력할 때 줄의 시작 부분으로 이동합니다.
Ctrl 키B	이전 문자로 이동합니다.
Ctrl전자	입력할 때 줄의 끝으로 이동합니다.
Ctrl 키F	다음 문자로 이동합니다.
Ctrl 키G	외부 편집기에서 프롬프트를 편집합니다.
Ctrl 키H	이전 문자를 삭제합니다.
CtrlK(K)	커서에서 줄 끝까지 삭제합니다.
CtrlU	커서부터 줄의 시작 부분까지 삭제합니다.
CtrlW	이전 단어를 삭제합니다.
홈	현재 줄의 시작으로 이동합니다.
끝	현재 줄의 끝으로 이동합니다.
Ctrl 키홈	텍스트의 시작 부분으로 이동합니다.
Ctrl 키끝	텍스트의 끝으로 이동합니다.
메타←→	커서를 한 단어씩 이동합니다.
↑↓	명령 기록을 탐색합니다.

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

Command	목적
/add-dir PATH	파일 액세스를 위해 허용된 목록에 디렉터리를 추가합니다.
/agent	사용 가능한 에이전트(있는 경우)를 찾아 선택합니다.
,	모든 권한(도구, 경로 및 URL)을 사용하도록 설정합니다.
,	대화 기록을 지웁다.
/compact	컨텍스트 창 사용량을 줄이기 위해 대화 기록을 요약합니다.
/context	컨텍스트 창 토큰 사용 및 시각화를 표시합니다.
,	작업 디렉터리를 변경하거나 현재 디렉터리를 표시합니다.
/delegate [PROMPT]	AI 생성 끌어오기 요청을 사용하여 원격 리포지토리에 변경 내용을 위임합니다.
/diff	현재 디렉터리의 변경 내용을 검토합니다.
,	CLI를 종료합니다.
/experimental [on|off]	실험적 기능을 설정/해제합니다.
/feedback	CLI에 대한 피드백을 제공합니다.
/fleet [PROMPT]	태스크 부분의 병렬 스바겐트 실행을 사용하도록 설정합니다. AUTOTITLE을(를) 참조하세요.
/help	대화형 명령에 대한 도움말을 표시합니다.
/ide	IDE 작업 영역에 연결합니다.
/init	이 리포지토리에 대한 Copilot 사용자 지정 지침 및 에이전트 기능을 초기화합니다.
/list-dirs	파일 액세스가 허용된 모든 디렉터리를 표시합니다.
/login	Copilot에 로그인하세요.
/logout	Copilot에서 로그아웃합니다.
/lsp [show|test|reload|help] [SERVER-NAME]	언어 서버 구성을 관리합니다.
/mcp [show|add|edit|delete|disable|enable] [SERVER-NAME]	MCP 서버 구성을 관리합니다.
,	사용하려는 AI 모델을 선택합니다.
/plan [PROMPT]	코딩하기 전에 구현 계획을 만듭니다.
/plugin [marketplace|install|uninstall|update|list] [ARGS...]	플러그 인 및 플러그 인 마켓플레이스를 관리합니다.
/rename NAME	현재 세션의 이름을 바꿉니다 (별칭: ).
/reset-allowed-tools	허용된 도구 목록을 다시 설정합니다.
/resume [SESSION-ID]	목록에서 선택하여 다른 세션으로 전환합니다(선택적으로 세션 ID 지정).
/review [PROMPT]	코드 검토 에이전트를 실행하여 변경 내용을 분석합니다.
/session [checkpoints [n]|files|plan|rename NAME]	세션 정보 및 작업 영역 요약을 표시합니다. 자세한 내용은 하위 명령을 사용합니다.
/share [file|gist] [PATH]	Markdown 파일 또는 GitHub 요점에 세션을 공유합니다.
/skills [list|info|add|remove|reload] [ARGS...]	향상된 기능을 위한 기술을 관리합니다.
/terminal-setup	여러 줄 입력 지원을 위해 터미널을 구성합니다(ShiftEnter 및 CtrlEnter).
/theme [show|set|list] [auto|THEME-ID]	터미널 테마를 보거나 구성합니다.
/usage	세션 사용 메트릭 및 통계를 표시합니다.
/user [show|list|switch]	현재 GitHub 사용자를 관리합니다.

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

명령줄 옵션

Option	목적
--acp	에이전트 클라이언트 프로토콜 서버를 시작합니다.
--add-dir PATH	파일 액세스를 위해 허용된 목록에 디렉터리를 추가합니다(여러 번 사용할 수 있습니다).
--add-github-mcp-tool TOOL	기본 CLI 하위 집합 대신 GitHub MCP 서버에 사용하도록 설정하는 도구를 추가합니다(여러 번 사용할 수 있음). 모든 도구에 을 사용하십시오.
--add-github-mcp-toolset TOOLSET	기본 CLI 하위 집합 대신 GitHub MCP 서버에 사용하도록 설정할 도구 집합을 추가합니다(여러 번 사용할 수 있음). 모든 도구 집합에 을 사용합니다.
--additional-mcp-config JSON	이 세션에 대해서만 MCP 서버를 추가합니다. 서버 구성은 JSON 문자열 또는 파일 경로(접두사 포함)로 제공할 수 있습니다. 에서 구성을 확장합니다. 동일한 이름으로 설치된 모든 MCP 서버 구성을 재정의합니다.
--agent AGENT	사용할 사용자 지정 에이전트를 지정합니다.
--allow-all	모든 사용 권한을 와 동일하게 활성화합니다.
--allow-all-paths	파일 경로 확인을 사용하지 않도록 설정하고 모든 경로에 대한 액세스를 허용합니다.
--allow-all-tools	모든 도구가 확인 없이 자동으로 실행되도록 허용합니다. CLI를 프로그래밍 방식으로 사용할 때 필요합니다(env: ).
--allow-all-urls	확인 없이 모든 URL에 대한 액세스를 허용합니다.
--allow-tool [TOOLS...]	CLI에 사용할 수 있는 권한이 있는 도구입니다. 사용 권한을 묻는 메시지가 표시되지 않습니다.
--allow-url [URLS...]	특정 URL 또는 도메인에 대한 액세스를 허용합니다.
--alt-screen [VALUE]	터미널 대체 화면 버퍼( 또는 )를 사용합니다.
--autopilot	프롬프트 모드에서 자동 운항 연속 실행을 활성화합니다. AUTOTITLE을(를) 참조하세요.
--available-tools [TOOLS...]	이러한 도구만 모델에서 사용할 수 있습니다.
--banner	시작 배너를 표시합니다.
--bash-env [VALUE]	bash 셸(또는)에 대한 지원을 사용하도록 설정합니다.
--config-dir PATH	구성 디렉터리(기본값: )를 설정합니다.
--continue	가장 최근 세션을 다시 시작합니다.
--deny-tool [TOOLS...]	CLI에 사용할 권한이 없는 도구입니다. 사용 권한을 묻는 메시지가 표시되지 않습니다.
--deny-url [URLS...]	특정 URL 또는 도메인에 대한 액세스 거부는 보다 우선합니다.
--disable-builtin-mcps	모든 기본 제공 MCP 서버(현재: )를 사용하지 않도록 설정합니다.
--disable-mcp-server SERVER-NAME	특정 MCP 서버를 사용하지 않도록 설정합니다(여러 번 사용할 수 있습니다).
--disable-parallel-tools-execution	도구의 병렬 실행을 사용하지 않도록 설정합니다(LLM은 병렬 도구 호출을 수행할 수 있지만 순차적으로 실행됨).
--disallow-temp-dir	시스템 임시 디렉터리에 대한 자동 액세스를 방지합니다.
--enable-all-github-mcp-tools	기본 CLI 하위 집합 대신 모든 GitHub MCP 서버 도구를 사용하도록 설정합니다. 및 옵션을 재정의합니다.
--excluded-tools [TOOLS...]	이러한 도구는 모델에서 사용할 수 없습니다.
--experimental	실험적 기능을 활성화합니다(을 사용해 비활성화).
,	도움말을 표시합니다.
,	대화형 세션을 시작하고 이 프롬프트를 자동으로 실행합니다.
--log-dir DIRECTORY	로그 파일 디렉터리(기본값: )를 설정합니다.
--log-level LEVEL	로그 수준(선택 사항: ,, , , ) 을 설정합니다.
--max-autopilot-continues COUNT	autopilot 모드의 최대 연속 메시지 수(기본값: 무제한). AUTOTITLE을(를) 참조하세요.
--model MODEL	사용하려는 AI 모델을 설정합니다.
--no-alt-screen	터미널 대체 화면 버퍼를 사용하지 않도록 설정합니다.
--no-ask-user	도구를 사용하지 않도록 설정합니다(에이전트는 질문을 하지 않고 자율적으로 작동).
--no-auto-update	CLI 업데이트를 자동으로 다운로드하지 않도록 설정합니다.
--no-bash-env	bash 셸에 대한 지원을 사용하지 않도록 설정합니다 .
--no-color	모든 색 출력을 사용하지 않도록 설정합니다.
--no-custom-instructions	사용자 지정 명령 및 관련 파일의 로드를 에서 비활성화합니다.
--no-experimental	실험적 기능을 사용하지 않도록 설정합니다.
,	프로그래밍 방식으로 프롬프트를 실행합니다(완료 후 종료).
--plain-diff	리치 다이프 렌더링(git 설정에서 지정한 diff 도구를 통해 구문 강조 표시 제공)을 비활성화합니다.
--resume [SESSION-ID]	목록에서 선택하여 이전 대화형 세션을 다시 시작합니다(선택적으로 세션 ID 지정).
,	을 사용하여 스크립팅하는 데 유용한 에이전트 응답(사용 통계 제외)만 출력합니다.
--screen-reader	화면 읽기 프로그램 최적화를 사용하도록 설정합니다.
--share [PATH]	프로그래밍 방식 세션(기본 경로: )이 완료된 후 Markdown 파일에 세션을 공유합니다.
--share-gist	프로그래밍 방식 세션이 완료된 후 세션을 비공개 GitHub gist로 공유합니다.
--stream MODE	스트리밍 모드(모드 선택: 또는)를 사용하거나 사용하지 않도록 설정합니다.
,	버전 정보를 표시합니다.
--yolo	모든 사용 권한을 와 동일하게 활성화합니다.

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

도구 사용 권한 패턴

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

Kind	Description	예제 패턴
shell	셸 명령 실행	, ,
write	파일 만들기 또는 수정	,
read	파일 또는 디렉터리 읽기	,
SERVER-NAME	MCP 서버 도구 호출	,
url	웹 페치 또는 셸을 통한 URL 액세스	,
memory	에이전트 메모리에 팩트 저장	memory

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

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

# 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	모든 권한을 자동으로 허용하도록 설정합니다(해당 ).
COPILOT_AUTO_UPDATE	자동 업데이트를 비활성화하려면 로 설정하세요.
COPILOT_CUSTOM_INSTRUCTIONS_DIRS	사용자 지정 지침에 대한 쉼표로 구분된 추가 디렉터리 목록입니다.
COPILOT_SKILLS_DIRS	기술에 대한 쉼표로 구분된 추가 디렉터리 목록입니다.
COPILOT_EDITOR	대화형 편집을 위한 편집기 명령(명령 및 검사 후). 설정되지 않은 경우 기본값은 로 설정됩니다.
COPILOT_GITHUB_TOKEN	인증 토큰입니다. 및 보다 우선합니다.
GH_TOKEN	인증 토큰입니다. 보다 우선합니다.
GITHUB_TOKEN	인증 토큰입니다.
XDG_CONFIG_HOME	구성 디렉터리를 재정의합니다. 기본값: .
XDG_STATE_HOME	상태 디렉터리를 재정의합니다. 기본값: .
USE_BUILTIN_RIPGREP	번들된 버전 대신 시스템의 ripgrep을 사용하도록 설정합니다.
PLAIN_DIFF	리치 차이 렌더를 로 비활성화합니다.
COLORFGBG	어두운/밝은 터미널 배경 감지에 대한 대안입니다.
COPILOT_CLI_ENABLED_FEATURE_FLAGS	사용하도록 설정할 기능 플래그의 쉼표로 구분된 목록입니다(예: ).

구성 파일 설정

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

암호키	유형	기본값	Description
allowed_urls	string[]	[]	URL 또는 도메인은 프롬프트 없이 허용됩니다.
alt_screen	boolean	false	터미널 대체 화면 버퍼를 사용합니다.
auto_update	boolean	true	CLI 업데이트를 자동으로 다운로드합니다.
banner	"always" | "once" | "never"	"once"	애니메이션 배너 표시 빈도입니다.
bash_env	boolean	false	bash 셸에 대한 지원을 사용하도록 설정합니다 .
beep	boolean	true	주의가 필요할 때 가청 경고음을 재생합니다.
compact_paste	boolean	true	대량 붙여넣기 데이터를 압축된 토큰으로 축소합니다.
custom_agents.default_local_only	boolean	false	로컬 사용자 지정 에이전트만 사용합니다.
denied_urls	string[]	[]	차단된 URL 또는 도메인(보다 우선합니다).
experimental	boolean	false	실험적 기능을 사용하도록 설정합니다.
include_coauthor	boolean	true	에이전트가 만든 git 커밋에 레이블을 추가합니다.
launch_messages	string[]	[]	시작 시 임의로 표시되는 사용자 지정 메시지입니다.
log_level	"none" | "error" | "warning" | "info" | "debug" | "all" | "default"	"default"	로깅 상세 수위
model	string	varies	사용할 AI 모델( 명령 참조).
reasoning_effort	"low" | "medium" | "high" | "xhigh"	"medium"	확장된 사고를 위한 추론적 노력의 수준입니다. 상위 수준은 더 많은 컴퓨팅을 사용합니다.
render_markdown	boolean	true	터미널 출력에서 Markdown을 렌더링합니다.
screen_reader	boolean	false	화면 읽기 프로그램 최적화를 사용하도록 설정합니다.
stream	boolean	true	스트리밍 응답을 사용하도록 설정합니다.
store_token_plaintext	boolean	false	시스템 키 집합을 사용할 수 없는 경우 인증 토큰을 구성 파일에 일반 텍스트로 저장합니다.
streamer_mode	boolean	false	미리 보기 모델 이름 및 할당량 세부 정보를 숨깁니다(기록할 때 유용).
theme	"auto" | "dark" | "light"	"auto"	터미널 색 테마입니다.
trusted_folders	string[]	[]	미리 부여된 파일 액세스 권한이 있는 폴더입니다.
update_terminal_title	boolean	true	터미널 제목에 현재 의도를 표시합니다.

후크 레퍼런스

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

후크 구성 형식

후크 구성 파일은 버전 과 함께 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"	네	이어야 합니다.
bash	문자열	다음 중 하나	Unix에 대한 셸 명령입니다.
powershell	문자열	다음 중 하나	Windows 대한 셸 명령입니다.
cwd	문자열	아니오	명령에 대한 작업 디렉터리입니다(리포지토리 루트 또는 절대를 기준으로).
env	객체	아니오	설정할 환경 변수(변수 확장 지원).
timeoutSec	숫자	아니오	초 단위의 시간 제한입니다. 기본값: .

후크 이벤트

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

의사 결정 제어

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

분야	가치들	Description
permissionDecision	, ,	도구가 실행되는지 여부입니다. 빈 출력은 기본 동작을 사용합니다.
permissionDecisionReason	문자열	에이전트에게 보여지는 이유. 결정 시 가 필요합니다.
modifiedArgs	객체	원본 대신 사용할 대체 도구 인수입니다.

의사 결정 제어

분야	가치들	Description
decision	,	는 를 프롬프트로 사용하여 다른 에이전트의 차례를 강제합니다.
reason	문자열	가 일 때 다음 턴에 대한 프롬프트.

후크 일치를 위한 도구 이름

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

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

MCP 서버 구성

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

전송 형식

유형	Description	필수 필드
local / stdio	stdin/stdout을 통해 통신하는 로컬 프로세스입니다.	,
http	스트리밍 가능한 HTTP 전송을 사용하는 원격 서버입니다.	url
sse	Server-Sent 이벤트 전송을 사용하는 원격 서버입니다.	url

로컬 서버 구성 필드

분야	필수	Description
command	네	서버를 시작하는 명령입니다.
args	네	명령 인수(배열).
tools	네	사용하도록 설정할 도구: 모두 또는 특정 도구 이름 목록
env	아니오	환경 변수입니다. , , 및 확장을 지원합니다.
cwd	아니오	서버에 대한 작업 디렉터리입니다.
timeout	아니오	도구 호출 시간 제한(밀리초)입니다.
type	아니오	또는 . 기본값: .

원격 서버 구성 필드

분야	필수	Description
type	네	또는 .
url	네	서버 URL입니다.
tools	네	활성화할 도구입니다.
headers	아니오	HTTP 헤더. 변수 확장을 지원합니다.
oauthClientId	아니오	정적 OAuth 클라이언트 ID(동적 등록 건너뛰기).
oauthPublicClient	아니오	OAuth 클라이언트가 공용인지 여부입니다. 기본값: .
timeout	아니오	도구 호출 시간 제한(밀리초)입니다.

필터 매핑

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

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

기본 제공 MCP 서버

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

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

모든 기본 제공 서버를 사용하지 않도록 설정하거나 특정 서버를 사용하지 않도록 설정하는 데 사용합니다.

기술 참조

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

기술 프런트매터 필드

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

기술 위치

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

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

명령(대체 기술 형식)

명령은 .에 개별 파일로 저장된 기술에 대한 대안입니다 . 명령 이름은 파일 이름에서 파생됩니다. 명령 파일은 간단한 형식을 사용하며 ( 필드가 필요하지 않음) , 및 를 지원합니다. 명령은 이름이 같은 기술보다 우선 순위가 낮습니다.

사용자 지정 에이전트 참조

사용자 지정 에이전트는 Markdown 파일에 정의된 특수한 AI 에이전트입니다. 파일 이름(확장명 빼기)이 에이전트 ID가 됩니다. 또는 을 파일 확장자로 사용합니다.

기본 제공 에이전트

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

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

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

사용자 지정 에이전트 위치

Scope	위치
프로젝트	또는
사용자	또는
플러그 인	<plugin>/agents/

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

사용 권한 승인 응답

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

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

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

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