fivetaku tikeytaka:requires — 플러그인 키 선언 대조
코어 CLI: bash "${CLAUDE_PLUGIN_ROOT}/bin/tkt" (이하 tkt)
tkt requires # 설치된 마켓/캐시 플러그인 전체 스캔
tkt requires <플러그인경로> ... # 특정 경로만
플러그인 루트의 keys.json 선언을 읽어 볼트와 대조한다. 사람이 "이 플러그인엔 무슨 키가 필요하더라"를 기억할 필요를 없앤다.
출력 읽는 법
ok— 볼트에 있음. 추가 조치 불필요.MISSING— 필수인데 미등록. exit code 4.opt— 선택 항목 미등록. 그 기능만 비활성일 뿐 정상 동작.
MISSING이 있으면 발급 링크(docs)를 안내하고 add 스킬 절차로 유도한다. 키 값을 채팅으로 받지 않는다 — tkt setp <service>(터미널 숨김 입력)를 사용자가 직접 실행하게 한다.
keys.json 스키마
플러그인 루트(plugin.json과 같은 층)에 둔다. plugin.json에는 넣지 않는다 — Claude Code 매니페스트 스키마에 없는 키를 넣으면 claude plugin validate가 실패한다.
{
"keys": [
{
"service": "gemini-api-key",
"env": "GEMINI_API_KEY",
"required": true,
"description": "이미지 분석 호출용",
"docs": "https://aistudio.google.com/apikey"
}
]
}
| 필드 | 필수 | 뜻 |
|---|---|---|
service |
O | 볼트 안의 서비스명 (tkt list 출력과 일치해야 함) |
env |
이 키가 들어갈 환경변수명 — 보고에 표시 | |
required |
기본 true. false면 opt로 보고하고 exit code에 영향 없음 |
|
description |
용도 한 줄 | |
docs |
발급 페이지 URL — 미등록일 때 사용자에게 안내됨 |
주의
service는 볼트의 실제 이름이다. 새로 짓지 말고tkt list로 기존 이름을 먼저 확인해 맞춘다 (같은 키가 두 이름으로 갈라지면 전파가 깨진다).- 이 명령은 읽기 전용이다. 키를 자동 등록하거나
.env를 건드리지 않는다. 전파는map-add+sync소관. - python3가 필요하다 (keys.json 파싱).