CodeBuddy腾讯云代码助手

CodeBuddy是腾讯推出的一款AI云代码助手工具，更懂中国开发者的智能编程伙伴。其实现了插件、IDE及CLI三端覆盖，提供贯穿编码、扩展与协作的全栈开发生态；支持自然语言编程、多文件代码生成、智能补全及单元测试，帮助开发者心无旁骛，释放创造潜能。

CodeBuddy腾讯云代码助手集成DeepSeek与腾讯混元双模型，并兼容VS Code、JetBrains等主流IDE，覆盖超200种编程语言及框架。CodeBuddy IDE更致力于打通“产品-设计-研发部署”全流程，实现AI一体化开发。CodeBuddy为不同角色与场景提供专属解决方案，是助力开发者实现效率极致飞跃的理想工具。

软件功能

1、自然语言驱动的全流程开发

用户仅需用自然语言描述需求，如“帮我做一个电商网站”，AI 即可自动生成结构化的 PRD 文档、设计原型、前后端代码，并完成部署，实现从构想到上线的全流程自动化。

2、集成后端服务 & 一键部署

接入腾讯云 CloudBase 或 Supabase 等服务。几步之内将应用上线，实现从开发到部署的全流程自动化。

3、Figma 设计一键转代码

将 Figma 设计稿导入系统，自动生成对应的页面代码，确保设计与开发的一致性。

4、组件库与自然语言修改

预置组件库和预览效果，可通过自然语言对预览的页面元素进行二次修改，如调整样式、布局等，提升开发效率。

CodeBuddy概述

作为 CodeBuddy 的 Agent，能自动调用工具、运行终端命令，帮你完成复杂编码任务。

模式 包括 Craft 和 Chat 模式。Craft 模式用于自动帮你完成复杂编码任务；Chat 模式用于为你解答代码库以及其它编码技术问题。每种模式都有对应的功能和工具，你可以根据使用需求自由切换。

工具 Agent 支持自动调用工具进行搜索、读取、编辑并运行命令。从代码库的语义化搜索到终端命令执行，Agent 自动通过工具帮你完成复杂编码任务。

规则包括用户规则和项目规则，通过自定义规则来规范 Agent 的行为，可以为 Agent 定义编码规范、编码框架、项目专属约定等等。

应用更改 AI 给出代码建议后，可以通过 Apply 智能应用到代码库中。Apply 能在确保精度的同时高效处理大规模代码更改。

检查点 检查点是 Agent 对此轮对话的文件变更自动创建的一轮检查点，并自动做一轮版本化管理。当您需要回退 Agent 此轮对话所做的更改时，可以通过回退检查点来实现。

查看代码差异 Agent 对您的代码库进行代码更改后，在接受更改前可以审查这些代码差异。审查界面会以不同颜色的行来分别标记代码里”新增的部分“和”删除的部分“，方便您审查这些修改。

CodeBuddy Code 的 ACP 协议集成指南

ACP （Agent Client Protocol） 是 Zed 编辑器推出的一种通用智能体协议，使智能体的核心功能（服务端）和用户界面（客户端）解耦，允许用户自由选择不同的智能体服务端和客户端进行搭配使用。

CodeBuddy Code 原生支持 ACP 协议，可以作为智能体服务端与支持 ACP 的编辑器无缝集成。

1、快速开始

启动 ACP 模式

使用 参数启动 CodeBuddy Code 的 ACP 服务器：--acp

2、Zed 编辑器集成

配置步骤

打开 Zed 配置文件（），添加以下配置：~/.config/zed/settings.json

随后即可在 Zed 侧边栏创建 CodeBuddy Code Thread，开始使用。

3、配置说明

command： 指定 CodeBuddy Code 的命令路径（确保 在 PATH 中可用）codebuddy

args： 使用 启用 ACP 协议模式["--acp"]

env： 可选的环境变量配置，例如：

4、ACP 协议特性

工具代理机制

ACP 协议支持客户端代理部分工具作，提升性能和安全性：

文件作代理： 基于客户端的 和 能力fs.readTextFilefs.writeTextFile

终端作代理： 基于客户端的 能力terminal

当客户端声明支持这些能力时，CodeBuddy Code 会自动将相关工具调用代理给客户端执行。

命令列表推送

CodeBuddy Code 会在创建新会话时自动向客户端推送可用的 Slash 命令列表（），让客户端能够：available_commands_update

提供命令自动补全功能

显示命令提示和帮助信息

动态更新可用命令

命令列表会自动过滤掉本地命令（如 、）和客户端专属命令（如 、），只推送适用于 ACP 模式的命令。/clear/exit/theme/config

5、其他编辑器支持

ACP 是开放协议，理论上任何支持 ACP 的编辑器都可以集成 CodeBuddy Code。配置方式与 Zed 类似：

6、故障排除

连接失败

问题： Zed 无法连接到 CodeBuddy

