Codebuddy调用内置模型说明

对腾讯云Codebuddy代码助手的内置模型进行全维度说明，覆盖内置模型清单、核心特性、调用方式、配置规则、权限与使用限制等内容，帮助开发者规范、高效调用内置模型，适配代码开发、调试、审查等各类场景，同时保证上下文衔接流畅、实操指引清晰。

一、Codebuddy内置模型基础概述

Codebuddy作为腾讯云官方AI代码助手，内置多款适配代码开发场景的大模型，分为国内版内置模型与国际版内置模型两大体系，默认启用自研模型保障合规性与稳定性，同时支持模型手动切换，适配不同开发需求、算力消耗与响应速度要求。

内置模型均为平台预部署、免额外API密钥配置的模型，无需开发者自行接入第三方接口，登录Codebuddy后即可直接调用，支持代码生成、补全、解释、调试、审查、重构、单元测试生成等全流程开发场景，部分子代理任务会自动匹配最优内置模型，无需手动指定。

二、内置模型完整清单与核心特性

2.1 国内版专属内置模型（默认可用，合规优先）

模型名称	模型定位	核心优势	适用场景	默认启用状态
腾讯混元大模型	通用代码开发主模型	国产自研、合规性拉满、上下文理解强、代码生成准确率高、适配国内开发规范	常规代码编写、注释生成、代码解释、基础调试、技术问答	是（全局默认模型）
DeepSeek-R1/V3	高性能代码专用模型	代码推理能力强、长文本支持好、复杂逻辑重构适配、响应速度快	复杂代码开发、多文件重构、算法实现、批量代码优化	可选（手动切换）
混元Turbo S	轻量级高速模型	低延迟、高并发、算力消耗小、适合快速交互	代码快速补全、临时调试、简短代码生成、实时问答	可选（子代理默认）

2.2 国际版专属内置模型

模型名称	模型定位	核心优势	适用场景
GPT系列（GPT-4o、GPT-4 Turbo）	国际通用代码模型	全球生态适配、多语言支持完善、复杂任务推理强	跨境项目开发、英文技术文档对接、国际通用代码规范适配
Gemini系列（Gemini 3.0 Pro/Flash）	高速轻量化+高性能双版本	Flash版低延迟快速响应，Pro版适配复杂代码任务	快速代码补全、批量文件检索、复杂项目规划

2.3 内置子代理专用模型（自动调用）

Codebuddy内置三大专用子代理，会自动绑定对应内置模型，无需开发者手动配置，保障任务执行效率：

General-Purpose子代理：绑定全局默认模型（混元），适配复杂多步骤代码修改、多文件操作、深度推理任务，支持全权限工具调用；
Plan子代理：绑定默认高性能模型，仅用于计划模式，负责代码库分析、任务规划，只读模式不修改文件；
Explore子代理：绑定Gemini 3.0 Flash/混元Turbo S，轻量化只读模型，专注代码库搜索、文件检索、快速分析，延迟极低。

三、内置模型调用方式（全场景实操）

3.1 可视化界面手动调用（最常用）

适用于IDE插件、Web端Codebuddy操作，步骤极简：

登录Codebuddy，打开主对话面板/代码编辑界面；
找到左侧/顶部Model（模型）下拉选择框；
下拉列表中展示所有可用内置模型，直接点击目标模型即可切换；
切换后当前会话及后续对话，均使用选中模型生成响应。

适配终端：Visual Studio 2022插件、Cloud Studio在线IDE、Web端Codebuddy控制台。

3.2 子代理配置调用（任务专属）

针对自定义子代理或内置子代理，可在配置文件中指定内置模型，支持固定模型或继承主模型：

3.2.1 配置文件写法（YAML前置Markdown）

---
name: code-reviewer
description：代码审查专用子代理
tools: Read, Grep, Bash
model: hunyuan-turbo-s  # 直接指定内置模型别名
# model: inherit  # 继承主对话模型，保持风格一致
permissionMode: default
---
# 子代理系统提示
你是专业代码审查员，专注代码安全、规范与可读性，输出标准化审查报告。

3.2.2 CLI命令行调用

通过CLI参数动态指定内置模型，适合脚本自动化、临时任务调试：

codebuddy --agents '{
"code-analyzer": {
"description": "代码分析专家",
"prompt": "深度分析代码逻辑与性能瓶颈",
"tools": ["Read", "Glob"],
"model": "deepseek-r1"
}
}'

3.3 自动调用（无感适配）

Codebuddy内置智能调度机制，会根据任务类型、场景自动匹配最优内置模型：

常规代码问答、注释生成：默认调用混元大模型；
快速检索、文件查找：自动调用Explore子代理+轻量级模型；
复杂重构、多步骤修改：自动切换General-Purpose子代理+高性能模型；
国内用户默认优先国产内置模型，国际用户自动适配对应区域内置模型。

四、内置模型核心配置规则

核心配置要点：内置模型无需配置API Key，仅需通过别名或界面选择调用，禁止私自修改内置模型部署参数，避免调用异常。

4.1 模型别名规范（调用必填）

调用内置模型需使用平台指定标准别名，禁止自定义别名，常用别名对照表：

腾讯混元：hunyuan、hunyuan-turbo-s
DeepSeek：deepseek-r1、deepseek-v3
Gemini：gemini-3.0-flash、gemini-3.0-pro
GPT：gpt-4o、gpt-4-turbo

4.2 继承机制（inherit）

子代理配置中，若设置 model: inherit，则子代理会完全继承主对话当前选中的内置模型，保证整个会话响应风格、推理逻辑一致，适合连贯任务流，避免多模型切换导致的响应差异。

4.3 优先级规则

手动界面选择模型 > 子代理固定模型配置 > 自动调度模型；
CLI临时配置模型 < 项目级子代理模型配置 < 用户级全局模型配置；
内置子代理专用模型，优先级高于自定义子代理默认配置。

五、使用限制与注意事项

5.1 权限与可用性限制

内置模型仅对已登录、完成实名认证的Codebuddy用户开放，未登录状态无法调用；
国内版用户仅可调用国产内置模型，国际版模型需切换至国际版账号才可使用，遵循区域合规要求；
免费版用户内置模型调用有频次与算力限制，企业版/付费版无额外限制，可全量使用所有内置模型。

5.2 上下文与算力限制

内置模型均有上下文窗口限制，常规代码任务建议单轮对话不超过20万Token，避免上下文溢出导致响应截断；
轻量级模型（混元Turbo S、Gemini Flash）不适合超长代码、多文件批量任务，建议切换至高性能模型；
子代理独立上下文窗口，不会污染主对话上下文，长时间任务可通过恢复代理ID继续执行，保留上下文。

5.3 安全与规范要求

禁止使用内置模型生成违法、违规、恶意代码，平台会对调用内容进行合规检测；
内置模型调用记录会留存于平台，企业用户可查看调用日志，保障代码安全；
不得将内置模型调用能力二次分发、转售，仅限账号本人/本企业开发使用。

5.4 常见问题排查

模型下拉框无选项：检查账号登录状态、实名认证情况、区域版本是否匹配；
调用失败/无响应：检查模型别名是否正确、上下文是否过长、账号频次是否超限；
子代理模型不生效：确认配置文件格式无误，优先级是否低于全局配置。

六、快速选型建议

日常开发、基础调试：选用腾讯混元大模型，稳定合规，适配绝大多数场景；
复杂代码、重构优化：选用DeepSeek-R1，推理能力更强，处理长代码更流畅；
快速检索、临时问答：选用混元Turbo S，响应快，算力消耗低；
连贯任务、子代理协作：开启inherit继承模式，保持全流程一致性。