
---

Qwen Code 是一款专为 **Qwen3-Coder** 模型优化的命令行 AI 工作流工具，通过先进的代码理解能力、自动化任务和智能辅助功能，显著提升开发效率。

---

## 🛠 操作步骤

### 1️⃣ 获取阿里云百炼 API Key

1. 登录 **阿里云百炼大模型服务平台**。
    
2. 如果页面顶部显示 **image**，说明需要开通服务。
    
    - 开通后可领取新人免费额度（30~180天）。
        
    - 如果提示 **实名认证**，请先完成认证。
        
3. 免费额度详情可在 **新人免费额度页面** 查看。
    
4. 获取 **阿里云百炼 API Key**。
    

---

### 2️⃣ 选择模型

Qwen Code 支持 **OpenAI 兼容接口模型**，包括：

- 🌟 **qwen3-coder-plus**（推荐，2025年7月23日起限时优惠）
    
- qwen3-coder-480b-a35b-instruct
    
- qwen3-coder-flash
    
- qwen3-coder-30b-a3b-instruct
    

---

### 3️⃣ 安装与配置 Qwen Code

#### ✅ Node.js 版本检查

```bash
node -v
```

需 **Node.js 20+**，低于则需重新安装。

#### 📦 安装 Qwen Code

```bash
# 配置镜像源加速
npm config set registry https://registry.npmmirror.com

# 安装 Qwen Code
npm install -g @qwen-code/qwen-code@latest
```

---

### 4️⃣ 启动并配置 Qwen Code

1. 在终端中输入：
    
    ```bash
    qwen
    ```
    
2. 选择认证方式 → **OpenAI**
    
3. 填写以下信息：
    

|配置项|说明|
|---|---|
|🔑 API Key|阿里云百炼 API Key|
|🌐 Base URL|`https://dashscope.aliyuncs.com/compatible-mode/v1`|
|🤖 Model|推荐 `qwen3-coder-plus`|

👉 若不想每次都输入，请配置 **环境变量**。

---

### 5️⃣ 配置环境变量

在系统中设置：

```bash
export OPENAI_API_KEY=你的APIKey
export OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
export OPENAI_MODEL=qwen3-coder-plus
```

---

### 6️⃣ 向 Qwen Code 提问

💡 示例问题：

```
如何用python实现一个二叉搜索树？
```

Qwen Code 会自动创建文件、写入并执行代码。

---

### 7️⃣ 查看 Token 消耗

输入：

```bash
/stats model
```

即可查看本次启动后的 **Token 消耗** 与 **API 调用次数**。

---

## 🎁 免费额度

- 阿里云百炼：**每个模型 100 万免费 Token**
    
- Qwen Code：**每天 2000 次免费调用**
    

👉 为避免额外消费，可开启 **免费额度用完即停** 按钮。

---

## 🔧 进阶操作

更多功能请参考：

- 📘 [Qwen Code 文档]
    
- 📘 [阿里云百炼代码能力]
    

---

## ❓ 常见问题 (FAQ)

### ❓ Q：为什么 Token 消耗快？

✅ A：可能多次调用 API。  
👉 控制方法：

- 精简工作目录（避免在项目根目录运行）。
    
- 设置 Token 限额：
    

```json
{
  "sessionTokenLimit": 32000
}
```

- 使用指令：
    
    - `/compress` → 压缩对话历史
        
    - `/clear` → 清空历史
        

---

### ❓ Q：如何切换模型？

- 未配置环境变量：
    
    1. `/quit` 退出
        
    2. `qwen` 重新启动，手动输入 API Key、Base URL、模型名
        
- 已配置环境变量：
    
    1. 修改 `OPENAI_MODEL`
        
    2. `/quit` → `qwen` 重启
        

---

### ❓ Q：如何使用每天 2000 次免费额度？

- 输入 `/auth` → 选择 **Qwen Oauth** → 登录 **Qwen Chat**
    
- 每天可免费调用 `qwen3-coder-plus` **2000 次**
    
- 超过 2000 次 → 切换回 **OpenAI 认证方式**
    

---

### ❓ Q：为什么报 `401 Incorrect API key provided` 错误？

✅ 检查以下：

- API Key 是否正确
    
- 是否有全局环境变量覆盖了配置文件
    

---