claude-context
CLI 도구zilliztech/claude-context
AI 코딩 에이전트를 위한 전체 코드베이스 의미 검색을 제공하는 MCP 플러그인입니다.
개요
Claude Context는 MCP 서버로, Claude Code 등 AI 프로그래밍 어시스턴트가 전체 코드베이스에서 의미론적 검색을 수행할 수 있게 합니다. 벡터 임베딩을 통해 관련 코드 조각을 효율적으로 검색하며, 전체 디렉터리를 로드하지 않아 비용을 절감합니다.
README 미리보기
\n\n> 🆕 **Looking for persistent memory for Claude Code?** Check out [memsearch Claude Code plugin](https://github.com/zilliztech/memsearch#for-claude-code-users) — a markdown-first memory system that gives your AI agent long-term memory across sessions.\n\n### Your entire codebase as Claude's context\n\n[](https://opensource.org/licenses/MIT)\n[](https://nodejs.org/)\n[](docs/)\n[](https://marketplace.visualstudio.com/items?itemName=zilliz.semanticcodesearch)\n[](https://www.npmjs.com/package/@zilliz/claude-context-core)\n[](https://www.npmjs.com/package/@zilliz/claude-context-mcp)\n[](https://twitter.com/zilliz_universe)\n[](https://deepwiki.com/zilliztech/claude-context)\n\n\n\n\n**Claude Context** is an MCP plugin that adds semantic code search to Claude Code and other AI coding agents, giving them deep context from your entire codebase.\n\n🧠 **Your Entire Codebase as Context**: Claude Context uses semantic search to find all relevant code from millions of lines. No multi-round discovery needed. It brings results straight into the Claude's context.\n\n💰 **Cost-Effective for Large Codebases**: Instead of loading entire directories into Claude for every request, which can be very expensive, Claude Context efficiently stores your codebase in a vector database and only uses related code in context to keep your costs manageable.\n\n---\n\n## 🚀 Demo\n\n\n\nModel Context Protocol (MCP) allows you to integrate Claude Context with your favorite AI coding assistants, e.g. Claude Code.\n\n## Quick Start\n\n### Prerequisites\n\n\nGet a free vector database on Zilliz Cloud 👈\n\nClaude Context needs a vector database. You can [sign up](https://cloud.zilliz.com/signup?utm_source=github&utm_medium=referral&utm_campaign=2507-codecontext-readme) on Zilliz Cloud to get an API key.\n\n\n\nCopy your Personal Key to replace `your-zilliz-cloud-api-key` in the configuration examples.\n\n\n\nGet OpenAI API Key for embedding model\n\nYou need an OpenAI API key for the embedding mode
FAQ (3)
문제 해결Claude Code MCP 서버가 시작 시 'Address is required and could not be resolved from token' 오류와 함께 충돌하는 이유는 무엇인가요?
Claude Code MCP 구성에 MILVUS_ADDRESS 환경 변수가 누락되었습니다. MCP 서버를 추가할 때 Zilliz Cloud 엔드포인트를 제공해야 합니다. 예시:
claude mcp add claude-context \\
-e OPENAI_API_KEY=sk-your-openai-api-key \\
-e MILVUS_TOKEN=your-zilliz-cloud-api-key \\
-e MILVUS_ADDRESS=your-zilliz-cloud-api-endpoint \\
-- npx @zilliz/claude-context-mcp@latest이렇게 하면 'Address is required and could not be resolved from token' 오류를 방지할 수 있습니다. 이 수정 사항은 최신 README에 반영되었습니다.
문제 해결왜 제 코드베이스가 충돌 후 매 세션마다 강제 재인덱싱을 계속하나요?
이것은 v0.1.6에서 알려진 버그입니다: 인덱싱 중단 후 스냅샷 파일이 0/0에서 멈추어 무한 재인덱싱 루프가 발생합니다. 해결 방법: ~/.context/mcp-codebase-snapshot.json을 편집하고 해당 코드베이스의 'indexedFiles'와 'totalChunks'를 Milvus의 실제 행 수(Milvus stats를 통해 확인)와 일치하도록 업데이트하십시오. 영구적인 수정이 계획되어 있습니다 (track #295).
문제 해결claude-context가 ignore 파일에 포함되어 있음에도 불구하고 /Library/와 같은 루트 레벨 디렉토리 내부의 파일들을 왜 여전히 인덱싱하나요?
claude-context는 무시 패턴에서 선행 슬래시(루트만 일치)와 후행 슬래시(디렉터리 및 내용)를 완전히 해석하지 않습니다. Git과 같은 표준 도구는 /Library/를 '루트에 있는 Library 폴더와 그 안의 모든 내용을 무시'로 처리합니다. 해결 방법으로 선행 슬래시를 제거하고 후행 슬래시를 /**로 대체하거나(예: Library/**), 슬래시 없이 Library를 사용하여 디렉터리와 그 파일을 재귀적으로 무시할 수 있습니다. 이 문제는 #200으로 추적됩니다.