Kimi K2.7 Code는 MoonshotAI의 코딩 특화 MoE 모델로, 256K 컨텍스트 윈도우, 인터리브 사고, 다단계 도구 호출 기능을 갖추고 있습니다. Novita AI의 Anthropic 호환 엔드포인트를 통해 Claude Code에 직접 연결할 수 있어 기존 워크플로를 유지하면서도 Claude Sonnet보다 훨씬 저렴한 가격에 에이전틱 코딩에 특화된 모델로 전환할 수 있습니다.
이 가이드에서는 API 키 발급, 환경 변수 설정, 그리고 moonshotai/kimi-k2.7-code를 모델로 사용하여 Claude Code를 시작하는 모든 단계를 안내합니다.
Claude Code에서 Kimi K2.7 Code를 사용해야 하는 이유
Claude Code는 내부적으로 Anthropic SDK를 사용하므로 Anthropic 호환 엔드포인트가 필요합니다(OpenAI 호환 엔드포인트가 아님). Novita AI는 https://api.novita.ai/anthropic에서 정확히 이 기능을 제공하므로, 래퍼 라이브러리나 추가 도구 없이 Kimi K2.7 Code를 Claude Code에 바로 적용할 수 있습니다.
실용적인 측면은 세 가지로 요약됩니다.
비용. Novita AI에서 입력 토큰 100만 개당 $0.95, 출력 토큰 100만 개당 $4.00(2026년 6월 기준 확인)으로, Kimi K2.7 Code는 Claude Sonnet 4.5(토큰 100만 개당 $3.00/$15.00)보다 입력은 약 68%, 출력은 약 73% 저렴합니다. 하루에 수백 개의 코딩 작업을 처리하는 팀에게 이 차이는 실질적입니다.
컨텍스트. 256K 토큰 컨텍스트 윈도우 덕분에 여러 파일, 테스트 출력, 아키텍처 노트 등 상당한 저장소 컨텍스트를 세션 중간에 제한 없이 전송할 수 있습니다. 대부분의 일상적인 코딩 에이전트는 32K~64K 토큰 내에서 잘 작동하며, 256K가 있으면 컨텍스트를 자르는 경우가 거의 없습니다.
코딩 특화. Kimi K2.7 Code는 범용 모델이 아니라 코딩 및 에이전틱 워크플로에 특화되어 제작되었습니다. 인터리브 사고 아키텍처는 Kimi K2.6보다 약 30% 적은 사고 토큰을 생성하므로, 다단계 코딩 작업에서 더 빠른 응답을 제공합니다.
Kimi K2.7 Code 사양 한눈에 보기
| 항목 | 값 |
|---|---|
| 모델 ID | moonshotai/kimi-k2.7-code |
| 아키텍처 | MoE(Mixture of Experts) |
| 총 파라미터 | 1T |
| 활성화 파라미터 | 토큰당 32B |
| 컨텍스트 윈도우 | 262,144 토큰(~256K) |
| 최대 출력 토큰 | 262,144 토큰 |
| 입력 모달리티 | 텍스트, 이미지, 비디오 |
| 출력 모달리티 | 텍스트 |
| 특징 | 함수 호출, 구조화된 출력, 추론(인터리브 사고) |
| Novita AI 엔드포인트 | chat/completions, anthropic |
Claude Code의 경우 anthropic 엔드포인트 제품군을 사용하세요. 이것이 Anthropic SDK가 기대하는 방식입니다.
Novita AI에서 Kimi K2.7 Code 비용은 얼마인가요?
| 토큰 유형 | Novita AI 가격 | Claude Sonnet 4.5 가격 |
|---|---|---|
| 입력 | $0.95 / 1M | $3.00 / 1M |
| 캐시 읽기 입력 | $0.19 / 1M | — |
| 출력 | $4.00 / 1M | $15.00 / 1M |
가격은 2026년 6월 기준 Novita AI의 Kimi K2.7 Code 모델 페이지를 기반으로 합니다. Novita AI는 캐시 읽기 가격도 제공하며, 이는 동일한 시스템 프롬프트와 도구 스키마를 여러 번 호출에 재사용하는 에이전트와 같은 반복 컨텍스트 워크플로에 중요합니다.
1단계: Novita AI API 키 받기
Novita AI 계정에 가입하면 새 계정에 무료 평가판 크레딧이 제공됩니다.
로그인 후:
- 대시보드에서 키 관리로 이동합니다.
- 새 키 만들기 를 클릭합니다.
- 키를 즉시 복사하여 안전한 곳에 보관하세요. 한 번만 표시됩니다.
이 키를 다음 단계에서 ANTHROPIC_AUTH_TOKEN으로 사용합니다.
2단계: Claude Code 설치
Claude Code는 Node.js 18 이상이 필요합니다. 먼저 버전을 확인하세요.
node --version
Claude Code를 전역에 설치합니다.
npm install -g @anthropic-ai/claude-code
설치를 확인합니다.
claude --version
3단계: 환경 변수 설정
Claude Code는 사용할 엔드포인트, API 키 및 모델을 알기 위해 네 가지 환경 변수를 읽습니다. 네 가지를 모두 설정하세요. ANTHROPIC_SMALL_FAST_MODEL은 요약이나 빠른 편집과 같은 가벼운 하위 작업에 Claude Code가 사용하는 모델을 제어합니다.
Mac 및 Linux
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="YOUR_NOVITA_API_KEY"
export ANTHROPIC_MODEL="moonshotai/kimi-k2.7-code"
export ANTHROPIC_SMALL_FAST_MODEL="moonshotai/kimi-k2.7-code"
영구적으로 설정하려면 네 줄을 ~/.zshrc 또는 ~/.bashrc에 추가한 다음 source ~/.zshrc(또는 ~/.bashrc)를 실행하세요.
Windows (명령 프롬프트)
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=YOUR_NOVITA_API_KEY
set ANTHROPIC_MODEL=moonshotai/kimi-k2.7-code
set ANTHROPIC_SMALL_FAST_MODEL=moonshotai/kimi-k2.7-code
이 환경 변수는 현재 세션 동안만 지속됩니다. Windows에서 영구적으로 설정하려면 시스템 속성 → 환경 변수 를 통해 추가하세요.
각 변수의 역할
| 변수 | 값 | 목적 |
|---|---|---|
ANTHROPIC_BASE_URL |
https://api.novita.ai/anthropic |
Claude Code를 Novita AI의 Anthropic 호환 엔드포인트로 지정 |
ANTHROPIC_AUTH_TOKEN |
사용자의 Novita API 키 | 요청 인증 |
ANTHROPIC_MODEL |
moonshotai/kimi-k2.7-code |
코딩 작업의 기본 모델 설정 |
ANTHROPIC_SMALL_FAST_MODEL |
moonshotai/kimi-k2.7-code |
가벼운 하위 작업의 모델 설정 |
4단계: Claude Code 실행
프로젝트 디렉토리로 이동하여 세션을 시작합니다.
cd your-project-directory
claude .
Claude Code가 대화형 프롬프트를 엽니다. 이제 일반 영어로 작업을 설명할 수 있습니다. 기능 구현, 버그 수정, 모듈 리팩토링, 테스트 작성 등 Kimi K2.7 Code가 Novita AI 엔드포인트를 통해 추론과 코드 생성을 처리합니다.
모델 라우팅이 올바르게 되었는지 확인하려면 Claude Code 세션 내에서 /status를 실행하세요. 설정된 기본 URL과 모델이 표시되어야 합니다.
실용적인 코딩 워크플로 팁
더 많은 컨텍스트를 미리 보내세요. 256K 토큰을 사용할 수 있으므로 발췌문 대신 관련 파일의 전체 내용을 포함할 수 있습니다. Claude Code는 요약이 아닌 실제 코드를 참조할 수 있으므로 구현 세부 사항에 대한 환각이 줄어듭니다.
복잡한 작업에는 인터리브 사고를 사용하세요. Kimi K2.7 Code는 코드를 생성하기 전에 단계별로 추론합니다. 여러 파일에 걸친 리팩토링이나 아키텍처 결정의 경우 모델이 전체 그림을 볼 수 있도록 충분한 컨텍스트를 제공하세요. 작성하기 전에 계획을 세우므로 후속 수정이 줄어듭니다.
멀티모달 디버깅. Kimi K2.7 Code는 이미지와 비디오를 입력으로 받습니다. 워크플로에 스크린샷 기반 버그 보고서나 UI 검토 작업이 포함된 경우 이를 세션에 직접 전달할 수 있습니다. 응답은 항상 텍스트이므로 출력은 코드, 계획 또는 분석입니다.
캐시 집약적 시스템 프롬프트. 여러 세션에 걸쳐 일관된 시스템 프롬프트(코딩 표준, 프로젝트 규칙, 아키텍처 노트)를 사용하는 경우 Novita AI의 캐시 읽기 가격(토큰 100만 개당 $0.19)이 반복 콘텐츠에 적용됩니다. 길고 안정적인 시스템 프롬프트를 사용하는 팀의 경우 작업당 비용이 크게 절감됩니다.
일관성을 위해 하나의 모델을 유지하세요. ANTHROPIC_MODEL과 ANTHROPIC_SMALL_FAST_MODEL을 모두 moonshotai/kimi-k2.7-code로 설정하면 기본 작업과 하위 작업 전반에서 일관된 동작을 유지할 수 있습니다. 나중에 비용 절감을 위해 하위 작업에 더 가벼운 모델을 사용하려면 ANTHROPIC_SMALL_FAST_MODEL만 변경하면 됩니다.
문제 해결
401 Unauthorized
API 키가 잘못되었거나 만료되었습니다. Novita AI 키 관리에서 키를 확인하세요. 키를 복사할 때 공백이나 줄바꿈이 추가되었는지 확인하세요.
모델을 찾을 수 없음 / 404
모델 ID가 정확히 moonshotai/kimi-k2.7-code인지 확인하세요. 공백 없이, 대소문자가 정확해야 합니다. Kimi K2.7 Code 모델 페이지에서 확인할 수 있습니다.
긴 프롬프트에서 응답이 느림
Claude Code에서 기본적으로 스트리밍을 활성화하세요. 대부분의 구성이 자동으로 이 작업을 수행합니다. 매우 긴 컨텍스트 입력(100K+ 토큰)의 경우 초기 응답 지연 시간이 증가합니다. 우선순위가 낮은 컨텍스트를 먼저 잘라내는 것을 고려하세요.
환경 변수가 적용되지 않음
Mac/Linux에서 프로필 파일을 편집한 후 source를 실행했는지 확인하세요(source ~/.zshrc). Windows에서 set으로 설정된 환경 변수는 현재 명령 프롬프트 세션에서만 지속됩니다. 영구 변수를 사용하려면 시스템 속성 패널을 사용하세요.
FAQ
Kimi K2.7 Code가 Claude Code의 도구 사용 및 MCP 통합과 호환되나요?
네. Kimi K2.7 Code는 Novita AI의 Anthropic 호환 엔드포인트를 통해 함수 호출을 지원하며, Claude Code는 도구 호출 및 MCP 통합에 이를 사용합니다.
OpenAI 호환 대신 Anthropic 엔드포인트를 사용하는 이유는 무엇인가요?
Claude Code는 Anthropic SDK를 기반으로 구축되었습니다. OpenAI가 아닌 Anthropic의 메시지 형식을 사용하여 통신합니다. Novita AI의 https://api.novita.ai/anthropic 엔드포인트가 이 형식을 변환하므로 Claude Code가 수정 없이 작동합니다.
Claude Code에서 Kimi K2.7 Code와 Kimi K2.5는 어떻게 비교되나요?
Kimi K2.7 Code는 K2.6보다 약 30% 적은 사고 토큰을 생성하며(K2.5의 효율성보다 개선됨), 코딩 품질은 유지합니다. 반복적인 다단계 작업이 있는 Claude Code 세션에서 사고 토큰이 적다는 것은 작업당 더 빠른 응답과 더 낮은 토큰 비용을 의미합니다.
이 설정을 VS Code나 Cursor에서 사용할 수 있나요?
네. Claude Code는 플러그인과 터미널을 통해 VS Code 및 Cursor와 통합됩니다. 동일한 환경 변수 구성이 적용됩니다. 설정이 완료되면 IDE 통합과 독립형 터미널 모두 구성된 모델을 사용합니다.
Novita AI는 개발자가 간단한 API를 통해 최첨단 모델에 쉽게 접근할 수 있도록 하고, 합리적인 가격과 안정적인 GPU 인프라를 제공하는 AI 클라우드 플랫폼입니다.
