tikeytaka:verify — 키 생사 실측 검증

코어 CLI: bash "${CLAUDE_PLUGIN_ROOT}/bin/tkt" (이하 tkt)

원칙

1. 등록 전 검증 필수: 죽은 키는 볼트에 들어가면 안 된다. add/scan은 이 절차를 통과한 값만 set-stdin 한다.
2. 무과금 엔드포인트만: 모델 목록 조회, getMe, auth/key 조회 등. 과금 호출이 불가피하면 max_tokens=1 또는 빈 바디로 인증 단계만 확인.
3. 값 미출력: 키는 셸 변수로만 다루고, 비교·보고는 sha256 앞 8자리 지문으로만.
4. argv 미노출: curl은 --config -(stdin)로 URL·헤더를 전달한다. curl -H "Bearer $KEY" 직접 사용 금지.

HTTP 코드 해석 (오판 방지)

코드	판정
200	생존
400	키 유효 — 요청 형식 문제일 뿐 (빈 바디 프로브의 정상 응답)
401	키 사망/무효
403	키 유효, 권한·플랜 문제 (예: 플랜 미구매) — 사망으로 오판하지 말 것
000	네트워크/프록시 차단 — 프록시 우회(env -u HTTP_PROXY -u HTTPS_PROXY) 후 재시도하고 나서 판정

⚠️ 흔한 오판 2종: ① 로컬 프록시(teamclaude 등)가 api.anthropic.com을 차단해 000 → 우회 재시도 필수. ② rc 파일에서 값을 추출할 때 $(command …) 참조형이면 리터럴 문자열을 키로 보내게 됨 — 값이 $(로 시작하면 해당 명령을 실행해 실제 값을 얻어 검증한다.

알려진 프로바이더 레시피 (2026-08 실측 검증됨)

np() { env -u HTTP_PROXY -u HTTPS_PROXY curl -s -m 10 --config - "$@"; } 전제.

서비스	프로브	생존 판정
Gemini/Google AI	GET generativelanguage.googleapis.com/v1beta/models?key=K	200
OpenAI	GET api.openai.com/v1/models + Bearer	200
Anthropic	GET api.anthropic.com/v1/models + x-api-key + anthropic-version: 2023-06-01 (프록시 우회 필수)	200
OpenRouter	GET openrouter.ai/api/v1/auth/key + Bearer	200
Perplexity	POST api.perplexity.ai/chat/completions + Bearer, 빈 바디 {}	400 (401=사망)
Telegram 봇	GET api.telegram.org/bot<K>/getMe	"ok":true + 봇 이름
data.go.kr (KMA/TOUR 등)	KMA getUltraSrtNcst에 serviceKey — 원본과 URL인코딩 양쪽 시도	resultCode 00/10 (SERVICE_KEY_IS_NOT_REGISTERED=인코딩 재시도 후 판정)
DashScope/QwenCloud	계약된 엔드포인트로 max_tokens=1 (예: token-plan.*.maas.aliyuncs.com/apps/anthropic/v1/messages)	200/400; 403 Unpurchased=키 유효·플랜 없음
로컬/자체 프록시	/health 200 + 인증 필요한 경로 1개 200	둘 다

미지의 프로바이더 — 공식문서로 레시피 만들기

레시피 표에 없는 서비스는 추측으로 프로브를 만들지 말고:

1. docs-guide 스킬(/docs-guide:docs-guide)로 해당 서비스 공식 API 문서에서 무과금 인증 확인 엔드포인트(모델 목록·계정 조회류)를 확인한다.
2. docs-guide 불가 시 WebSearch → 공식 문서 WebFetch 폴백.
3. 확인된 엔드포인트로 위 원칙(2·3·4)에 맞는 프로브를 구성해 검증한다.
4. 검증에 성공한 레시피는 이 표에 추가할 가치가 있음을 사용자에게 알린다 (플러그인 개선 제안).

전량 검증 모드 ("볼트 키 전부 확인")

tkt list 순회 → 서비스명에서 프로바이더 추정 → 각 레시피 실행 → 표로 보고: 서비스명 / 판정(생존·사망·권한문제·판정불가) / 근거 코드. 사망 키는 재발급 안내 + tkt del 제안. 프록시 URL 항목(*-proxy-url, *-base-url)은 /health + 인증 경로로 검증한다.