CodeBuddy —— 腾讯出品的 AI 编程搭档，Craft 模式改变游戏规则

一句话简介

CodeBuddy（腾讯云代码助手）是腾讯云自研的 AI 编程工具，以混元大模型 + DeepSeek 为底座，提供 IDE 插件、独立 AI IDE 和 CLI 命令行三种使用形态——用大白话说，就是你写代码时旁边坐了一个 AI 搭档，能帮你写代码、改 Bug、生成测试、解释逻辑，甚至你说句话就能生成一整个项目，属于 AI 编程助手类软件。

和 GitHub Copilot 是老外做的、需要翻墙不同，CodeBuddy 是国产的、国内直连的、而且公测期间个人版免费。2026 年 4 月推出的 Craft 模式被认为是真正的分水岭——之前 AI 编程工具主要帮你补全代码，现在你可以用自然语言描述一个完整需求，AI 自动拆解任务、规划架构、编写代码、运行测试。

核心亮点

• 三形态覆盖全场景：IDE 插件（在你的 VS Code/JetBrains 里嵌入 AI 能力）、独立 AI IDE（零配置开箱即用，适合新手和产品/设计师）、CLI 命令行（终端里的 AI 搭档，适合运维和自动化脚本）

• Craft 智能体是核心卖点：用自然语言描述需求，AI 自主完成需求理解→任务拆解→架构规划→多文件代码生成→运行测试→部署上线的完整流程。复杂项目拆成子任务并行执行（Sub-Agents），实测 20 分钟搞定一个全栈 CRUD 的 80% 工作量

• 国产免翻墙，个人免费：国内服务器直连，不需要科学上网。个人体验版免费（500 Credits/两周），包含 Craft Agent 模式、MCP 生态支持、微信开发专属能力

• 生态深度整合：Figma 设计稿一键转代码、CloudBase/EdgeOne Pages 一键部署、微信小程序开发专属 MCP 能力（审核、云函数、支付，说句话就搞定）、腾讯编码规范内置

• MCP 协议支持：国内首个支持 MCP 的编程助手。通过 MCP 连接你的内部文档、API 文档、数据库，AI 生成的代码自动符合公司的技术规范和编码风格

适合谁用

• 个人开发者：个人体验版免费，核心功能齐全，零成本获得专业级 AI 编程能力

• 全栈开发者：Craft 模式帮你从零生成完整项目，前端后端部署一条龙，跳过脚手架和样板代码的重复劳动

• 微信生态开发者：做小程序、小游戏、公众号的——CodeBuddy 内置微信专属 MCP 服务，审核、云函数、支付等高频操作自然语言搞定

• 编程初学者：用自然语言描述需求就能生成代码，遇到看不懂的代码直接问 AI 解释，学习曲线大大降低

• 企业研发团队：腾讯内部数据——AI 代码生成占比 43%，人均编码时间缩短 40%，人均 Bug 率降低 31.5%。企业版支持 SaaS/VPC 专享/私有化部署

解决的痛点

痛点 1：新项目从零搭建太费时间，脚手架、配置、样板代码写了半天还没开始写业务

你要做一个用户管理系统的原型：前端 React + TypeScript，后端 Go + Gin，数据库 PostgreSQL，还要配 Docker。光是 create-react-app、建目录结构、写配置文件、配路由、写第一个 CRUD 接口——半天过去了，还没开始写真正的业务逻辑。关键是这些"搭架子"的工作每个项目都得重复一遍。

CodeBuddy 怎么解决：打开 Craft 模式，输入"帮我生成一个用户管理系统，前端 React + TypeScript，后端 Go + Gin，数据库 PostgreSQL，包含用户注册、登录、信息修改、列表查询功能，并生成 docker-compose 配置"。CodeBuddy 自动拆解需求→生成项目结构→生成前后端代码→生成数据库迁移脚本→生成 Docker 配置→生成 API 文档。做完后你在上面修改业务逻辑即可，脚手架和样板代码 100% 由 AI 完成。

痛点 2：GitHub Copilot 好用但需要翻墙和付费，Claude Code 也出不了国

