📖 튜토리얼 ⏱ 약 22분 분량

Kimi K2.6 에이전트 오픈소스 × Clash: Moonshot API·Kimi Code CLI 분류와 DNS 실측 (2026)

2026년 4–5월 기술 커뮤니티에서 Kimi K2.6는 「1T급 MoE·에이전트 스웜·장기 코딩」 키워드로 Cursor·Junie·Codex 계열과 다른 축의 화제가 됐습니다. 웹 챗은 되는데 platform.moonshot.ai API만 연결 타임아웃이거나, Kimi Code CLI 터미널만 끊기는 경우 대부분은 모델 성능이 아니라 도메인 분류·DNS·터미널 프록시 세 층이 어긋난 패턴입니다. 이 글은 Moonshot·Kimi 호스트를 Clash 규칙으로 묶고 실측하는 순서를 한국어 실무 관점으로 정리합니다.

① Kimi K2.6를 쓸 때 네트워크가 갈라지는 세 갈래

Kimi K2.6를 접하는 경로는 한 줄로 묶기 어렵습니다. 브라우저에서 kimi.com 웹·앱을 쓰는 흐름, 개발자 콘솔·SDK가 치는 Moonshot API(대표 호스트 platform.moonshot.ai, 국내 문서·레거시 경로는 api.moonshot.cn·platform.moonshot.cn), 그리고 GitHub moonshotai/kimi-cli 기반 Kimi Code CLI 터미널 에이전트가 각각 다른 프로세스·다른 프록시 인식 방식을 가집니다.

오픈 가중치를 Hugging Face에서 받아 로컬 vLLM·SGLang으로 돌리면 Moonshot 클라우드 호스트는 거의 안 나갑니다. 반대로 클라우드 에이전트 코딩·스웜·멀티모달을 쓰면 API·웹·CLI가 동시에 여러 접미사를 두드리므로, 「전역 VPN 하나」보다 Rule 기반 Clash Meta(Mihomo)가 패치·감사에 유리합니다. 입문은 Clash 튜토리얼의 Rule·DNS 차이부터 맞춰 두면 이후 단계가 덜 헷갈립니다.

② 증상 지도: 웹 OK·API만 실패 vs CLI만 실패

검색 의도가 「Kimi K2.6 Clash 분류」라면 보통 아래 표에 가까운 증상입니다.

  • 패턴 A: 웹 챗은 로딩되나 OpenAI 호환 API 호출에서 ETIMEDOUT·TLS handshake timeout.
  • 패턴 B: IDE 확장은 되고 Kimi Code CLI만 zsh에서 실패(시스템 프록시 미적용).
  • 패턴 C: .ai와 .cn 엔드포인트를 섞어 쓰다 한쪽만 GEOIP·DIRECT로 떨어짐.
  • 패턴 D: 에이전트가 병렬 서브태스크를 열며 짧은 간격으로 새 HTTPS 연결이 폭증해 429·끊김이 간헐적으로 보임.

비슷한 멀티 공급자 CLI 디버깅 흐름은 Junie CLI × Clash 분류·Claude Code CLI 분류 글과 결이 같습니다. Kimi는 Moonshot 전용 접미사 묶음이 추가된다고 보면 됩니다.

③ 추측 말고 로그부터: 고정할 호스트 목록

릴리스마다 스테이징 호스트가 바뀔 수 있어 외운 블록리스트만으로는 부족합니다. 아래 순서를 권합니다.

  1. Kimi Code CLI 실행 시 --verbose 또는 HTTP 디버그로 실제 HTTPS 호스트 문자열을 복사합니다.
  2. 동일 머신·동일 셸에서 curl -v https://platform.moonshot.ai(문서에 안내된 경로)로 핸드셰이크 시간을 잽니다.
  3. Clash Verge Rev·Mihomo 로그에서 RULE 줄로 목표 접미사가 어느 proxy-group으로 갔는지 캡처합니다.
  4. 패키지·플러그인 설치가 끼면 github.com·objects.githubusercontent.com도 함께 확인합니다(Cursor·GitHub 분류 참고).
