5分钟装好并跑通 Qwen Code：AI 编码助手实操教程

5分钟装好并跑通 Qwen Code：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 Code 是一个 agent 型 AI 编程伙伴：你在终端里下达指令，它负责找文件、提出改动、执行前征求你的批准。它不止是代码生成器，还带自动记忆、技能、子代理等能力，开箱即用。除终端外，它还能以 IDE 插件、桌面应用、SDK 的形式工作。核心优势：

• 开源无锁定：框架与模型都开源，可自由替换供应商
• 多协议：OpenAI、Anthropic、Gemini、Qwen 接口运行中可切换
• 多会话并行：每个会话上下文独立，互不干扰
• Git 对话化：建分支、提交、解冲突用自然语言完成

装好它

前置条件：一个终端（bash / zsh / PowerShell 均可）和稳定网络；若改用 npm 方式安装，需 Node.js 22 及以上。

官方推荐一键脚本，Linux / macOS 执行：

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

Windows 用户用官方对应的 PowerShell 脚本。装完重启终端，验证：

qwen -v

能打印版本号即成功。首次运行qwen时按提示执行/auth，选择模型供应商并填入 API key 即可。

上手第一遍

在项目目录下运行qwen进入交互界面，第一次走这条流程：

1. 输入@加文件名，文件内容即成为上下文；也可以直接问"解释一下这个目录结构"，它会按需自己读文件。
2. 下个小任务，例如"给主文件加一个 hello world 函数"。它会先定位文件、展示 diff，经你确认后才落盘——所有文件修改都有批准环节。
3. 想省事可以在会话里开启全部接受模式。
4. 手头有多个任务时，另开会话分别处理：一个重构、一个修 bug，历史记录与上下文互不串扰。

Git 操作同样对话化："创建一个叫 feature/quickstart 的分支""把改动提交掉""帮我解决合并冲突"，直接说即可。

值得了解的进阶能力

内存表现

长时流式输出曾容易导致 OOM。优化后，SSE 压力测试中堆内存从 512 MiB 限制内爆掉，降到稳定在 100-130 MiB，任务持续时长从不足一分钟提升到约三倍。

工作区管理

同时管多个项目时，可把目录注册为工作区并设置展示名称；开启"服务重启后保留"，配置持久化到守护进程，重启后不丢。

分支与 worktree

界面里可直接选择在主分支上开发、从 main 新建分支，或启用隔离的 worktree 并行跑任务，省去来回切分支的麻烦。

遇到问题先看这里

• VS Code 扩展装不上：多半是版本低于 1.96.0 或网络受阻。先核对版本，再从 Marketplace 直接安装，重启 IDE。
• 对话无响应：API key 过期或断网。运行/doctor检查当前认证与环境，再开新会话试一次。
• 建议不准：上下文不足。用@引用相关文件，说明语言与框架，附上报错日志。
• Token 消耗快：历史太长。用/compress压缩聊天历史，只挂必要文件，描述尽量精简。
• 生成代码不敢直接收：盲目信任是最大风险。逐行看 diff 再批准，判断权留给自己。

想继续深入，读 快速开始文档 了解完整命令表；要接入编辑器，看 VS Code 集成指南。

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