腾讯云CodeBuddy完全对接指南：从安装配置到企业级集成实践

腾讯云CodeBuddy，是目前腾讯云在AI编程助手领域推出的核心产品。它深度融入了腾讯云的整个生态体系，能力覆盖了从最基础的代码编写，到最终的项目部署上线，全链路都有AI辅助的影子。更关键的是，CodeBuddy提供了三种截然不同的产品形态：IDE插件、独立IDE，还有CLI命令行工具。这意味着无论是重度依赖IDE的专业开发者，还是刚入门的新手，都能找到适合自己的那款。这篇文章会从零开始，把安装、配置、API接入、第三方集成，一直到最终的部署，整个流程系统地梳理一遍。

需要先登录腾讯云控制台，点击：腾讯云控制台。

一、CodeBuddy产品形态与选型

到底该选哪种形态？这就得看具体的使用场景了。CodeBuddy目前提供了三个方向，可以对照着来挑选：

：这是最简单、门槛最低的入门方式。它就像个外设，直接装到你日常的VS Code、JetBrains系列IDE里，即插即用，基本没有学习成本。代码补全、错误修复、自动生成单元测试、代码审查这些核心功能，它都具备，非常适合日常编码的开发者。

：这是一个独立的、完全为AI而生的IDE。它主打“对话即编程”，把AI的能力渗透到了需求规划、产品设计、代码开发再到部署的整个流程。如果你是产品经理、设计师、全栈开发者或者刚接触编程的新手，这会是一个相当高效的选择。

：这个版本是为专业工程师准备的AI命令行工具。你可以在命令行里直接用自然语言驱动整个开发流程，实现高度自动化。如果你从事DevOps、运维、SRE工作，或者是个资深开发者，这个工具会带来前所未有的效率提升。

二、CodeBuddy插件安装与接入

2.1 Visual Studio Code插件安装

在VS Code里安装CodeBuddy是最顺手的。操作很简单：打开VS Code，进入扩展市场（Extensions），搜索“腾讯云代码助手”或“CodeBuddy”，找到后点击安装就行。装好后，VS Code的侧边栏会出现一个新的CodeBuddy图标，点击它就能打开对话面板，直接开始对话了。

2.2 JetBrains系列IDE插件安装

对于IntelliJ IDEA、PyCharm这些JetBrains系列的IDE，安装方式也差不多。进入“Settings → Plugins”，搜索“Tencent Cloud CodeBuddy”或“腾讯云代码助手”，找到后点击安装。安装完毕后，重启IDE就能在侧边栏看到它了。

2.3 Visual Studio插件安装

Visual Studio用户有两种安装方式可选：

直接访问Visual Studio市场，搜索“Tencent Cloud CodeBuddy”，下载插件安装程序，然后双击运行就完成了。

在Visual Studio顶部菜单栏单击“扩展” → “管理扩展”，搜索“腾讯云代码助手CodeBuddy”，单击安装。关闭Visual Studio后，在弹出的VSIX Installer窗口中单击Modify执行下载。

需要留意的是，Visual Studio的最低版本要求是17.6及以上。

2.4 插件登录

安装好之后，打开IDE就能看到CodeBuddy的登录界面。直接用腾讯云的账号扫个码，或者输入账号密码，就能登录了。

三、CodeBuddy CLI安装与配置

3.1 安装CodeBuddy CLI

CodeBuddy CLI（也就是CodeBuddy Code）可以通过npm进行全局安装：

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

在安装之前，请确保你的本地已经安装了Node.js 18.0或更新的版本。

3.2 获取API Key

使用CLI工具需要一个API Key来做身份认证，具体步骤如下：

1. 进入腾讯云TokenHub的API Key管理页面。
2. 单击“创建API Key”。
3. 设置可访问范围时，如果要用特定模型，记得勾选对应模型。
4. 创建完成后，复制并妥善保管好你的API Key。

3.3 配置模型文件

找到CodeBuddy Code的配置文件models.json，路径因系统而异：

• Windows：C:Users<用户名>.codebuddymodels.json
• macOS/Linux：~/.codebuddy/models.json

如果文件不存在，新建一个就行。下面是一个配置Hy3 preview模型的示例：

 {
  "models": [
    {
      "id": "hy3-preview",
      "name": "hy3-preview",
      "vendor": "Tencent Cloud",
      "apiKey": "",
      "url": "https://tokenhub.tencentmaas.com/v1"
    }
  ],
  "a vailableModels": ["hy3-preview"]
}

把替换成你实际获取的API Key就行。如果models.json已经存在，只需要在models和a vailableModels里追加新模型的配置即可。

3.4 启动CodeBuddy CLI

配置完成后，执行以下命令就可以启动了：

 codebuddy

首次启动时会弹出信任文件选择界面，询问是否信任当前工作目录下的项目文件：

