> ## 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
> Configure o AIHubMix no CodeBuddy e use qualquer modelo suportado pelo AIHubMix.
O CodeBuddy oferece suporte a modelos personalizados compativeis com OpenAI. Depois de adicionar o AIHubMix, voce pode usar modelos GPT, Claude, Gemini, DeepSeek, GLM e outros modelos do AIHubMix.
## Preparacao
* Instale e abra o [CodeBuddy](https://www.codebuddy.cn/).
* Crie uma API Key no [console do AIHubMix](https://aihubmix.com/token). O formato geralmente e `sk-***`.
* Copie o ID do modelo desejado na lista de modelos do AIHubMix, por exemplo `gpt-5.5`, `gemini-3.5-flash` ou `deepseek-chat`.
## Configurar o AIHubMix na interface
No CodeBuddy, clique no nome do modelo atual abaixo da caixa de entrada, por exemplo **Default**.
Role ate o final da lista, selecione **Configure custom models**, clique em **Add Model** e escolha **Custom** em **Provider**.
* **Endpoint**: `https://aihubmix.com/v1`. Se o endereco principal estiver indisponivel, use `https://api.inferera.com/v1`.
* **API Key**: a chave criada no [console do AIHubMix](https://aihubmix.com/token).
* **Model Name**: o ID do modelo, por exemplo `gpt-5.5`.
* **Advanced Settings**: ative **Tool Calling**, **Image Input** ou **Reasoning** somente quando o modelo oferecer suporte.
Clique em **Save** e selecione o modelo salvo em **Custom Models**.
## Adicionar um modelo por arquivo de configuracao
Edite o arquivo local:
```text theme={null}
%USERPROFILE%\.codebuddy\models.json
```
Para um projeto especifico, use `seu-diretorio-do-projeto\.codebuddy\models.json`; essa configuracao tem prioridade. Em `models.json`, use a URL completa de Chat Completions:
```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"]}
```
Para o endereco de reserva:
```json theme={null}
"url": "https://api.inferera.com/v1/chat/completions"
```
Na interface basta usar `/v1`; `models.json` exige `/chat/completions`. Reinicie o CodeBuddy ou abra novamente o seletor. Para nao salvar a chave em texto simples:
```json theme={null}
"apiKey": "${AIHUBMIX_API_KEY}"
```
## CodeBuddy CLI
A versao de linha de comando chama-se **CodeBuddy Code**. Instale com npm e execute `codebuddy` para iniciar:
```shell theme={null}
npm install -g @tencent-ai/codebuddy-code
```
A interface AIHubMix compativel com Anthropic usa a URL raiz em `CODEBUDDY_BASE_URL`:
```powershell theme={null}
$env:CODEBUDDY_API_KEY="sk-***"
$env:CODEBUDDY_BASE_URL="https://aihubmix.com"
$env:CODEBUDDY_MODEL="glm-4.7"
codebuddy
```
Para manter as configuracoes, adicione-as em `%USERPROFILE%\.codebuddy\settings.json`:
```json theme={null}
{"env":{"CODEBUDDY_API_KEY":"sk-***","CODEBUDDY_BASE_URL":"https://aihubmix.com","CODEBUDDY_MODEL":"glm-4.7"}}
```
A CLI usa o protocolo compativel com Anthropic; os modelos personalizados do aplicativo usam o endpoint compativel com OpenAI. Em caso de erro 404, confira se `CODEBUDDY_BASE_URL` nao contem caminhos OpenAI como `/v1/chat/completions`.
## Verificar a configuracao
Selecione o modelo e envie uma mensagem curta. Uma resposta confirma a configuracao.
Com um modelo compativel, envie uma imagem para testar a entrada de imagem.
## Perguntas frequentes
**O modelo nao fica disponivel apos salvar.**
Confira se o endpoint contem `/v1`, se a API Key esta completa e se o nome e o ID do modelo AIHubMix. Em `models.json`, a URL tambem deve conter `/chat/completions`.
**CLI e aplicativo usam as mesmas configuracoes?**
Nao. O aplicativo usa `models.json`; a CLI le variaveis de ambiente ou o objeto `env` de `settings.json`.
Ultima atualizacao: 2026-07-10