Kimi Debugging and operations

공급사: Moonshot AI (月之暗面) | 공식 문서: platform.kimi.ai/docs 한글화 일자: 2026-07-22

Kimi API 운영·디버깅·벤치마킹을 위한 도구와 모범 사례를 정리한 가이드 모음입니다. 트러블슈팅, Playground, MoonPalace, Batch API, Auto Reconnect, Benchmark Best Practices를 다룹니다.

---

📚 Kimi Debugging and operations 가이드

#	문서	설명
1	Kimi Troubleshooting	Kimi API 자주 묻는 문제: 401/404/429/모델/충전/도구/연결/SDK
2	Kimi Playground Debug	웹 UI에서 모델 디버깅 + 공식 도구 + 모델 비교 + 대화 공유
3	Kimi MoonPalace	로컬 프록시 + inspect/list/export로 Bad Case 캡처·내보내기
4	Kimi Batch API	K2.6/K2.5 JSONL 대량 처리 (kimi-k3는 미지원), 40% 비용 절감
5	Kimi Benchmark Best Practices	K2.6/K2.5/K2-Thinking 벤치마크 권장 설정 + FAQ + 재현성 팁
6	Kimi Auto Reconnect	연결 끊김 시 exponential backoff 재시도 구현 예제 (K3 기준)

---

🎯 패턴 선택 가이드

시나리오	권장 가이드
자주 묻는 문제 (잔액/Key/429/모델 등)	Kimi Troubleshooting
웹 UI 디버깅 (토큰·비교·공식 도구)	Kimi Playground Debug
로컬 프록시 캡처 (Bad Case 내보내기)	Kimi MoonPalace
대량 비동기 처리 (40% 비용 절감)	Kimi Batch API
벤치마크 재현성 (K2.6/K2.5/K2-Thinking)	Kimi Benchmark Best Practices
연결 끊김 자동 복구 (재시도 패턴)	Kimi Auto Reconnect

---

⚡ 빠른 시작

# 가장 자주 발생하는 문제: 401/404/permission denied
# 1. 다른 Kimi 제품의 Key를 쓰고 있지 않은지 확인 (Open Platform ↔ Kimi Code)
# 2. Key 발급 지역과 엔드포인트가 일치하는지 (platform.kimi.ai = api.moonshot.ai)
# 3. GET /v1/models 로 모델 존재 확인
# 4. 로컬 라우팅 도구(CC Switch 등)의 환경 변수/프록시 잔여물 정리

# 자세한 내용: 각 가이드의 FAQ 섹션 참고

---

📚 영역 구분

영역	페이지
Models	Kimi K3 Quickstart, Kimi K2.7 Code Quickstart, Kimi K2.6 Quickstart
Tooling	Dynamic Tool Loading, Tool Calling Best Practices
Integrations	Claude Code, Codex CLI, OpenCode

---

📞 추가 리소스

리소스	링크
공식 API 문서	https://platform.kimi.ai/docs
Playground	https://platform.kimi.ai/playground
API Key 발급	https://platform.kimi.ai/console/api-keys
개발자 커뮤니티	https://platform.kimi.ai/docs/api/join-the-community

---

변경 이력

날짜	변경
2026-07-22	Kimi Debugging and operations를 hub 페이지로 전환, 6개 자식 가이드 한글화