> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.
# CodeBuddy
> CodeBuddy에서 AIHubMix를 설정하고 AIHubMix가 지원하는 모든 모델을 사용합니다.
CodeBuddy는 OpenAI 호환 사용자 지정 모델을 지원합니다. AIHubMix를 추가하면 CodeBuddy에서 GPT, Claude, Gemini, DeepSeek, GLM 등 AIHubMix 모델을 사용할 수 있습니다.
## 준비
* [CodeBuddy](https://www.codebuddy.cn/)를 설치하고 실행합니다.
* [AIHubMix 콘솔](https://aihubmix.com/token)에서 API Key를 만듭니다. 일반적으로 형식은 `sk-***`입니다.
* AIHubMix 모델 목록에서 사용할 모델 ID를 복사합니다. 예: `gpt-5.5`, `gemini-3.5-flash`, `deepseek-chat`.
## 화면에서 AIHubMix 모델 설정하기
CodeBuddy 입력창 아래의 현재 모델 이름(예: **Default**)을 클릭합니다.
목록 맨 아래에서 **Configure custom models**를 선택하고 **Add Model**을 클릭한 뒤, **Provider**에서 **Custom**을 선택합니다.
* **Endpoint**: `https://aihubmix.com/v1`을 입력합니다. 기본 주소를 일시적으로 사용할 수 없으면 `https://api.inferera.com/v1`을 사용합니다.
* **API Key**: [AIHubMix 콘솔](https://aihubmix.com/token)에서 만든 Key를 입력합니다.
* **Model Name**: 모델 ID를 입력합니다. 예: `gpt-5.5`.
* **Advanced Settings**: 모델이 지원하는 기능에 한해 **Tool Calling**, **Image Input**, **Reasoning**을 켭니다.
**Save**를 클릭한 다음 **Custom Models**에서 저장한 모델을 선택합니다.
## 설정 파일로 모델 추가하기
다음 로컬 파일을 직접 편집할 수 있습니다.
```text theme={null}
%USERPROFILE%\.codebuddy\models.json
```
프로젝트별 설정 위치는 `프로젝트 디렉터리\.codebuddy\models.json`이며, 이 설정의 우선순위가 더 높습니다. `models.json`에는 전체 Chat Completions URL을 사용합니다.
```json theme={null}
{"models":[{"id":"gpt-5.5","name":"gpt-5.5","vendor":"AIHubMix","url":"https://aihubmix.com/v1/chat/completions","apiKey":"sk-***","maxInputTokens":128000,"maxOutputTokens":8192,"supportsToolCall":true,"supportsImages":true,"supportsReasoning":true}],"availableModels":["gpt-5.5"]}
```
기본 주소를 사용할 수 없을 때는 다음 주소를 사용합니다.
```json theme={null}
"url": "https://api.inferera.com/v1/chat/completions"
```
화면에서는 `/v1`까지만 입력하면 되지만, `models.json`에는 `/chat/completions`가 필요합니다. 저장 후 CodeBuddy를 재시작하거나 모델 선택기를 다시 엽니다. Key를 평문으로 저장하지 않으려면 다음과 같이 설정합니다.
```json theme={null}
"apiKey": "${AIHUBMIX_API_KEY}"
```
## CodeBuddy CLI
명령줄 버전의 이름은 **CodeBuddy Code**입니다. npm으로 설치한 뒤 `codebuddy` 명령으로 실행합니다.
```shell theme={null}
npm install -g @tencent-ai/codebuddy-code
```
AIHubMix의 Anthropic 호환 인터페이스는 `CODEBUDDY_BASE_URL`에 루트 URL을 사용합니다.
```powershell theme={null}
$env:CODEBUDDY_API_KEY="sk-***"
$env:CODEBUDDY_BASE_URL="https://aihubmix.com"
$env:CODEBUDDY_MODEL="glm-4.7"
codebuddy
```
고정 설정은 `%USERPROFILE%\.codebuddy\settings.json`에 추가합니다.
```json theme={null}
{"env":{"CODEBUDDY_API_KEY":"sk-***","CODEBUDDY_BASE_URL":"https://aihubmix.com","CODEBUDDY_MODEL":"glm-4.7"}}
```
CLI는 Anthropic 호환 프로토콜을 사용하고 데스크톱 사용자 지정 모델은 OpenAI 호환 엔드포인트를 사용합니다. 404 오류가 나면 `CODEBUDDY_BASE_URL`에 `/v1/chat/completions` 같은 OpenAI 경로를 넣지 않았는지 확인하세요.
## 동작 확인
사용자 지정 모델을 선택한 뒤 짧은 메시지를 보냅니다. 정상 응답이 오면 설정이 완료된 것입니다.
지원 모델에서는 이미지를 업로드하여 이미지 입력도 확인할 수 있습니다.
## 자주 묻는 질문
**저장 후 모델을 사용할 수 없습니다.**
Endpoint에 `/v1`이 포함되어 있는지, API Key가 완전한지, 모델명이 AIHubMix 모델 ID와 일치하는지 확인하세요. `models.json`의 URL에는 `/chat/completions`도 필요합니다.
**CLI와 데스크톱 앱은 같은 설정을 사용하나요?**
완전히 같지는 않습니다. 데스크톱 앱은 `models.json`을 사용하고, CLI는 환경 변수 또는 `settings.json`의 `env`를 읽습니다.
업데이트 날짜: 2026-07-10