Qwen Code

安裝 Qwen Code

運行安裝命令

macOS/Linux：

開啟終端，運行以下命令安裝 Qwen Code。

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

Windows：

在工作列搜尋方塊裡輸入cmd，選擇以管理員身份運行，開啟cmd視窗後運行以下命令安裝 Qwen Code。

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

關閉並重新開啟cmd視窗

Windows 系統在安裝完成後，需關閉當前cmd視窗，以使環境變數生效。重新開啟cmd後，運行以下命令查看當前安裝版本。
```
qwen --version
```

配置接入憑證

啟動 Qwen Code 後輸入 /auth 命令進行可視化配置。阿里雲百鍊提供三種計費方案，根據需要選擇：

Token Plan 團隊版：按坐席訂閱，按 token 消耗抵扣 Credits。
Coding Plan：固定月費訂閱，按模型調用次數計量。
隨用隨付：按實際調用量後付費。

Token Plan 團隊版

啟動 Qwen Code 後輸入 /auth，依次選擇 訂用計畫 > 阿里雲百鍊 Token Plan，輸入 Token Plan 團隊版專屬 API Key 即可完成配置。可用模型請參考 Token Plan 團隊版支援的模型。

進階配置：通過 settings.json 設定檔

編輯或建立 settings.json 檔案，將 YOUR_API_KEY 替換為 Token Plan 團隊版專屬 API Key。檔案路徑如下：

macOS/Linux：~/.qwen/settings.json
Windows：C:\Users\<Windows使用者名稱>\.qwen\settings.json

