docs/users/overview.md
Learn about Qwen Code, Qwen's agentic coding tool that lives in your terminal and helps you turn ideas into code faster than ever before.
The recommended installer uses a standalone archive when one is available for your platform. If it falls back to npm, Node.js 22 or later with npm must be available on PATH.
Linux / macOS
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
Windows
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex
[!note]
It's recommended to restart your terminal after installation if
qwenis not immediately available on PATH. If the installation fails, please refer to Manual Installation in the Quickstart guide. For offline installation, download a release archive and run the installer with--archive PATH; keepSHA256SUMSnext to the archive.
cd your-project
qwen
On first launch you'll be prompted to connect a model provider. The menu offers Alibaba ModelStudio (Coding Plan, Token Plan, or Standard API Key), Third-party Providers (built-in providers such as DeepSeek, MiniMax, Z.AI, and OpenRouter, connected with an API key), and Custom Provider (a local server, proxy, or unsupported provider). For the Alibaba Cloud Coding Plan (intl), choose Alibaba ModelStudio → Coding Plan; to use a ModelStudio API key, choose Alibaba ModelStudio → Standard API Key and follow the API setup guide (Beijing / intl). Then let's start with understanding your codebase. Try one of these commands:
what does this project do?
You'll be prompted to log in on first use. That's it! Continue with Quickstart (5 mins) →
[!tip]
See troubleshooting if you hit issues.
[!note]
New VS Code Extension (Beta): Prefer a graphical interface? Our new VS Code extension provides an easy-to-use native IDE experience without requiring terminal familiarity. Simply install from the marketplace and start coding with Qwen Code directly in your sidebar. Download and install the Qwen Code Companion now.
tail -f app.log | qwen -p "Slack me if you see any anomalies appear in this log stream" works. Your CI can run qwen -p "If there are new text strings, translate them into French and raise a PR for @lang-fr-team to review".