企业官网建设流程全解析

Qwen Code 入门教程：3 步跑通终端里的 AI 编程助手

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

Qwen Code 是一个开源 AI 编程助手，直接运行在终端里：你用自然语言让它读懂项目、修改代码、管理 Git 分支。第一次上手时，大多数人卡住的地方其实不是安装，而是装完之后不知道该做什么。这篇文章按顺序讲三件事：装好 CLI、接通模型让它真正能对话、再接进编辑器，看完你就能在自己的项目里让它改出一段代码。

1. 如何安装 Qwen Code CLI

安装是全程最省事的一步，一条命令通常就够了。

一键安装脚本

在 Linux 或 macOS 上，把这条命令贴进终端执行即可：

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

Windows 则用 PowerShell 版本：irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex。装完记得重开一次终端，环境变量才会生效。脚本源码放在仓库的安装脚本目录里，想核对内容可以直接翻。

npm 或 Homebrew 安装

已经用 Node.js 的话，直接npm install -g @qwen-code/qwen-code@latest，前提是 Node.js 22 及以上；macOS 和 Linux 也支持brew install qwen-code。三条路殊途同归，选你顺手的。

装完先跑一次

在任意项目目录里输入qwen，会启动交互式界面。先别急着提问——第一次运行弹出的是认证配置菜单，这一步才是多数人卡住的地方，下一节展开说。

2. 如何接通模型：认证配置与排查

为什么装完还不能干活？因为 CLI 本身只是壳子，真正产出回答的是背后的模型。首次运行qwen时出现的认证菜单，就是来解决这件事的。

三种接入方式

首跑菜单按来源分三组：

• 阿里云 ModelStudio（官方推荐）：下分 Coding Plan（面向个人开发者，含每周额度）、Token Plan（按量计费，面向团队）、标准 API Key（用已有密钥直连）
• 第三方服务商：DeepSeek、Kimi、OpenRouter 等，填 API key 即可
• 自定义 Provider：指向本地模型或代理，Ollama、vLLM 这类本地服务都能接

⚠️ 注意：旧的 "Qwen OAuth" 登录方式已于 2026 年 4 月 15 日下线，老教程里如果提到它，直接忽略。完整说明见快速开始文档。

随时切换与体检

会话内输入/auth可随时换 Provider，/doctor则能检查当前认证与环境配置。行为不对劲时，先跑一次 doctor，比凭空猜测快得多。

3. 完成第一次对话：让它读懂并修改代码

能对话之后，第一件事是让它读。

直接用自然语言问

cd进项目目录启动qwen，第一句发"explain the folder structure"。你不需要手动粘贴文件内容，它会按需自己去读；需要指向具体文件时，在输入框敲@加文件名，它会把那个文件作为上下文读进来。想把流程写进脚本或 CI，还有无界面形态qwen -p "..."，不打开 UI 直接出结果。

改代码前它一定先问

修改文件时，它总是先展示改动内容再等你的确认：可以逐条批准，也可以开启会话级"全部接受"模式。Git 操作同样可以口述，"commit my changes"、"create a new branch called feature/quickstart" 都能直接执行。

日常会用到的斜杠命令

/help列出全部命令；/compress把冗长的聊天历史压缩成摘要，省 token；/clear（快捷键 Ctrl+L）清屏；/language调整界面与输出语言。

4. 如何将 Qwen Code 接入 VS Code

扩展带来什么

官方 VS Code 扩展（Beta）提供一个原生侧边栏：AI 的改动直接反映在编辑器里，能实时看到差异，还有自动接受模式；附件文件、图片也能直接带上，且支持同时跑多个会话。以前要在终端和编辑器之间来回切换的事，现在一个窗口内完成。细节可看VS Code 集成文档。

安装要求与常见问题

要求 VS Code 1.96.0 及以上，在扩展市场搜 Qwen Code 安装即可。装不上时按顺序查：VS Code 版本是否达标、账号是否允许安装第三方扩展，最后再从市场网站直接装一遍试试。

5. 多任务并行：多会话、分支与工作区

多会话：多个对话窗口各记各的

可以把多会话理解成和同一个助手开多个对话窗口，各自记各自的上下文。会话 A 做重构、会话 B 修 bug，互不干扰。

分支与 Worktree 隔离改动

新建会话时的 Git 模式弹窗提供三种玩法：直接在当前分支上开发、从 main 新建分支，或用 Worktree 做一份隔离副本——后两种适合多个任务并行推进。

给项目起个看得懂的名字

项目一多，默认目录名很难分辨。添加工作区时可以填一个展示名称，勾选"服务重启后保留"，重启之后名字也不会丢。

下一步很具体：cd到你最常用的项目目录，运行qwen，发一句"explain the folder structure"，然后让它改一个最小改动并确认差异——这条链路走通，入门就算完成了。

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