GitHub Copilot CLI 구성 디렉터리

          코파일럿 CLI 는 컴퓨터의 단일 디렉터리에 구성, 세션 기록, 로그 및 사용자 지정을 저장합니다. 기본적으로 이 디렉터리는 `~/.copilot` (즉, `$HOME/.copilot`)입니다.

이 문서에서는 이 디렉터리의 내용과 이를 사용하는 방법을 설명합니다.

디렉터리 개요

          `~/.copilot` 디렉터리에는 다음과 같은 최상위 항목이 포함됩니다.

Path	유형	설명
`config.json`	파일	개인 구성 설정
`mcp-config.json`	파일	사용자 수준 MCP 서버 정의
`permissions-config.json`	파일	프로젝트당 저장된 도구 및 디렉터리 권한
`agents/`	디렉터리	개인 사용자 지정 에이전트 정의
`skills/`	디렉터리	개인 사용자 지정 기술 정의
`hooks/`	디렉터리	사용자 수준 후크 스크립트
`logs/`	디렉터리	세션 로그 파일
`session-state/`	디렉터리	세션 기록 및 작업 영역 데이터
`session-store.db`	파일	세션 간 데이터에 대한 SQLite 데이터베이스
`installed-plugins/`	디렉터리	설치된 플러그 인 파일
`ide/`	디렉터리	IDE 통합 상태

참고

이러한 항목이 모두 즉시 표시되지는 않습니다. 일부는 특정 기능을 처음 사용할 때 요청 시 만들어집니다. 예를 들어 installed-plugins/ 첫 번째 플러그 인을 설치한 후에만 표시됩니다.

사용자가 편집할 수 있는 파일

다음 파일은 사용자가 직접 편집하거나 CLI 명령을 통해 관리하도록 설계되었습니다.

`config.json`

에 대한 기본 구성 파일입니다 코파일럿 CLI. 텍스트 편집기에서 직접 편집하거나 대화형 명령을 /model``/theme 사용하여 세션 내에서 특정 값을 변경할 수 있습니다. 파일은 주석이 있는 JSON(JSONC)을 지원합니다.

일반적인 설정은 다음과 같습니다.