💡 한 줄 요약 platform.moonshot.ai는 콘솔·SDK 문서의 base URL과 항상 같아야 합니다. 문서와 다른 호스트로 규칙을 맞추면 「분류는 맞는데 여전히 타임아웃」이 반복됩니다.

④ 규칙 스케치: MOONSHOT_API와 KIMI_WEB을 나누기

아래는 개념 레이아웃입니다. proxy-groups 이름은 본인 구독 YAML과 일치시키고, 검증된 호스트만 prepend 하세요.

rules:
  - DOMAIN-SUFFIX,platform.moonshot.ai,MOONSHOT_API
  - DOMAIN-SUFFIX,api.moonshot.cn,MOONSHOT_API
  - DOMAIN-SUFFIX,platform.moonshot.cn,MOONSHOT_API
  - DOMAIN-SUFFIX,moonshot.ai,MOONSHOT_API
  - DOMAIN-SUFFIX,moonshot.cn,MOONSHOT_API
  - DOMAIN-SUFFIX,kimi.com,KIMI_WEB
  - DOMAIN-SUFFIX,kimi.ai,KIMI_WEB
  - DOMAIN-SUFFIX,cdn.kimi.com,KIMI_WEB
  - DOMAIN-SUFFIX,github.com,PROXY_DEPS
  - DOMAIN-SUFFIX,githubusercontent.com,PROXY_DEPS
  - GEOIP,CN,DIRECT
  - MATCH,DIRECT

MOONSHOT_API와 KIMI_WEB을 한 그룹에 몰아도 되지만, 「웹만 느리다」「API 키 교환만 실패」처럼 층을 나누면 Kimi K2.6 스웜·장기 코딩 세션 디버깅이 빨라집니다. 문법·순서 충돌은 사용자 정의 규칙 튜토리얼과 교차 검증하세요.

⑤ Kimi Code CLI: 터미널은 브라우저와 다른 출구

Kimi Code CLI(moonshotai/kimi-cli)는 셸에서 파일 편집·명령 실행·웹 조회를 묶는 에이전트 코딩 도구입니다. VS Code·Agent Client Protocol 연동도 있어, GUI 확장은 시스템 프록시를 타고 CLI만 직접 HTTPS를 여는 경우가 흔합니다.

검증 체크:

  • CLI를 연 터미널에 export https_proxy=http://127.0.0.1:7890 등 mixed-port를 명시했는지(대소문자·no_proxy 포함).
  • TUN 모드만 켜고 셸 프록시가 비어 있으면 CLI가 터널 밖으로 나가는지(TUN·DNS 심화).
  • WSL2에서 Windows Clash와 localhost 불일치 여부(WSL2 Git·npm 프록시).

CI·헤드리스 러너 패턴은 Cursor Agent SDK CI 분류 글의 환경 변수 레이어 설명을 그대로 적용할 수 있습니다. 차이점은 에이전트 호스트가 Cursor 접미사가 아니라 Moonshot·kimi.com 축이라는 점뿐입니다.

⑥ DNS: fake-ip·DoH·.ai / .cn 교차

fake-ip가 켜진 프로필에서는 앱이 보는 IP와 실제 라우팅이 어긋나 보일 수 있습니다. Kimi K2.6 멀티모달·문서 업로드는 CDN 접미사가 추가되기 쉬워, 규칙만 맞고 DNS가 다른 경로를 타면 간헐 실패가 납니다.

한 번에 한 변수만 바꿔 좁히세요: (1) 증상 호스트에 nameserver-policy 지정, (2) OS·브라우저 DoH와 Clash dns 블록 동시 사용 여부, (3) .ai와 .cn을 같은 해석기로 묶었는지. Mixin으로 DNS만 덮어쓰려면 Verge Rev Mixin 패턴을 쓰면 구독 본체를 덜 건드립니다.

⚠️ 보안 전제 API 키·조직 정책·이용 지역은 사용자가 스스로 확인해야 합니다. 이 글은 합법 범위의 연결 품질·분류만 다루며, 규제 우회를 권하지 않습니다.

⑦ OpenAI·Anthropic SDK 호환과 엔드포인트 고정

