codebuddy新功能需在ide国际版v2.4+、ide插件v3.2.0+或cli v2.1.0+中使用，核心能力包括craft模式、@workspace项目级问答、mcp扩展及模型切换，旧版本不支持。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
直接用最新版 CodeBuddy IDE 或插件就能体验全部新功能，不需要额外配置。关键是要选对入口、设对模式、给准上下文——不是所有功能在任意状态下都可触发。
确认你用的是支持新功能的版本
2026 年起，CodeBuddy 的核心能力（Agent 模式、项目级问答、MCP 扩展、Craft 自动执行）只在以下三种形态中完整可用：
- 独立 IDE：下载 CodeBuddy IDE 国际版（v2.4+），官网地址 www.codebuddy.ai；
- IDE 插件：IntelliJ 系列（IDEA/PyCharm 等）、VS Code 插件需更新至 v3.2.0 或更高；
- Cli 工具：全局安装 @tencent-ai/codebuddy-code@latest，命令行输入
codebuddy --version查看是否 ≥ 2.1.0。
旧版本（如 v2.0 以下插件或未升级的 Cli）无法调用 Agent 模式和 workspace 级问答，会提示“功能暂未启用”。
Unified LLM Gateway - One API for 70+ AI models. Route to GPT, Claude, Gemini, Qwen, Deepseek, Grok and more
下载
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
开启 Agent 模式（Craft 模式）的实操步骤
这是 CodeBuddy 区别于普通补全工具的核心——它能自主读文件、写代码、运行验证、迭代修复。启动方式很固定：
- 在 IDE 右侧 Chat 面板，点击顶部下拉菜单，选择 Craft 模式（不是 Chat 模式）；
- 输入明确目标，例如：“把当前项目中所有 Python 文件的函数都加上 Google 风格 docstring，并保存”；
- 它会自动列出要处理的文件、展示修改预览，按 Enter 确认执行，过程中不需人工干预；
- 若中途出错（比如某文件编码异常），它会暂停并说明原因，你只需回复“跳过该文件”或“用 utf-8 重试”，它继续执行。
使用 @workspace 实现项目级理解
想让 AI 看懂整个工程，不是靠“上传代码”，而是靠指令唤起上下文扫描：
- 在 Chat 输入框里，开头必须带 @workspace，例如：
@workspace 这个项目的数据流向是怎样的？入口 API 是哪个？； - 首次使用时，它会花 20–60 秒解析项目结构（中型项目约 3 万行），完成后生成
codebuddy.md缓存文件，后续提问响应更快； - 支持限定范围，比如：
@file src/utils/db.py 这个模块有没有连接泄漏风险？，它只分析该文件，响应更快更精准； - 如果回答有遗漏，直接追问：“再查一下 models/ 目录下的 init_db 函数调用链”，它会增量补充，不用重新扫描。
调用 MCP 和模型切换技巧
MCP（Model Calling Protocol）是 CodeBuddy 接入外部服务的关键通道，比如联网查文档、调用腾讯云 API、读取知识库：
- 在 Chat 输入框底部，找到 MCP 按钮（图标为两个齿轮套叠），点击后可启用“联网搜索”“CNB 知识库”“企业知识库”等扩展；
- 模型切换在右上角“Model”下拉菜单中，日常开发推荐 DeepSeek-V3（逻辑强），写文档或解释用 HunYuan-Turbo（语言自然）；
- 部分功能（如 Figma 转代码）需先开启 MCP 中的 “Design-to-Code” 服务，启用后上传 .fig 文件，它会自动生成 Vue/React 组件代码。