암호키	유형	설명
`model`	문자열	사용할 AI 모델(예: "gpt-5.2"``"claude-sonnet-4.6"
`effortLevel`	문자열	이를 지원하는 모델에 대한 추론 노력 수준
`theme`	문자열	색 테마: `"auto"`, `"dark"`또는 `"light"`
`alt_screen`	부울	대체 화면 버퍼 사용(기본값: `true`)
`mouse`	부울	대체 화면 모드에서 마우스 지원 사용(기본값: `true`)
`banner`	문자열	애니메이션 배너 빈도: `"always"`, `"once"`또는 `"never"` (기본값: `"once"`)
`render_markdown`	부울	응답에서 markdown 렌더링(기본값: `true`)
`screen_reader`	부울	화면 읽기 프로그램 최적화 사용(기본값: `false`)
`auto_update`	부울	자동으로 CLI 업데이트 다운로드(기본값: `true`)
`stream`	부울	토큰 단위로 응답을 스트리밍(기본값: `true`)
`includeCoAuthoredBy`	부울	에이전트에서 만든 커밋에 공동 작성자 추가(기본값: `true`)
`respectGitignore`	부울	파일 선택기에서 `@` gitignored 파일 제외(기본값: `true`)
`trusted_folders`	문자열[]	읽기/실행 권한이 부여된 폴더
`allowed_urls`	문자열[]	메시지를 표시하지 않고 허용된 URL 또는 도메인
`denied_urls`	문자열[]	항상 거부되는 URL 또는 도메인
`log_level`	문자열	로그 상세 수준: `"none"`, `"error"`, `"warning"`, `"info"`, `"debug"`, `"all"` 또는 `"default"` (기본값: `"default"`)
`disableAllHooks`	부울	모든 후크 사용 안 함(기본값: `false`)
`hooks`	객체	인라인 사용자 수준 후크 정의

구성 설정의 전체 목록을 보려면 터미널에 입력 copilot help config 합니다.

팁

명령줄 플래그를 사용하여 일부 설정을 설정할 수도 있습니다. 예를 들어 --alt-screen과 --no-alt-screen은 alt_screen 값을 설정하고 config.json에 저장합니다. /model 슬래시 명령은 모델 선택을 이 파일에 기록하여 세션 간에 유지합니다.

`mcp-config.json`

사용자 수준에서 사용할 수 있는 MCP(모델 컨텍스트 프로토콜) 서버를 정의합니다. 이러한 서버는 현재 있는 프로젝트 디렉터리에 관계없이 모든 세션에서 사용할 수 있습니다. 서버 이름이 충돌할 때 프로젝트 수준 MCP 구성(인 .mcp.json또는.github/mcp.json``.vscode/mcp.json)이 사용자 수준 정의보다 우선합니다.

자세한 내용은 GitHub Copilot 명령 줄 인터페이스 (CLI)에 MCP 서버 추가하기을(를) 참조하세요.

`agents/`

여기에 개인 사용자 지정 에이전트 정의를 파일로 .agent.md 저장합니다. 이 디렉터리에 배치된 에이전트는 모든 세션에서 사용할 수 있습니다. 프로젝트 수준 에이전트(in .github/agents/)는 동일한 이름을 공유하는 경우 개인 에이전트보다 우선합니다.

자세한 내용은 GitHub Copilot 명령 줄 인터페이스 (CLI)를 위한 사용자 지정 에이전트 생성 및 사용을(를) 참조하세요.

`skills/`

여기에 개인 사용자 지정 기술 정의를 저장합니다. 각 기술은 파일을 포함하는 SKILL.md 하위 디렉터리에 있습니다(예 ~/.copilot/skills/my-skill/SKILL.md: .). 개인 기술은 모든 세션에서 사용할 수 있습니다. 동일한 이름을 공유하는 경우 프로젝트 수준 기술이 개인 기술보다 우선합니다.

자세한 내용은 GitHub Copilot 명령 줄 인터페이스 (CLI)용 에이전트 기술 생성을(를) 참조하세요.

`hooks/`

여기에 사용자 수준 후크 스크립트를 저장합니다. 이러한 후크는 모든 세션에 적용됩니다. 키를 사용하여 config.json 내부에 후크를 인라인으로 정의할 수도 있습니다. 리포지토리 수준 후크(in .github/hooks/)는 사용자 수준 후크와 함께 로드됩니다.

자세한 내용은 GitHub Copilot 명령 줄 인터페이스 (CLI)에서 후크를 사용하는 방법을(를) 참조하세요.

자동으로 관리되는 파일

다음 항목은 CLI에서 관리됩니다. 일반적으로 수동으로 편집해서는 안 됩니다.

`permissions-config.json`

프로젝트 위치별로 구성된 저장된 도구 및 디렉터리 권한 결정을 저장합니다. 도구를 승인하거나 디렉터리에 대한 액세스 권한을 부여하는 경우 CLI는 여기에 결정을 기록하므로 동일한 프로젝트에서 다시 메시지가 표시되지 않습니다.

참고

프로젝트에 대한 사용 권한을 다시 설정하려면 이 파일에서 관련 항목을 삭제할 수 있습니다. 그러나 세션이 실행되는 동안 파일을 편집하면 예기치 않은 동작이 발생할 수 있습니다.

`session-state/`

하위 디렉터리의 세션 ID별로 구성된 세션 기록 데이터를 포함합니다. 각 세션 디렉터리에는 이벤트 로그(events.jsonl) 및 작업 영역 아티팩트(계획, 검사점, 추적된 파일)가 저장됩니다. 이 데이터는 세션 다시 시작(--resume 또는 --continue)을 사용하도록 설정합니다.

`session-store.db`

검사점 인덱싱 및 검색과 같은 세션 간 데이터에 대해 CLI에서 사용하는 SQLite 데이터베이스입니다. 이 파일은 자동으로 관리되며 편집해서는 안 됩니다.

`logs/`

CLI 세션에 대한 로그 파일을 포함합니다. 각 세션은 .라는 process-{timestamp}-{pid}.log로그 파일을 만듭니다. 이러한 파일은 문제를 디버깅하는 데 유용합니다.

팁

현재 세션에 대한 로그 파일을 찾으려면 대화형 세션을 입력 /session 합니다. 출력에는 세션 ID, 기간 및 작업 디렉터리와 같은 다른 세션 세부 정보와 함께 로그 파일의 전체 경로가 포함됩니다.

설치한 플러그 인에 대한 파일을 포함합니다. 마켓플레이스에서 설치된 플러그 인은 .에 installed-plugins/{marketplace-name}/{plugin-name}/저장됩니다. 직접 설치된 플러그 인은 아래에 installed-plugins/_direct/저장됩니다. 이 디렉터리를 직접 편집하는 대신 명령을 사용하여 copilot plugin 플러그 인을 관리합니다.

자세한 내용은 GitHub Copilot CLI 플러그 인 참조을(를) 참조하세요.

`ide/`

IDE 통합을 위한 잠금 파일 및 상태를 포함합니다(예: 코파일럿 CLI가 Visual Studio Code에 연결할 때). 이 디렉터리가 자동으로 관리됩니다.

구성 디렉터리의 위치 변경

다음 두 가지 방법으로 기본 ~/.copilot 위치를 재정의할 수 있습니다.

        **환경 변수**: 사용하려는 디렉터리의 경로로 설정합니다 `COPILOT_HOME` .

Bash

export COPILOT_HOME=/path/to/my/copilot-config

export COPILOT_HOME=/path/to/my/copilot-config

        **명령줄 옵션**: CLI를 시작할 때 사용합니다 `--config-dir` .