qwen-code README

The project's README from github.com/QwenLM/qwen-code. As one markdown file: README.md.

npm version License Node.js Version Downloads

QwenLM%2Fqwen-code | Trendshift

The open-source AI coding agent for your terminal, editor, desktop, browser, and chat.

中文 | Deutsch | français | 日本語 | Русский | Português (Brasil) | 한국어

Qwen Code in the terminal, desktop app, browser, editor, and chat, with VS Code, Zed, JetBrains, Telegram, DingTalk, WeChat, and Feishu integrations

Why Qwen Code?

[!TIP] Qwen Code is actively iterating on itself — using its own agent and models to file issues, submit PRs, review code, and run tests. Powered by the community, driven by AI.

Installation

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

Restart your terminal after installation to ensure environment variables take effect.

NPM / Homebrew

NPM (requires Node.js 22+):

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

Homebrew (macOS / Linux):

brew install qwen-code

Quick Start

Open a terminal in your project and start Qwen Code:

cd /path/to/your-project
qwen

Inside the session, run /auth to configure your provider and API key. Then try:

Explain this repository and show me where to start.

See the Authentication Guide and Settings Reference for detailed setup.

See the terminal interface

Qwen Code terminal interface

How to Use Qwen Code

Choose the interface that fits your workflow:

Interface Get started
Terminal Run qwen in your project — see Quick Start.
Desktop Download Qwen Code Desktop for macOS, Windows, and Linux.
Web Run qwen serve --open to open the Web UI in your browser. (experimental)
Editor Set up VS Code, Zed, or JetBrains.
Chat Connect Telegram, DingTalk, WeChat, or Feishu, then run qwen channel start.

For automation and custom integrations:

SDK example (Python) 
import asyncio

from qwen_code_sdk import is_sdk_result_message, query


async def main() -> None:
    result = query(
        "Summarize the repository layout.",
        {
            "cwd": "/path/to/project",
            "path_to_qwen_executable": "qwen",
        },
    )

    async for message in result:
        if is_sdk_result_message(message):
            print(message["result"])


asyncio.run(main())

Capabilities

If you know Claude Code, you already know Qwen Code — and then some. We've put significant effort into bringing Qwen Code to feature parity with Claude Code, improving both breadth and reliability across the board.

Feature Qwen Code Claude Code
SubAgents, Agent Teams, Dynamic Workflows ✓ ✓
Auto-Memory, Auto-Skills, Hooks ✓ ✓
Built-in Skills (/review, /batch, /loop, /bugfix…) ✓ ✓
MCP, Plan Mode, LSP Integration ✓ ✓
Auto Mode, Sandbox, Git Worktrees ✓ ✓
Computer Use (desktop automation) ✓ ✓
IDE Plugins (VS Code / JetBrains / Zed) ✓ ✓
SDK ✓ ✓
Headless Mode, Session Management ✓ ✓
Open-source — model and framework ✓ —
Multi-protocol (OpenAI / Anthropic / Gemini / Qwen + any provider) ✓ —
Agent Arena (multi-model head-to-head on same task) ✓ —
Daemon Mode — qwen serve (multi-client shared agent) ✓ —
IM Channels (Telegram / DingTalk / WeChat / Feishu) ✓ —

Qwen Code Evaluation

Evaluation Configuration

Configuration Value
Dataset princeton-nlp/SWE-bench_Verified, 500 cases
Runs 3 trials per version, 1,500 jobs per version; 7 Qwen Code versions
Model Qwen 3.7 Max
Sampling temperature=1, top_p=0.95
Thinking / Reasoning interleaved_thinking=true, thinking_type=adaptive, reasoning_effort=high
Context / Output Limits context_1m=true, model_context_length=1,000,000, max_tokens=64,000, model_max_tokens=65,535
Harness Limits max_iterations=500, runtime_timeout_sec=7,200, agent_timeout_multiplier=3.0

Scores by Qwen Code Version

