4.3 KB · updated 2026-07-06 · md

claude-code-plugin.ko.md

docs/i18n/integrations/claude-code-plugin.ko.md

Claude Code 플러그인

<!-- translations:start -->

English · 中文 · 日本語 · Русский · Español · Français · Deutsch

<!-- translations:end -->

Tesserae는 Claude Code 플러그인을 함께 제공합니다. TUI 세션 내부에서 전체 Tesserae 워크플로우를 사용할 수 있게 해줍니다 — 슬래시 명령, 자동 등록 MCP 서버, 에이전트를 안내하는 스킬, 에이전트↔프로젝트 메모리 루프를 닫는 네 개의 훅. 플러그인은 저장소 내 plugin/에 있습니다.

설치

# 사전 조건: `tesserae`가 이미 설치되어 있어야 합니다(`pip install tesserae` 또는 `pipx install tesserae`).
/plugin install /path/to/Tesserae/

사전 조건: tesserae가 이미 설치되어 있어야 합니다(pip install tesserae 또는 pipx install tesserae). pipx로 설치하는 경우, ~/.local/bin이 Claude Code가 시작 시 상속받는 PATH에 있는지 확인하세요.

포함된 것

  • 슬래시 명령 9개 — CLI에 1:1로 매핑되는 7개 래퍼(/tesserae:compile, /tesserae:ask, /tesserae:sessions-import, /tesserae:build-site, /tesserae:serve, /tesserae:obsidian-sync, /tesserae:setup) + 두 개의 워크플로우 매크로(/tesserae:refresh는 import + compile + obsidian-sync를 체인, /tesserae:status는 그래프 카운트와 마지막 컴파일 표시).
  • tesserae 서버 자동 등록 — 에이전트가 전체 도구 표면을 수동 설정 편집 없이 mcp__plugin_tesserae_tesserae__<tool>로 사용합니다: 그래프 쿼리(search_nodes, node_context, graph_ppr, search_facts), 온디맨드 compile_context / list_communities / fresh_insights 컴파일러, 세션 메모리(ask, list_sessions, find_session_findings, find_code_symbol_mentions), 가이드 설정(tesserae_setup_plan / tesserae_setup_apply). 전체 목록은 mcp.ko.md 참조.
  • using-tesserae 스킬 — 사용자가 타입드 그래프, 과거 세션 회수, 위키/볼트 콘텐츠, 또는 tesserae 워크플로우에 대해 질문할 때 자동 로드됩니다. 에이전트에게 어떤 MCP 도구를 사용할지 vs 어떤 슬래시 명령을 제안할지 가르쳐줍니다.
  • 훅 5개 — SessionStart는 그래프 요약을 출력; SessionEnd는 이번 대화의 인사이트가 다음 세션의 그래프 노드가 되도록 백그라운드 import+compile; Edit/Write/MultiEdit에서 두 개의 PostToolUse 훅이 발동 — 하나는 docs/ 편집 시 옵트인 증분 재컴파일, 다른 하나는 코드 그래프 동기화를 디바운스(~30초); PreToolUse(Bash 대상)는 큰 그래프 컴파일을 확인 대화상자로 게이팅.

전체 세부 정보, 명령/훅 표, 프로젝트별 opt-out 설정은 플러그인 자체의 MD0에 있습니다.

왜 플러그인과 MCP 서버 모두?

역할이 다릅니다:

  • MCP 도구 = 대화 중 에이전트가 호출하는 읽기 전용 그래프 쿼리. 항상 켜져 있고 마찰이 적습니다.
  • 슬래시 명령 = 명시적으로 호출하는 워크플로우 작업(compile, refresh, obsidian-sync). 영향력이 크지만 사용자의 결정이어야 합니다.

MCP 서버만 단독으로 사용할 수도 있습니다(tesserae projects mcp-config를 통한 수동 claude_desktop_config.json 편집). 플러그인은 단지 슬래시 명령, 스킬, 훅과 함께 패키징하여 한 단계로 설치할 수 있게 해줍니다.

설치 확인

/plugin list
/mcp
/tesserae:status

제거

/plugin uninstall tesserae

되돌릴 수 있습니다. 어떤 프로젝트의 .tesserae/ 디렉토리도 건드리지 않습니다.

참고