CodeBuddy Code 教程：腾讯自研终端 AI 编程上手（2026）
发布于 2026年6月23日
如果你在找一款能在终端里用自然语言驱动开发、又不用翻墙的 AI 编程工具，腾讯自研的 CodeBuddy Code 值得一试。它被不少人称作「中国版 Claude Code」——同样是命令行里的 AI 智能体，能读你的代码库、改文件、跑命令，而且国内直连、上手成本低。这篇 CodeBuddy 教程带你从安装、登录到三种使用模式走一遍。
CodeBuddy Code 是什么
CodeBuddy 是腾讯云出品的 AI 编程助手，已经发展成一个产品矩阵，包含三种形态：IDE 插件、独立 IDE，以及本文要讲的命令行工具 CodeBuddy Code（CLI）。CLI 版面向真实开发流程，支持在终端里用自然语言完成代码生成、调试、测试到部署的多个环节。
- 插件：装进 VS Code / JetBrains，做补全和对话
- IDE：腾讯自研的 AI 代码编辑器
- CLI（CodeBuddy Code）：终端里的 AI 智能体，本文主角
安装
前置条件
需要 Node.js 18.0 及以上版本。没装的话先去 nodejs.org 装 LTS 版，再执行下面的命令。
bash
# 全局安装
npm install -g @tencent-ai/codebuddy-code
# 验证安装成功（能打印版本号即可）
codebuddy --version首次登录
进入任意项目目录，运行 codebuddy 启动。首次使用会弹出登录方式选择界面，按提示完成账号认证后即可进入交互会话。
bash
cd 你的项目目录
codebuddy
# 首次启动按提示选择登录方式并完成认证三种使用模式
| 模式 | 怎么用 | 适合 |
|---|---|---|
| 交互对话 | 运行 codebuddy 进入会话，连续多轮对话 | 边聊边改、探索式开发 |
| 单命令 | 一句话下达一个明确任务，执行完返回 | 脚本化、自动化场景 |
| 项目级操作 | 让它读懂整个仓库后做跨文件改造 | 初始化项目、批量重构、加功能 |
最常见的用法就是在项目根目录运行 codebuddy 进入交互模式，然后像和同事说话一样描述需求，比如「给这个登录接口加上失败重试」「把所有 console.log 换成统一的日志函数」，它会读相关文件、给出改动并执行。
和 Claude Code 比有什么不一样
| 维度 | CodeBuddy Code | Claude Code |
|---|---|---|
| 厂商 / 模型 | 腾讯自研 | Anthropic（Claude） |
| 国内直连 | 原生支持，无需代理 | 需要解决网络与支付 |
| 交互形态 | 终端 CLI，三种模式 | 终端 CLI |
| 中文场景 | 中文需求理解、文档完善 | 英文生态为主 |
迁移几乎零成本
如果你已经习惯 Claude Code 的「在终端里指挥 AI 改代码」这套心智模型，切到 CodeBuddy Code 几乎不用重新学——核心交互方式是相通的，差别主要在登录方式和背后的模型。
常见坑
- Node 版本过低：低于 18 会安装失败或启动报错，先 node -v 确认。
- 全局安装权限：macOS / Linux 若提示权限不足，别直接 sudo，优先用 nvm 管理的 Node 避免权限问题。
- 在错误目录启动：要在项目根目录运行 codebuddy，它才能正确读到你的代码库上下文。
- 免费政策会变：限免 / 额度等商业政策可能调整，以官方文档和控制台显示为准。
装好 CodeBuddy Code 只是第一步，真正拉开差距的是会不会用它把需求拆清楚、把项目稳稳推进到上线。IMAI 的系统课从工具配置讲到提示词工程、再到完整的终端 AI 编程工作流，配合视频实操和可复制的提示词，帮你把「会装工具」变成「会用 AI 做出东西」。
想系统学会用 AI 编程,从入门到做出真实产品?
查看系统课程