我是小虎，浙江大学计算机本硕，专注AI编程。
这几天我的学习群里有人在问“怎么开始学习”？
虽然之前我写过一篇文章[【全集】CodeBuddy新手从0到1，保姆级AI编程指南，万字长文，建议收藏]
讲解了0 - 1，但缺少1 - 100。
今天，我会把CodeBuddy从安装到功能，从工作流到进阶技巧，掰开揉碎倾囊相授，带你一步步走向AI编程高手之路。
第一部分：CodeBuddy概述与理念
1.1 什么是CodeBuddy？
CodeBuddy是腾讯推出的国产AI编程工具，它不仅仅是一个代码补全工具，而是一个真正理解你代码库的智能编程伙伴。
核心特点：
- 中文自然语言交互：直接使用中文描述需求，像和朋友聊天一样编程
- 可视化操作界面：告别纯黑命令行窗口，清爽界面所见即所得
- 全栈开发能力：从前端到后端，从数据库到云端部署一体化
- 智能错误修复：自动检测并尝试修复错误，像耐心老师一样指导
- 云端部署一体化：无缝集成腾讯云，一键部署生成可分享网址
与其他工具的区别：
- vs 传统****IDE：不只是编辑工具，而是智能开发伙伴
- vs 其他AI助手：更深度的代码库理解，更完整的开发流程支持
- 国产化优势：支持微信登录，更好的中文支持，本地化服务
1.2 CodeBuddy的核心理念
代理式编程（Agentic Coding）
- 传统编程：你告诉计算机如何做
- 代理式编程：你告诉CodeBuddy做什么，它自己想办法如何做
# 传统方式
git checkout -b feature-auth
mkdir src/auth
touch src/auth/login.js src/auth/register.js
# ... 更多手动步骤
# CodeBuddy方式
codebuddy "创建一个用户认证功能，包括登录和注册"
人机协作新模式
- 你负责：需求定义、架构决策、代码审查
- CodeBuddy负责：代码实现、测试编写、文档更新
终端原生哲学
CodeBuddy选择终端而非GUI的原因：
- 速度：命令行操作更快
- 自动化：易于脚本化和流水线集成
- 灵活性：可以与任何编辑器配合
- 可控性：更好的权限管理
第二部分：安装与环境配置
2.1 系统要求
支持的操作系统：
- macOS 10.15+ (推荐 macOS 12+)
- Linux Ubuntu 18.04+, CentOS 7+, 或其他现代发行版
- Windows Windows 10+ (通过 WSL2 推荐)
必要依赖：
- Node.js 16+ (用于某些MCP服务器)
- Git 2.20+ (版本控制集成)
- 终端支持 UTF-8 编码
2.2 安装步骤
方法一： npm****全局安装（推荐）
# 全局安装CodeBuddy Code CLI工具
npm install -g @tencent-ai/codebuddy-code
# 验证安装
codebuddy --version
方法二：官方安装脚本
# 访问官方文档获取最新安装方式
# 通常包含自动下载和配置
方法三：手动安装
- 访问GitHub Releases页面
- 下载对应平台的二进制文件
- 添加到系统PATH
2.3 初始配置
首次启动与登录：
# 在项目目录启动
cd your-project
codebuddy
# 选择登录方式
# - 国际版：Google/GitHub登录
# - 国内版：微信登录
API密钥配置：
# 第一次运行会自动引导配置
codebuddy
# 手动配置（如有需要）
codebuddy config set api-key YOUR_API_KEY
基础设置优化：
# 设置默认编辑器
codebuddy config set editor code # VS Code
codebuddy config set editor vim # Vim
# 配置Git集成
codebuddy config set git-auto-commit true
codebuddy config set git-commit-style conventional
# 设置工作目录偏好
codebuddy config set workspace-detection auto
2.4 IDE集成
VS Code扩展配置
# 安装官方扩展
code --install-extension codebuddy.codebuddy
# 配置扩展设置
{
"codebuddy.apiKey": "your-api-key-here",
"codebuddy.model": "gemini-2.5-pro",
"codebuddy.autoComplete": true
}
第三部分：基本工作流 - 从想法到运行
在我超过二十年的开发经验里，最大的心得是——不要一上来就写代码，而是先把你的需求讲清楚，让工具替你跑腿。CodeBuddy就是这个听话的“跑腿程序员”。
3.1 基本开发流程
步骤 1：定义需求
在CodeBuddy里，你只需要用自然语言告诉它你想实现什么。例如：
"创建一个简单的网页，显示当前时间，并每秒刷新"
它会帮你生成HTML、JavaScript文件，并做好目录结构。
步骤 2：查看与修改代码
CodeBuddy生成的代码会直接保存在你的项目文件夹中，你可以用VS Code、Vim或其他编辑器打开。
code .
如果你觉得风格不合适，可以再告诉CodeBuddy修改：
"将网页的背景改成渐变蓝色"
步骤 3：运行与测试
对于Web项目，直接打开index.html即可看到效果。 对于Node项目，可以运行：
node index.js
如果遇到错误，不用自己查半天StackOverflow，只需告诉CodeBuddy：
"修复运行时报错：xxx"
它会帮你定位并尝试修复。
步骤 4：部署到云端
"部署到腾讯云并生成访问链接"
你会得到一个可以分享的网址，这意味着你的作品已经上线了。
3.2 代码管理与版本控制
我建议无论是练习还是正式项目，都建立Git仓库，这样修改记录清晰、回退方便。
初始化Git：
git init
让CodeBuddy自动提交：
codebuddy config set git-auto-commit true
每次生成或修改代码，它都会帮你记录版本。
3.3 示例：完整的“Todo清单”
我的一个教学案例是“Todo清单”，因为它同时包含前端交互、数据存储和基本逻辑，非常适合入门。
"创建一个网页Todo清单，支持添加、删除任务，并将数据保存在浏览器本地存储"
运行后，你会得到一个带输入框、任务列表、删除按钮的网页。想让它更漂亮？直接下命令：
"使用简洁的CSS布局，并让任务项有淡入淡出动画效果"
这样，你不仅学到了功能实现，还学到了界面优化思路。
第四部分：进阶功能与MCP服务器
当你掌握了基础交互，就可以开始利用CodeBuddy的MCP****服务器（Multi-Capability Plugin Server）。
4.1 为什么需要MCP？
简单来说，MCP让CodeBuddy的能力不仅限于生成代码，还能访问数据库、调用API、读写文件等——相当于给它装上“外挂模块”。
4.2 配置MCP服务器
假设你想让CodeBuddy直接访问N8N MCP，你可以这样做：
帮我创建一个n8n工作流，有AI Agent节点，使用GPT-5大模型，可对外提供HTTP调用
它会生成连接代码、执行查询，并返回结果。
4.3 常用MCP插件举例
- 文件操作插件：让CodeBuddy批量整理文件
- API调用插件：让CodeBuddy直接请求外部数据
- 数据可视化插件：自动生成图表
这些功能在做数据分析和全栈项目时特别有用。
第五部分：AI协作与团队开发
我很推崇用CodeBuddy进行多人协作，因为它能减少沟通成本。
5.1 团队模式
通过共享项目目录和配置文件，每个成员的CodeBuddy会保持一致环境。
codebuddy config list
# 其他成员导入
codebuddy config add <key> <values...>
5.2 PR自动生成
你可以让CodeBuddy直接帮你生成Pull Request说明：
codebuddy "生成本次修改的PR说明，包含变更摘要和测试说明"
这样可以节省大量文档撰写时间。
第六部分：常见错误与解决方案
6.1 权限问题
现象： 安装或运行时报Permission denied
解决： 使用sudo或调整目录权限。
sudo npm install -g @tencent-ai/codebuddy
6.2 网络问题
现象： 登录或调用API超时。
解决：
- 确认网络能访问腾讯服务器
- 尝试使用国内版或代理
6.3 代码生成不符合预期
解决：
- 明确需求：多用限定词，如“使用ES6”、“布局采用Flexbox”
- 分步骤生成：先功能，再优化界面
第七部分：练习路线 - 从小白到高手
为了让你稳步提升，我设计了一个简化版训练路线图，每天花1小时，30天能从零到可以独立做简单全栈项目。
第1-7天：熟悉工具
- 学会启动CodeBuddy
- 练习用自然语言生成HTML、CSS、JS
- 玩转Todo清单项目
第8-14天：掌握版本控制和部署
- 建立Git仓库
- 自动提交与版本管理
- 部署到腾讯云
第15-21天：进阶功能
- 安装和使用MCP插件
- 调用外部API并显示数据
- 生成基本图表
第22-30天：综合项目
- 设计一个完整的Web应用（如在线记事本）
- 包含前端交互、后端API、数据库
- 完成上线并分享
第八部分：结语
作为一个从C语言、Java、Python一路走过来的程序员，我可以负责任地说：
CodeBuddy是我见过对中文用户最友好的一款AI编程工具，如果你跟着这份指南坚持练习，不仅能掌握它，还能真正进入AI编程新时代。
如果你也想学习编程，欢迎联系小虎进CodeBuddy学习群。
更多阅读：
- [如果不是女儿讨厌英语，我可能永远不会发现AI编程的这个秘密。]
- [CodeBuddy运行报错的三种原因与解决方法]
- [深度长文 | AI编程CodeBuddy实战全流程：从需求到上线，小白也能看懂的“造物”之旅。]
- [CodeBuddy实战：小白8个步骤搞定程序部署到云服务器，附AI编程提示词+保姆级教程]
- [CodeBuddy实战：我用一场对话，化解了云服务器的“暴力破解”危机]
- [【CodeBuddy实战】一个AI编程提示词，我打通了公众号文章到RPA自动发送的“最后一公里”]
- [CodeBuddy实战：拆解一个真实商业项目的全过程【第一集】]
- [CodeBuddy使用界面全解析：第一次打开该怎么看]
- [70后大叔硬核独白：我为什么决定死磕腾讯CodeBuddy日更一年]
- [【全集】CodeBuddy新手从0到1，保姆级AI编程指南，万字长文，建议收藏]
Hey，大家好！我是小虎，浙江大学计算机本硕，专注AI编程。
每天2条朋友圈，分享AI编程干货。（很多不方便公开讲的都在朋友圈里）
