腾讯 CodeBuddy 怎么用：安装到 Agent 模式全流程

腾讯 CodeBuddy 上手只要三步：选一种形态（独立 IDE、编辑器插件或 CLI）、下载安装、扫码登录后就能让 AI 生成代码。个人体验版限时免费，每月 500 积分，代码补全限免期不限次数，学习和中小项目够用。下面按真实使用顺序把每一步讲清楚，并把官方定价页的完整套餐表和 12 条真实报错放在后面。

先选形态：三个入口对应三种人

CodeBuddy 目前同时提供三种使用形态（来源：腾讯 CodeBuddy 官网与官方文档），选对入口能省下不少折腾时间：

1. CodeBuddy IDE：独立安装的 AI 原生 IDE，主打「对话即编程」，从需求规划、产品设计、代码研发到部署全流程打通，适合新手、产品经理和全栈开发者。
2. 插件：装进你已有的 VS Code 或 JetBrains 系列编辑器，传统开发者主导、AI 打辅助，适合带着老项目继续用熟悉环境的人。
3. CodeBuddy Code（CLI）：面向专业工程师的命令行工具，支持 Shell、文件、网络操作与任务编排，适合 DevOps、运维、SRE 和习惯终端工作流的人。

官网还有 Agents 智能体平台（Beta）、NPC 智能体角色，以及主打办公自动化的 WorkBuddy（公测），本教程聚焦编程主线，其余入口进阶后再看。

前置条件：装之前先对一下版本

插件形态有明确的最低 IDE 版本要求，版本太老会出现「装了但用不了」的情况（来源：官方文档）：

CLI 形态要求 Node.js 18.0 及以上，一条命令安装：

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

安装与登录：以 IDE 为例

进入官网顶部下载入口，选择 CodeBuddy IDE 的对应系统安装包，双击安装即可，流程和装普通桌面软件没有区别。IDE 支持 Windows 和 macOS。

1. 打开 CodeBuddy IDE，点击登录。
2. 用微信扫码或腾讯账号完成认证。
3. 进入主界面后，左侧是会话列表，点击加号可以新建会话，右侧可查看会话历史（官方 FAQ 提到的标准操作路径）。

选插件形态的话，在 VS Code 或 JetBrains 的插件市场搜索「腾讯云代码助手」安装，之后同样扫码登录。选 CLI 则在终端里执行上面的 npm 命令，国内站用 copilot.tencent.com，国际站用户走 codebuddy.ai 站点，两站账号体系独立。

第一次生成代码：从补全到 Agent 自动任务

建议按由小到大的顺序体验三件事，每件事都在验证上一层的成果：

1. 代码补全：在编辑器里写注释或函数名，CodeBuddy 会实时给出补全建议，体验版限免期补全不限次数，先把手感练出来。
2. 对话生成：在会话框描述需求，比如让它写一个读取表格并按列汇总的脚本，生成结果可以直接应用到文件里。
3. Agent 自动任务：把复杂需求整体交给它，IDE 会自动把任务拆解成可执行步骤、逐步完成并汇报结果。定价页显示体验版自动任务限免 99 个，付费后按档位从 15 个到 99 个不等。

验证是否跑通很简单：生成的代码能正常运行、输出符合预期，会话历史里能看到刚才的记录，整条链路就算正常。

进阶玩法：Figma 转代码与一键部署

IDE 形态的两条进阶路径值得专门留出时间试。一是导入 Figma 设计稿直接生成页面代码，保持设计与开发一致。这里有前置条件：官方 FAQ 明确需要先申请 Figma 的编辑和开发权限，因为 Figma 的查看权限默认不开放 API；开发侧只开通开发权限也可以，但需要在 Figma 网页先切普通模式再切开发模式。之后在 IDE 内选中图片加入会话即可。

二是接入 CloudBase、Supabase 等后端服务，从生成代码到数据库、登录鉴权配置再到部署上线，都能在 IDE 内闭环完成。官方还支持一键部署到 CloudStudio、EdgeOne Pages 等平台，并生成可公开访问的链接。

如果你还处在选型阶段，可以先看这篇 AI 编程工具怎么选 梳理需求，再决定要不要从 Cursor 与 Claude Code 的组合 迁移过来；零基础想补 vibe coding 的思路，也可以顺带读一下 vibe coding 入门。

免费额度与套餐：积分到底怎么算

先记住体验版的关键数字：每月 500 积分，代码补全 5000 次每月（限免期不限次），自动任务 3 个（限免期 99 个），可创建 5 个项目，每项目 3 人协作（限免期 5 人），模型调度用 Auto 模式但限免期全模型可选。

2026 年 7 月 1 日起，CodeBuddy 国内个人版升级为「标准 / 高级 / 旗舰」三档，完整价格与权益如下（来源：官方定价页）：

几条容易被忽略的规则，来自官方《积分说明》：

1. 积分按月发放，当月有效，不累积结转；赠送部分自到账日起 1 个月内有效。
2. 月会员有效期为新购当日到次月当日，年会员为当日起一个自然年；到期后账号月积分额度降为个人体验版额度。
3. 加量包是付费会员（标准版及以上）用完后补充的入口，规格为 1000 积分 / 50 元 / 1 个月有效期，没有常驻购买入口，只在积将耗尽时弹提醒。
4. 体验版原来的 500 积分自 2026 年 7 月 1 日起不再另行发放，开通付费会员后也不会再叠加。

企业侧另有两条线：SaaS 企业版 198 元/人/月或 2376 元/人/年（1 个坐席起购，含 2000 积分/人/月，积分团队内共享，对话问答不限频）；专有云企业版 316 元/人/月或 3792 元/人/年（100 个坐席起购）。如果是 2026 年 7 月 1 日前的付费老用户，官方给了过渡方案：已开启月付自动续费的享半年保价，2026 年 12 月 31 日前按 58 元/月续费，2027 年 1 月 1 日起按 70 元/月。当前官网首页还在挂「Deepseek-v4.1-flash 独家联合首发 9.10-9.23」的限时活动，资费随活动调整，下单前以官方定价页实时展示为准。

常见报错速查

以下 12 条整理自官网故障排除文档，都是真实高频问题，遇到时对号入座即可（来源：官方故障排除）：

需要反馈问题时，走帮助菜单里的「打开日志文件夹」，打包当天的 zip 一起发送。