fivetaku tikeytaka:verify — 키 생사 실측 검증
코어 CLI: bash "${CLAUDE_PLUGIN_ROOT}/bin/tkt" (이하 tkt)
원칙
- 등록 전 검증 필수: 죽은 키는 볼트에 들어가면 안 된다. add/scan은 이 절차를 통과한 값만
set-stdin한다. - 무과금 엔드포인트만: 모델 목록 조회, getMe, auth/key 조회 등. 과금 호출이 불가피하면 max_tokens=1 또는 빈 바디로 인증 단계만 확인.
- 값 미출력: 키는 셸 변수로만 다루고, 비교·보고는 sha256 앞 8자리 지문으로만.
- 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 |
둘 다 |
미지의 프로바이더 — 공식문서로 레시피 만들기
레시피 표에 없는 서비스는 추측으로 프로브를 만들지 말고:
- docs-guide 스킬(
/docs-guide:docs-guide)로 해당 서비스 공식 API 문서에서 무과금 인증 확인 엔드포인트(모델 목록·계정 조회류)를 확인한다. - docs-guide 불가 시 WebSearch → 공식 문서 WebFetch 폴백.
- 확인된 엔드포인트로 위 원칙(2·3·4)에 맞는 프로브를 구성해 검증한다.
- 검증에 성공한 레시피는 이 표에 추가할 가치가 있음을 사용자에게 알린다 (플러그인 개선 제안).
전량 검증 모드 ("볼트 키 전부 확인")
tkt list 순회 → 서비스명에서 프로바이더 추정 → 각 레시피 실행 → 표로 보고:
서비스명 / 판정(생존·사망·권한문제·판정불가) / 근거 코드. 사망 키는 재발급 안내 + tkt del 제안.
프록시 URL 항목(*-proxy-url, *-base-url)은 /health + 인증 경로로 검증한다.