How to Use Qwen Code as a Free Coding Agent

Qwen Code is Alibaba’s free, open-source terminal coding agent. It is a fork of Gemini CLI retargeted to the Qwen3-Coder model, and a browser OAuth login gives you 2,000 free requests per day.

That is twice the daily quota of its Gemini ancestor. The tradeoff is that the model behaves differently, and the ecosystem around it is younger.

What Is Qwen Code and How Is It Different From Gemini CLI?

Same interface, different brain. Qwen Code keeps the command structure and tool set of Gemini CLI but runs Qwen3-Coder, a 480-billion-parameter mixture-of-experts model with 35 billion active parameters tuned for agentic coding.

If you already know one, the other feels familiar within minutes.

How Do You Install Qwen Code?

• Install Node.js 20 or newer
• Run npm install -g @qwen-code/qwen-code
• Start it with qwen inside a project
• Choose Qwen OAuth and sign in through the browser
• Confirm the quota shows 2,000 requests

The OAuth step matters. Without it you land on an API key path and pay per token instead of using the free daily allowance.

Is Qwen Code Free?

Yes, 2,000 requests per day through Qwen OAuth, which is the largest free quota among the major CLI agents right now. No card required. The quota resets daily, and heavy agent loops can still exhaust it.

What Does the Agent Actually Do?

It edits multiple files in one turn and shows you a unified diff. It runs shell commands, greps the repo, and supports MCP clients so you can attach databases or internal APIs. The multi-file diff view is the part that saves the most time on real work.

Who Should Use It Instead of the Alternatives?

Choose Qwen Code if you want a big free quota and are comfortable with a fast-moving project. Look elsewhere if you need the maturity of Google’s backing, or if you are already standardized on a different model family.

What Are the Rough Edges?

Documentation lags the code, and version bumps sometimes change flag names. The model is strong at code but weaker than frontier models on ambiguous product questions. Give it precise instructions.

Quick Summary

• Qwen Code is Alibaba’s open-source fork of Gemini CLI on Qwen3-Coder.
• Install with npm install -g @qwen-code/qwen-code.
• Qwen OAuth unlocks 2,000 free requests per day.
• It edits several files per turn with a unified diff.
• Docs move slower than releases, so pin a version for team use.