© 2026FindAgent  · @simprr
返回列表
Q

QwenLM/qwen-code

An open-source AI agent that lives in your terminal.

⭐

21.2k

Stars

🔱

1.9k

Forks

👁

114

Watchers

📋

680

Issues

TypeScriptApache-2.0创建于 2025/6/26更新于 今天
在 GitHub 上查看访问主页
README
由 Gemini 翻译整理

npm version License Node.js Version Downloads

一个运行在终端中的开源 AI Agent。

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

🎉 新闻 (2026-02-16): Qwen3.5-Plus 现已发布!您可以通过 Qwen OAuth 登录直接使用,或从 阿里云百炼 (ModelStudio) 获取 API Key,通过兼容 OpenAI 的 API 进行调用。

Qwen Code 是一款运行在终端中的开源 AI Agent,专门针对 Qwen3-Coder 进行了优化。它能帮助您理解大型代码库、自动化繁琐工作并加速交付。

为什么选择 Qwen Code?

  • 多协议支持,免费 OAuth 额度:支持 OpenAI / Anthropic / Gemini 兼容的 API,或通过 Qwen OAuth 登录获取每天 1,000 次免费请求额度。
  • 开源且协同进化:框架与 Qwen3-Coder 模型均开源,共同发布并同步演进。
  • Agent 工作流,功能丰富:内置丰富的工具(Skills, SubAgents),提供完整的 Agent 工作流和类似 Claude Code 的使用体验。
  • 终端优先,IDE 友好:专为命令行开发者打造,同时可选集成 VS Code、Zed 和 JetBrains 系列 IDE。

安装

快速安装(推荐)

Linux / macOS

bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)"

Windows (以管理员身份运行 CMD)

curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat

注意:安装后建议重启终端,以确保环境变量生效。

手动安装

前置要求

请确保已安装 Node.js 20 或更高版本。可从 nodejs.org 下载。

NPM

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

Homebrew (macOS, Linux)

brew install qwen-code

快速上手

# 启动 Qwen Code (交互模式)
qwen

# 然后,在会话中输入:
/help
/auth

首次使用时,系统会提示您登录。您可以随时运行 /auth 来切换身份验证方式。

提示词示例:

What does this project do?
Explain the codebase structure.
Help me refactor this function.
Generate unit tests for this module.

点击观看演示视频

您的浏览器不支持 video 标签。

身份验证

Qwen Code 支持两种身份验证方式:

  • Qwen OAuth (推荐且免费):通过您的 qwen.ai 账号在浏览器登录。
  • API-KEY:使用 API Key 连接到任何受支持的供应商(OpenAI、Anthropic、Google GenAI、阿里云百炼以及其他兼容的终端节点)。

Qwen OAuth (推荐)

启动 qwen 后,运行:

/auth

选择 Qwen OAuth 并完成浏览器登录流程。您的凭据会缓存在本地,因此通常无需重复登录。

注意:在非交互式或无头(headless)环境(如 CI、SSH、容器)中,通常无法完成 OAuth 浏览器登录流程。在此类情况下,请使用 API-KEY 身份验证方式。

API-KEY (灵活)

如果您希望在供应商和模型选择上拥有更多灵活性,请使用此方式。支持多种协议:

  • OpenAI 兼容:阿里云百炼、ModelScope、OpenAI、OpenRouter 及其他兼容 OpenAI 的供应商。
  • Anthropic:Claude 系列模型。
  • Google GenAI:Gemini 系列模型。

配置模型和供应商的推荐方式是编辑 ~/.qwen/settings.json(如果文件不存在,请手动创建)。该文件允许您在一处集中定义所有可用模型、API Key 和默认设置。

3 步快速配置

第 1 步:创建或编辑 ~/.qwen/settings.json

以下是一个完整示例:

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "description": "Qwen3-Coder via Dashscope",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "env": {
    "DASHSCOPE_API_KEY": "sk-xxxxxxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

第 2 步:了解各字段含义

| 字段 | 说明 |

贡献者
tyMpLNoDsK
项目信息
默认分支main
LicenseApache License 2.0
创建时间2025/6/26
最近更新今天
GAI 中文摘要

Qwen Code 是一款运行在终端环境下的开源 AI 开发助手,旨在通过深度集成 Qwen3-Coder 模型来提升开发者的编码效率。该项目通过提供智能的代码理解、自动化工作流和多工具支持,帮助开发者快速处理复杂代码库并加速开发交付。

支持多种兼容 OpenAI、Anthropic 等标准的 API 协议,并提供通过 Qwen OAuth 认证的每日免费额度。 内置丰富的开发辅助工具(Skills)与子代理系统(SubAgents),实现完整的智能化编码工作流。 专为终端用户设计,提供原生的命令行交互体验,并支持与 VS Code、Zed 及 JetBrains 等 IDE 的无缝集成。 作为开源项目与 Qwen3-Coder 模型同步演进,确保开发工具与底层模型能够协同升级,保持技术领先性。

适用于长期在命令行进行开发工作的软件工程师,尤其是在需要快速理解大型开源项目、进行自动化编码任务或希望在终端直接驱动 AI 辅助编程的场景中使用。