> Source: https://clickhouse.github.io/loom/ko/reference/environment/ (Markdown: https://clickhouse.github.io/loom/ko/reference/environment.md)

<!-- i18n: source=docs/reference/environment.md blob=e44b7d6f0a825acdb0756c4891692dfb99d2fad8 model=claude-sonnet-5-5 -->
> 이 페이지는 [영어 원문](https://clickhouse.github.io/loom/reference/environment/)을 기계 번역한 것이며, 영어 원문이 기준입니다.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/environment/), which is authoritative.

<a id="environment-variables-reference"></a>

# 환경 변수 레퍼런스

Loom의 거의 모든 구성은 설정 필드로 이루어집니다. 이는 `server.settings.Settings`의 필드에 대응하는 환경 변수 `LOOM_<FIELD>`이며, 기본값과 의미는 생성된 [구성 레퍼런스](https://github.com/ClickHouse/loom/blob/main/docs/reference/configuration.md)에 나와 있습니다. 이 페이지에서는 나머지를 다룹니다. 서버, CLI, SDK, 플러그인, 컨테이너 이미지, compose 파일, 운영자 스크립트가 `os.environ`(또는 셸의 `${VAR}`)으로 직접 읽는 변수입니다. 이 중 `LOOM_*` 변수는 `NON_SETTINGS_ENV`(`server/settings/_env.py`)에 나열되어 있으며, 웹훅 서명 시크릿 같은 변수군은 `NON_SETTINGS_ENV_PREFIXES`에 나열되어 있습니다. 서버의 알 수 없는 변수 경고는 이들을 건너뜁니다. `tests/unit/test_environment_reference.py`는 이 목록들과 이 페이지가 서로 일치하도록 유지합니다.

<a id="server"></a>

## 서버

| 변수                                                 | 읽는 곳                                                    | 기본값               | 의미                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ---------------------------------------------------- | ---------------------------------------------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `OPENAI_API_KEY`                                     | `server/embedding/openai.py`, `server/llm/openai.py`       | 설정 안 됨           | OpenAI 임베더와 LLM용 키입니다. OpenAI 모델이 설정되어 있는데 키가 없으면 임베더는 ERROR 로그를 남기고 가짜 n-gram 임베더로, LLM은 가짜 클라이언트로 대체되며 `loom doctor`가 경고합니다.                                                                                                                                                                                                                                                                                                                                                                                                  |
| `ANTHROPIC_API_KEY`                                  | `server/llm/anthropic.py`                                  | 설정 안 됨           | Anthropic LLM 프로바이더용 키입니다(`LOOM_LLM_PROVIDER=anthropic`, 또는 `claude*` 모델에서 추론됨).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `GEMINI_API_KEY`, `GOOGLE_API_KEY`                   | `server/embedding/gemini.py`                               | 설정 안 됨           | Gemini 임베더용 키입니다. 먼저 설정된 것이 사용됩니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `COHERE_API_KEY`                                     | `server/core/provider_keys.py`                             | 설정 안 됨           | 호스팅 rerank 프로바이더용 키입니다. 없으면 리랭커가 경고를 로그에 남기고 후보를 입력 순서대로 반환합니다(fail-open).                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `LOOM_EMBEDDING_API_KEY`                             | `server/core/provider_keys.py`                             | 설정 안 됨           | `compatible` 임베딩 프로바이더(`LOOM_EMBEDDING_PROVIDER=compatible`)용 키입니다. 없으면 `/v1/health`와 `loom doctor`가 누락되었다고 보고합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `LOOM_ENV_FILE`                                      | `server/core/env_file.py`, `server/cli/app.py`             | `.env`               | `Settings`가 읽는 env 파일이자 `loom` CLI가 환경에 로드하는 파일입니다. 비워 두면 사용하지 않습니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `LOOM_SETTINGS_FILE`                                 | `server/core/env_file.py`                                  | 설정 안 됨(없음)     | `Settings`가 env 파일과 환경 변수보다 낮은 우선순위로 읽는 YAML 설정 파일입니다([구성 레퍼런스](https://github.com/ClickHouse/loom/blob/main/docs/reference/configuration.md)). 지정한 파일이 없으면 시작을 거부합니다. 환경 변수에서 읽고, 없으면 env 파일에서 읽습니다. 환경 변수의 값이 비어 있으면 env 파일에 무엇이 있든 아무것도 읽지 않습니다.                                                                                                                                                                                                                                    |
| `LOOM_INSTANCE_LABEL`                                | `server/observability/instance.py`                         | 설정 안 됨           | 모든 원장 행에 기록되는 이 프로세스의 레이블입니다(최대 64자). 이 값도 없고 `LOOM_DEPLOYMENT=1`(제공되는 compose 파일이 설정하는 설정 필드)도 없이 시작한 프로세스는 부팅을 거부하므로, 모든 행의 출처를 알 수 있습니다.                                                                                                                                                                                                                                                                                                                                                                  |
| `XDG_RUNTIME_DIR`                                    | `server/core/runtime_files.py`                             | 설정 안 됨           | `LOOM_RUNTIME_DIR`가 설정되지 않았을 때, 한 서버의 웹 프로세스들이 공유 파일(속도 제한 테이블)을 두는 위치입니다. `$XDG_RUNTIME_DIR/loom`, `/run/loom`, `/tmp/loom-<uid>` 중 해당 사용자만 들어갈 수 있는 디렉터리이거나 그렇게 만들 수 있는 첫 번째 경로가 사용됩니다. 웹 프로세스가 여러 개인데 이 경로가 없으면, `scripts/serve.sh`가 개수를 직접 정한 경우에는 하나를 시작하고, 그렇지 않으면 중단하고 해당 프로세스를 알려 줍니다. `scripts/serve.sh`는 이 선택을 한 번만 하고 `LOOM_RUNTIME_DIR`로 내보냅니다.                                                                  |
| `HOSTNAME`                                           | `server/observability/instance.py`                         | 시스템 호스트 이름   | `hostname:pid` 형식의 인스턴스 id에 쓰이는 대체 호스트 이름입니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `POD_NAMESPACE`, `POD_NAME`                          | `server/core/provider_process.py`                          | 설정 안 됨           | 이 pod의 네임스페이스와 이름입니다(차트가 downward API에서 설정함). 해당 네임스페이스의 API에 그 pod가 더 이상 없거나 실패 상태이면, workers 리더가 유실된 pod의 프로바이더 참가자를 정리합니다.                                                                                                                                                                                                                                                                                                                                                                                         |
| `KUBERNETES_SERVICE_HOST`, `KUBERNETES_SERVICE_PORT` | `server/core/provider_process.py`                          | Kubernetes가 설정    | 유실된 pod 확인이 서비스 어카운트 토큰과 함께 질의하는 API 서버입니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `NODE_OPTIONS`                                       | `server/code/workers/scip_ts_delta.py`, `scip_py_delta.py` | 설정 안 됨           | 컴파일러 티어 인덱서 서브프로세스에 그대로 전달됩니다. 해당 서브프로세스의 다른 모든 변수는 워커가 설정합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `SCIP_ENV_JSON`                                      | `server/code/workers/scip_py_delta.py`                     | 설정 안 됨           | Python 컴파일러 티어 인덱서에 그대로 전달됩니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `PATH`                                               | `server/code/workers/scip_go_delta.py`                     | 상속됨               | Go 툴체인과 인덱서 바이너리를 찾는 데 사용됩니다. 서브프로세스는 자체 `PATH`를 갖습니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `LOOM_WEBHOOK_SECRET_<ORG>__<NAME>`                  | `server/core/webhooks.py`                                  | 설정 안 됨           | 웹훅 서명 시크릿으로, 메모리 웹훅의 `secret_ref` 또는 작업 인박스의 `webhook_secret_ref`가 가리키는 이름입니다. ORG는 [작업 인박스 웹훅](https://github.com/ClickHouse/loom/blob/main/docs/features/tasks-and-decisions.md)에서처럼 인코딩된 org id입니다. `whsec_` 접두사는 base64 키를 뜻하며, 공백은 제거됩니다. 설정되지 않았거나, `whsec_` 값이 비어 있거나 base64가 아니거나, 값이 UTF-8이 아니면 시크릿을 사용할 수 없습니다. 이 경우 메모리 웹훅 이벤트는 대기하고(2.5일 후 dead 처리), 작업 인박스의 알림은 보류되며, 서버는 해당 변수 이름을 밝혀 한 번 경고합니다. 알 수 없는 변수 경고는 이 접두사를 가진 모든 이름을 건너뜁니다. |

프로바이더 선택 자체(`LOOM_EMBEDDING_MODEL`, `LOOM_LLM_PROVIDER`,
`LOOM_LLM_MODEL`)는 설정 항목입니다.
[배포](https://github.com/ClickHouse/loom/blob/main/docs/operations/deployment.md#providers)와
[LLM 아키텍처](https://clickhouse.github.io/loom/ko/architecture/llm-architecture/)를 참고하세요.

<a id="container-image-and-uvicorn"></a>

## 컨테이너 이미지와 uvicorn

이미지의 명령인 `scripts/serve.sh`가 이 값들을 읽어 uvicorn을 시작합니다. 이 스크립트는 값을 환경 변수에서만 가져오며 `.env`나 `LOOM_ENV_FILE`에서는 가져오지 않습니다(compose의 `env_file:`은 값을 환경에 설정합니다). 단, 설정 필드인 `LOOM_WEB_WORKERS`, `LOOM_TRUSTED_PROXIES`, `LOOM_RUNTIME_DIR`은 예외이며, 서버가 로드할 때 환경, env 파일, [설정 파일](https://github.com/ClickHouse/loom/blob/main/docs/reference/configuration.md) 순으로 해석합니다. uvicorn 자체의 `UVICORN_<OPTION>` 변수는 읽지 않습니다. `scripts/serve.sh`가 전달하지 않는 uvicorn 옵션에 대해 이 변수가 설정되어 있으면 웹 티어는 시작을 거부합니다.

| 변수                       | 기본값               | 의미                                                                                                                                                                                                                                                                                                                                                   |
| -------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `PORT`                     | `7777`               | uvicorn이 컨테이너 안에서 바인딩하는 포트입니다.                                                                                                                                                                                                                                                                                                       |
| `LOOM_LISTEN_HOST`         | `127.0.0.1`          | `uvicorn --host`: 수신 대기하는 주소입니다. 이미지는 `0.0.0.0`으로 설정합니다. `LOOM_BIND_HOST`는 시작 점검이 읽는 주소로 유지되며, 환경에 설정되어 있지 않으면 `scripts/serve.sh`가 루프백이 아닌 수신 주소로 설정합니다(env 파일이나 설정 파일의 값을 덮어씁니다).                                                                                  |
| `LOOM_WEB_WORKERS`         | CPU당 1개, 최대 8개  | `uvicorn --workers`. 설정하지 않으면 컨테이너가 사용할 수 있는 CPU(cpuset을 CPU 할당량으로 낮춘 값)당 1개이며, 메모리 1GiB당 최대 1개, 전체 최대 8개입니다. `.env`에 개수를 지정하지 않으면 compose 파일이 값을 설정합니다. `deploy/standalone`과 개발 스택은 2, 클라우드와 colour 스택은 1입니다. 설정 필드이기도 하며, 속도 제한기가 예산을 이 값으로 나눕니다。 |
| `LOOM_UVICORN_LOOP`        | `asyncio`            | `uvicorn --loop`: `asyncio`, `auto`, `uvloop` 중 하나입니다. uvloop는 git을 실행할 때마다 프로세스 전체를 포크하므로 루프가 멈춥니다.                                                                                                                                                                                                                   |
| `LOOM_TRUSTED_PROXIES`     | `127.0.0.1`          | `uvicorn --forwarded-allow-ips`: `X-Forwarded-For`/`-Proto`를 적용할 피어입니다.                                                                                                                                                                                                                                                                       |
| `LOOM_GRACEFUL_SHUTDOWN_S` | `10`                 | `uvicorn --timeout-graceful-shutdown`: 종료 중인 프로세스가 요청을 처리하며 비우는 시간입니다.                                                                                                                                                                                                                                                         |
| `LOOM_KEEP_ALIVE_S`        | `5`                  | `uvicorn --timeout-keep-alive`: 유휴 연결을 열어 두는 시간입니다. 연결을 재사용하는 로드 밸런서 뒤에서는 로드 밸런서의 유휴 타임아웃보다 길어야 합니다.                                                                                                                                                                                                 |

빌드 인수: `LOOM_BUILD_COMMIT`(이미지에 `LOOM_BUILD_COMMIT`으로 내장되며 `build_commit`으로 보고됩니다). 이미지에는 항상 로컬 CPU 임베더와 기본 모델이 포함되어 있으며 `LOOM_LOCAL_EMBEDDING_MODEL_DIR=/app/models`로 설정됩니다. 나머지 `ARG`는 컴파일러 티어 인덱서의 도구 체인 버전과 체크섬을 고정합니다(`GO_VERSION`, `NODE_VERSION`, `SCIP_GO_VERSION`, `SCIP_CLANG_VERSION`, 이들의 `*_SHA256*` 값, LLVM 서명 키의 지문인 `LLVM_SIGNER_FPR`). `scripts/install-code-toolchains.sh`는 npm으로 설치하는 도구(scip-typescript, scip-python, 패키지 관리자)의 버전을 고정합니다.

<a id="compose-files"></a>

## Compose 파일

| 변수                                            | 읽는 곳                                                    | 기본값                                | 의미                                                                                                                                                                                                                                                                                                                   |
| ----------------------------------------------- | ---------------------------------------------------------- | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `LOOM_CH_HOST_PORT`, `LOOM_CH_NATIVE_HOST_PORT` | `dev/docker-compose.dev.yml`, `dev/ci_start_clickhouse.sh` | `8123`, `9000`                        | 로컬 ClickHouse가 게시하는 호스트 포트(HTTP 및 네이티브)입니다.                                                                                                                                                                                                                                                        |
| `LOOM_CH_CONTAINER`                             | `dev/ci_start_clickhouse.sh`                               | `loom-ch`                             | 컨테이너 이름입니다. 두 번째 ClickHouse(워크트리당 하나)를 첫 번째 옆에서 실행할 수 있습니다.                                                                                                                                                                                                                          |
| `LOOM_COLOUR`, `LOOM_COLOUR_PORT`               | `dev/docker-compose.colour.yml`                            | 필수                                  | blue/green 프로젝트가 실행할 색(`blue` 또는 `green`)과 호스트 포트(`7781` 또는 `7782`)입니다.                                                                                                                                                                                                                          |
| `LOOM_CLICKHOUSE_IMAGE`                         | `compose.yaml`, `dev/ci_start_clickhouse.sh`               | `clickhouse/clickhouse-server:latest` | 스택이 실행하는 ClickHouse 이미지입니다. 릴리스 번들의 compose 파일은 기본값을 번들을 빌드하고 스키마를 검사한 릴리스로 지정합니다.                                                                                                                                                                                     |
| `LOOM_IMAGE_REPOSITORY`, `LOOM_VERSION`         | `compose.yaml`, `install.sh`                               | `ghcr.io/clickhouse/loom`, `latest`   | 독립 실행형 스택이 실행하는 이미지와 태그입니다. 설치 프로그램은 `.env`에 태그를 고정합니다.                                                                                                                                                                                                                           |
| `LOOM_EXTRACTOR_IMAGE_REPOSITORY`               | `compose.yaml`, `install.sh`                               | `ghcr.io/clickhouse/loom-extractor`   | 문서 추출기 서비스의 이미지이며 `LOOM_VERSION`으로 실행됩니다.                                                                                                                                                                                                                                                         |
| `LOOM_PORT`                                     | `compose.yaml`, `install.sh`                               | `7777`                                | 독립 실행형 스택이 게시하는 호스트 포트입니다.                                                                                                                                                                                                                                                                         |
| `LOOM_REPOSITORY`                               | `install.sh`                                               | `ClickHouse/loom`                     | 설치 프로그램이 릴리스를 다운로드하는 GitHub 저장소입니다.                                                                                                                                                                                                                                                             |
| `LOOM_RELEASES_URL`                             | `install.sh`                                               | GitHub                                | 설치 프로그램이 릴리스 파일을 다운로드하는 위치로, `https://` URL입니다. 기본값은 `https://github.com/$LOOM_REPOSITORY/releases`입니다.                                                                                                                                                                                 |
| `LOOM_CONNECT`                                  | `install.sh`                                               | 설정 안 됨                            | 묻지 않고 연결할 코딩 에이전트로, `claude-code`, `codex`, `vscode`의 쉼표 목록, `all`, 또는 단독 `none`입니다. 설정하지 않으면 터미널에서는 묻고, 터미널이 없는 실행에서는 아무것도 연결하지 않습니다([빠른 시작](https://clickhouse.github.io/loom/ko/getting-started/quickstart/#fast-path-released-image-no-clone)).                                |
| `LOOM_LOCAL_MODELS`                             | `install.sh`                                               | 설정 안 됨                            | `ollama`는 묻지 않고 Loom의 모델 작업(추출, 그리고 활성화된 경우 어시스턴트)을 이 머신의 Ollama에서 실행하도록 설정합니다. `off`는 이를 제안하지 않습니다. 설정하지 않으면 터미널에서의 새 설치는 실행 중인 Ollama를 제안받습니다([모델과 키](https://github.com/ClickHouse/loom/blob/main/docs/getting-started/models-and-keys.md#a-model-server-on-your-machine-no-api-key)). |
| `LOOM_NO_OPEN`                                  | `install.sh`                                               | 설정 안 됨                            | `1`은 설치 프로그램이 브라우저에서 대시보드를 열지 않도록 합니다.                                                                                                                                                                                                                                                      |

설치 프로그램에 `LOOM_VERSION`을 주면 해당 릴리스를 설치합니다. 주지 않으면 릴리스의
`install.sh`는 자신의 릴리스를 설치하고, 저장소의 사본은 `latest`를 설치합니다. 더 새로운 설치 위에
더 오래된 릴리스를 설치하는 것은 `LOOM_VERSION`으로 명시하지 않으면 거부됩니다
(먼저 ClickHouse를 고정하세요:
[설치 프로그램으로 설치한 환경 다운그레이드](https://github.com/ClickHouse/loom/blob/main/docs/operations/upgrades.md#downgrading-an-installer-install)).

compose 파일의 다른 `${LOOM_*}` 참조는 compose 수준의 기본값이 주어진 설정 필드와 위의
uvicorn 변수입니다. 설치 프로그램은 두 이미지 저장소(`LOOM_IMAGE_REPOSITORY`,
`LOOM_EXTRACTOR_IMAGE_REPOSITORY`), 태그, 포트, 바인드 호스트, `LOOM_CLICKHOUSE_IMAGE`가
주어지면 `.env`에 유지합니다. 기본 `.env`가 설정하는 내용은 [빠른 시작](https://clickhouse.github.io/loom/ko/getting-started/quickstart/)에서
설명합니다.

<a id="loom-cli"></a>

## `loom` CLI

| 변수                               | 읽는 곳                                                                    | 기본값                      | 의미                                                                          |
| ---------------------------------- | -------------------------------------------------------------------------- | --------------------------- | ----------------------------------------------------------------------------- |
| `LOOM_BASE_URL`                    | `server/cli/_client.py` 및 클라이언트 명령                                 | `http://localhost:7777`     | 클라이언트 명령(`install`, `demo`, `export-okf`, …)이 통신하는 서버입니다.    |
| `LOOM_API_KEY`                     | `server/cli/_client.py` 및 클라이언트 명령                                 | 설정 안 됨, 이후 `~/.loom/token` | 클라이언트 명령이 제시하는 토큰입니다. 여기에 오래된 값이 있으면 `~/.loom/token`보다 우선합니다. |
| `LOOM_BIND_HOST`, `LOOM_BIND_PORT` | `server/cli/serve.py`                                                      | `0.0.0.0`, `7777`           | `loom serve --host` 및 `--port`의 기본값입니다.                               |
| `LOOM_CONFIG_FILE`                 | `server/cli/_client.py`                                                    | `~/.loom/config.json`       | `loom doctor --client`가 읽는 클라이언트 설정입니다(`loom init`이 작성하는 파일). |
| `LOOM_API_KEY_FILE`                | `server/cli/_client.py`, 플러그인의 `lib/loom-client.mjs`, grep shim       | `~/.loom/token`             | `LOOM_API_KEY`가 설정되지 않았을 때 읽는 토큰 파일입니다.                     |

[CLI 레퍼런스](https://github.com/ClickHouse/loom/blob/main/docs/reference/cli.md)를 참고하세요.

<a id="sdks"></a>

## SDK

| 변수            | 읽는 주체                    | 기본값                                        | 의미                                                                                          |
| ------------------- | -------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| `LOOM_BASE_URL`     | Python 및 TypeScript SDK | `http://localhost:7777`                        | 생성자에 서버를 지정하지 않았을 때 사용하는 서버입니다.                                                     |
| `LOOM_API_KEY`      | Python 및 TypeScript SDK | `loom login` 세션, 없으면 `~/.loom/token` | 생성자에 지정하지 않았을 때 사용하는 베어러 토큰입니다. 빈 값은 설정하지 않은 것으로 간주합니다.                        |
| `LOOM_PROFILE`      | Python 및 TypeScript SDK | `default`                                      | 생성자에 지정하지 않았을 때 클라이언트가 사용하는 `~/.loom/credentials`의 `loom login` 세션입니다. |
| `LOOM_LOG_LEVEL`    | Python 및 TypeScript SDK | 설정 안 됨                                          | SDK 로거의 레벨입니다(`debug`, `info`, `warning`/`warn`, `error`, `off`).                      |
| `LOOM_MENTOR_BRIEF` | Python 및 TypeScript SDK | 꺼짐                                            | `on`이면 첫 호출 시 백그라운드에서 `mentor.brief`를 가져옵니다.                                 |
| `LOOM_AUTO_RUN`     | Python SDK                 | 꺼짐                                            | 각 `Agent`의 수명에 암묵적 실행(run)을 바인딩합니다.                                                  |

[Python SDK](https://github.com/ClickHouse/loom/blob/main/docs/reference/python-sdk.md)와 [TypeScript SDK](https://github.com/ClickHouse/loom/blob/main/docs/reference/typescript-sdk.md)를 참고하세요.

<a id="coding-agent-plugins-and-hook-scripts"></a>

## 코딩 에이전트 플러그인과 훅 스크립트

| 변수                                       | 읽는 곳                                                                                                 | 기본값                                                                                        | 의미                                                                                              |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `LOOM_ORG`, `LOOM_NAMESPACE`, `LOOM_AGENT` | 플러그인의 `lib/loom-client.mjs`, `integrations/cursor/`, `integrations/generic/`, `dev/loom_init.py` | `~/.loom/config.json`, 그다음 토큰의 클레임, 그다음 `default` / `coding` / 클라이언트 이름 | 훅과 스크립트가 캡처한 행을 기록할 때 사용하는 ID입니다.                                     |
| `LOOM_HOOK_TIMEOUT_MS`                     | 플러그인의 `lib/loom-client.mjs`                                                                      | 측정한 `/v1/health` 왕복 시간의 5배, 3000에서 8000 사이                               | 각 훅 요청을 중단시키는 타임아웃입니다. `loom doctor --client`가 이 값을 보고합니다.                     |
| `LOOM_HOOK_EXIT_MS`                        | 플러그인의 `lib/loom-client.mjs`                                                                      | `LOOM_HOOK_TIMEOUT_MS`                                                                        | 훅 프로세스가 요청을 보낸 뒤 종료하기 전에 대기하는 시간입니다.                                     |
| `LOOM_SHUNT_READ_CAP`                      | 플러그인의 `hooks/loom-code-shunt.mjs`                                                                | `0` (꺼짐)                                                                                    | 인덱싱되었고 수정되지 않은 파일의 범위 읽기가 이 줄 수를 넘으면 대신 코드 도구로 보냅니다. |

[Claude Code 플러그인](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/claude-code.md)을 참고하세요.

<a id="operator-scripts"></a>

## 운영자 스크립트

| 변수                                                                                                             | 읽는 곳                                                               | 기본값                                            | 의미                                                                                                                                                                                                                                                                                    |
| ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `LOOM_REPO`                                                                                                      | `redeploy.sh`                                                         | 스크립트가 있는 디렉터리                          | 배포 체크아웃입니다.                                                                                                                                                                                                                                                                    |
| `LOOM_REDEPLOY_READY_TIMEOUT_S`                                                                                  | `redeploy.sh`                                                         | `180`                                             | 전환을 중단하기 전에, 유휴 상태인 색상의 `/v1/health`가 준비 완료를 보고할 때까지 기다리는 시간입니다.                                                                                                                                                                                  |
| `LOOM_PUBLIC_HEALTH_URL`                                                                                         | `redeploy.sh`                                                         | 설정 안 됨                                        | 설정하면 클라이언트가 사용하는 상태 확인 URL을 마지막에 확인합니다.                                                                                                                                                                                                                     |
| `LOOM_PREFLIGHT_STRICT`                                                                                          | `redeploy.sh`                                                         | `1`                                               | `0`으로 설정하면 원장에만 있는 마이그레이션 행과 체크섬 불일치를 중단하지 않고 보고만 합니다.                                                                                                                                                                                           |
| `LOOM_PREFLIGHT_HEALTH_URL`                                                                                      | `dev/redeploy_preflight.sh`                                           | `http://localhost:7777/v1/health`                 | 사전 점검이 읽는 상태 확인 URL입니다.                                                                                                                                                                                                                                                   |
| `LOOM_PREFLIGHT_PORT`                                                                                            | `dev/redeploy_preflight.sh`                                           | `7777`                                            | 사전 점검이 확인하는 포트입니다.                                                                                                                                                                                                                                                        |
| `LOOM_PREFLIGHT_MIGRATE`                                                                                         | `dev/redeploy_preflight.sh`                                           | `$PYTHON -m server.core.schema.migrate --dry-run` | 사전 점검이 실행하는 마이그레이션 드라이 런 명령입니다.                                                                                                                                                                                                                                 |
| `HDX_BASE`, `HDX_COOKIE` 또는 `HDX_EMAIL` + `HDX_PASSWORD`, `HDX_DB`, `HDX_PREFIX`, `HDX_CONNECTION_ID`, `DRY_RUN` | `deploy/clickstack_sources.sh`                                        | `HDX_DB=default`, `HDX_PREFIX=loom`, `DRY_RUN=0`  | Loom의 ClickStack 소스를 등록할 HyperDX 인스턴스, 자격 증명, 이름 규칙입니다.                                                                                                                                                                                                           |
| `LOOM_ADMIN_TOKEN`                                                                                               | `dev/onboard_tenant.py`                                               | 설정 안 됨                                        | 테넌트를 온보딩하는 관리자 토큰입니다.                                                                                                                                                                                                                                                  |
| `LOOM_OUTPUT_DIR`                                                                                                | `dev/loom_init.py`, `dev/onboard_tenant.py`                           | `.`                                               | 온보딩 스크립트가 출력 파일을 쓰는 위치입니다.                                                                                                                                                                                                                                          |
| `LOOM_REBUILD_DIR`                                                                                               | `scripts/ops/table_rebuild.py`, `scripts/ops/vector_codec_rebuild.py` | `.`                                               | 재빌드 스크립트가 실행을 중단시키는 `ABORT_REBUILD` 파일을 찾는 위치이며, `vector_codec_rebuild.py`가 생성한 트윈의 UUID(`<table>_rebuild.uuid`)를 기록하는 위치입니다. 이 UUID로 트윈이 잔여물인지 판단하므로, 하나의 재빌드에 속한 모든 명령은 같은 디렉터리에서 실행하세요. |
| `LANGFUSE_HOST`, `LANGFUSE_ORG_API_KEY`                                                                          | `dev/loom_init.py`                                                    | 설정 안 됨                                        | `dev/loom_init.py` 실행 중 Langfuse 프로젝트를 프로비저닝합니다.                                                                                                                                                                                                                        |

재배포 절차와 사전 점검은
[배포](https://github.com/ClickHouse/loom/blob/main/docs/operations/deployment.md)와 [업그레이드](https://github.com/ClickHouse/loom/blob/main/docs/operations/upgrades.md)를 참고하세요.
컴파일러 티어 워커는
[코드 인덱스 운영](https://github.com/ClickHouse/loom/blob/main/docs/operations/code-index-operations.md)을, ClickStack은
[ClickStack](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/clickstack.md)을 참고하세요.

<a id="related"></a>

## 관련 문서

- [구성 참조](https://github.com/ClickHouse/loom/blob/main/docs/reference/configuration.md): 모든 `LOOM_*` 설정 필드.
- [배포](https://github.com/ClickHouse/loom/blob/main/docs/operations/deployment.md): 필수 환경, 공급자 및 프로덕션 체크리스트.