• Yes, proceed（推荐）
  ：信任当前目录的所有文件时选这个，这样CodeBuddy Code才能读写项目文件、执行命令来辅助开发。

• No, exit
  ：如果当前目录包含不信任或来源不明的代码，选这个，工具会安全退出。

启动后，会显示登录方式选择界面，有几种方式：

• Chinese Site
  ：中国站用户，通过腾讯云中国站进行认证。

• International Site
  ：国际站用户，通过腾讯云国际站进行认证。

• Enterprise Domain
  ：专享版或私有化部署用户，需要输入企业的服务地址。

• iOA
  ：腾讯内部员工专用。

选择登录方式后，会自动打开浏览器完成认证。认证成功后返回命令行界面，输入/model就可以进入模型选择列表，选择你配置好的模型开始使用了。

四、CodeBuddy IDE使用指南

4.1 打开或创建项目

CodeBuddy IDE支持三种方式打开项目：新建一个文件夹、打开本地已有的文件夹、或者直接克隆一个远程Git仓库。

4.2 Craft与Chat双模式

CodeBuddy IDE提供了侧栏对话功能，支持Craft和Chat两种模式：

：就是咱们熟悉的AI聊天窗口。你可以通过自然语言进行技术对话，询问各种编程问题，而且支持多轮追问，能感知上下文。日常开发中的技术咨询、代码解释、问题排查，用它非常顺手。

：这个模式就不一样了。它不再是一个简单的聊天机器人，而是一个有“独立思考”和“自主执行”能力的编程伙伴。你只需要用自然语言描述项目需求，它就能自动生成完整的工程代码和多个文件。开启Plan Mode后，它还能根据需求进行任务拆解、制定开发计划，甚至反过来跟你澄清需求。从需求到原型再到代码，端到端全包了，非常适合从零开始启动一个新项目。

4.3 多模型支持

CodeBuddy IDE内置了多种模型供你切换，包括Default（Hunyuan）、DeepSeek-V3.1、DeepSeek-0324等。不同的任务类型，可以灵活选择最合适的模型。

4.4 添加上下文

为了让AI的回答更精准，CodeBuddy IDE支持多种方式添加上下文：

• 添加图片
  ：直接用Ctrl V截图粘贴进来，就能作为上下文。

• 添加代码块
  ：圈选代码后，右键选择“Add To Chat”。

• 添加文件或目录
  ：在文件树中右键点击文件或目录，选择“Add File CodeBuddy”。

• 添加终端报错
  ：在底部面板里，把问题或终端报错直接丢给CodeBuddy。

• @引用上下文
  ：使用@符号来引用文件、文件夹、Git提交、知识库、Rules等。

五、第三方开发集成与企业级对接

CodeBuddy的专享版和企业版支持配置第三方开发集成，简单来说，就是可以通过开发第三方服务的方式，对接你内部的身份管理平台。而旗舰版则是使用腾讯统一身份进行登录认证管理。

5.1 第三方服务开发

开发者需要按照CodeBuddy提供的接口规范，开发一个第三方组织架构服务。这个Custom Provider通过HTTP袋里来对接外部的组织架构服务，组织服务需要实现一组固定的REST接口，返回符合约定的数据结构。

具体配置项长这样：

 {
  "name": "custom-org",
  "base_url": "https://example.com",
  "enterprise_id": "ent-xxx",
  "timeout_seconds": 15,
  "auth_header": "Authorization",
  "auth_token": "token-value",
  "bearer_token": true,
  "extra_headers": {
    "X-From": "org-service"
  },
  "account_id_header": "X-Account-Id",
  "account_id_query": "account_id",
  "success_code": 0,
  "config_header": "X-Custom-Config"
}

几个关键字段说明一下：

• base_url
  ：必填，自定义组织服务的根地址。

• enterprise_id
  ：默认作为查询参数附加。

• timeout_seconds
  ：请求超时时间，默认是15秒。

• auth_token
  ：鉴权token，发送时会放在Authorization: Bearer 里。

• extra_headers
  ：附加到所有请求的额外请求头。

• account_id_header
  ：将AccountID放入这个请求头。

• account_id_query
  ：将AccountID作为这个查询参数。

• success_code
  ：响应包装code的成功值，默认是0。

5.2 启用第三方集成

进入企业域名后台（<企业id>.copilot.qq.com/admin），选择“开放与集成” → “组织架构同步”，单击任意第三方系统。然后根据页面提示，输入上游系统名称、服务域名、token信息，再配置好关联规则（支持根据用户ID、邮箱、手机号匹配），选择完成后提交就行了。

5.3 效果验证

配置完成后，在“开放与集成” → “组织架构同步”页面，就能看到从第三方服务同步过来的组织架构和人员信息了。单击“手动关联”，就能把成员从第三方服务同步到CodeBuddy中。

