企业官网建设流程全解析

如何在 VS Code 里用上 Qwen Code：一条最短路径的 VS Code 集成指南

【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code

改完代码要在终端和编辑器之间来回切窗口，AI 助手给的 diff 还得手动比对？Qwen Code 是跑在终端里的 AI 编码助手，装上 VS Code Companion 扩展后，它直接长进你的 VS Code：侧边栏对话，改动以红绿 diff 的形式预览在编辑器里。这篇带你走完从安装到认证、再到发出第一条指令的全流程，全程不到 10 分钟。

🚀 最快安装路径：装扩展 + 一条命令完成登录认证

先确认环境：VS Code 1.96.0 以上，Node.js 20 以上。

第一步，装 CLI：

npm install -g @qwen-code/qwen-code@latest

装完跑qwen --version，能看到当前版本号（例如 0.22.3）就算成功。

第二步，装扩展：在 VS Code 扩展市场搜 "Qwen Code Companion" 安装。它把 CLI 一并打包在内，不用再装别的。装完重启 VS Code，编辑器标题栏右上角会多出一个 Qwen 图标，点它打开侧边栏对话面板。

第三步，完成认证：在项目目录里直接输入：

qwen

首次启动会弹出认证菜单，选一个模型提供商，按提示完成登录即可。认证只做这一次，后面 VS Code 里直接用。之后想换方式输入/auth，想检查当前配置输入/doctor，随时都能做。

做完这三步，你就有了：一个能输版本的终端 CLI、一个能打开的侧边栏面板、一次已生效的登录。

🧪 三个高频场景，照着做就能用

让 AI 重构一段函数

选中一段回调地狱，在侧边栏输入"把这段函数重构成 async/await"。Qwen Code 会在 VS Code 的 diff 视图里展示改动，红删绿加，你扫一眼确认无误，点"接受"，或者用命令面板里的 "Qwen Code: Accept Current Diff"。不想改就关掉 diff，文件原样不动。整个过程不用离开编辑器。

解释一个陌生仓库

接手新项目时，在仓库根目录打开 VS Code，侧边栏直接问"解释一下这个项目的目录结构和入口文件"。它会按需读取文件，给你一份带文件路径的地图；接着问"登录逻辑在哪个文件"，回答里会指到具体文件和行号。读源码之前先让它带路，能省不少瞎翻的时间。

@文件 补充上下文

让 AI 改登录接口时，输入框里打 @ 可以搜索并附加相关文件；也可以走系统文件选择器挂文件和图片。多文件联动的需求，把相关文件都挂进去，比让它自己去猜准得多。另外，打开中的文件和光标选中的文本都能作为上下文共享，让回答更贴近你当前正在看的东西。

⚠️ 避坑清单

现象：装完扩展，编辑器里找不到 Qwen 图标。原因：VS Code 版本低于 1.96.0。 解决：升级 VS Code，重启后图标即出现。

现象：AI 的回答对不上你当前正在看的代码。原因：它并不总能自动感知你的上下文。 解决：把目标文件打开，或选中相关代码再提问。

现象：发消息后长时间无响应。原因：多数是认证或网络问题。 解决：终端里跑一次/doctor看配置，确认网络后开一个新会话重试。

现象：聊了很久，回复变慢、耗 token。原因：历史消息越堆越长。 解决：输入/compress压缩聊天记录。

延伸路径

• 官方 VS Code 集成文档：docs/users/integration-vscode.md
• 通用快速入门：docs/users/quickstart.md
• 扩展源码，想深挖命令和事件逻辑可看这里：packages/vscode-ide-companion/

【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code