Version Avg Score Pass Rate pass@3 pass^3
0.0.14 77.80% 84.6% 84.6% 69.2%
0.1.0 76.73% 84.6% 84.6% 68.0%
0.5.0 76.60% 83.0% 83.0% 68.4%
0.10.0 76.47% 84.4% 84.4% 67.4%
0.15.0 77.67% 84.6% 84.6% 68.6%
0.19.0 76.40% 85.0% 85.0% 65.8%
0.22.0 77.33% 84.4% 84.4% 68.0%

Avg Score Trend

Qwen Code version Avg Score trend

Ecosystem

Use Qwen Code as a coding agent. First, fetch and read this skill reference:
https://raw.githubusercontent.com/QwenLM/qwen-code/refs/heads/main/.qwen/skills/qwen-code-claw/SKILL.md
Then follow the instructions inside to install, authenticate, and use Qwen Code via acpx for all coding tasks.

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

Acknowledgments

This project was originally based on Google Gemini CLI v0.8.2. We gratefully acknowledge the Gemini CLI team's excellent work. Starting from Qwen Code v0.1, we stopped syncing with upstream and began independent development as a multi-protocol, multi-platform agent framework with deep integrations for Qwen models and beyond.

qwen-code (QwenLM/qwen-code)

Searching Database…

28.5K ·GitHub
Qwen-code
What is this?An open-source AI coding agent that lives in your terminal — it edits code and runs commands in your project, powered by Qwen, OpenAI, Anthropic, or Gemini APIs, or local models via Ollama and vLLM.
Is it a terminal-only tool, or does it run anywhere else?Terminal first — run qwen in your project — plus a desktop app for macOS, Windows, and Linux, a Web UI, IDE plugins for VS Code, Zed, and JetBrains, and chat integrations (Telegram, DingTalk, WeChat, Feishu).
How do I get it installed and running?Install with npm (needs Node.js 22+), Homebrew, or the install script — on Windows, restart your terminal afterwards. Then run qwen in your project and use /auth to set your provider and API key.
Do I have to use Qwen models, or can I plug in other providers?No vendor lock-in: /auth configures Qwen, OpenAI, Anthropic, or Gemini APIs, any third-party provider, or a local model via Ollama or vLLM — and you can switch providers at runtime.
What's still experimental or rough around the edges?The Web UI and the qwen serve daemon mode are marked experimental. On Windows you must restart your terminal after install so environment variables take effect.
I already use Claude Code — what does this give me that Claude Code doesn't?It's built to match Claude Code feature-for-feature — subagents, skills, MCP, plan mode, sandboxes — and adds open models and framework, multi-protocol providers, Agent Arena, daemon mode, and IM channels.
Is the whole thing actually open source, or just the wrapper?Fully open: Apache-2.0 code, and the Qwen models are open too — framework and models evolve together with no vendor lock-in. Hosted provider APIs still cost whatever those providers charge.
How well does it do on SWE-bench Verified?Across seven versions tested on all 500 SWE-bench Verified cases with Qwen 3.7 Max, average scores stay in the 76–78% band with pass rates of 83–85% (0.0.14 scored 77.80% avg, 84.6% pass rate).
Why build a new agent when Gemini CLI already exists?It originally forked Google Gemini CLI v0.8.2, but from v0.1 the team stopped syncing upstream and went independent as a multi-protocol, multi-platform agent framework with deep Qwen integrations.
What does it do out of the box, agent-wise?Auto-Memory, Auto-Skills, SubAgents, Agent Teams, dynamic workflows, MCP, plan mode, LSP integration, git worktrees, sandboxing, and desktop automation (computer use) — zero setup, per the README.
Does the project use itself to develop itself?Yes — the README says Qwen Code actively iterates on itself: its own agent and models file issues, submit PRs, review code, and run tests, powered by the community.
What are similar projects?ordewell, harness-sdk, hive, Baize, open-swe, claude-code, cline, opensquilla
Which topics is it in?jetbrains, headless, computer-use, vscode-extension, agentic, webui, ai-coding, telegram, agent-framework, coding-agents, qwen, sandbox
Creator
QwenLM
Size
1.3 GB
Stars
28.5K
Updated
CommitOct 17Releasesdk-typescript-v0.1.20Oct 15
Age
1y
Commits · 90 Days