# GITHUB COPILOT CLI 구성 디렉터리

`~/.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 통합 상태                  |

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

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

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

### `config.json`

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

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

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

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

> \[!TIP]
> 명령줄 플래그를 사용하여 일부 설정을 설정할 수도 있습니다. 예를 들어 `/model` 슬래시 명령은 모델 선택을 이 파일에 기록하여 세션 간에 유지합니다.

### `mcp-config.json`

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

자세한 내용은 [에 대한 MCP 서버 추가 GitHub Copilot 명령 줄 인터페이스 (CLI)](/ko/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers)을(를) 참조하세요.

### `agents/`

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

자세한 내용은 [사용자 지정 에이전트 만들기 및 사용 GitHub Copilot 명령 줄 인터페이스 (CLI)](/ko/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)을(를) 참조하세요.

### `skills/`

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

자세한 내용은 [GitHub Copilot 명령 줄 인터페이스 (CLI)에 에이전트 기술 추가](/ko/copilot/how-tos/copilot-cli/customize-copilot/add-skills)을(를) 참조하세요.

### `hooks/`

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

자세한 내용은 [후크 사용하기 GitHub Copilot 명령 줄 인터페이스 (CLI)](/ko/copilot/how-tos/copilot-cli/customize-copilot/use-hooks)을(를) 참조하세요.

## 자동으로 관리되는 파일

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

### `permissions-config.json`

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

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

### `session-state/`

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

### `session-store.db`

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

### `logs/`

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

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

### `installed-plugins/`

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

자세한 내용은 [GitHub Copilot CLI 플러그 인 참조](/ko/copilot/reference/copilot-cli-reference/cli-plugin-reference)을(를) 참조하세요.

### `ide/`

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

## 구성 디렉터리의 위치 변경

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

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

  ```bash copy
  export COPILOT_HOME=/path/to/my/copilot-config
  ```

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

  ```bash copy
  copilot --config-dir /path/to/my/copilot-config
  ```

`--config-dir` 옵션은 `COPILOT_HOME`보다 우선적이며, `COPILOT_HOME`은 기본  위치보다 우선적으로 적용됩니다.

### 알아야 할 사항

* ```
          `COPILOT_HOME` 는 전체 `~/.copilot` 경로를 바꿉니다. 설정한 값은 구성 파일 및 하위 디렉터리에 사용할 디렉터리의 전체 경로여야 합니다.
  ```
* 디렉터리를 변경하면 기존 구성, 세션 기록, 설치된 플러그 인 및 저장된 권한이 새 위치에서 찾을 수 없습니다. 내용을 유지하려는 경우 내용을 `~/.copilot` 복사하거나 새 위치로 이동합니다.
* ```
          **캐시 디렉터리**(마켓플레이스 캐시, 자동 업데이트 패키지 및 기타 임시 데이터에 사용됨)는 플랫폼 규칙을 따르며 영향을 `COPILOT_HOME`받지 않습니다. 다음 위치에 있습니다.
  ```

  \-
  **macOS**: `~/Library/Caches/copilot`
  -------------------------------------

  ```
          **Linux**: `$XDG_CACHE_HOME/copilot` 또는 `~/.cache/copilot`
  ```

  \-
  **Windows**: `%LOCALAPPDATA%/copilot`

  캐시 디렉터리를 별도로 재정의하려면 `COPILOT_CACHE_HOME`을 설정합니다.

## 안전하게 삭제할 수 있는 항목

| 항목                        | 삭제해도 안전한가요? | 영향                                                        |
| ------------------------- | ----------- | --------------------------------------------------------- |
| `logs/`                   | 예           | 로그 파일은 각 세션마다 다시 만들어집니다. 삭제해도 함수에 영향을 주지 않습니다.            |
| `session-state/`          | 주의해서        | 삭제하면 세션 기록이 제거됩니다. 더 이상 과거 세션을 다시 시작할 수 없습니다.             |
| `session-store.db`        | 주의해서        | 삭제하면 세션 간 데이터가 제거됩니다. 파일이 자동으로 다시 만들어집니다.                 |
| `config.json`             | 주의해서        | 모든 구성을 기본값으로 다시 설정합니다. 기본 설정을 다시 구성해야 합니다.                |
| `permissions-config.json` | 주의해서        | 저장된 모든 권한을 다시 설정합니다. CLI는 도구 및 디렉터리 승인을 다시 묻는 메시지를 표시합니다. |
| `installed-plugins/`      | 권장되지 않음     |                                                           |

```
          `copilot plugin uninstall`을 대신 사용하여 `config.json`의 플러그인 메타데이터가 일관성을 유지하도록 합니다. |
```

\| `mcp-config.json` | 권장되지 않음 | 사용자 수준 MCP 서버 정의가 손실됩니다. 먼저 백업하세요. |
\| `agents/`
`skills/`
`hooks/`
\| 권장되지 않음 | 개인 사용자 지정이 손실됩니다. 먼저 백업하세요. |

## 추가 읽기

* [GitHub Copilot 명령 줄 인터페이스 (CLI)](/ko/copilot/how-tos/copilot-cli)
* [GitHub Copilot CLI 명령 참조](/ko/copilot/reference/copilot-cli-reference/cli-command-reference)
* [GitHub Copilot CLI 프로그래밍 방식 참조](/ko/copilot/reference/copilot-cli-reference/cli-programmatic-reference)
* [GitHub Copilot CLI 플러그 인 참조](/ko/copilot/reference/copilot-cli-reference/cli-plugin-reference)