文章目录

1. 1. 获取 API token
2. 2. 安装qwen-code
3. 3. 使用qwen-code更新package.json的依赖

qwen-code是阿里千问的命令行AI工具，agentic自动化工作流程，在当前目录的上下文环境下进行文件处理与内容生成。qwen-code是基于google Gemini CLI的，可以对比使用看效果。

开始使用qwen-code，要完成如下的步骤：

1. 兼容openai的大模型服务API URL与API token。这里使用阿里云百炼平台提供的免费额度。
2. 安装nodejs, 要求nodejs version 20
3. 使用npm全局安装qwen-code,npm install -g @qwen-code/qwen-code
4. 打开命令行终端，运行qwen命令，按提示进行初始化设置，输入提示词开始工作流

参考网址：

• qwen-code github https://github.com/QwenLM/qwen-code
• bailian api-key https://bailian.console.aliyun.com/?tab=model#/api-key
• volta https://docs.volta.sh/guide/getting-started

获取 API token

按照Qwen Code在Github的readme描述，在国内使用需要设置如下3个环境变量。其中OPENAI_BASE_URL与OPENAI_API_KEY为OpenAI API兼容的服务路径与对应的token, OPENAI_MODEL为使用的模型，显示的是Qwen3 Coder。可以使用阿里云百炼平台的免费额度或者ModelScope每天2000次的免费额度。

通过实际使用，并不需要设置手动设置这些环境变量，在第一次启动时会提示输入API KEY， 按提示输入就行了。

export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3-coder-plus"

阿里云百炼平台上API-Key菜单下管理token, 可以通过右上角的[创建API-KEY]按钮来创建key：

安装qwen-code

安装nodejs version 20及以上。未还未安装nodejs, 可使用volta工具安装管理nodejs的版本。volta基于Rust开发，安装速度快，在windows/linux/macos等操作系统下都能统一处理。

# linux下安装volta
curl https://get.volta.sh | bash

# windows下安装volta
winget install Volta.Volta

# 安装nodejs, 现在会默认安装v22
volta install node

# 查看已安装的版本列表
volta list

# 运行which命令，显示当前使用npm命令所在的目录
volta which npm 

接下来是安装qwen-code, 可使用npm命令直接安装，或者从github上clone代码仓库后在本地编译安装。

# npm安装qwen-code
npm install -g @qwen-code/qwen-code
qwen --version

从源代码安装

git clone https://github.com/QwenLM/qwen-code.git
cd qwen-code
npm install
npm install -g .

使用qwen-code更新package.json的依赖

接下来是使用qwen-code尝试完成一个任务，更新一个react前端项目中的package.json里的依赖。使用windwos terminal中先cd切到项目目录下，然后执行qwen启动AI工具。

首次启动时，显示qwen log, 然后是提示选择代码高亮的风格样式Select Theme，和应用的范围。右侧preview区域显示代码样式的预览。使用上下方向键选择不同值，Tab键在不同的区域移到，按回车键确认选择。

接下来是认证方式，只支持OpenAI。按回车键确认。

提示输入API KEY, BASE URL,MODEL。这里输入百炼平台上的API-Key。

基本设置完成，显示开始提示操作，可以问问题、编辑文件或者运行命令。中间的输入框即是交互的窗口，类似天聊天输入窗口。

使用@符号来引用文件路径。输入@符号之后下方会自动出现文件列表，上下方向键来选择。这里选择ui/package.json，即前端项目的npm配置文件。

输入提示为@ui/package.json 检查使用的包有更新，接着AI模型会提示需要执行的步骤，然后提示确认是否执行命令。提示是否执行’npm view antd version’命令。回车选择yes后开始执行命令。

接下来会轮流提示检查package.json中列出的依赖包， 提示是否执行命令。

每一个依赖项都检查完成后，显示需要对package.json进行的变更，并确认是否应用变更。选择yes回车。

package.json变更生效后，显示包版本的变化。然后继续提示需要执行pnpm install才能生效。

在输入框输入: 运行pnpm install, AI模型提示将执行命令， 需要确认选择。

pnpm install执行完成后，汇总显示已更新的包。

整个执行下来， qwen-code 运行还是很流畅的，利用大语言模型显示提示，并能够自动执行命令；执行命令前，需要确认是否执行。