CodeBuddy 安装与上手：插件、IDE、CLI 怎么选怎么装

先选端：三种形态怎么挑

装之前先想清楚要在哪种环境里写代码，选错端会带来不必要的迁移成本。

• 已有成熟配置的 VS Code 或 JetBrains 用户——装插件，不动现有生态。
• 想要开箱即用、愿意用新编辑器——装 CodeBuddy IDE。
• 常在终端里工作、要跑脚本或做批量任务——用 CLI。

三者不互斥，可以先装插件，用顺了再补 CLI。

装 VS Code 插件

1. 打开扩展面板，搜索 CodeBuddy 并安装。
2. 安装完成后侧边栏会出现入口，点击进入并登录。
3. 按提示完成授权，回到编辑器即可开始对话。

如果登录后界面没有反应，先重启编辑器；仍然不行再确认插件版本与编辑器版本是否匹配。

装 JetBrains 插件

在 IntelliJ IDEA、PyCharm、WebStorm 等编辑器的插件市场里搜索安装，重启后登录即可。适合以 Java、Python 或全栈项目为主、不想换编辑器的人。判断标准和上面一致：能留在原环境就别迁移。

CodeBuddy IDE

不想折腾插件的话，直接下载 CodeBuddy IDE，安装后登录就能用全部模式，界面围绕对话和任务组织。它更适合把 AI 当主力开发方式的人；如果你高度依赖某个编辑器专属插件，先留在插件端更稳。

CLI：npm 安装与首次 /init

1. 用 npm 全局安装，安装完成后在终端输入 codebuddy 启动交互界面。
2. 进入项目目录后先执行 /init，让它建立项目知识图谱。首次使用或项目大改之后都建议重跑一次，后续回答和改动会准确很多。
3. 单次任务可以用 codebuddy -p "你的需求"；当它需要读写文件或执行命令时加 -y。
4. 权限模式用 Shift+Tab（macOS / Linux）或 Alt+M（Windows）切换。

第一次对话：快捷键与 @ 引用

• 内联对话：⌘+I（macOS）/ Ctrl+I（Windows），在光标处直接提问或改这一段代码。
• 侧边栏：Ctrl+⌘+I / Ctrl+Win+I，适合较长对话和多轮任务。
• @ 引用：用 @ 指定文件、文件夹或代码片段，把上下文明确交给它，比让它自己猜准得多。
• 也可以直接粘贴截图，或导入 Figma 链接作为输入。

装完先做三步验证，顺便避开常见卡点

1. 在 Ask 模式问一个关于当前项目的问题，确认它能读到文件。
2. 用 @ 引用一个文件，让它解释这个文件的职责，看引用是否生效。
3. 在单行代码上按内联快捷键，提一个最小改动，确认改动只落在预期位置。

三个高频问题也一并记下：回答泛泛而谈，多半是上下文没给全，用 @ 指定文件再问；CLI 反复要授权，确认是否漏了 -y，同时留意它究竟在改哪些文件，别默认放行；不知道装哪个，先用插件跑一周，有明确痛点再考虑 IDE 或 CLI。

接着往下

装好只是开始，下一步是搞清三种模式各自适合什么任务。想找配套工具去工具库，系统学习路径看学习中心。本文截至 2026-11，安装方式与快捷键以官方文档为准。