解决方法：

确认 命令可用：codebuddy

测试 ACP 模式启动：

检查配置文件 JSON 格式是否正确

工具调用失败

问题：文件作或命令执行报错

解决方法：

检查工作目录权限

查看 CodeBuddy 日志

常见问题

1、如何查看本地日志？

点击帮助 ---> 打开日志文件夹来打开本地文件夹，找到今天的日志压缩包并发送。

2、远程 SSH “无法建立连接” 失败的解决方案

根据 VSCode FAQ 官方文档，从 1.99 版本开始，远程开发功能强制要求远程主机具有 glibc>=2.28。

3、如何选择并导入 Figma 图片到 IDE

开发者需要先申请 Figma 权限。点击相应图片，需要使用腾讯企业微信邮箱登录。使用时，按照下面的图片操作并添加到对话中。

4、如何创建新对话或查看对话历史

点击左侧的 + 按钮创建新对话，右侧显示对话历史。

5、在市场中搜索和安装插件时看到“版本不兼容”消息该怎么办？

在 IDE 设置中搜索“gallery”，然后配置 https://marketplace.visualstudio.com 并重启 IDE。

6、终端无法执行终端命令

错误如下，表示需要将 shell 集成开关设置为启用。在设置中搜索“shell”，启用终端集成 Shell 集成为启用。

7、无法安装 C/C++ 扩展

解决方案：安装特定的较低版本，或安装 clangd

8、如何配置主题？

点击主题，选择配置主题。可用的主题选项包括颜色主题、文件图标主题和产品图标主题。

9、如何通过终端中的命令快捷方式快速打开 IDE 开发窗口？

使用向上箭头 ↑ + Command + P 打开安装窗口，输入“buddy”安装 buddy，安装成功后，在终端中执行命令。

更新日志

v4.12.0.37847260版本

一、新增功能

新增多根工作区支持：一个窗口可以同时打开多个项目目录，AI 能同时理解每个项目的规则、技能与自定义命令，不必再反复开关窗口

新增统一的插件与 Skill 市场，浏览、搜索、安装、更新与卸载都在同一入口完成

新增禅模式（Zen Mode），一键隐藏编辑区与底部面板，专注与 AI 对话

历史会话支持批量管理：可勾选多条一键导出为 zip 或删除，单个文件与 zip 包均可导入，常用会话支持置顶

新增生图 / 生视频等高积分操作的前置确认，确认后才会执行，避免误触消耗积分

自定义 Agent 支持单独配置思考强度与思考开关，不再受全局设置限制

新增 PostToolUse Hook 支持，Hook 改写后的工具结果能被 AI 正确读取

新增 CloudStudio 已部署环境的查看与删除，部署记录可自助清理

模型选择器新增「打开配置文件」入口，一键打开并编辑本地模型配置

新增 Codebase Search（代码库检索）工具的启用 / 禁用开关

二、体验优化

优化长对话首轮的响应速度，开启新对话时等待更短

优化大项目的文件监听，避免系统监听资源被耗尽导致改动检测失效或界面长时间卡住

优化打开会话的加载速度，长会话的响应更迅速

优化消息列表渲染，消息较多时滚动与对话更流畅

优化会话标签首次切换的卡顿

优化大结果集与内存占用，降低长会话卡死和闪退的风险

处理 AI 改动时，点「保留」或「撤销」后自动跳到下一处待处理的改动

把终端里选中的内容添加到对话时，改为插入紧凑的引用胶囊，不再占用大段输入框

@ 引用文件列表把当前正在看的文件排在首位，以预览方式打开的文件也可被引用

@ 的 Git 上下文补齐最近提交列表，不再只有工作区改动

会话列表按最近活动时间排序，定时任务会话显示最近一次执行时间

子 Agent 数量较多时，底部成员栏折叠为「+N」，不再挤占对话区

打开含项目级 MCP 配置的项目时，先展示待确认清单，确认后才会启动对应服务

升级内置腾讯云 CloudBase 集成至 2.32.4，并支持配置工具超时时间

三、BUG修复

修复粘贴或恢复超长文本导致 IDE 卡死的问题

修复多窗口启动时偶发闪退的问题

修复 Windows 上最大化或改变窗口大小后整窗黑屏的问题

修复远程环境下聊天面板白屏、长时间卡在加载中的问题

修复部分会话打开后消息区空白的问题，单条消息缺失或损坏不再影响整段会话

修复聊天面板资源加载失败时一直停在「正在加载」、没有重试入口的问题

修复在 Agent 终端执行过构建命令后，其它 IDE 中的编译被安全删除机制拦截而失败的问题

修复同时启用部分第三方插件时，文件搜索报错、集成面板加载失败的问题

修复生成方案时反复弹出「扩展主机意外终止」并丢失对话的问题

修复长对话触发自动总结后任务直接中断的问题