身边用 Copilot 的同事效率确实高，但你要么搞不定网络环境，要么觉得 $10/月不值。用通义灵码或其他国内工具，补全效果又不如 Copilot 准。想找个"在中国能用、效果不差、最好还免费"的 AI 编程助手。

CodeBuddy 怎么解决：腾讯云服务器部署在国内，网络直连。混元 + DeepSeek 双模型驱动——混元对中文和微信生态理解更深，DeepSeek 在开源社区有公认的代码生成能力。个人版免费，500 Credits/两周的核心功能（包括 Craft Agent）0 成本可用。如果不够用，专业版 ¥58/月（比 Copilot 的 $10/月便宜），2000 Credits/月，对话不限频。

痛点 3：接手别人的代码看不懂，维护起来寸步难行

你入职新公司接手了一个老项目，代码没有文档、没有注释、变量命名是拼音缩写。你需要改一个功能，但不知道从哪个文件改起、改了会不会影响其他地方。你花了两天时间"读代码"，其中大部分时间是在"猜"每个函数的意图。

CodeBuddy 怎么解决：选中一段代码 → 右键 →"解释代码"→ AI 用自然语言告诉你这段代码做了什么。更进一步，用 @workspace 让 AI 理解整个项目的代码结构，然后问"用户登录的流程涉及哪些文件和函数"，AI 基于全仓检索给出完整调用链。你从"盲猜"变成了"有向导的探索"。

痛点 4：写单元测试又枯燥又耗时，不写又担心质量

函数写完、功能跑通了，该写测试了。你要考虑正常情况、异常情况、边界值、空值……为一个 30 行的函数写 100 行测试代码。写完还不确定覆盖全不全。很多项目干脆"先上线，测试后补"——然后永远不会补。

CodeBuddy 怎么解决：选中一个函数 → 右键 →"生成测试"→ AI 分析函数的输入输出和逻辑路径，自动生成覆盖各种情况的测试用例。你不只是得到一个测试文件，而是得到一份比你手工写更全面的测试覆盖。腾讯内部用了以后 Bug 率降低 31.5%，这是有数据支撑的。

痛点 5：设计稿还原度低，前端和设计师反复拉扯

设计师在 Figma 里画了完美的稿子，你打开浏览器量间距、取色值、对着设计稿一行行写 CSS。切完一看——圆角不对、颜色有偏差、阴影效果没出来。设计师说"你做的和我给的不一样"，你说"我肉眼对的已经很接近了"。

CodeBuddy 怎么解决：IDE 版支持导入 Figma 设计稿，一键生成对应的前端代码（HTML/CSS/React/Vue）。设计稿中的组件层级、颜色值、字体、间距都被自动识别和转换，保持着和设计稿的高度一致性。生成后你只需要做微调，不用从零"手写 CSS 还原设计"。

使用场景

1. 自然语言描述需求，AI 生成完整项目：打开 CodeBuddy IDE 或 Craft 模式，用中文描述你想做什么，AI 从项目创建到部署全流程覆盖

2. 日常编码的智能补全：在 VS Code/JetBrains 里写代码时，CodeBuddy 插件根据上下文提供精准补全——不只是补全一行，是补全整个函数体。支持 200+ 编程语言

3. 代码审查和安全扫描：提交代码前让 CodeBuddy 审查本地的变更——潜在的逻辑错误、安全漏洞（SQL 注入、XSS 等）、不符合团队规范的地方，自动标记和建议修复

4. Figma 设计稿转代码：导入设计师的 Figma 链接，自动输出可维护的前端代码，支持 React、Vue 等主流框架

5. 微信小程序开发：创建小程序项目后，CodeBuddy 内置的微信专属 MCP 支持直接调用审核、云函数、支付配置——说"帮我配置微信支付"比看文档快得多

6. CLI 模式在终端里让 AI 修 Bug：服务端部署时发现一个错误，直接在终端输入 buddy fix，AI 读取报错信息→分析代码→给出修复方案→甚至直接修改文件

7. 企业知识库增强：把团队的内部文档、编码规范、API 文档导入 CodeBuddy 的 RAG 知识库，AI 生成的代码自动遵循团队风格

