Qwen Code 命令速查表 - 阿里通义 AI 编码 CLI 全参数

Qwen Code 是阿里开源的 Claude Code 风格 AI 编码 CLI,构建于 Qwen3-Max/Qwen3-Coder 之上,面向使用通义大模型、想在终端里让 AI 改代码的开发者,也适合已有阿里云 DashScope 账号的用户就近接入。它与 Claude Code 用法相近但模型与计费不同,可通过 DASHSCOPE_API_KEY 快速接入;本表帮你掌握启动、打印模式、斜杠命令与 MCP 接入。

AI 命令行·共 25 条命令·最后更新 2026-08-21
qwen-codeqwenaicliagent通义

安装与认证 5

npm install -g @qwen-code/qwen-code
通过 npm 全局安装
qwen --version
查看版本号
export DASHSCOPE_API_KEY="sk-..."
设置通义 API key
qwen auth login
交互式登录(如支持)
qwen auth status
查看认证状态

启动与运行 5

qwen
在当前目录启动交互式 REPL
qwen "重构 user 模块"
带初始提示启动
qwen -p "解释这个函数"
打印模式:执行后退出
qwen -c
继续最近一次会话(--continue)
qwen -m qwen3-max "任务"
指定模型运行

斜杠命令 5

/init
生成项目配置(QWEN.md)
/clear
清空对话历史
/compact
总结对话释放上下文
/model
切换激活模型
/exit
退出 REPL

MCP 与扩展 5

qwen mcp add <name> <url>
添加 MCP 服务器
qwen mcp list
列出已配置 MCP 服务器
qwen mcp remove <name>
移除 MCP 服务器
qwen mcp get <name>
查看服务器配置
@./src/utils.ts
提示词中用 @ 引用文件

中文语境技巧 5

qwen -p "用中文解释架构"
中文任务直接用中文提示
QWEN.md 写约定
把构建/测试命令写进 QWEN.md 自动加载
qwen -p --output-format json
JSON 输出便于脚本解析
多轮对话续接 -c
用 -c 接着上次上下文
qwen --permission-mode plan
只读规划模式

提示

  • Qwen Code 是国内厂商 CLI,中文语境与 Qwen3-Coder 代码能力强相关,是"中文 AI 速查"赛道必要占位。
  • 把构建/测试约定写进 QWEN.md,Qwen Code 每次会话自动加载,比反复提示更稳。
  • 打印模式 -p --output-format json 接 CI/脚本,与 Claude Code 用法一致,迁移成本低。
  • 需要联网装依赖时 CLI 会退出沙箱询问,默认安全;纯本地推理用 Qwen 开源权重也可走 Ollama。

常见问题

QWEN.md 应该写些什么?

写项目约定和命令,让它每次会话自动加载后不必再猜:构建用什么命令、测试怎么跑、代码风格要求、有哪些目录不能碰。最有价值的是把「怎么验证改动」写清楚,它就不会在没跑测试的情况下宣称改好了。内容保持简短,冗长的文档反而稀释注意力。

中文任务用中文提示更好吗?

通常是。qwen -p "用中文解释架构" 配合中文回答能减少一次翻译损耗,术语也不容易走形。需要它输出英文文档或代码注释时再显式指定语言并给出示例。与其靠默认,不如把目标语言的风格要求写清楚,例如「面向英文读者,使用技术写作风格」。

怎么给 Qwen Code 挂载 MCP 服务器?

qwen mcp add <name> <url> 添加,qwen mcp list 列出已配置的,qwen mcp get <name> 查看单个配置,qwen mcp remove <name> 删除。MCP 让它能访问外部工具与数据源。另外在提示里用 @./src/utils.ts 可以精准引用指定文件,不必让它扫描整个仓库。

怎么让 Qwen Code 输出 JSON 便于脚本解析?

用 qwen -p --output-format json,输出即为结构化 JSON,可直接交给下游程序解析。多轮对话的续接用 -c,接着上次的上下文继续,不必重新交代背景。计划类任务建议加 --permission-mode plan 保持只读。

Qwen Code 里的斜杠命令有哪些常用的?

/init 在项目根生成 QWEN.md 配置文件,把构建与测试命令写进去就会被自动加载;/clear 清空对话历史,适合彻底换任务;/compact 总结对话释放上下文长度,长会话里很有用;/model 切换当前激活的模型;/exit 退出 REPL。

官方参考来源

下方为命令对应的官方权威文档,供你核对最新用法与深入查阅。

由 巧匠 维护

公开更新于 2026年8月21日,内容持续校对官方文档。

联系我们

命令或描述有误?提交反馈、商务合作或产品建议都可发送邮件给我们。

联系我们