修复模型把工具调用输出成纯文本时，任务静默中断并影响后续对话的问题

修复点过工具确认后，本轮剩余时间无法显示「暂停」按钮的问题

修复多标签页下点击「停止」需要等满数分钟才真正停止的问题

修复后台会话出错后切回看不到失败原因、消息「…」菜单错位的问题

修复后台会话的工具审批卡片不下发导致对话卡死、切换标签后授权弹窗不弹出的问题

修复 Windows 上用 Alt+Tab 来回切换窗口后，对话输入框失焦、无法直接打字的问题

修复 IDE 启动时输入框自动抢焦点、导致文件搜索内容被清空的问题

修复粘贴长文本后视图跳到对话顶部的问题

修复粘贴后按一次撤销会把此前输入的内容一起清空的问题

修复拖动输入框调高把手后，鼠标保持拖拽状态、界面无法选中和复制文字的问题

修复排队消息编辑后未修改内容时被误判为重复发送的问题

修复 Plan 任务列表与回复状态区的长文本不换行、需要横向滚动的问题

修复模式选择器提示气泡、Tokens 明细浮窗与模型下拉的显示异常

修复对话页字号可设置范围过大导致看不清或界面被撑坏的问题

修复远程开发时远端扩展宿主约每两分钟周期性卡顿的问题，重连、审批弹窗与发送状态一并恢复

修复远程连接卡在「正在打开远程」、主机名解析失败导致连接不上的问题

修复远程恢复会话后对话内容空白、首次启动卡在「登录中」的问题

修复多窗口连接同一台远程主机时，每个窗口都要重新输入密码的问题

修复远程开发且网络受限时，市场数据拉取失败反复重试、阻塞对话的问题

修复团队模式下成员汇报丢失，导致主 Agent 一直等待、任务无法结束的问题

修复自定义子 Agent 关闭自动执行后，点了「允许」命令仍不执行、任务一直卡住的问题

修复 Agents 窗口「自动运行」只生效一次、子 Agent 关闭自动运行后命令确认卡死的问题

修复连续执行多条命令时命令行一直不退出、最终报参数过长的问题

修复命令执行失败时输出被丢弃、AI 看不到失败原因的问题

修复 Windows 上执行含中文的命令时输出乱码的问题

修复子 Agent 最终结果过长时被截断或变成空白的问题

修复子 Agent 调用失败时只显示笼统错误、看不到真实错误码的问题

修复子 Agent 卡片的调用方式在中文界面下显示为英文的问题

修复自定义 Agent 无法创建和调度 Agent Team 的问题

修复 MCP 服务描述过长时子 Agent 调用失败的问题

修复写入大段内容时界面卡住、取消后留下空文件或半截文件的问题

修复批量写入文件排队时误报超时、大批量写入卡住的问题

修复 AI 通过终端命令删除文件时，文件变更列表不刷新的问题

修复终端命令生成的文件不出现在文件变更列表、无法一键保留或撤销的问题

修复已删除文件在变更列表里无法查看差异、与「查看变更」内容不一致的问题

修复会话内新建又被删除的文件残留在变更列表的问题

修复登录或切换账号后文件变更面板失效、需要重启 IDE 的问题

修复回撤提问后旧方案仍参与后续对话、方案快照文件残留的问题

修复读取空文件时提示「文件过大，无法一次读取」的问题

修复部分历史会话文件因字数统计异常而无法导入的问题

修复自定义 / 第三方模型思考强度不生效、部分推理模型报 400 错误的问题

修复自定义模型与内置模型同名时，会话里选中的模型被反复改写的问题

修复管理员已禁用的模型仍被自动选中的问题

修复切换工作区后模型列表不按当前仓库的管控策略刷新的问题

修复企业账号「不限量」时积分余额显示为负数、误报积分不足的问题

修复积分余额显示异常、网络超时后一直显示错误余额的问题

修复刷新登录凭证期间偶发被误判为已登出的问题

修复网络请求、增强提示词与内联对话出错时只显示笼统提示、看不到真实原因的问题

修复 Hook 拦截输入后点「重试」仍会绕过拦截的问题

修复配置多个「提交提问时」触发的 Hook 时只有最后一个生效的问题

修复 AI 删除文件时的确认规则自相矛盾的问题

修复 Windows 上以管理员身份启动时 MCP 授权回调失败的问题

修复 Skills 触发字符不支持中文标点的问题

修复图像生成、语言服务开关在设置面板中修改后不生效的问题

修复自动化任务窗口的模型列表未按可用范围过滤的问题

修复新建自动化任务时被上一个会话的输出拉回旧界面的问题

修复 Windows 上系统安全策略拦截数据库组件时，自动化任务报错无法理解且必须重启 IDE 的问题

修复通过 /import 链接导入时因参数重复编码导致下载报错的问题

修复有工作正在进行时更新提示弹出打断用户的问题