CoBuddy는 Novita AI에서 제공하는 Baidu의 코딩 특화 모델로, 함수 호출, 추론, 128K 컨텍스트 윈도우, 그리고 개발자 워크플로에 적합한 낮은 종단간 지연 시간을 제공합니다. CoBuddy는 Anthropic 호환 엔드포인트 대신 OpenAI 호환 chat/completions 엔드포인트를 제공하기 때문에 Claude Code에서 설정하려면 ANTHROPIC_BASE_URL을 Novita AI의 OpenAI 호환 경로로 지정해야 합니다. 이 가이드는 API 키부터 첫 번째 세션까지 모든 단계를 안내합니다.
CoBuddy란?
CoBuddy는 Baidu가 개발하고 Novita AI의 LLM API를 통해 제공되는 코드 생성 모델입니다. 소프트웨어 개발 작업, 즉 코드 생성, 리팩터링, 테스트 작성, 구현 계획 및 에이전트 워크플로 지원에 특화되어 설계되었습니다.
| 사양 | 세부 내용 |
|---|---|
| 모델 ID | baidu/cobuddy |
| 컨텍스트 윈도우 | 131,072 토큰 (128K) |
| 최대 출력 | 65,536 토큰 |
| 입력 가격 | 100만 토큰당 $2.80 |
| 출력 가격 | 100만 토큰당 $11.30 |
| 캐시 읽기 | 100만 토큰당 $0.70 |
| 기능 | 함수 호출, 추론 |
| 엔드포인트 | OpenAI 호환 chat/completions만 지원 |
엔드포인트의 차이는 Claude Code 설정에 중요합니다. CoBuddy는 Anthropic 호환 엔드포인트를 지원하지 않으므로, 구성 시 anthropic 경로 대신 Novita AI의 OpenAI 호환 기본 URL(https://api.novita.ai/v3/openai)을 사용해야 합니다.
Claude Code에서 CoBuddy를 사용하는 이유는?
Claude Code는 일반 언어로 코딩 작업(파일 편집, 터미널 명령, 코드베이스 분석, 다단계 워크플로)을 위임할 수 있는 에이전트 CLI입니다. 기본적으로 Claude 모델에서 실행되지만, ANTHROPIC_BASE_URL 환경 변수를 통해 다른 제공자와 모델로 요청을 라우팅할 수 있습니다.
Novita AI를 통해 CoBuddy로 전환하면 다음과 같은 이점이 있습니다:
- 코딩 특화. CoBuddy는 일반 대화보다 소프트웨어 작업에 맞춰 구축되었습니다. 코드 생성, 리뷰 및 에이전트 워크플로를 직접 대상으로 합니다.
- Claude Sonnet 대비 비용 차이. Claude Sonnet 4.5는 입력 100만 토큰당 $3.00, 출력 100만 토큰당 $15.00입니다. Novita AI의 CoBuddy는 입력 100만 토큰당 $2.80, 출력 100만 토큰당 $11.30으로, 대량 사용 시 의미 있는 비용 절감 효과가 있으며 캐시 읽기는 100만 토큰당 $0.70입니다.
- 높은 처리량과 낮은 종단간 지연 시간. Novita AI의 CoBuddy 배포는 지속적인 처리량에 최적화되어 있어, 많은 증분 요청을 수행하는 긴 에이전트 세션에서 중요합니다.
- 128K 컨텍스트 윈도우. 단일 프롬프트에 상당한 파일 발췌, 테스트 출력 및 구현 노트를 전달할 수 있는 충분한 공간을 제공합니다.
이미 Claude Code를 사용하고 있으며 워크플로 도구를 변경하지 않고 코딩 우선 대안을 평가하려는 팀에게 CoBuddy는 실용적인 출발점입니다.
1단계: Novita AI API 키 발급
Novita AI 계정을 생성하면 새 계정에 무료 평가판 크레딧이 제공됩니다. 로그인 후 키 관리로 이동하여 새 키 생성 을 클릭합니다. 키는 한 번만 표시되므로 즉시 복사하세요.
2단계: Claude Code 설치
Claude Code는 Node.js 18 이상이 필요합니다. 버전을 확인하세요:
node --version
Node.js가 없거나 v18 미만인 경우 nodejs.org에서 설치하세요.
Claude Code를 전역으로 설치합니다:
npm install -g @anthropic-ai/claude-code
설치 확인:
claude --version
3단계: 환경 변수 구성
CoBuddy는 OpenAI 호환 엔드포인트만 지원합니다. ANTHROPIC_BASE_URL을 Novita AI의 OpenAI 호환 경로로 설정하여 Claude Code가 요청을 해당 경로로 전달하도록 합니다.
macOS 및 Linux
export ANTHROPIC_BASE_URL="https://api.novita.ai/v3/openai"
export ANTHROPIC_AUTH_TOKEN="<Your Novita API Key>"
export ANTHROPIC_MODEL="baidu/cobuddy"
export ANTHROPIC_SMALL_FAST_MODEL="baidu/cobuddy"
Windows (명령 프롬프트)
set ANTHROPIC_BASE_URL=https://api.novita.ai/v3/openai
set ANTHROPIC_AUTH_TOKEN=<Your Novita API Key>
set ANTHROPIC_MODEL=baidu/cobuddy
set ANTHROPIC_SMALL_FAST_MODEL=baidu/cobuddy
Windows (PowerShell)
$env:ANTHROPIC_BASE_URL = "https://api.novita.ai/v3/openai"
$env:ANTHROPIC_AUTH_TOKEN = "<Your Novita API Key>"
$env:ANTHROPIC_MODEL = "baidu/cobuddy"
$env:ANTHROPIC_SMALL_FAST_MODEL = "baidu/cobuddy"
각 변수의 역할:
ANTHROPIC_BASE_URL— Claude Code의 요청을 Anthropic 서버 대신 Novita AI의 OpenAI 호환 엔드포인트로 리디렉션합니다.ANTHROPIC_AUTH_TOKEN— 인증에 사용되는 Novita AI API 키입니다.ANTHROPIC_MODEL— 주요(복잡한) 작업에 사용되는 모델입니다.ANTHROPIC_SMALL_FAST_MODEL— 백그라운드 및 간단한 작업에 사용되는 모델입니다.
macOS/Linux에서 터미널 세션 간에 이러한 설정을 유지하려면 export 줄을 ~/.zshrc 또는 ~/.bashrc에 추가하세요.
4단계: Claude Code 시작
프로젝트 디렉터리로 이동하여 Claude Code를 실행합니다:
cd /path/to/your/project
claude .
.는 Claude Code가 현재 디렉터리에서 작동하도록 지시합니다. 일반 영어로 작업을 설명할 수 있는 대화형 프롬프트가 표시됩니다.
/model을 실행하여 활성화된 모델을 확인하거나 /doctor를 실행하여 구성 문제를 진단합니다.
CoBuddy 사양 및 가격
다음은 Novita AI의 CoBuddy와 Claude Sonnet 4.5의 전체 비교입니다:
| CoBuddy (Novita AI) | Claude Sonnet 4.5 | |
|---|---|---|
| 입력 (100만 토큰당) | $2.80 | $3.00 |
| 출력 (100만 토큰당) | $11.30 | $15.00 |
| 캐시 읽기 (100만 토큰당) | $0.70 | $0.30 |
| 컨텍스트 윈도우 | 131,072 토큰 | 200,000 토큰 |
| 최대 출력 | 65,536 토큰 | 64,000 토큰 |
| 함수 호출 | 예 | 예 |
| 추론 | 예 | 예 |
| Anthropic 엔드포인트 | 아니요 | 네이티브 |
주요 트레이드오프: CoBuddy의 출력 토큰 가격은 Sonnet 4.5보다 낮고, 컨텍스트를 재사용하는 에이전트 세션의 경우 캐시 읽기가 절대적으로 더 저렴합니다. Claude Sonnet 4.5는 더 큰 컨텍스트 윈도우를 가지며 Claude Code의 네이티브 모델입니다. 코딩에 특화된 모델을 원하고 출력 비용을 줄이고 싶다면 CoBuddy를 선택하고, 200K 컨텍스트 또는 더 넓은 추론 작업이 필요하다면 Sonnet을 계속 사용하세요.
실용적인 코딩 워크플로 팁
프롬프트는 작업별로 구체적으로 작성
CoBuddy는 소프트웨어 작업에 맞춰 조정되었습니다. 구체적인 엔지니어링 결과를 설명하는 프롬프트(예: “이 함수에 입력 유효성 검사 추가”, “체크아웃 흐름에 대한 단위 테스트 작성”, “순환 의존성을 제거하도록 이 모듈 리팩터링”)가 개방형 탐색 프롬프트보다 더 나은 결과를 제공합니다.
128K 컨텍스트 윈도우를 의도적으로 활용
128K 토큰에서 관련 파일 발췌, 테스트 출력, 스타일 가이드 및 API 계약을 단일 요청에 전달할 수 있습니다. 하지만 프롬프트를 구조화하세요: 작업 설명, 선택적 컨텍스트 제공, 제약 조건 나열, 제한된 출력 요청. 긴 컨텍스트가 명확한 지침을 대체하지는 않습니다.
함수 호출 출력 확인
CoBuddy는 함수 호출을 지원하며, Claude Code는 이를 도구 호출에 사용합니다. 파일을 수정하거나 명령을 실행하는 작업의 경우 승인 전에 계획된 작업을 검토하세요. Claude Code에서 /review를 사용하여 변경 사항이 적용되기 전에 검사합니다.
캐시가 많은 세션은 CoBuddy의 가격 이점 활용
캐시 읽기 토큰당 $0.70의 가격으로, 대규모 시스템 프롬프트나 반복적인 컨텍스트가 있는 세션은 시간이 지남에 따라 비용이 크게 절감됩니다. 동일한 코드베이스 컨텍스트를 반복적으로 참조하는 긴 에이전트 세션을 실행하는 경우 캐시 읽기가 누적되며, CoBuddy의 캐시 읽기 가격은 경쟁력이 있습니다.
실제 작업으로 평가 후 결정
팀에 CoBuddy를 평가하는 가장 좋은 방법은 실제 백로그(버그 티켓, 테스트 생성 작업, 소규모 리팩터링)에서 실행해 보는 것입니다. 일반적인 벤치마크에 의존하지 말고 특정 작업에서 현재 모델과 출력 품질을 비교하세요.
FAQ
Novita AI에서 CoBuddy의 모델 ID는 무엇인가요?
ANTHROPIC_MODEL 환경 변수와 모든 직접 API 요청 본문에 baidu/cobuddy를 사용하세요.
anthropic 엔드포인트 대신 https://api.novita.ai/v3/openai를 사용하는 이유는?
CoBuddy는 OpenAI 호환 chat/completions 엔드포인트만 지원합니다. ANTHROPIC_BASE_URL을 Novita AI의 OpenAI 호환 경로(https://api.novita.ai/v3/openai)로 설정하면 Claude Code가 해당 엔드포인트로 요청을 라우팅합니다. anthropic 호환 경로(https://api.novita.ai/anthropic)는 Anthropic 메시지 API를 네이티브로 구현하는 모델용이며, CoBuddy는 그렇지 않습니다.
Novita AI에서 CoBuddy의 비용은 얼마인가요?
2026년 6월 기준: 입력 100만 토큰당 $2.80, 출력 100만 토큰당 $11.30, 캐시 읽기 100만 토큰당 $0.70입니다. 프로덕션 계획 전에 CoBuddy 모델 페이지에서 최신 가격을 확인하세요.
CoBuddy는 함수 호출을 지원하나요?
예. CoBuddy는 함수 호출과 추론을 지원하며, 둘 다 Claude Code의 에이전트 루프에 필요합니다.
Cursor 또는 다른 도구에서 CoBuddy를 사용할 수 있나요?
예. 사용자 정의 OpenAI 호환 기본 URL을 허용하는 모든 도구는 Novita AI를 통해 CoBuddy를 사용할 수 있습니다. 기본 URL을 https://api.novita.ai/v3/openai로 설정하고 모델을 baidu/cobuddy로 설정하세요.
Novita AI는 개발자가 간단한 API를 사용하여 AI 모델을 쉽게 배포할 수 있도록 지원하는 AI 클라우드 플랫폼이며, 확장 및 구축을 위한 저렴하고 안정적인 GPU 클라우드를 제공합니다.