8. 学习和理解未知代码库：面对一个陌生的开源项目，让 AI 解释架构、分析模块间的关系、帮你找到修改的切入点

下载与安装

官方下载

• 官网地址：https://www.codebuddy.cn/

• IDE 最新稳定版：v4.9.12（2026 年 6 月）

• CLI 最新版本：v2.59.0

三种使用形态：

💡 如果你是第一次用 AI 编程工具，推荐从 AI IDE 独立客户端开始——零配置开箱即用，界面友好，Figma 转代码、Craft 智能体等功能体验最完整。

安装步骤

独立 AI IDE：

1. 访问官网，下载对应系统的安装包

2. 双击安装，按提示完成

3. 首次启动后登录腾讯云账号（微信扫码即可）

4. 创建项目或打开已有项目，开始使用

插件版（VS Code）：

1. VS Code 扩展市场搜索 "CodeBuddy"

2. 点击安装，重启 VS Code

3. 左侧会出现 CodeBuddy 面板，点击登录

CLI 版：

1. 确保安装了 Node.js 18+

2. 终端执行 npm install -g @tencent-ai/codebuddy-code

3. 终端输入 buddy 开始交互

4. CLI 支持的命令：/agents 管理智能体、/memory 内存管理、/resume 恢复任务、/doctor 诊断修复

系统要求

定价

最佳实践

1. 写好 Prompt——这是你最重要的技能

和使用 ChatGPT 聊天不同，用 CodeBuddy 写代码时，prompt 的质量直接决定生成代码的质量。几个技巧：

• 说清楚技术栈：不要只说"做个用户系统"，要说"用 React + TypeScript + Ant Design 做用户管理界面，后端用 Node.js + Express + PostgreSQL"

• 说明约束条件："需要支持响应式布局"、"使用 JWT 做认证"、"数据库表需要包含软删除字段"

• 分步骤给需求：先让 AI 搭项目框架，确认无误后再让它写具体功能。不要一次扔 10 个需求，容易混乱

• 提供示例：如果你有已写好的类似代码或接口文档，贴出来让 AI 参考

2. Craft 模式的最佳使用姿势

Craft 模式适合"从零到一"的项目创建，但不要期望它一次就完美。推荐工作流：

• 第一次：让 Craft 生成完整的项目骨架（框架搭建、基础配置、核心数据模型）

• 审阅：花 10 分钟通览生成的代码，确认技术选型和结构是否符合预期

• 第二次：针对具体功能模块，逐个让 Craft 生成并添加

• 微调：在 AI 生成的代码上做业务逻辑定制

这样你既享受了 AI 的速度，又保持了对代码质量的把控。

3. 用 @workspace 让 AI 理解你的项目

在插件版的对话框里，使用 @workspace 指令告诉 AI："请扫描整个项目，建立上下文理解"。之后问任何问题，AI 都会在项目全文中检索相关信息回答。比如"这个项目里数据是怎么从 Controller 流到数据库的"、"我想加一个搜索功能，应该改哪些文件"——比你自己在全仓搜索快得多。

4. 善用 MCP 连接团队规范

CodeBuddy 支持 MCP（模型上下文协议），可以连接你的内部文档系统、API 文档、数据库 Schema。配置好团队的编码规范文档后，AI 生成的代码自动遵循团队的命名规则、目录结构、错误处理方式。这是 CodeBuddy 相比其他 AI 编程工具最大的差异化能力——不只是"写代码"，而是"按你团队的规矩写代码"。

5. CLI 模式用于自动化和快速修复

CLI 的 buddy 命令特别适合：

• 服务端部署时发现报错，直接 buddy "这个错误怎么修" 就地排查

• 批量处理脚本：buddy "给所有 TypeScript 文件加上版权头注释"

• 代码审查：buddy "审查 src/ 目录下的安全风险"

• 配合 YOLO 模式自动执行（CLI v1.3 新增），适合高度自动化的场景

6. 代码补全的"惯性"养成

CodeBuddy 的补全精度依赖"上下文惯性"——你写得越多、越连贯，它猜得越准。几个小技巧：

