腾讯 CodeBuddy 是腾讯云推出的一站式 AI 编程助手，旨在通过“Vibe Coding”理念提升开发效率，支持 IDE 插件、CLI 命令行工具等多种形态。以下是其核心使用指南：
1. 安装与接入
CodeBuddy 提供多种接入方式，开发者可根据习惯选择：
- IDE 插件版：支持 VS Code、JetBrains 系列（如 WebStorm、IntelliJ IDEA）。在插件市场搜索“Tencent Cloud CodeBuddy”或“CodeBuddy”安装即可。重启编辑器后，登录账号即可在侧边栏看到入口。
- CLI 命令行版：适合习惯终端操作的开发者。通过 npm 全局安装：
npm install -g @tencent-ai/codebuddy-cli。安装后在终端输入codebuddy即可启动，支持微信、GitHub 或 Google 账号登录。 - Web 端/独立 IDE：部分版本提供基于浏览器的在线开发环境或独立客户端，直接访问官网即可使用。
2. 核心功能模式
CodeBuddy 通常包含以下几种交互模式，对应不同的开发场景：
- Chat（对话模式） ：用于日常代码解释、技术问答、生成代码片段或单元测试。适合解决具体的编程疑问。
- Craft（实干/生成模式） ：这是 CodeBuddy 的核心亮点。用户输入自然语言需求（如“做一个贪吃蛇游戏”或“还原这个 Figma 设计稿”），AI 会自动规划、生成多文件代码并直接运行预览。它支持从需求分析到代码落地的全流程。
- Code Review（代码审查） ：自动检查代码规范、潜在 Bug 和安全漏洞，提供优化建议。
- Unit Test（单元测试生成） ：根据现有代码逻辑，自动生成覆盖率高、结构合理的测试用例。
3. 特色实战场景
- Figma 设计稿还原：
在 Craft 模式下，CodeBuddy 支持直接连接 Figma。登录后选中设计稿，AI 能高精度还原 HTML/CSS 代码，保留布局、样式甚至部分交互逻辑，大幅缩短前端切图时间相比传统工具，其还原度在行业内处于领先水平。 - 全栈应用生成：
输入如“帮我做一个个人介绍主页”或“2048 小游戏”，CodeBuddy 会自动生成项目结构、HTML、CSS、JS 文件，并启动本地服务器供预览。它还能处理端口冲突等部署问题，自动调整配置。 - 项目初始化与维护：
在 CLI 中，使用/init命令可让 AI 分析现有项目结构，生成codebuddy.md上下文文件，以便后续更准确地进行代码修改和功能迭代。
4. 使用技巧与最佳实践
- 指定工作目录：在使用 Craft 模式生成代码前，建议在 IDE 中先打开或指定一个文件夹路径。否则生成的文件可能散落在临时目录，难以查找。
- 模型切换：CodeBuddy 支持切换底层大模型（如 Claude、DeepSeek、混元等）。在 CLI 中可通过
/config或/model命令切换；在 IDE 中通常在设置或对话框顶部选择。不同模型在代码逻辑和创意生成上表现各异，可根据任务类型选择。 - 截图胜过千言万语：遇到 UI 布局或报错问题时，直接截图发送给 CodeBuddy，往往比文字描述更高效。AI 能识别界面元素或错误日志，给出精准修复方案。
- 语言设置：若界面为英文，可通过命令面板（VS Code 中按
Cmd+Shift+P或Ctrl+Shift+P）输入Configure Display Language切换为中文。 - 迭代优化：生成的代码若不完全符合预期，可通过多轮对话进行微调。例如，“把按钮改成蓝色渐变”或“修复左上角方块固定不动的 Bug”。保持指令清晰、具体，有助于获得更好结果。
5. 注意事项
- 端口冲突：自动部署时若遇到端口占用（如 8000、3000），AI 通常会尝试自动切换，但手动指定空闲端口更稳妥。
- 复杂逻辑验证：对于游戏逻辑或复杂算法，AI 生成的代码可能存在细微 Bug（如随机数生成位置错误）。建议开发者在生成后进行人工测试和关键逻辑审查。
- 网络与权限：使用 Figma 集成或联网搜索功能时，需确保网络通畅并授权相应权限。
通过以上步骤，你可以充分利用 CodeBuddy 实现从灵感构思到代码落地的加速，体验“1% 提示词 + 99% AI 执行”的高效开发流程。
