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
Что это такое?AI-агент для программирования с открытым кодом, который живёт прямо в терминале: он правит код и выполняет команды в вашем проекте. Работает на API Qwen, OpenAI, Anthropic или Gemini, а также на локальных моделях через Ollama и vLLM.
Это только терминальный инструмент или работает где-то ещё?В первую очередь терминал — запустите qwen в своём проекте — плюс десктопное приложение для macOS, Windows и Linux, веб-интерфейс, плагины для IDE (VS Code, Zed, JetBrains) и интеграции с мессенджерами (Telegram, DingTalk, WeChat, Feishu).
Как его установить и запустить?Установите через npm (нужен Node.js 22+), Homebrew или установочный скрипт — на Windows после установки перезапустите терминал. Затем запустите qwen в своём проекте и задайте провайдера и API-ключ командой /auth.
Обязательно использовать модели Qwen или можно подключить других провайдеров?Никакой привязки к одному вендору: через /auth настраиваются API Qwen, OpenAI, Anthropic или Gemini, любой сторонний провайдер или локальная модель через Ollama и vLLM — причём переключать провайдеров можно прямо во время работы.
Что пока считается экспериментальным или сырым?Веб-интерфейс и режим демона qwen serve помечены как экспериментальные. На Windows после установки нужно перезапустить терминал, чтобы переменные окружения вступили в силу.
Я уже пользуюсь Claude Code — что здесь есть такого, чего нет в Claude Code?Он сделан так, чтобы повторять возможности Claude Code один в один — сабагенты, скиллы, MCP, режим плана, песочницы — и вдобавок предлагает открытые модели и фреймворк, мультипротокольных провайдеров, Agent Arena, режим демона и каналы в мессенджерах.
Проект полностью открытый или открыт только код-обёртка?Всё открыто: код под Apache-2.0, а модели Qwen тоже открыты — фреймворк и модели развиваются вместе, без привязки к вендору. Облачные API провайдеров стоят столько, сколько эти провайдеры запрашивают.
Насколько он хорошо показывает себя на SWE-bench Verified?На семи версиях, протестированных на всех 500 задачах SWE-bench Verified с Qwen 3.7 Max, средние результаты держатся в диапазоне 76–78% при pass rate 83–85% (у версии 0.0.14 — 77,80% в среднем и 84,6% решённых задач).
Зачем делать нового агента, если уже есть Gemini CLI?Изначально это был форк Google Gemini CLI v0.8.2, но начиная с v0.1 команда перестала синхронизироваться с апстримом и пошла своим путём как мультипротокольный мультиплатформенный фреймворк агентов с глубокой интеграцией Qwen.
Что он умеет сразу, из коробки, в плане агентности?Auto-Memory, Auto-Skills, SubAgents, Agent Teams, динамические воркфлоу, MCP, режим плана, интеграция с LSP, git worktrees, песочницы и автоматизация рабочего стола (computer use) — без какой-либо настройки, как заявлено в README.
Проект сам использует себя для собственной разработки?Да — в README сказано, что Qwen Code активно развивает сам себя: собственные агенты и модели заводят issues, присылают PR, ревьюят код и гоняют тесты, поддерживаемые сообществом.
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