文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>腾讯云代码助手>操作指南>模型配置

模型配置

最近更新时间：2026-05-08 14:10:26

我的收藏

本页目录：

目前，腾讯云代码助手内置模型包括腾讯支持的混元大模型、DeepSeek 大模型、智谱大模型、Kimi 大模型。

内置模型列表

支持对话模型的自由切换，在 AI 输入框下方进行配置：


Auto 模型

Craft 模式支持选择 Auto 模型，根据提问自动选择最优模型。

Max 模式

开启后实现最大化上下文窗口，关闭自动上下文压缩。该模式会消耗更多 Credit，建议仅在复杂或高质量任务中使用。

models.json 配置

models.json 是一个配置文件，用于自定义模型列表和控制模型下拉列表的显示。该配置支持两个级别：
说明：
CodeBuddy IDE 和 CLI 形态支持配置 models.json 文件，插件版暂不支持。
用户级: ~/.codebuddy/models.json —— 全局配置，适用于所有项目
项目级: <workspace>/.codebuddy/models.json —— 项目特定配置，优先级高于用户级
项目级配置会覆盖用户级配置中的相同模型定义（基于 id 字段匹配）。
设置 availableModels 字段后，项目级完全覆盖用户级，不进行合并。

配置结构

{
  "models": [
    {
      "id": "model-id",
      "name": "Model Display Name",
      "vendor": "vendor-name",
      "apiKey": "sk-actual-api-key-value",
      "maxInputTokens": 200000,
      "maxOutputTokens": 8192,
      "url": "https://api.example.com/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": true
    }
  ]
}

配置字段说明

models

类型： Array<LanguageModel>
定义自定义模型列表，可以添加新模型或覆盖内置模型配置。
字段
类型
必填
说明
id
string
✓
模型唯一标识符
name
string
-
模型显示名称
vendor
string
-
模型供应商 （如 OpenAI, Google）
apiKey
string
-
API 密钥（实际密钥值，非环境变量名）
maxInputTokens
number
-
最大输入 token 数
maxOutputTokens
number
-
最大输出 token 数
url
string
-
API 端点 URL (必须是接口完整路径,一般以 /chat/completions 结尾）
supportsToolCall
boolean
-
是否支持工具调用
supportsImages
boolean
-
是否支持图片输入
supportsReasoning
boolean
-
是否支持推理模式
重要说明：
目前仅支持 OpenAI 接口格式的 API
url 字段必须是接口完整路径,一般以 /chat/completions 结尾
例如: https://api.openai.com/v1/chat/completions 或 http://localhost:11434/v1/chat/completions

availableModels

类型： Array<string>
控制模型下拉列表中显示哪些模型。只有在此数组中列出的模型 ID 才会在 UI 中显示。
如果未配置或为空数组，则显示所有模型。
配置后，只显示列出的模型 ID。
可以同时包含内置模型和自定义模型的 ID。

配置自定义模型

在用户级或项目级添加新的模型配置：
{
  "models": [
    {
      "id": "my-custom-model",
      "name": "My Custom Model",
      "vendor": "OpenAI",
      "apiKey": "sk-custom-key-here",
      "maxInputTokens": 128000,
      "maxOutputTokens": 4096,
      "url": "https://api.myservice.com/v1/chat/completions",
      "supportsToolCall": true
    }
  ]
}

覆盖内置模型配置

修改内置模型的默认参数：
{
  "models": [
    {
      "id": "gpt-4-turbo",
      "name": "GPT-4 Turbo (Custom Endpoint)",
      "vendor": "OpenAI",
      "url": "https://my-proxy.example.com/v1/chat/completions",
      "apiKey": "sk-your-key-here"
    }
  ]
}

限制可用模型列表

只在下拉列表中显示特定模型：
{
  "availableModels": [
    "gpt-4-turbo",
    "gpt-4o",
    "my-custom-model"
  ]
}

场景示例

项目特定配置：为特定项目使用不同的模型或 API 端点。
项目 A 的 .codebuddy/models.json文件配置：
{
  "models": [
    {
      "id": "project-a-model",
      "name": "Project A Model",
      "vendor": "OpenAI",
      "url": "https://project-a-api.example.com/v1/chat/completions",
      "apiKey": "sk-project-a-key",
      "maxInputTokens":100000,
      "maxOutputTokens":4096
    }
  ],
  "availableModels": ["project-a-model", "gpt-4-turbo"]
}
注意：
删除配置中的 "availableModels" 字段后，需要同步删除对应的配置，后再保存配置。
项目A修改示例：

OpenRouter 平台配置：使用 OpenRouter 访问多种模型。
{
  "models": [
    {
      "id": "openai/gpt-4o",
      "name": "open-router-model",
      "url": "https://openrouter.ai/api/v1/chat/completions",
      "apiKey": "sk-or-v1-your-openrouter-api-key",
      "maxInputTokens": 128000,
      "maxOutputTokens": 4096,
      "supportsToolCall": true,
      "supportsImages": false
    }
  ]
}
DeepSeek 平台配置：使用 DeepSeek 模型。
{
  "models": [
    {
      "id": "deepseek-chat",
      "name": "DeepSeek Chat",
      "vendor": "DeepSeek",
      "url": "https://api.deepseek.com/v1/chat/completions",
      "apiKey": "sk-your-deepseek-api-key",
      "maxInputTokens": 32000,
      "maxOutputTokens": 4096,
      "supportsToolCall": true,
      "supportsImages": false
    }
  ]
}

完整示例

{
  "models": [
    {
      "id": "gpt-4o",
      "name": "GPT-4o",
      "vendor": "OpenAI",
      "apiKey": "sk-your-openai-key",
      "maxInputTokens":128000,
      "maxOutputTokens":16384,
      "supportsToolCall": true,
      "supportsImages": true
    },
    {
      "id": "my-local-llm",
      "name": "My Local LLM",
      "vendor": "Ollama",
      "url": "http://localhost:11434/v1/chat/completions",
      "apiKey": "ollama",
      "maxInputTokens":8192,
      "maxOutputTokens":2048,
      "supportsToolCall": true
    }
  ],
  "availableModels": [
    "gpt-4o",
    "my-local-llm"
  ]
}

热重载

models.json 配置文件支持热重载：
文件变更会被自动检测。
使用 1 秒防抖延迟避免频繁重载。
配置更新后会自动同步到应用。
监听的文件：
~/.codebuddy/models.json （用户级）
<workspace>/.codebuddy/models.json （项目级）

标签系统

通过 models.json 添加的模型会自动标记 custom 标签，便于在 UI 中识别和过滤。

合并策略

models.json配置使用 SmartMerge 策略：
相同 ID 的模型配置会被覆盖。
不同 ID 的模型会被追加。
项目级配置优先于用户级配置。
availableModels 过滤在所有合并完成后执行。

中国站