Qwen Code 快速上手:3 步在终端装好开源 AI 编码助手 📅 发布时间:2026/9/4 13:36:10 👁 浏览次数: Qwen Code 快速上手3 步在终端装好开源 AI 编码助手【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-codeQwen Code 是一个开源的终端 AI 编码助手面向需要读代码、改代码、跑 Git 的开发者。它直接运行在你本地的仓库和 shell 里按需读取文件、执行命令、编辑代码支持 OpenAI、Anthropic、Gemini、Qwen 等多家 API 协议也兼容 Ollama、vLLM 本地模型供应商可以在运行时切换。定位驻留在终端里的编码代理Qwen Code 想解决的是一条很具体的链路读懂代码、定位问题、改动文件、跑测试、提交。这些环节过去分散在编辑器、终端和网页之间它把这套流程收敛到一个交互会话里由 agent 主动读文件和执行命令而不是靠你手动粘贴上下文。与多数同类工具不同它的框架和模型两侧都是开源的不绑定单一供应商当前版本为 0.22.3Node.js 22 起步。同一套内核还有多种入口终端交互、qwen -p无头模式、qwen serve守护模式HTTPSSE多客户端共享一个会话目前标记为实验性、IDE 插件、桌面端以及 TypeScript、Python、Java 三套 SDK。三步完成安装并验证第一步安装。两种方式任选其一npm install -g qwen-code/qwen-codelatestnpm 路线要求 Node.js 22 及以上Linux 和 macOS 也可以用官方一键脚本安装Windows 为对应 PowerShell 脚本脚本会优先下载独立压缩包不强制预装 Node。装完后建议重启终端让环境变量生效。第二步认证。在项目目录里运行qwen首次启动会进入 /auth 引导菜单可选择阿里云 ModelStudioCoding Plan、Token Plan 或标准 API Key、内置第三方供应商DeepSeek、Kimi、OpenRouter 等或自定义本地端点。配置好后随时可用 /doctor 检查当前认证与环境状态。第三步看到第一个实际结果。在欢迎界面里直接问一句这个项目是做什么的它会自行遍历仓库并给出结构总结不需要你手动附加任何文件。这一步同时验证了模型连通性和读文件能力。四个功能与对应场景用 把文件固定进上下文给一个已有模块加接口时最稳妥的做法是让它看着相关类型定义改。在输入框打加文件名对应文件内容会作为上下文注入对话。它本身也会按需自动读文件 的意义在于把关键文件钉死在上下文里避免它走偏。写文件前它总会展示改动并请求批准嫌频繁可以在会话内开启整段接受模式。幽灵文字跟进建议模型回答结束后约 300ms输入框会出现一行灰色占位文字预测你的下一步比如修完 bug 后给出run the tests。按 Tab 或 Enter 填入输入框按任意键则消失继续手动输入。细节上Enter 只填内容不提交意味着被接受的斜杠命令还需要你再按一次 Enter 才执行避免了误触发。这个功能默认开启适合改完就测、测完就提交这类有固定节奏的工作流。对话式 Git 与工作树隔离Git 操作可以直接用自然语言驱动改了哪些文件帮我提交并写一条描述性信息建一个 feature 分支。Web Shell 界面还提供可视化的 Git 模式入口包括工作树worktree开关用于在隔离环境里并行开发不同分支。无头模式与多客户端共享需要脚本化时qwen -p ...可以在没有任何界面的情况下执行一次任务输出可被管道消费比如把日志流接进去让它报告异常。多人共用一个长会话的场景则由qwen serve承担起一个守护进程多个客户端通过 HTTPSSE 接入同一个 agent 会话。注意守护模式目前在文档中标记为实验性生产环境用前先看 qwen-serve 文档。一次真实任务的走查以给注册表单加输入校验为例完整流程大致是这样。在项目目录进入会话后直接用一句话描述需求并说明用户能提交空表单这个具体现象。agent 会先做探索定位表单相关文件和已有的校验逻辑把理解复述给你。接着它提出改动以 diff 形式展示新增的校验函数和调用点等确认后才落盘。改动落盘前它通常会建议先开一个独立分支这一步可以口述完成也可以在界面上直接输入分支名。文件写好后如果项目里已有测试它会尝试跑一遍相关测试并贴出结果。全部通过后输入框里的幽灵文字往往会给出下一步建议提交信息也可以让它代写。整个过程里人只做两件事描述问题、在 diff 前点头。边界与常见坑先说适用性。它的交互主界面是终端 TUI如果团队里有人完全不接受命令行官方有 VS Code 扩展Beta和桌面端可用但体验深度以终端为主。重视觉、重交互的界面开发不是它的主场它擅长的是逻辑层重构、修 bug、补测试、批量文本处理。几个高频问题。装完找不到qwen命令几乎都是终端没重启环境变量尚未生效。认证方式在持续变动文档明确标注 Qwen OAuth 已于 2026 年 4 月 15 日停用旧账号用户需要走 /auth 换到当前支持的方式不要照搬过期教程。成本方面要心里有数每一轮对话、每一次工具调用都会消耗模型 token长会话历史会推高单轮开销。/compress 可以把聊天记录替换为摘要来省 token另外两条实操建议是只 真正必要的文件、把大任务拆成小步。性能上仓库设计文档记录过流式场景的内存对比测试优化前长会话内存持续上涨直至中断优化后曲线趋于平稳任务可以完整跑完。延伸阅读快速上手文档认证选项、常用命令表的完整清单项目概览能力边界与各入口的官方描述开发者架构文档想读源码前先看整体分层core 包源码agent 循环、工具调用与记忆逻辑的实现所在【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考