<a id="clickhouse-loom-documentation"></a>

# ClickHouse Loom 문서

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


Loom은 AI 에이전트를 위한 메모리, 문서 및 코드 인덱스 서버로, ClickHouse에 데이터를 저장하며,
실시간 메모리와 지식 상태를 위해 [Postgres](https://github.com/ClickHouse/loom/blob/main/docs/architecture/storage-authority.md#why-two-stores)를 선택적으로 사용할 수 있습니다. 에이전트와 사용자는 MCP, HTTP, Python 및
TypeScript SDK, 그리고 대시보드를 통해 Loom에 접근합니다. 이 페이지는 모든 페이지를 읽는 순서대로 나열합니다.

![대시보드의 라이브러리: 환불 규칙 검색에 대해 인용된 구절로 답변한 화면](https://github.com/ClickHouse/loom/raw/main/docs/assets/screenshots/document-search.webp)

<video src="https://github.com/ClickHouse/loom/raw/main/docs/assets/screenshots/clip-assistant-answer.webm" controls autoplay loop muted playsinline width="100%" aria-label="Ask AI answering a question about refunds, with its numbered sources checked against Loom"><a href="https://github.com/ClickHouse/loom/blob/main/docs/assets/screenshots/clip-assistant-answer.webm">확인된 출처와 함께 답변하는 Ask AI (클립)</a></video>

<a id="start-here"></a>

## 시작하기

| 단계                     | 읽을 문서                                                                                                                                                                                 |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1. 결정                  | [개요](/ko/getting-started/overview) → [Loom 평가하기](/ko/getting-started/evaluate)                                                                                                        |
| 2. 설치                  | [빠른 시작](/ko/getting-started/quickstart) → [배포](https://github.com/ClickHouse/loom/blob/main/docs/operations/deployment.md)                                                                                                      |
| 3. 에이전트 연결         | [코딩 에이전트 연결하기](/ko/getting-started/connect-a-coding-agent) → [통합](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/index.md)                                                                      |
| 4. SDK 및 API            | [첫 번째 에이전트](https://github.com/ClickHouse/loom/blob/main/docs/getting-started/first-agent.md) → [Python SDK](https://github.com/ClickHouse/loom/blob/main/docs/reference/python-sdk.md) / [HTTP API](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md)                                                            |
| 5. 네임스페이스 및 접근  | [ID와 네임스페이스](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md) → [토큰과 권한](https://github.com/ClickHouse/loom/blob/main/docs/guides/tokens-and-grants.md)                                                                     |
| 6. 코드 인덱스           | [코드 인덱스](https://github.com/ClickHouse/loom/blob/main/docs/features/code-index/overview.md) → [리포지토리](/ko/features/code-index/repositories) → [코드 인덱스 운영](https://github.com/ClickHouse/loom/blob/main/docs/operations/code-index-operations.md)                        |
| 7. 운영                  | [모니터링](/ko/operations/monitoring) · [문제 해결](/ko/operations/troubleshooting) · [업그레이드](/ko/operations/upgrades) · [백업 및 복구](/ko/operations/backup-and-recovery) |

<a id="use-cases"></a>

## 사용 사례

필요별로 한 페이지씩 구성했으며, 각 페이지에서 Loom이 해당 필요에 무엇을 해주는지와 어디서 시작하면 되는지를 설명합니다:
[에이전트 메모리](/ko/use-cases/agent-memory) ·
[문서 검색과 RAG](/ko/use-cases/document-search) ·
[코딩 에이전트를 위한 코드 인덱스](/ko/use-cases/code-intelligence) ·
[언어별 코드 인덱스](/ko/use-cases/code-intelligence-by-language) ·
[코드와 연결된 메모리](/ko/use-cases/memory-linked-to-code) ·
[코딩 에이전트 모델 비용](/ko/use-cases/coding-agent-cost) ·
[멀티 에이전트 공유 컨텍스트](/ko/use-cases/multi-agent) ·
[자율 에이전트: 회상, 감사, 삭제](/ko/use-cases/autonomous-agents) ·
[실행, 트레이스, PR 이력](/ko/use-cases/runs-and-pr-history) ·
[ClickHouse 셀프 호스팅](/ko/use-cases/self-hosted-clickhouse) ·
[모든 사용 사례](/ko/use-cases).

<a id="1-getting-started"></a>

## 1. 시작하기

- [개요](/ko/getting-started/overview): Loom이 무엇인지, 어떤 경우에 적합한지, 사전 요구 사항.
- [포함된 기능](/ko/getting-started/whats-included): Loom의 주요 기능과 각 기능의 페이지.
- [빠른 시작](/ko/getting-started/quickstart): 로컬 스택을 처음부터 끝까지 구성하는 방법.
- [모델 및 API 키 구성](/ko/getting-started/models-and-keys): 에이전트 구독,
  서버 LLM, 임베딩, 단일 공급자 구성.
- [Loom 평가](/ko/getting-started/evaluate): 스모크 테스트, 워크로드 평가,
  재현 가능한 공개 벤치마크.
- [코딩 에이전트 연결](/ko/getting-started/connect-a-coding-agent): 플러그인 또는 MCP 진입점.
- [코딩 에이전트로 Loom 설정](/ko/getting-started/agent-setup): 고정된 릴리스를 설치하고
  동작을 검증하는 에이전트를 위한 문서이며, 정해진 형식의 보고서를 포함합니다.
- [첫 번째 에이전트](https://github.com/ClickHouse/loom/blob/main/docs/getting-started/first-agent.md): SDK 튜토리얼.

<a id="2-install-and-run-the-server"></a>

## 2. 서버 설치 및 실행

- [배포](https://github.com/ClickHouse/loom/blob/main/docs/operations/deployment.md): 구성 형태, 환경, 프로바이더, ID 모드,
  프록시, 이미지, 프로덕션 체크리스트.
- [싱글 사인온](https://github.com/ClickHouse/loom/blob/main/docs/operations/sso.md): 대시보드, 
  `loom login`, MCP 클라이언트를 위한 OIDC ID 프로바이더.
- [대시보드 없이 Loom 사용하기](/ko/guides/without-the-dashboard): 모든 대시보드 보기에 대응하는 `loom login`, `loom call`
  및 SDK 호출.
- [업그레이드](/ko/operations/upgrades) · [지원 버전](/ko/operations/supported-versions) ·
  [백업 및 복구](/ko/operations/backup-and-recovery) ·
  [모니터링](/ko/operations/monitoring) · [유지 관리](/ko/operations/maintenance) ·
  [런타임 설정](/ko/operations/runtime-settings) ·
  [문제 해결](/ko/operations/troubleshooting) ·
  [코드 인덱스 운영](https://github.com/ClickHouse/loom/blob/main/docs/operations/code-index-operations.md) ·
  [N개 레플리카 실행](/ko/operations/replicas): 하나의 URL 뒤에 있는 동일한 Loom들 ·
  [Postgres](https://github.com/ClickHouse/loom/blob/main/docs/operations/postgres.md): Postgres 메모리 권한 저장소 ·
  [Kubernetes](https://github.com/ClickHouse/loom/blob/main/docs/operations/kubernetes.md): EKS 및 kind 오버레이가 포함된 Helm 차트 ·
  [ClickHouse Cloud 및 Managed Postgres](https://github.com/ClickHouse/loom/blob/main/docs/operations/clickhouse-cloud.md): 두 관리형 서비스 위에서 동작하는
  차트 ·
  [네임스페이스를 다른 Loom으로 복사하기](https://github.com/ClickHouse/loom/blob/main/docs/operations/okf-sync.md) ·
  [사용량을 데이터 웨어하우스로 내보내기](/ko/operations/analytics-export)

<a id="3-connect-agents"></a>

## 3. 에이전트 연결

[통합](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/index.md) ·
[MCP 클라이언트](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/mcp-clients.md) ·
[에이전트 지침](/ko/features/integrations/agent-instructions) ·
[Claude Code](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/claude-code.md) ·
[Codex](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/codex.md) · [Cursor](/ko/features/integrations/cursor) ·
[VS Code](/ko/features/integrations/vscode) ·
[프레임워크](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/frameworks.md) ·
[Grep 셤](/ko/features/integrations/grep-shim) ·
[Langfuse](/ko/features/integrations/langfuse) ·
[ClickStack](/ko/features/integrations/clickstack) ·
[OKF](/ko/features/integrations/okf)

<a id="4-sdk-and-api"></a>

## 4. SDK와 API

[참조 색인](/ko/reference) · [HTTP API](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md) ·
[MCP](https://github.com/ClickHouse/loom/blob/main/docs/reference/mcp.md) · [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) · [환경 변수](/ko/reference/environment) ·
[호출 가능한 연산(op)](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) · [구성](https://github.com/ClickHouse/loom/blob/main/docs/reference/configuration.md) ·
[워커](https://github.com/ClickHouse/loom/blob/main/docs/reference/workers.md) · [CLI](https://github.com/ClickHouse/loom/blob/main/docs/reference/cli.md) · [오류](https://github.com/ClickHouse/loom/blob/main/docs/reference/errors.md) ·
[상태](https://github.com/ClickHouse/loom/blob/main/docs/reference/status.md) · [스키마](https://github.com/ClickHouse/loom/blob/main/docs/reference/schema.md) ·
[추출기 계약](/ko/reference/extractor-contract). 연산과 필드는 릴리스마다 바뀔 수 있습니다.
[알 수 없는 필드와 제거된 필드](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#unknown-and-removed-fields)에서는 서버가 더 이상 읽지 않는 필드를
클라이언트가 어떻게 받게 되는지 설명합니다.

<a id="5-namespaces-access-and-the-memory-model"></a>

## 5. 네임스페이스, 접근 권한, 메모리 모델

- [아이덴티티와 네임스페이스](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md): 튜플, 역할,
  권한 부여(grant), 읽기 범위.
- [메모리](https://github.com/ClickHouse/loom/blob/main/docs/concepts/memory.md): 행(row), 쓰기를 판단하는 방식, 시간, 이력,
  출처(provenance).
- [검색과 랭킹](/ko/concepts/retrieval-and-ranking): 레그(leg), 융합(fusion), 응답 보류(abstain),
  보정(calibration).

<a id="guides"></a>

## 가이드

[에이전트 연동](/ko/guides/agent-integration) ·
[헤드리스 봇](/ko/guides/headless-bots) ·
[토큰과 권한 부여](https://github.com/ClickHouse/loom/blob/main/docs/guides/tokens-and-grants.md) ·
[긴 실행 추적 및 재개](/ko/guides/trace-and-resume) ·
[네임스페이스 최적화](/ko/guides/optimize-namespace) ·
[조사 에이전트 메모리](https://github.com/ClickHouse/loom/blob/main/docs/guides/investigation-agent-memory.md) ·
[추출 파이프라인](/ko/guides/extraction-pipeline) ·
[성능 튜닝](/ko/guides/performance-tuning) · [디버깅](/ko/guides/debugging) ·
[Postgres에서 Loom 쿼리하기](/ko/guides/query-from-postgres) ·
[Loom으로 가르치기](/ko/guides/teaching)

<a id="features"></a>

## 기능

- 플레인: [네임스페이스와 공유](/ko/features/namespaces-and-sharing) ·
  [통합 검색](https://github.com/ClickHouse/loom/blob/main/docs/features/unified-search.md) · [지식](https://github.com/ClickHouse/loom/blob/main/docs/features/knowledge.md) ·
  [엔티티 그래프](https://github.com/ClickHouse/loom/blob/main/docs/features/entity-graph.md) ·
  [대화와 세션](https://github.com/ClickHouse/loom/blob/main/docs/features/conversations-and-sessions.md) ·
  [실행](https://github.com/ClickHouse/loom/blob/main/docs/features/runs.md) · [태스크와 의사결정](/ko/features/tasks-and-decisions) ·
  [대시보드](https://github.com/ClickHouse/loom/blob/main/docs/features/dashboard.md)
- 메모리: [쓰기](https://github.com/ClickHouse/loom/blob/main/docs/features/memory/writing.md) ·
  [검색과 질문](https://github.com/ClickHouse/loom/blob/main/docs/features/memory/search-and-ask.md) ·
  [충돌과 거부](https://github.com/ClickHouse/loom/blob/main/docs/features/memory/conflicts-and-refusal.md) ·
  [추출](https://github.com/ClickHouse/loom/blob/main/docs/features/memory/extraction.md) ·
  [이력과 출처](https://github.com/ClickHouse/loom/blob/main/docs/features/memory/history-and-provenance.md) ·
  [보존과 삭제](https://github.com/ClickHouse/loom/blob/main/docs/features/memory/retention-and-erasure.md) ·
  [절차와 학습 내용](https://github.com/ClickHouse/loom/blob/main/docs/features/memory/procedures-and-learnings.md) ·
  [워킹 메모리와 프로필](/ko/features/memory/working-memory-and-profiles)
- 관측성: [감사](/ko/features/observability/audit) ·
  [비용과 사용량](https://github.com/ClickHouse/loom/blob/main/docs/features/observability/cost-and-usage.md) ·
  [텔레메트리](https://github.com/ClickHouse/loom/blob/main/docs/features/observability/telemetry.md)
- 트래커: [개요](https://github.com/ClickHouse/loom/blob/main/docs/features/tracker/overview.md) ·
  [레코드 계약](/ko/features/tracker/record-contract)

<a id="6-code-index"></a>

## 6. 코드 인덱스

[개요](https://github.com/ClickHouse/loom/blob/main/docs/features/code-index/overview.md) ·
[리포지토리](/ko/features/code-index/repositories) ·
[최신성](/ko/features/code-index/freshness) ·
[기록과 PR](/ko/features/code-index/history-and-prs) ·
[호출 가능한 오퍼레이션(op)](/ko/features/code-index/operations) ·
[코드 인덱스 운영 런북](https://github.com/ClickHouse/loom/blob/main/docs/operations/code-index-operations.md)

<a id="architecture"></a>

## 아키텍처

[시스템 개요](https://github.com/ClickHouse/loom/blob/main/docs/architecture/system-overview.md) ·
[서버 레이아웃](/ko/architecture/server-layout) ·
[ClickHouse](/ko/architecture/clickhouse) ·
[메모리 아키텍처](https://github.com/ClickHouse/loom/blob/main/docs/architecture/memory-architecture.md) ·
[기준 스토리지 백엔드](https://github.com/ClickHouse/loom/blob/main/docs/architecture/storage-authority.md) ·
[셀](/ko/architecture/cells) ·
[스토리지 레이아웃](https://github.com/ClickHouse/loom/blob/main/docs/architecture/storage-layout.md) ·
[코드 인덱스 아키텍처](/ko/architecture/code-index-architecture) ·
[문서 추출](/ko/architecture/document-extraction) ·
[문서 소스](https://github.com/ClickHouse/loom/blob/main/docs/architecture/document-sources.md) ·
[LLM 및 임베딩](/ko/architecture/llm-architecture) ·
[보안](https://github.com/ClickHouse/loom/blob/main/docs/architecture/security.md) ·
[어시스턴트 설계](https://github.com/ClickHouse/loom/blob/main/docs/architecture/assistant.md) ·
[장애 및 복구](/ko/architecture/failure-and-recovery) ·
[롤링 업그레이드](https://github.com/ClickHouse/loom/blob/main/docs/architecture/rolling-upgrades.md)

<a id="benchmarks"></a>

## 벤치마크

[개요](/ko/benchmarks/overview) · [커버리지](/ko/benchmarks/coverage) ·
[방법론](/ko/benchmarks/methodology) ·
[실행](https://github.com/ClickHouse/loom/blob/main/docs/benchmarks/running.md) · [결과](https://github.com/ClickHouse/loom/blob/main/docs/benchmarks/results.md) ·
[케이스 추가](/ko/benchmarks/adding-a-case) · [스킬 평가](/ko/benchmarks/skill-eval)

<a id="development"></a>

## 개발

기여자를 위한 문서: [저장소 가이드](https://github.com/ClickHouse/loom/blob/main/docs/development/repository-guide.md) ·
[로컬 개발](https://github.com/ClickHouse/loom/blob/main/docs/development/local-development.md) ·
[테스트](/ko/development/testing) · [코드 생성](/ko/development/code-generation) ·
[마이그레이션](/ko/development/migrations) ·
[릴리스 절차](/ko/development/release-process) ·
[문서 스타일](https://github.com/ClickHouse/loom/blob/main/docs/development/documentation-style.md) ·
[큐레이션 루프 설계](https://github.com/ClickHouse/loom/blob/main/docs/development/curation-loop-design.md) ·
[Loom 확장](/ko/development/extending-loom) ·
[오퍼레이션 추가](/ko/development/adding-an-operation) ·
[워커 추가](/ko/development/adding-a-worker) ·
[테이블 추가](/ko/development/adding-a-table) ·
[언어 지원 추가](/ko/development/adding-language-support) ·
[대시보드 설계](/ko/development/dashboard-design).
[CONTRIBUTING.md](https://github.com/ClickHouse/loom/blob/main/CONTRIBUTING.md)에서 풀 리퀘스트 워크플로를 다룹니다.

<a id="also"></a>

## 함께 보기

[용어집](/ko/glossary): Loom의 용어를 한곳에 정리했습니다. [자주 묻는 질문](/ko/faq): 가장 먼저 나오는 질문과 한 단락짜리 답변입니다. [`llms.txt`](https://github.com/ClickHouse/loom/blob/main/llms.txt): 에이전트를 위해 생성한 문서 색인입니다. [`llms-full.txt`](https://clickhouse.github.io/loom/llms-full.txt)에는 Loom이 무엇인지, 어떻게 시작하는지를 설명하는 페이지가 하나의 파일에 담겨 있습니다.
