컨텍스티움: Claude 코드를 위한 오픈소스 지속적 컨텍스트 프레임워크

Contextium은 Claude Code를 위해 특별히 제작된 오픈소스 지속적 컨텍스트 프레임워크입니다. 이는 시간이 지남에 따라 지식을 축적하는 구조화된 저장소 시스템을 만들어 각각의 새로운 Claude Code 세션에서 컨텍스트를 다시 설명해야 하는 문제를 해결합니다.

주요 기능

Contextium은 정보를 앱, 통합, 지식 도메인, 프로젝트, 저널 등 여러 범주에 걸쳐 마크다운 파일로 구성합니다. 핵심 메커니즘은 CLAUDE.md 파일로, 현재 작업에 따라 Claude가 어떤 파일을 로드해야 하는지 알려주는 컨텍스트 라우터 역할을 합니다. 이는 관련 콘텐츠만 지연 로드하여 컨텍스트 창 팽창을 방지합니다.

주요 특징

• 컨텍스트 라우터 테이블: CLAUDE.md 파일에는 특정 파일 로드를 트리거하는 라우팅 테이블이 포함되어 있습니다:

  | 트리거 | 로드 |
  |----------------------|-----------------------------------|
  | 프로젝트 작업 | projects/README.md |
  | 언급된 사람 | knowledge/people/{name}/ |
  | 통합/API 호출 | integrations/{name}/README.md |
  | 이전 작업 | journal/ (최신) |

• 다중 에이전트 지원: 연구는 Gemini로(비용 효율성), 대량 편집은 Codex로(속도) 라우팅하면서 Claude는 전략과 결정에 집중하도록 유지
• 템플릿 구조: 오픈소스 버전에는 6개의 샘플 앱과 27개 통합에 대한 문서가 포함되어 제공됩니다
• 실제 규모: 제작자의 개인 인스턴스에는 35개의 앱 프로토콜, 27개의 통합 커넥터, 100개 이상의 완료된 프로젝트(결정 로그 포함), 600개 이상의 저널 항목이 포함되어 있습니다

설치 및 설정

단일 명령어로 설치:

bash curl -sSL contextium.ai/install | bash

설치 프로그램은 bash와 gum을 사용하여 터미널 UI를 제공하며, 사용자 이름을 묻고, AI 에이전트(Claude Code 및 8개의 다른 에이전트 지원)를 선택하고, 통합을 선택하며, 저장소를 설정합니다. 이 과정은 약 5분이 소요되며 macOS와 Linux에서 작동합니다.

개발 과정

제작자는 Claude Code를 사용하여 몇 달에 걸쳐 Contextium을 구축했으며, Claude Code가 코드의 약 90%를 작성했습니다. 여기에는 다음이 포함됩니다:

• 설치 스크립트(bash + gum)
• 27개 통합 README 파일의 적응
• 에이전트 구성 템플릿
• Astro 웹사이트
• 새로운 VM에서의 여러 테스트 실행을 통한 디버깅

기술적 세부사항

• 라이선스: Apache 2.0
• GitHub: https://github.com/Ashkaan/contextium
• 웹사이트: https://contextium.ai