• 先写好函数签名和注释，AI 会根据签名和注释自动生成函数体

• 保持代码风格一致——如果前几个函数用了 async/await，AI 在补全新函数时也会自动用 async/await

• 有明确的变量命名习惯后，AI 补全的准确度会提升

7. 代码审查不要跳过

有了 AI 写代码，反而更需要代码审查。至少做到：

• AI 生成的代码必须通读一遍再合并

• 安全问题（密钥硬编码、SQL 拼接）重点检查

• 逻辑正确性验证——AI 可能生成了"看起来对但跑起来有问题"的代码

• 使用 CodeBuddy 的智能评审功能做第一遍自动检查，人工做第二遍

替代方案对比

几点诚实补充：

GitHub Copilot 在补全精准度上可能还是稍强。这是它在全球上千万开发者数据上训练的自然结果。但差距已经在缩小——CodeBuddy 在中文场景和微信生态上的优势，是 Copilot 完全不具备的。

如果你已经是 Cursor 用户且用得很顺，没有必要立刻切换。但可以关注 CodeBuddy 的发展——Craft 模式和 MCP 生态是 Cursor 目前不具备的差异化能力。

CodeBuddy 的免费策略对个人开发者非常有吸引力——同样是 Craft/Agent 级别的能力，Cursor Pro 要 $20/月，CodeBuddy 免费版就有。500 Credits/两周对轻度到中度使用来说基本够用。

功能详解

一、Craft 智能体：这不再是"代码补全"，而是"自动造项目"

Craft 是 CodeBuddy 2026 年 4 月推出的核心功能，代表了 AI 编程从"辅助"到"主导"的转变。工作流程：

1. 你描述需求（自然语言）

2. Craft 拆解任务为多个子步骤

3. Craft 规划技术架构（用什么框架、怎么组织文件、数据库怎么设计）

4. Sub-Agents 并行执行各自的子任务（写前端、写后端、写测试、写配置）

5. Craft 汇总成果，生成完整的项目文件

6. 你审阅、微调、确认

Craft 模式下你可以随时和 AI 对话调整方向——"把数据库从 MySQL 换成 PostgreSQL"、"给用户表加一个角色字段"、"前端用一个更简洁的配色"——不需要自己动手改代码，AI 帮你改。

二、代码补全：上下文越丰富，补全越智能

插件版的代码补全基于 AST（抽象语法树）分析 + 向量化检索，理解你的代码结构后给出精准建议。补全不只是"猜下一个词"——它能补全整个函数体、补全 Switch Case 的所有分支、补全测试用例的边界情况。

支持 200+ 编程语言和数十款主流 IDE（VS Code、JetBrains 全家桶、Visual Studio、Xcode 等）。

三、AI 对话：嵌入在编辑器里的技术顾问

对话框可以问任何技术问题——解释代码、生成代码、调试建议、重构方案。支持：

• @workspace：基于整个项目上下文回答

• @file：基于特定文件回答

• 选中代码直接提问

• 多轮对话，保持上下文

四、单元测试生成：让测试覆盖率不再焦虑

选中函数 → 生成测试 → AI 分析函数的逻辑路径 → 生成覆盖正常、异常、边界情况的测试用例。支持多种测试框架（JUnit、pytest、Jest、Go testing 等）。

五、智能代码审查

提交前让 CodeBuddy 审查本地的变更——自动检测安全隐患、代码规范问题、性能问题。语言级定制：Python 检查 SQL 注入和反序列化、Java 扫描 Log4j 等历史漏洞、Go 检查 Goroutine 泄露。官方数据：误报率比通用扫描器低 67%。

六、RAG 知识库：让 AI 按你的规范写代码

把团队的编码规范文档、API 文档、数据库 Schema 导入知识库，CodeBuddy 生成的代码自动遵循这些规范。企业版还支持 RAG 对接企业内部的文档系统和代码仓库。

七、MCP 生态：连接一切

CodeBuddy 支持 MCP 协议——通过 MCP Server 连接外部数据源和工具。内置的微信生态 MCP 是独家优势——小程序审核、云函数部署、支付配置等操作都可以用自然语言触发。