六、部署对接与集成

6.1 EdgeOne Makers部署对接

CodeBuddy IDE支持集成EdgeOne Makers的快速部署能力。在开发过程中，可以一键构建并部署到Makers上。操作步骤很简单：

1. 在CodeBuddy IDE中单击Deploy按钮。
2. 选择EdgeOne Makers进行连接。
3. 单击Manage进入腾讯云，登录账号进行授权。

建议提前配置好EdgeOne Makers Rules（pages-llms.mdc），这样AI能更懂怎么编写符合Makers规范的代码。部署完成后，可以在CodeBuddy里查看部署情况、获取预览地址，也可以直接访问腾讯云控制台进行更深入的项目管理。

6.2 CloudBase后端集成

CodeBuddy集成了Supabase和腾讯云开发CloudBase后端服务。这意味着你不需要手动配置数据库、认证这些繁琐的后端服务，就能获得一个可运行的后端环境。CodeBuddy IDE已经内置了CloudBase MCP，建议优先使用配置集成的方式。

七、高级功能与自定义配置

7.1 MCP协议扩展

CodeBuddy支持MCP（Model Context Protocol）协议，你可以通过配置文件来声明外部服务。比如，你声明一个数据库服务：

 {
  "services": {
    "database": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-database", "mongodb://localhost:27017/mydb"]
    }
  }
}

这个MCP Server功能很强大，甚至可以一键生成Dockerfile，然后直接部署到腾讯云等平台。

7.2 自定义Rules规则

在Rules文件里，你可以自定义项目的各种规则，比如项目规范、框架约定、库使用规则、编码安全要求等等。这些规则定义好后，在当前项目里就会生效。每次启动或重载项目时，它会自动扫描并加载.codeBuddy/rules目录下的Rules文件。

关于Rules，有一条最佳实践：规则应当聚焦、可操作、范围清晰。每条规则最好控制在500行以内，如果规则太长，可以拆分成多个可组合的小规则。

7.3 代码质量保障

CodeBuddy提供了智能审查与静态分析功能，能自动检测代码风格违规、潜在的Bug（比如空指针、资源泄漏）、安全漏洞（比如SQL注入、XSS）等问题。举个例子，如果你的代码里出现了SELECT * FROM users，CodeBuddy会提示你“建议使用参数化查询防止SQL注入”。

单元测试生成也很方便：右键点击某个方法，选择“Generate Unit Test”，它就能自动生成JUnit/Mockito测试模板，还会覆盖边界条件与异常场景。

八、最佳实践

总结下来，CodeBuddy的最佳实践可以归纳为16个字：

。要善用它的智能补全和生成能力，但核心逻辑的掌控终究还是要靠自己。

8.1 精准描述需求

给CodeBuddy下指令时，一定要具体。比如，“用React + TypeScript开发一个动态表单生成器，支持字段类型扩展，要求代码包含校验逻辑和API调用示例”。而不是简单地说一句“写一个表单”。

8.2 分步骤迭代

生成代码不要指望一步到位，分阶段进行效率更高：

1. 先生成核心逻辑，比如表单校验函数。
2. 再逐步扩展UI组件和状态管理。
3. 最后整合API调用与错误处理。

8.3 团队协作规范

可以在.codebuddyrc中定义团队规范：

 {
  "indentation": "2 spaces",
  "naming_convention": "camelCase",
  "prohibit": ["var", "eval"]
}

企业知识库集成也很实用。把项目文档、API手册上传到CodeBuddy里，以后就能通过自然语言查询直接获取上下文帮助。

九、常见问题

答：CodeBuddy插件支持VS Code、JetBrains系列（IntelliJ IDEA、PyCharm等）、Visual Studio（17.6及以上版本）等主流IDE。

答：目前CodeBuddy可以免费使用。具体计费政策请以腾讯云官方公告为准。

答：理论上不限制任何类型的代码语言。前端（HTML、Ja vaScript、CSS、Vue、React等）、后端（Node.js、Python、Ja va、C#、Ruby、PHP等）、客户端（Ja va、Kotlin、Swift等）以及C++、Go、Rust、TypeScript等都在支持范围内。

答：Windows系统在C:Users<用户名>.codebuddymodels.json，macOS/Linux系统在~/.codebuddy/models.json。

答：CodeBuddy专享版和企业版支持第三方开发集成。你需要开发一个符合接口规范的组织架构服务，然后进入企业后台配置上游系统名称、服务域名、token信息及关联规则。旗舰版则使用腾讯统一身份进行登录认证管理。

答：Chat模式是技术对话工具，适合日常技术咨询和代码解释。而Craft模式更像一个有独立思考和自主执行能力的编程伙伴，可以通过自然语言描述项目需求，自动生成完整的工程代码。它支持Plan Mode进行任务拆解，特别适合从零启动新项目。