Qwen Code VS Code 集成指南:3分钟装好 Companion 扩展,AI 编码助手就坐在编辑器里
【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code
Qwen Code 原本是个住在终端里的 AI 编码助手,做完 VS Code 集成之后,你不用再在两个窗口之间来回切:Qwen 的改动直接出现在编辑器里,可以逐行 diff 审阅,也能让它自动应用。这篇文章把 Qwen Code Companion 扩展在 VS Code 里的安装和使用完整走一遍,从环境自查、认证、喂上下文,到少踩的坑,读完大概 5 分钟。
💡 终端和 IDE 割裂的痛点,VS Code 集成补上了
在终端里用 Qwen Code 很顺,但有一个绕不开的体验问题:AI 给出的改动,你得切到编辑器里自己去看。改了哪几行、上下文对不对,来回切窗口很容易断片。
VS Code 集成解决的就是这件事:Qwen Code Companion 扩展在 VS Code 里挂了一个专属侧边栏面板,会话、文件变更、历史记录都在一起。改动以原生 diff 视图呈现,可以逐行审阅、手动微调,也可以接受或拒绝。
对习惯终端的人来说,这相当于把 AI 助手搬进了编辑器,不用再复制粘贴当传声筒。
📦 环境自查与三分钟装好
装之前先自查三件事:
- VS Code 1.101.0 或更高版本(Cursor 等 VS Code 系编辑器同样可用)
- Node.js 20 或更高版本
- 本地网络可以访问 npm 仓库
一条命令装好 CLI:
npm install -g @qwen-code/qwen-code@latest终端里运行qwen能正常启动就行。
接着在 VS Code 扩展市场搜 "Qwen Code Companion" 并安装。扩展是打包好的,装完不需要额外配置,官方说明见 Qwen Code Companion 扩展文档。
🔑 一次 /auth 完成登录
认证放在 CLI 里做,不在扩展里。新开一个会话,输入:
/auth系统会引导你走一遍 Qwen OAuth 登录流程,凭据存在本地,CLI 和扩展共用,登录一次之后不用重复。过期了就重跑这条命令。
📎 把上下文喂给 Qwen Code
它写得好不好,很大程度取决于它看不看得到你的项目。VS Code 集成给了三种喂上下文的方式:
- @ 提及文件:输入框里打
@再输入路径,那个文件的内容直接进上下文,不用复制粘贴。 - 附加文件和图片:用系统文件选择器附上报错截图、日志文件。"看看这个报错"比用文字描述快得多。
- 光标与选中:当前打开的文件、选中的代码段会自动带入上下文。
一个值得养成的习惯:问 bug 之前先把出问题的代码选中再提问,它会直接定位到点子上。
🔀 diff 对比、自动接受与多会话
Qwen Code 改代码时,变更直接落在 VS Code 原生 diff 视图里。默认是人工确认:逐行看,手动改一点再接受,或者整份拒绝。
信任某个任务的话,可以打开自动接受编辑模式,改动一产生就落地。比如"把整个仓库的这个工具函数换个实现"这类批量重构,速度会明显快一截。
两个任务并行时,不用挤在一个会话里排队。Qwen Code 支持多会话同时运行,历史面板里也能回看旧对话:一个会话修 bug,另一个写单测,互不打扰。
🩹 常见问题速查
- 扩展装不上:确认 VS Code 是 1.101.0 以上,确认有安装扩展的权限;仍不行就改从市场网页直接装。
- 会话没响应:先查网络,再开一个新会话重试。
- 认证过期或提示未登录:重跑
/auth刷新凭据。 - 改动没在编辑器里显示:确认当前在对应工作区的会话上,多会话的视图是独立的。
相关资源
- 官方 VS Code 集成文档
- Companion 扩展说明与命令列表
- 快速入门指南
装完这套流程后,建议把一个小任务丢进侧边栏,实际感受一遍在编辑器里审阅改动的节奏。
【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考