初识Qwen Code CLI

前言

小伙伴们大家好，我是小溪，见字如面。Qwen Code CLI发布有段时间了，一直没有使用，今天来继续体验CLI。对AI Code CLI以往期内容感兴趣的小伙伴也可以看往期：

当前使用版本

Qwen Code CLI：0.1.0

优势

无缝访问Qwen模型
无需手动管理 API key
每分钟 60 次请求
每天免费 2,000 次请求
任何兼容 OpenAI 的API

限制

需要有效的 qwen.ai 账户

简介

Qwen Code 是一个强大的命令行 AI 工作流工具，基于 Gemini CLI 改造而来的，并针对 Qwen3-Coder 模型进行了专门优化。它通过先进的代码理解能力、自动化任务和智能辅助功能，显著提升你的开发工作流效率。

官方文档：qwenlm.github.io/qwen-code-d...

开源Github地址：github.com/QwenLM/Qwen...

功能特性

超大规模参数量：Qwen3-Coder基于MoE（混合专家）架构的模型，总参数量达4800亿（480B），激活参数约350亿（35B），支持256K token上下文，并可通过YaRN技术扩展至1M token长度。
多模态与Agent能力：Qwen3-Coder拥有具备自主交互能力的智能体（Agent），不仅能进行代码生成，而且可以自主调用工具、理解复杂需求、进行多轮交互。
代码生成与优化：Qwen3-Coder支持代码生成、自动测试、多轮交互及工具调用，覆盖从需求分析到代码落地的全流程。

安装配置

前提条件

需要Node.js 20及更高版本

安装CLI

通过npm安装

在终端命令行输入如下指令

ruby 复制代码

$ npm install -g @qwen-code/qwen-code@latest

安装完成后，输入 qwen -v 查看Qwen Code CLI版本，看到以下信息表示Qwen Code CLI安装成功。

使用 Homebrew 全局安装

在macOS/Linux环境可以直接通过brew进行安装

css 复制代码

$ brew install qwen-code

从源码安装

也可以直接克隆源码进行安装

shell 复制代码

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

基本使用

因为Qwen Code CLI是基于Gemini CLI魔改的，大部分功能和Gemini CLI是一样的，这里我们只探索Qwen Code CLI独有的功能。

登录授权

手动授权

Qwen Code CLI安装完成后，在命令行终端输入 qwen 启动CLI，启动后界面如下：

可以看到操作界面和Gemini CLI基本是一样的，区别是模型换成了coder-model，登录方式有 Qwen OAuth 和 OpenAI 两种授权方式：

1）Qwen OAuth

选择【Qwen OAuth】会默认展示二维码且在浏览器打开Qwen授权页面，可以选择使用Qwen应用扫码授权也可以在web端进行授权

授权成功后Qwen Code CLI会展示已授权状态

2）OpenAI

该登录授权方式是以兼容OpenAI的提供商提供的API Key进行授权登录

API Key：提供商API Key（密钥）
Base URL：提供商请求API请求URL
Model：提供商模型名称

这里以魔搭平台为例进行演示，对魔搭还不了解的小伙伴可以看往期内容：Claude Code CLI平台与中转站接入汇总及避坑

授权配置完成后，即可正常进入对话界面，该版本OpenAI授权配置方式有时会有问题，授权完成后会报错，使用自动授权方式正常

自动授权

新开命令行终端，以 macOS 为例在终端导出模型提供商配置

ini 复制代码

export OPENAI_API_KEY="your_api_key_here"   
export OPENAI_BASE_URL="your_api_endpoint"   
export OPENAI_MODEL="your_model_choice"

以魔搭为例配置如下：

ini 复制代码

export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="https://api-inference.modelscope.cn/v1"
export OPENAI_MODEL="Qwen/Qwen3-Coder-480B-A35B-Instruct"

重新启动Qwen Code CLI，授权成功效果如下：

也可以在项目根目录创建 .env 文件，配置OpenAI兼容的提供商API Key

ini 复制代码

OPENAI_API_KEY=your_api_key_here
OPENAI_BASE_URL=https://api-inference.modelscope.cn/v1
OPENAI_MODEL=Qwen/Qwen3-Coder-480B-A35B-Instruct

执行Shell

和Gemini CLI一样在交互式命令中输入 ! 可进入Shell模式执行Shell命令

交互式命令

agents

Qwen Code CLI新增的交互式命令，用于专注任务的专用 AI 子代理（子代理是配置了特定专业知识和工具访问权限的独立 AI 助手）。

create：启动交互式向导以创建新的子代理，用法：/agents create
manage：打开交互式管理对话框以查看、编辑和删除现有子代理，用法：/agents manage

approval-mode

Qwen Code CLI新增的交互式命令，用于更改工具使用的审批模式

plan：仅分析，不修改文件或执行命令
default：要求审批文件编辑或 shell 命令
auto-edit：自动批准文件编辑
yolo：自动批准所有工具

选择一种模式后，可以看到每种模式还提供了作用范围

--session：仅应用于当前会话
--project：为此项目 / 工作区持久化
--user：为这台机器上的用户进行持久化设置