八、Figma 转代码：设计到开发的桥梁

导入 Figma 设计资源 → 自动分析组件层级、颜色、字体、间距 → 生成 React/Vue/HTML 代码。支持精确的 DOM 调试和实时同步，保持设计与开发一致性。

常见问题

概念认知类

Q1：CodeBuddy 和 GitHub Copilot 有什么区别？该选哪个？

A：核心区别：CodeBuddy 国产直连 + 三形态 + Craft 全流程 + 微信生态 + 免费版；Copilot 全球生态 + 补全更精准 + 社区更大。如果你在国内开发、在意性价比和微信生态，选 CodeBuddy。如果你在国外或在用 GitHub 全家桶，Copilot 更成熟。

Q2：代码会被上传到腾讯的服务器吗？安全吗？

A：代码补全在本地进行——AST 分析和向量检索都在本地完成。AI 对话和 Craft 模式需要把部分上下文发送到云端模型进行推理（和所有 AI 编程工具一样）。企业版支持 VPC 专享和私有化部署，数据完全不出企业内网，满足等保三级和国密双加密要求。

Q3：Credits 是什么概念？500 Credits 够用多少？

A：Credits 是 CodeBuddy 的使用额度单位。不同的操作消耗不同数量的 Credits——AI 对话、Craft 生成、代码补全的消耗不同。个人体验版 500 Credits/两周，轻度到中度使用（日常补全 + 偶尔 AI 对话 + 少量 Craft 生成）基本够用。如果不够，可以升级到专业版（2000 Credits/月）。

Q4：我是编程新手，能用好 CodeBuddy 吗？

A：CodeBuddy 反而对新手特别友好。你不需要知道怎么写代码——用自然语言描述你想做什么，AI 生成代码，你边看边学。遇到看不懂的地方，选中代码让 AI 解释。这是"反向学习"——先看到结果，再理解原理，比传统"先学语法再动手"的路径更直观。

实操问题类

Q5：Craft 生成的代码质量怎么样？能直接上线吗？

A：Craft 生成的代码质量在"能用"到"好用"之间——架构合理、逻辑正确、有基础错误处理。但直接上线前建议做到：通读所有生成代码（至少一遍）、调整业务逻辑的细节、添加你自己项目的特定配置、确认安全策略。把 Craft 当成"自动完成 80% 的写代码工作"，剩下的 20% 需要你的专业判断。

Q6：CLI 怎么安装和使用？

A：前提是安装了 Node.js 18+。终端执行 npm install -g @tencent-ai/codebuddy-code，安装后在命令行输入 buddy 启动交互模式。支持的命令：/agents 管理 Sub-Agents、/memory 对话记忆管理、/resume 恢复之前任务、/doctor 诊断问题。也可以直接 buddy "帮我..." 开始对话。

Q7：插件和独立 IDE 怎么选？

A：有自己习惯的编辑器（VS Code/JetBrains）→ 装插件版，不改变工作流。新手、产品/设计师、想完整体验 Craft + Figma 转代码 → 用独立 IDE。两个不冲突，可以同时装。

Q8：代码补全不准怎么办？

A：补全精度依赖上下文。提升方法：保持代码风格一致、先写好函数签名和注释、用 @workspace 让 AI 建立项目级理解。如果某个文件的补全一直不对，可能是因为该文件的代码风格或依赖关系比较特殊——不用纠结，继续手写，AI 会跟着你的节奏调整。

小结

如果你想在国内环境中零成本体验专业级 AI 编程，CodeBuddy 是目前最值得尝试的选择——个人版免费且包含 Craft Agent 核心能力，三种形态覆盖各种开发场景，微信生态的专属支持更是竞品不具备的差异化优势。腾讯内部的数据（代码生成占比 43%、编码时间缩短 40%）是有说服力的背书。

如果你已经深度绑定 GitHub 生态且网络环境不是问题，Copilot 在补全精度上的小幅领先和更成熟的社区依然有价值。但说实话——CodeBuddy 的 Craft 多文件生成、MCP 协议扩展、Figma 转代码这些能力，正在重新定义"AI 编程助手"的上限。