Mint Security의 Claude Code용 Dividend 플러그인 설치 및 사용

Dividend란 무엇인가요?

Dividend는 Mint Security가 Claude Code를 위해 만든 오픈 소스 플러그인입니다. 작업 중 빠른 팁과 짧은 강의를 표시하여 현재 세션의 컨텍스트, 프롬프트 캐시, 사용량 제한을 이해하는 데 도움을 줍니다.

플러그인의 인사이트는 Claude Code가 보고하는 정보를 기반으로 하며, 데이터는 사용자의 컴퓨터에 보관됩니다. 다른 Claude Code 모드와 마찬가지로 Dividend는 TypeScript로 작성된 JavaScript이며 사용자 권한으로 Claude Code 내부에서 실행됩니다.

Claude Code 플러그인은 사용자 권한으로 실행되므로 설치 전에 플러그인 문서와 소스 코드를 검토하세요. Dividend의 README에는 컴퓨터에서 플러그인이 수행하는 작업과 보관하는 정보가 설명되어 있습니다.

주요 기능

• 세션 컨텍스트 안내: Claude Code 세션과 연결된 컨텍스트를 이해하는 데 도움을 줍니다.
• 프롬프트 캐시 인사이트: Claude Code가 보고하는 프롬프트 캐시와 관련된 팁과 강의를 제공합니다.
• 사용량 제한 정보: Claude Code가 보고하는 사용량 제한을 더 쉽게 해석할 수 있도록 합니다.
• 세션 내 패널: 작업 중 /dividend 명령으로 열 수 있습니다.
• 로컬 작동: 보고된 인사이트와 보관되는 정보는 사용자의 컴퓨터 안에 유지됩니다.
• 데스크톱 지원: Claude 데스크톱 앱의 Code 탭에서도 플러그인을 불러올 수 있습니다.

사전 요구 사항

Dividend를 사용하려면 Claude Code 2.1.291 이상이 필요합니다. 문서에 명시된 릴리스는 2.1.291 버전에서 테스트되었습니다. 계속하기 전에 호환되는 Claude Code 설치 환경인지 확인하세요.

셸에서 Dividend 설치

먼저 Mint Security의 플러그인 마켓플레이스를 추가합니다.

claude plugin marketplace add Mint-Security/claude-code-plugins

그런 다음 해당 마켓플레이스에서 Dividend를 설치합니다.

claude plugin install dividend@mint-security

설치가 끝나면 새 Claude Code 세션을 시작합니다. 이미 세션이 열려 있다면 플러그인을 다시 불러옵니다.

/reload-plugins

마지막으로 Dividend 패널을 엽니다.

/dividend

Claude Code 세션에서 설치

터미널 기반 Claude Code 세션 내부에서 슬래시 명령 하나로 Dividend를 직접 설치할 수도 있습니다.

/plugin install dividend --marketplace Mint-Security/claude-code-plugins

1. Claude Code 세션에서 명령을 실행합니다.
2. 마켓플레이스를 추가할지 묻는 메시지가 표시되면 y를 입력합니다.
3. 플러그인을 설치할 위치를 선택합니다.
4. 필요한 경우 플러그인을 다시 불러옵니다.
5. /dividend를 실행하여 패널을 엽니다.

데스크톱 앱에 설치

Claude 데스크톱 앱에서 Dividend를 사용하려면 Settings를 열고 Plugins로 이동한 다음 Add를 선택하고 다음 마켓플레이스를 추가합니다.

Mint-Security/claude-code-plugins

추가한 후 마켓플레이스에서 Dividend를 설치합니다. 그러면 데스크톱 앱의 Code 탭에서 플러그인을 불러옵니다.

기본 사용법

Dividend는 활성 Claude Code 세션 중에 사용하도록 설계되었습니다. Claude Code가 보고하는 세션 정보를 해석하는 데 도움이 필요할 때 패널을 엽니다.

/dividend

패널에는 다음 세 가지 주요 영역에 대한 빠른 팁과 짧은 강의가 표시됩니다.

• 세션의 컨텍스트
• 프롬프트 캐시
• 사용량 제한

플러그인을 방금 설치했지만 명령을 사용할 수 없다면 플러그인을 다시 불러온 후 다시 시도하세요.

/reload-plugins
/dividend

검토된 릴리스에 Dividend 고정

이 마켓플레이스에서는 자동 업데이트가 기본적으로 비활성화되어 있습니다. 문서에 명시된 검토 릴리스를 계속 사용하려면 Dividend를 설치하기 전에 릴리스 태그를 사용하여 마켓플레이스를 추가하세요.

claude plugin marketplace add Mint-Security/claude-code-plugins#dividend--v0.1.0
claude plugin install dividend@mint-security

이렇게 마켓플레이스를 고정하면 설치가 고정되지 않은 마켓플레이스 참조가 아니라 dividend--v0.1.0 태그에 연결됩니다.

개발 및 로컬 테스트

저장소에 기여하거나 플러그인을 로컬에서 검토하는 경우 Claude Code에서 검증 및 테스트를 위한 명령을 제공합니다.

전체 저장소 검증

claude plugin validate .

Dividend만 검증

claude plugin validate plugins/dividend

플러그인 테스트 실행

claude plugin test plugins/dividend

세션에서 Dividend 직접 불러오기

claude --plugin-dir plugins/dividend

--plugin-dir 옵션을 사용하면 로컬 Dividend 디렉터리를 Claude Code 세션에서 실행할 수 있습니다. 패키지로 제공되는 마켓플레이스 릴리스를 설치하기 전에 변경 사항을 확인할 때 유용합니다.

고급 팁

• 설치 후 다시 불러오기: Claude Code 세션이 이미 열려 있다면 재시작하는 대신 /reload-plugins를 사용하세요.
• 안정성이 중요할 때 고정: 문서에 명시된 검토 릴리스를 사용하려면 #dividend--v0.1.0 접미사를 붙여 마켓플레이스를 추가하세요.
• 테스트 전 검증: 로컬에서 개발할 때는 테스트 명령을 실행하기 전에 저장소 또는 플러그인 디렉터리의 검증을 실행하세요.
• 플러그인 동작 확인: 플러그인이 표시하는 내용, 컴퓨터에서 수행하는 작업, 보관하는 정보를 자세히 알아보려면 Dividend 전용 README를 검토하세요.
• 권한 모델 기억: Claude Code는 사용자 권한으로 모드를 실행하므로 플러그인 검토를 설치 과정의 일부로 여기세요.

결론

Dividend는 간단한 세션 내 안내를 통해 Claude Code 세션 컨텍스트, 프롬프트 캐싱 및 사용량 제한을 쉽게 확인할 수 있도록 합니다. Mint Security의 마켓플레이스를 추가하고 플러그인을 설치한 후 /dividend를 사용하여 해당 패널을 엽니다. 개발자는 TypeScript 기반 플러그인을 로컬에서 검증하고 테스트하고 실행할 수도 있습니다. 이 프로젝트는 Apache-2.0 라이선스에 따라 배포됩니다.