Novita AI Partnerships

ForgeCode에서 Novita AI API 사용 방법: 설정 가이드

ForgeCode에서 Novita AI API 사용 방법: 설정 가이드

ForgeCode는 v2.2.2부터 Novita AI를 기본 제공 업체로 지원합니다. 즉, Kimi-K2.5, GLM-5, MiniMax-M2.5 같은 모델을 터미널에서 바로 사용할 수 있습니다. 추가 구성 레이어나 별도 앱이 필요 없습니다. 이 가이드는 일반적으로 몇 분이면 끝나는 설정 과정을 안내합니다.

ForgeCode란?

ForgeCode는 Zsh에 직접 통합되는 CLI 기반 코딩 하네스입니다. 에디터, 브라우저 기반 채팅, 터미널을 오가며 전환하는 대신 : 뒤에 프롬프트를 입력하면 ForgeCode가 나머지 모든 작업 — 코드 수정, 파일 생성, 디버깅 — 을 이미 사용 중인 셸 안에서 처리합니다.

작성 시점 기준으로 TermBench 2.0에서 81.8% 정확도로 1위를 기록했습니다. 리더보드 순위는 변동되므로 현재 순위를 확인하세요. ForgeCode는 세 가지 특화 에이전트로 구성된 멀티 에이전트 아키텍처를 사용합니다.

  • Forge — 직접 구현을 담당하는 기본 에이전트: 버그 수정, 코드 작성, 기능 생성
  • Muse — 코드베이스를 분석하고 실행 없이 솔루션을 제안하는 계획 에이전트
  • Sage — Forge와 Muse가 코드베이스를 더 깊이 이해해야 할 때 자동으로 호출하는 읽기 전용 리서치 에이전트

핵심 차별점은 ForgeCode가 수백 개의 LLM 공급 업체를 기본으로 지원한다는 점입니다. 세션 중간에 재시작하지 않고도 다른 공급 업체의 모델로 전환할 수 있으며, 대화 컨텍스트는 유지됩니다.

ForgeCode에서 Novita AI를 사용해야 하는 이유

ForgeCode는 이미 OpenAI와 Anthropic 같은 주요 공급 업체를 지원합니다. Novita AI를 추가할 가치가 있는 이유는 다음과 같습니다.

오픈소스 프런티어 모델 액세스. Novita AI는 대부분의 다른 공급 업체에서 찾아볼 수 없는 모델을 호스팅합니다 — Kimi-K2.5, GLM-5, MiniMax-M2.5 등이 여기에 포함됩니다. 이들은 경쟁력 있는 코딩 모델로, 동일한 ForgeCode 세션 안에서 실제 작업을 통해 독점 모델과 비교 테스트할 수 있습니다.

코딩 워크로드에 대한 저렴한 비용. Novita AI의 가격은 독점 모델 API보다 훨씬 낮습니다. 예를 들어 MiniMax-M2.5는 입력 토큰 100만 개당 $0.30에 불과하며, 이는 GPT-5.4 또는 Claude Sonnet 요금의 일부에 해당합니다. 코딩 에이전트를 매일 사용하는 개발자라면 이 차이가 크게 누적됩니다.

OpenAI 및 Anthropic 호환 API. Novita AI는 OpenAI 호환 및 Anthropic 호환 API 엔드포인트를 모두 제공합니다. ForgeCode는 공급 업체로부터 OpenAI 형식을 기대하며, Novita AI는 여기에 직접 부합합니다 — 어댑터 레이어도, 사용자 지정 구성도 없이 기본 URL과 API 키만 있으면 됩니다.

사용한 만큼 지불하는 결제 방식. 구독이 필요 없습니다. 실제 사용한 토큰에 대해서만 비용을 지불하므로, 부담 없이 여러 모델을 실험해 보기 쉽습니다.

사전 요구 사항

시작하기 전에 두 가지가 필요합니다.

1. ForgeCode 설치

ForgeCode를 설치하고 Zsh 플러그인을 구성하세요:

# Install ForgeCode
curl -fsSL https://forgecode.dev/install.sh | sh

# Verify installation
forge --help

# Set up the Zsh plugin
forge zsh setup

forge setup 실행 후 플러그인을 적용하려면 터미널을 재시작하세요. : 프롬프트 트리거가 작동하지 않는다면 이 문제가 가장 일반적인 원인입니다.

2. Novita AI API 키

  1. novita.ai에서 회원가입 또는 로그인
  2. API Keys 찾기
  3. Add New Key 클릭
  4. 키를 복사해 준비

api 키 생성 방법

필요한 것은 이것뿐입니다. 나머지는 ForgeCode 안에서 진행됩니다.

동일한 키는 ForgeCode뿐만 아니라 Novita AI API를 지원하는 모든 곳에서 사용할 수 있습니다. OpenAI 호환 클라이언트의 기본 URL은 https://api.novita.ai/openai/v1이며, 키는 계정 설정의 Key Management에서 관리합니다. 직접 API 사용에 대한 자세한 내용은 모델 API 참조를 확인하세요. 키를 소스 제어 또는 커밋된 .env 파일에 보관하지 마세요.

