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를 사용하므로 OpenAI 호환 엔드포인트가 아닌 Anthropic 호환 엔드포인트가 필요합니다. Novita AI는 https://api.novita.ai/anthropic에서 정확히 그 엔드포인트를 제공하여, 래퍼 라이브러리나 추가 도구 없이 Kimi K2.7 Code를 Claude Code에 바로 사용할 수 있게 합니다. OpenAI 호환 API 설정은 Kimi K2.7 Code API 빠른 시작을 참조하세요.
실용적인 측면은 세 가지로 요약됩니다.
비용. 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 |
| 아키텍처 | Mixture of Experts (MoE) |
| 총 파라미터 | 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 ~/.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 클라우드 플랫폼입니다.
