로컬 임베딩, 호출 그래프 추적, AI 코딩 에이전트용 MCP 서버를 지원하는 프라이버시 우선 CLI 시맨틱 코드 검색 도구입니다.
cocoindex-io/cocoindex-code
코드베이스를 인덱싱해 코딩 에이전트가 의미를 바탕으로 코드를 찾도록 돕는 AST 기반 시맨틱 코드 검색 CLI 및 MCP 서버입니다.
- 스타
- 2,966
- 포크
- 248
- 열린 이슈
- 62
- 마지막 커밋
- 22시간 전
어떤 프로젝트인가요?
cocoindex-code는 로컬 코드베이스를 위한 경량 시맨틱 코드 검색 도구입니다. tree-sitter로 소스 파일을 파싱해 AST 기반 청크로 나누고 임베딩한 뒤, 인덱스를 로컬에 저장하므로 정확한 텍스트 대신 자연어 설명으로 검색할 수 있습니다. CocoIndex Rust 데이터 변환 엔진을 기반으로 하며 변경된 파일만 다시 인덱싱합니다.
ccc index, ccc search 같은 명령으로 CLI에서 사용하거나, MCP 서버(ccc mcp) 또는 설치 가능한 에이전트 스킬을 통해 Claude Code, Codex 같은 코딩 에이전트에 연결할 수 있습니다. 별도의 ccc grep 명령은 인덱스 없이 코드 예제를 바탕으로 구조적 검색을 수행합니다.
임베딩에는 전체 extra를 설치하면 API 키 없이 사용할 수 있는 로컬 SentenceTransformers 모델이나 LiteLLM을 통한 클라우드 제공자를 사용할 수 있습니다. 설정은 전역 및 프로젝트별 YAML 파일에 저장하며, 컨테이너 환경에서 사용할 수 있도록 Docker 이미지도 제공합니다.
핵심 기능
- 01정확한 텍스트 일치 대신 자연어 쿼리로 코드의 의미를 검색합니다.
- 02Python, TypeScript, Rust, Go, Java, C/C++ 등을 포함한 여러 언어를 tree-sitter로 파싱합니다.
- 03업데이트를 빠르게 유지하도록 변경된 파일만 다시 인덱싱합니다.
- 04Claude Code, Codex 같은 코딩 에이전트에서 사용할 수 있도록 검색 기능을 MCP 도구로 제공합니다.
- 05LiteLLM을 통해 로컬 임베딩 모델이나 클라우드 임베딩 제공자를 지원합니다.
- 06인덱스 없이 코드 예제로 구조적 검색을 수행하는 ccc grep을 제공합니다.
활용 사례
- 크고 익숙하지 않은 저장소에서 코딩 에이전트가 관련 코드를 찾도록 돕습니다.
- 함수나 변수의 정확한 이름을 모를 때 동작을 설명해 구현을 찾습니다.
- 관련 코드 청크만 가져와 코딩 에이전트의 토큰 사용량을 줄입니다.
- 로컬 임베딩 모델을 사용해 API 키 없이 비공개 코드 검색을 로컬에서 실행합니다.
빠른 시작
- 1
pipx로 CLI 설치(필요한 구성 요소 포함)
pipx install 'cocoindex-code[full]' - 2
코딩 에이전트에 ccc skill 설치
npx skills add cocoindex-io/cocoindex-code - 3
또는 프로젝트에서 인덱스를 직접 빌드
ccc index - 4
의미를 기반으로 코드베이스 검색
ccc search "authentication logic"
사용 전 알아둘 점
- 전체 설치 시 로컬 임베딩을 위해 torch와 transformers가 약 1GB 다운로드됩니다.
- slim 버전에는 클라우드 임베딩 제공업체와 API 키가 필요합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- cocoindex-code은(는) 무엇인가요?
- 코드베이스를 인덱싱해 코딩 에이전트가 의미를 바탕으로 코드를 찾도록 돕는 AST 기반 시맨틱 코드 검색 CLI 및 MCP 서버입니다. cocoindex-code는 로컬 코드베이스를 위한 경량 시맨틱 코드 검색 도구입니다. tree-sitter로 소스 파일을 파싱해 AST 기반 청크로 나누고 임베딩한 뒤, 인덱스를 로컬에 저장하므로 정확한 텍스트 대신 자연어 설명으로 검색할 수 있습니다. CocoIndex Rust 데이터 변환 엔진을 기반으로 하며 변경된 파일만 다시 인덱싱합니다.
- cocoindex-code은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- cocoindex-code은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- cocoindex-code은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. cocoindex-code의 마지막 커밋은 2026년 11월 5일입니다.
- cocoindex-code은(는) 어디에 사용할 수 있나요?
- 크고 익숙하지 않은 저장소에서 코딩 에이전트가 관련 코드를 찾도록 돕습니다. 함수나 변수의 정확한 이름을 모를 때 동작을 설명해 구현을 찾습니다. 관련 코드 청크만 가져와 코딩 에이전트의 토큰 사용량을 줄입니다. 로컬 임베딩 모델을 사용해 API 키 없이 비공개 코드 검색을 로컬에서 실행합니다.
- cocoindex-code는 어떻게 설치하나요?
- pipx로 CLI 설치(필요한 구성 요소 포함): pipx install 'cocoindex-code[full]' 코딩 에이전트에 ccc skill 설치: npx skills add cocoindex-io/cocoindex-code 또는 프로젝트에서 인덱스를 직접 빌드: ccc index 의미를 기반으로 코드베이스 검색: ccc search "authentication logic"
- cocoindex-code은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/cocoindex-io/cocoindex-code
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
코드베이스의 시맨틱 지식 그래프를 구축하고 MCP를 통해 코딩 에이전트에 에이전트 기반 코드 분석 도구를 제공하는 Rust 도구입니다.
tree-sitter AST 파싱으로 코드베이스, 문서, 스키마, PDF를 로컬에서 질의 가능한 지식 그래프로 변환합니다.
Ollama 또는 LM Studio 임베딩을 사용해 Claude Code, Codex, Cursor, OpenCode에 코드베이스의 의미 기반 검색을 제공하는 로컬 시맨틱 코드 검색 MCP 서버입니다.
코드, 문서, 인프라를 로컬 지식 그래프로 인덱싱해 AI 코딩 에이전트가 파일을 다시 읽는 대신 구조를 질의할 수 있게 하는 MCP 서버입니다.
다국어 코드베이스를 지식 그래프로 인덱싱해 AI 에이전트나 MCP 서버를 통해 자연어로 조회·검색·편집합니다.