매일 코딩 에이전트를 실행한다면, Novita Coding Plan을 통해 종량제 대안으로 모델 라인업 전체에 걸친 유연한 월간 결제를 이용할 수 있습니다.

ForgeCode에 Novita AI 연결 방법

1단계: 로그인 플로우 실행

터미널을 열고 다음을 입력하세요:

:login

ForgeCode가 사용 가능한 공급 업체 목록을 표시합니다. 목록에서 Novita 를 선택하세요.

2단계: API 키 입력

메시지가 표시되면 Novita AI API 키를 붙여넣으세요. 키는 보안을 위해 터미널에서 마스킹됩니다. 요청 시 공급 업체 전환을 확인하세요.

3단계: 모델 선택

로그인 후 모델 선택기를 여세요:

:model

Novita 모델을 찾아보거나 검색하세요. 하나를 선택하고 Enter를 누르세요. ForgeCode는 세션 간 선택을 기억하며, :model로 언제든지 변경할 수 있습니다.

이것으로 전체 설정이 완료됩니다. 워크플로는 동일하게 유지되며, 뒤에서 작동하는 공급 업체만 변경됩니다.

ForgeCode에서 사용할 수 있는 Novita AI 모델

Novita AI를 통해 제공되는 모델 라인업은 다음과 같습니다. 아래 가격과 컨텍스트 윈도우는 2026-08-26 기준 Novita AI 모델 API로 확인한 것이며, 가격은 변동될 수 있으므로 예산을 세우기 전에 가격 페이지에서 현재 요금을 확인하세요.

모델 입력 (/M tokens) 출력 (/M tokens) 캐시 읽기
(/M tokens)
컨텍스트 최적 대상
Kimi-K2.5 $0.60 $3.00 $0.10 262K 일반 코딩, 추론, 도구 사용
GLM-5 $1.00 $3.20 $0.20 202K 에이전트 코딩, 구조화된 추론
MiniMax-M2.5 $0.30 $1.20 $0.03 204K 긴 컨텍스트 코딩 세션

최적 대상 열은 벤치마크 결과가 아닌 일반적인 적합성을 나타냅니다. 이 가이드는 비교 코딩 벤치마크를 게시하지 않으므로, 이를 시작 제안으로 간주하고 자신의 작업에서 테스트해 보세요.

ForgeCode에서 Novita AI를 사용하는 진짜 장점은 비교입니다. Kimi-K2.5, GLM-5, MiniMax-M2.5에서 동일한 리팩토링 작업을 실행하면 어떤 모델이 어떤 유형의 작업에 적합한지 빠르게 감을 잡을 수 있습니다. ForgeCode는 전환을 즉시 가능하게 합니다 — :model을 입력하고 다른 모델을 선택하면 컨텍스트가 유지됩니다.

결론

ForgeCode와 Novita AI를 함께 사용하면 경쟁력 있는 가격으로 다양한 오픈소스 코딩 모델에 터미널 네이티브 액세스가 가능합니다. 설정은 간단합니다. API 키를 얻고 :login을 실행한 뒤 모델을 선택하고 코딩을 시작하면 됩니다.

Novita AI 모델은 ForgeCode에서 바로 사용할 수 있습니다 — 설정 오버헤드 없이 사용한 만큼만 지불하면 됩니다. 지금 위 단계로 직접 사용해 보거나 Novita AI Playground에서 모델 옵션을 살펴보세요.

Novita AI는 개발자와 스타트업이 고성능, 안정성, 비용 효율성을 바탕으로 모델과 에이전틱 애플리케이션을 구축, 배포, 확장할 수 있도록 돕는 AI 및 에이전트 클라우드 플랫폼입니다.

자주 묻는 질문

ForgeCode란 무엇인가요?

ForgeCode는 Zsh와 통합되는 CLI 기반 코딩 하네스로, 터미널에서 직접 AI 프롬프트를 보낼 수 있습니다. 작성 시점 기준 TermBench 2.0에서 1위를 기록했으며 Novita AI를 포함한 여러 AI 공급 업체를 지원합니다.

Novita AI 연결 후 워크플로를 변경해야 하나요?

아니요. 설정은 :login 실행, Novita 선택, API 키 붙여넣기, 모델 선택이 전부입니다. 이후에는 ForgeCode를 동일한 방식으로 사용하면 됩니다 — 공급 업체만 변경되고 워크플로는 변경되지 않습니다.

ForgeCode에서 가장 먼저 시도해야 할 Novita AI 모델은 무엇인가요?

일반 코딩 작업에는 Kimi-K2.5를 먼저 사용해 보세요. 추론과 도구 사용을 잘 처리합니다. 비용에 민감한 워크로드는 MiniMax M2.5가 토큰 100만 개당 $0.30으로 강력한 성능을 제공합니다.

추천 문서

관련 게시글