사용자 지정 엔드포인트로 CodeBuddy Code에서 Claude 사용하기
환경 변수 세 개를 설정해 Tencent의 CodeBuddy Code CLI를 AI in IDE를 통해 Claude Opus 5.5, Sonnet 5.5, Haiku 4.5로 실행합니다.
2026-11-06에 @tencent-ai/codebuddy-code 2.180.0으로 테스트했습니다. 아래 설정으로 codebuddy -p가 claude-sonnet-5-5와 claude-haiku-4-5-20251001의 응답을 받았습니다.
빠른 설정
- CLI 설치.
npm install -g @tencent-ai/codebuddy-code를 실행한 뒤codebuddy --version으로 확인합니다. - API 키 만들기. API Keys를 열어 키를 만들고 AWSQ 또는 CCMAX 채널을 선택합니다.
- 환경 변수 설정.
~/.zshrc또는~/.bashrc에 다음을 추가하고 새 터미널을 엽니다.
1 export CODEBUDDY_BASE_URL="https://api.aiinide.com/v1"2 export CODEBUDDY_API_KEY="YOUR_DASHBOARD_API_KEY"3 export CODEBUDDY_MODEL="claude-sonnet-5-5"
Windows PowerShell에서는 setx CODEBUDDY_BASE_URL "https://api.aiinide.com/v1"을 실행하고 나머지 두 변수도 같은 방식으로 설정한 뒤 새 창을 엽니다.
- 확인.
codebuddy -p "Reply with exactly: OK"를 실행합니다. 응답은OK이고 요청은 Usage에 나타납니다.
베이스 URL은 /v1로 끝나야 합니다
CodeBuddy Code는 OpenAI Chat Completions 형식을 쓰고 /chat/completions를 붙입니다. https://api.aiinide.com/v1을 넣으면 AWSQ와 CCMAX 키를 받는 /v1/chat/completions를 호출합니다. 호스트 이름만 넣으면 Codex 채널 경로인 /chat/completions를 호출해 400 This endpoint requires a CODEX API key로 실패합니다.
CodeBuddy 문서에 따르면 비대화형 -p 모드에서는 항상 CODEBUDDY_API_KEY를 사용합니다. 대화형 세션의 요청이 AI in IDE 사용량에 나타나지 않으면 /model로 세션이 어떤 계정이나 모델을 골랐는지 확인하세요.
지원 모델
CODEBUDDY_MODEL | 채널 | 적합한 용도 |
|---|---|---|
claude-opus-5-5 | AWSQ, CCMAX | 어려운 리팩터링, 긴 에이전트 실행 |
claude-sonnet-5-5 | AWSQ, CCMAX | 일상 코딩 |
claude-haiku-4-5-20251001 | AWSQ, CCMAX | 빠른 수정, 저렴한 확인 |
CodeBuddy 문서에 따르면 CODEBUDDY_SMALL_FAST_MODEL과 CODEBUDDY_CODE_SUBAGENT_MODEL로 백그라운드 모델과 서브에이전트 모델을 설정합니다. claude-haiku-4-5-20251001을 쓰면 비용을 낮게 유지할 수 있습니다. 요율은 모델과 요금에 있습니다.
자주 묻는 질문
CodeBuddy Code에서 AI in IDE를 쓰려면 어떤 베이스 URL이 필요한가요?
https://api.aiinide.com/v1입니다. CodeBuddy가 /chat/completions를 붙이며, 호스트 이름만 쓰면 Codex 경로로 가서 400이 반환됩니다.
CodeBuddy IDE 플러그인에서도 동작하나요?
이 페이지는 CodeBuddy Code CLI만 다룹니다. IDE 플러그인의 모델 설정은 테스트하지 않았습니다.
이 엔드포인트에서 Claude 전용 도구 기능이 동작하나요?
OpenAI 호환 엔드포인트에서는 텍스트, 스트리밍, 클라이언트 함수 도구가 동작합니다. Fast mode나 호스팅 도구 같은 Claude 확장 기능은 지원하지 않으므로, 이런 기능이 필요하면 Claude Code를 쓰세요.