选择作用范围后，Qwen Code CLI会将配置写到指定配置文件中

除了使用交互式命令，也可以使用命令后参数进行配置

bash 复制代码

/approval-mode plan --project
/approval-mode yolo --user

重启Qwen Code CLI后，已选择的对话模式仍然生效

model

Qwen Code CLI新增的交互式命令，用于查看和切换模型

quit-confirm

Qwen Code CLI新增的交互式命令，用于退出 Qwen Code 前显示确认对话框，允许你选择如何处理当前会话。

Quit immediately：立即退出，不保存任何内容直接退出（等效于 /quit）
Generate summary and quit：生成摘要并退出，在退出前使用 /summary 创建项目摘要
Save conversation and quit：保存对话并退出，在退出前使用自动生成的标签保存当前对话
Cancel：取消退出操作

配置文件

Qwen Code CLI延续了Gemini CLI的配置文件系统，提供了 .qwen/settings.json、.env、QWEN.md 等配置文件，整体上和Gemini CLI的配置文件没有太大差异。

对话模式

Qwen Code CLI提供了 plan、default、auto-edit、yolo 4种对话模式，关于对话模式的解释可以看上方【交互式命令】，可以在交互式命令中通过 /approval-mode 命令进行选择

也可以通过快捷键【Shift + Tab】进行切换

Qwen Code CLI默认为【default】模式，该模式下所有文件编辑和Shell指令执行都需要人为进行权限审批

当我们切换到【plan mode】模式发起一个任务时，Qwen Code CLI会对任务进行分析和规划，但是并不会执行计划，而是会提示我们切换到【auto-accept】模式

当我们切换到【auto-accept edits】模式时，再次执行同一个任务时，Qwen Code CLI会直接进行文件编辑任务

使用【auto-accept edits】模式只有编辑权限，没有MCP执行等其他权限

如需调用MCP等其他命令的自动批准权限，需要切换到【YOLO mode】模式

视觉模型

使用【Qwen OAuth】方式授权，在交互式命令中调用 /model命令可以看到除了 coder-model 模型，还提供了一个 vision-model 视觉模型

最新的阿里云 ModelStudio Qwen Vision 模型（qwen3-vl-plus-2025-09-23）是"通义千问"Qwen3-VL系列的新一代视觉语言模型，在图像、视频与文本等多模态理解能力上极为强大。该版本不仅在企业和科研应用场景具备卓越表现，并且对中文任务支持十分完善。

切换到 vision-model 模型，提供一张图片看看效果

再贴一张Gemini CLI的效果图，看看更喜欢哪个

自定义命令

Qwen Code CLI支持自定义命令，也就是Claude Code CLI的斜杠命令。不同的是Qwen Code CLI的自定义命令需要在 .qwen/commands/ 目录下创建后缀为.toml的文件，文件内容格式如下：

ini 复制代码

description = "测试命令"
prompt = "输出`测试命令`话术"

Qwen Code CLI的自定义命令和Claude Code CLI还是有不少差异的，由于篇幅问题，下次展开说明。

Subagents

Qwen Code CLI支持子代理功能，在交互式命令中输入 /agents 可以查看Agents菜单

manage：管理现有的子代理（查看、编辑、删除）
create：创建一个带有引导式设置的新子代理

使用 manage 命令可以管理已存在的子代理

使用 create 命令可以创建不同作用范围的子代理

MCP服务

Qwen Code CLI支持使用命令行一键添加MCP，也可以直接在 settings.json 文件中进行配置，其他MCP操作和Gemini CLI保持一致

shell 复制代码

$ qwen mcp add --transport http context7 https://mcp.context7.com/mcp

Qwen Code CLI新增了MCP服务快捷键快速查看功能，配置完MCP服务后，可以看到聊天框上方多了一个提示

使用快捷键【Ctrl+T】可以快速查看MCP服务信息

Qwen Code CLI还新增了【Debug Console】功能

使用快捷键【Ctrl+O】可以快速打开【Debug Console】查看调试信息

总结

Qwen Code CLI并不是照搬Gemini CLI，而是在Gemini CLI的基本上提供了自己的创新功能，其提供的Qwen Code授权提供了每天 2000次免费请求，这对AI小白来说很友好，但是对工具、MCP等工具调用上感觉还不够只能，在日常开发中可作为补充使用，对于企业级项目还可以再等等。

常见问题

无法准确调用MCP服务

使用【Qwen OAuth】授权时使用的【coder-model】模型对应的是 qwen3-coder-plus-2025-09-23 模型，该模型在执行MCP时时常会出现无法正常调用MCP的情况

解决方案就是改换为OpenAI授权方式，使用魔搭社区的 Qwen/Qwen3-Coder-480B-A35 模型或者其他模型

使用魔搭API 429问题

使用的 Qwen/Qwen3-Coder-480B-A35 模型根据魔搭平台的动态调整策略目前调用次数限制为大约 50 次了，超过 50 次就429，只需要换个模型就行了。

友情提示

见原文：初识Qwen Code CLI

本文同步自微信公众号 "程序员小溪" ，这里只是同步，想看及时消息请移步我的公众号，不定时更新我的学习经验。友情提示友情提示