Repolode
cocoindex-io

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. 1

    pipx로 CLI 설치(필요한 구성 요소 포함)

    pipx install 'cocoindex-code[full]'
  2. 2

    코딩 에이전트에 ccc skill 설치

    npx skills add cocoindex-io/cocoindex-code
  3. 3

    또는 프로젝트에서 인덱스를 직접 빌드

    ccc index
  4. 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 통계는 매일 갱신됩니다.

관련 프로젝트