# 설정

CLI가 키를 보관하는 위치와, CLI의 동작을 바꾸는 환경 변수를 설명합니다.

## 키가 보관되는 위치

`lockpick login` 후 CLI는 키를 시스템 키체인의 `lockpick-cli` 서비스 아래에 보관합니다. 키체인이 없으면 본인만 읽을 수 있는 `~/.config/lockpick/config.json`에 보관합니다.

## 환경 변수

| 변수                    | 역할                                                     |
| --------------------- | ------------------------------------------------------ |
| `LOCKPICK_HOST`       | 로그인한 주소 대신 사용할 Lockpick 주소                             |
| `LOCKPICK_KEY`        | 저장된 키 대신 사용할 키입니다. 예를 들어 CI에서 씁니다                      |
| `LOCKPICK_CONFIG_DIR` | `config.json`을 보관할 위치                                  |
| `XDG_CONFIG_HOME`     | 설정 폴더를 `$XDG_CONFIG_HOME/lockpick`으로 옮깁니다              |
| `LOCKPICK_KEYCHAIN`   | `0`으로 설정하면 키체인을 건너뛰고 파일을 사용합니다                         |
| `NO_COLOR`            | 색상을 끕니다                                                |
| `FORCE_COLOR`         | 터미널이 아닌 곳, 예를 들어 CI 로그에서 색상을 켜려면 `1`로 설정합니다. `0`이면 끕니다 |

> **Careful**
>
> 키는 로그인할 때 허용한 범위의 작업을 할 수 있습니다. `LOCKPICK_KEY`는 저장소가 아니라 CI의 비밀 값 저장소에 보관하세요.

## CLI가 출력하는 내용

스캔한 사이트에서 가져온 텍스트, 예를 들어 근거와 문제 제목에는 터미널이 실행해 버릴 수 있는 문자가 들어 있을 수 있습니다. 화면 지우기, 텍스트 숨기기, 클립보드 쓰기, 링크 위장 같은 것들입니다. CLI는 이런 문자를 터미널로 그대로 보내지 않고, 보이는 기호로 표시합니다. 이스케이프 문자는 `␛`로 나타납니다. 오류 메시지가 키를 반복해서 보여 줄 때도 CLI는 키를 출력하지 않습니다.

`--json`을 사용하면 결과는 표준 출력으로, 오류는 표준 오류로 JSON 형식이 되며 색상은 없습니다.

## 유휴 상태의 키는 만료됩니다

키는 사용하는 동안 계속 작동합니다. 워크스페이스에서 정한 기간, 관리자가 바꾸지 않았다면 30일 동안 아무도 쓰지 않은 키는 작동을 멈춥니다. Lockpick에서 **AI에 추가** 아래 **CLI 및 키** 탭에서 키를 보고 폐기할 수 있습니다.

## CLI를 MCP 서버로 사용하기

`lockpick mcp`는 Lockpick을 코딩 도우미용 로컬 MCP 서버로 실행합니다. `lockpick mcp config claude`, `cursor`, `vscode` 또는 `codex`를 실행하면 각 도구의 설정이 출력됩니다. 대부분의 사용자는 [호스팅 서버](/ko/docs/mcp/hosted-server)를 대신 사용합니다.