Moonshot API는 OpenAI·Anthropic SDK 호환 모드로 안내되는 경우가 많습니다. 클라이언트가 base_url을 https://platform.moonshot.ai/...로 고정했는지, 실수로 다른 리전 URL을 섞지 않았는지 먼저 봅니다. SDK가 리다이렉트·추가 호스트를 열면 규칙에 없는 접미사가 생깁니다.

로컬 오픈 가중치 추론만 할 때는 Moonshot 호스트가 안 나가므로 Clash 이슈가 없습니다. 클라우드 에이전트·스웜·Kimi Code CLI가 API를 두드릴 때만 이 글의 체크리스트가 필요합니다. 다른 국산·글로벌 모델 분류와 비교하려면 DeepSeek 분류·OpenAI Codex·ChatGPT 분류를 대조해 보세요.

⑧ 에이전트 스웜·장기 세션: 연결 폭증과 백오프

Kimi K2.6는 서브 에이전트·장기 코딩 시나리오에서 짧은 간격으로 많은 HTTPS 연결을 엽니다. 회선·노드 품질 문제가 아니라 속도 제한·동시성 상한에 걸리면 429·간헐 끊김이 보입니다. 애플리케이션 층에서 동시성 제한·지수 백오프를 먼저 줄인 뒤에도 패킷 이상이 지속되면 다시 분류·DNS로 돌아옵니다.

⑨ 릴리스 직후 30분 점검 루틴

  1. 활성 프로필 SHA·구독 갱신 시각을 기록합니다.
  2. 실패 빌드·CLI stderr에서 HTTPS 호스트를 그대로 복사합니다.
  3. platform.moonshot.ai 등 문서 URL과 로그 문자열이 일치하는지 확인합니다.
  4. Rule 적중 로그로 MOONSHOT_API·KIMI_WEB 분리 여부를 봅니다.
  5. fake-ip on/off로 DNS A/B 한 번씩.
  6. Kimi Code CLI 셸에 프록시 변수·no_proxy를 재적용합니다.

⑩ 자주 묻는 질문

platform.moonshot.ai와 api.moonshot.cn 중 무엇을 규칙에 넣어야 하나요?

콘솔·SDK에 표시된 base URL을 기준으로 합니다. 조직·결제·리전에 따라 달라질 수 있어, 둘 다 prepend 하되 실제 로그에 안 찍히는 줄은 정리하는 편이 유지 보수에 낫습니다.

브라우저는 되는데 Kimi Code CLI만 안 됩니다.

터미널 프록시 변수·TUN 적용 범위·WSL 브리지를 먼저 보세요. CLI는 시스템 프록시 토글만으로는 안 잡히는 경우가 많습니다.

Kimi K2.6 오픈소스면 VPN 없이 로컬만 쓰면 되지 않나요?

로컬 추론만 하면 그렇습니다. 웹·Moonshot API·Kimi Code CLI 클라우드 경로를 쓰면 이 글의 Clash 분류가 필요합니다.

⑪ 정리: 「Kimi K2.6」과 「Moonshot 호스트」를 한 세트로

2026년 Hot Topic인 Kimi K2.6는 모델 스펙만큼이나 platform.moonshot.ai·kimi.com·Kimi Code CLI 출구가 갈라집니다. 안정 체감은 노드 품질뿐 아니라 도메인 분류 적중·DNS 경로 일치·터미널 프록시 동기화에 달립니다.

일부 원클릭 VPN은 모든 트래픽을 한 터널로 밀어 넣기 쉽지만, 에이전트 코딩처럼 API·GitHub·CDN이 동시에 열리면 세밀한 API 분류를 손보기 어렵고 호스트가 바뀔 때마다 다시 헷갈리기 쉽습니다. 반면 Clash는 규칙을 텍스트로 남길 수 있고 Mihomo의 RULE-PROVIDER로 Moonshot 접미사 패치를 팀과 공유하기 쉽습니다.

Kimi K2.6 웹·Moonshot API·Kimi Code CLI를 장기적으로 쓸 계획이라면, 지금 회선 위에서 MOONSHOT_API 블록부터 나누는 편이 매번 클라이언트를 갈아끼우는 것보다 시간을 덜 씁니다. Clash를 내려받아 테스트 전용 간소 프로필로 위 규칙을 검증해 보세요.