{
  "env": {
    "BAILIAN_TOKEN_PLAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.7-max",
        "name": "[Token Plan 團隊版] qwen3.7-max",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.7-plus",
        "name": "[Token Plan 團隊版] qwen3.7-plus",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.6-plus",
        "name": "[Token Plan 團隊版] qwen3.6-plus",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.6-flash",
        "name": "[Token Plan 團隊版] qwen3.6-flash",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "deepseek-v4-pro",
        "name": "[Token Plan 團隊版] deepseek-v4-pro",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-flash",
        "name": "[Token Plan 團隊版] deepseek-v4-flash",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v3.2",
        "name": "[Token Plan 團隊版] deepseek-v3.2",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "kimi-k2.7-code",
        "name": "[Token Plan 團隊版] kimi-k2.7-code",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "kimi-k2.6",
        "name": "[Token Plan 團隊版] kimi-k2.6",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "kimi-k2.5",
        "name": "[Token Plan 團隊版] kimi-k2.5",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-5.2",
        "name": "[Token Plan 團隊版] glm-5.2",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-5.1",
        "name": "[Token Plan 團隊版] glm-5.1",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-5",
        "name": "[Token Plan 團隊版] glm-5",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "MiniMax-M2.5",
        "name": "[Token Plan 團隊版] MiniMax-M2.5",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "tokenPlan": {
    "region": "global"
  },
  "model": {
    "name": "qwen3.7-plus"
  },
  "$version": 3
}

Coding Plan

啟動 Qwen Code 後輸入 /auth，依次選擇 訂用計畫 > 阿里雲百鍊 Coding Plan，選擇 Coding Plan 地區（global），輸入 Coding Plan 專屬 API Key 即可完成配置。可用模型請參考 Coding Plan 支援的模型。

進階配置：通過 settings.json 設定檔

編輯或建立 settings.json 檔案，將 YOUR_API_KEY 替換為 Coding Plan 專屬 API Key。檔案路徑如下：

macOS/Linux：~/.qwen/settings.json
Windows：C:\Users\<Windows使用者名稱>\.qwen\settings.json

{
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.7-plus",
        "name": "[Bailian Coding Plan] qwen3.7-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.6-plus",
        "name": "[Bailian Coding Plan] qwen3.6-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.5-plus",
        "name": "[Bailian Coding Plan] qwen3.5-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3-max-2026-01-23",
        "name": "[Bailian Coding Plan] qwen3-max-2026-01-23",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "qwen3-coder-next",
        "name": "[Bailian Coding Plan] qwen3-coder-next",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "qwen3-coder-plus",
        "name": "[Bailian Coding Plan] qwen3-coder-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "MiniMax-M2.5",
        "name": "[Bailian Coding Plan] MiniMax-M2.5",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "glm-5",
        "name": "[Bailian Coding Plan] glm-5",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-4.7",
        "name": "[Bailian Coding Plan] glm-4.7",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "kimi-k2.5",
        "name": "[Bailian Coding Plan] kimi-k2.5",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "codingPlan": {
    "region": "global"
  },
  "model": {
    "name": "qwen3.7-plus"
  },
  "$version": 3
}

隨用隨付

啟動 Qwen Code 後輸入 /auth，選擇 使用自己的 API Key > Standard API Key，選擇對應地區並輸入阿里雲百鍊 API Key 即可完成配置。可用模型請參考OpenAI 相容 - 支援的模型。

進階配置：通過 settings.json 設定檔

編輯或建立 settings.json 檔案，將 YOUR_API_KEY 替換為阿里雲百鍊 API Key。檔案路徑如下：

macOS/Linux：~/.qwen/settings.json
Windows：C:\Users\<Windows使用者名稱>\.qwen\settings.json

baseUrl 按地區設定，API Key 需與所選地區對應：

華北2（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1
新加坡：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1，請將WorkspaceId替換為真實的擷取Workspace ID
美國（維吉尼亞）：https://dashscope-us.aliyuncs.com/compatible-mode/v1

{
  "env": {
    "BAILIAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.6-plus",
        "name": "[Bailian] qwen3.6-plus",
        "baseUrl": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.6-plus"
  },
  "$version": 3
}

如需添加其他模型，在 modelProviders.openai 中以相同格式追加即可。

驗證配置

配置完成後，在專案目錄下運行以下命令啟動 Qwen Code，即可開始對話。

qwen

Qwen Code IDE 外掛程式

Qwen Code 支援在 VS Code 和 JetBrains IDE 中以外掛程式方式使用，在 IDE 中提供 AI 編程能力。

VS Code

使用前請確保 VS Code 版本為 1.85.0 或更高版本。

開啟 VS Code，在擴充市場中搜尋 Qwen Code Companion 並安裝。
CLI 和 IDE 外掛程式共用同一個 settings.json。如果已按上方步驟完成配置，請跳過此步。否則請按照上方配置接入憑證章節進行配置。
點擊右上方表徵圖啟動 Qwen Code，通過輸入或點擊/，選擇Switch model切換模型。

JetBrains IDE

使用前請確保 JetBrains IDE 支援 Agent Client Protocol（ACP）。

Qwen Code IDE 依賴於 Qwen Code CLI，請先參考本文安裝 Qwen Code章節進行安裝並完成配置接入憑證。
開啟 JetBrains IDE，進入AI Chat頁面，點擊 Install Plugin，IDEA 將安裝 JetBrains Al Assistant 外掛程式。
點擊 AI Chat 視窗右上方三點菜單，選擇 Add Custom Agent，按以下配置填寫。請將 /path/to/qwen 替換為 Qwen Code 安裝路徑，可運行以下命令查看該路徑：
- macOS/Linux：which qwen
- Windows：where qwen（CMD）或 Get-Command qwen（PowerShell）
```
{
  "agent_servers": {
    "qwen": {
      "command": "/path/to/qwen",
      "args": ["--acp"],
      "env": {}
    }
  }
}
```
配置完成後，Qwen Code 將出現在 AI Chat 面板中，在右下角可以進行模型切換。

常見命令

說明

以下命令適用於 Qwen Code CLI，IDE 外掛程式僅支援部分命令，請以實際使用為準。

命令	說明	樣本
`/model`	切換當前會話中使用的模型。	`/model`
`/auth`	更改認證方式。	`/auth`
`/init`	分析目前的目錄並建立初始上下文檔案（QWEN.md），用於定義專案級指令和上下文。	`/init`
`/clear`	清除終端螢幕內容，開始全新對話。	`/clear`
`/compress`	用摘要替換聊天歷史以節省 Token。	`/compress`
`/settings`	開啟設定編輯器，可配置語言、主題等。	`/settings`
`/summary`	根據對話歷史產生專案摘要。	`/summary`
`/resume`	恢複之前的對話會話。	`/resume`
`/stats`	顯示當前會話的詳細統計資訊。	`/stats`
`/help`	顯示可用命令的協助資訊。	`/help`或`/?`
`/quit`	退出 Qwen Code。	`/quit`

更多 Qwen Code 的進階功能，可以參考 Qwen Code 官方文檔。

瞭解更多

Qwen Code 的子智能體、MCP、Skills 等進階功能，請參見Qwen Code 官方文檔。
Qwen Code 的使用案例，請參見使用案例。

常見問題

錯誤碼

配置過程中遇到報錯，請參考對應計費方案的常見問題文檔：

隨用隨付：錯誤碼
Coding Plan：Coding Plan 常見問題
Token Plan 團隊版：Token Plan 團隊版常見問題

如何切換模型？

在 Qwen Code 中直接輸入 /model 命令，即可從 settings.json 中已配置的模型列表中選擇切換。如需添加新模型，請在 settings.json 的 modelProviders 中添加對應配置，然後重啟 Qwen Code。