CoBuddy는 Baidu가 개발한 코딩 특화 모델로, Novita AI에서 제공되며 함수 호출, 추론, 128K 컨텍스트 창, 개발자 워크플로를 위한 낮은 종단 간 지연 시간을 제공합니다. CoBuddy는 OpenAI 호환 chat/completions 엔드포인트를 노출하고 Anthropic 호환 엔드포인트는 제공하지 않기 때문에, 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는 입력 $2.80, 출력 $11.30 — 대량 사용 시 의미 있는 비용 절감 효과가 있으며, 캐시 읽기는 $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에서 터미널 세션 간에 이러한 설정을 유지하려면 ~/.zshrc 또는 ~/.bashrc에 export 줄을 추가하세요.
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의 캐시 읽기 가격은 경쟁력이 있습니다.
실제 작업으로 평가 후 결정
팀에 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 클라우드를 제공합니다.
