AiHubMix Documentation Hub

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.
Crie uma API Key no console do AIHubMix. 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.

Abrir configuracao de modelos personalizados

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.
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:

%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:

{"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:

"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:

"apiKey": "${AIHUBMIX_API_KEY}"

CodeBuddy CLI

A versao de linha de comando chama-se CodeBuddy Code. Instale com npm e execute codebuddy para iniciar:

npm install -g @tencent-ai/codebuddy-code

A interface AIHubMix compativel com Anthropic usa a URL raiz em CODEBUDDY_BASE_URL:

$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:

{"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

​Preparacao

​Configurar o AIHubMix na interface

​Adicionar um modelo por arquivo de configuracao

​CodeBuddy CLI

​Verificar a configuracao

​Perguntas frequentes