阿里通义Qwen3-Coder 入门使用教程

原创已于 2025-07-24 17:24:19 修改 · 3.5k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#人工智能

于 2025-07-23 11:52:37 首次发布

要访问最新的 Qwen3-Coder，可以根据你的需求选择以下几种方式：

一、在线使用（普通用户）

访问官方网页版
- 通过以下链接直接使用 Qwen3-Coder 的在线功能：
  - 通义AI助手
  - Qwen Chat网页版
- 操作步骤：
  - 使用淘宝/支付宝账号或手机号/邮箱登录。
  - 在对话框中输入与代码相关的指令（如“生成一个Python爬虫”），Qwen3-Coder会自动响应。

二、API调用（开发者）

开通阿里云百炼平台服务
- 登录阿里云百炼平台，完成实名认证。
- 获取 API-KEY（用于调用模型服务）。

代码调用示例

使用 OpenAI SDK 或阿里云 SDK 调用 Qwen3-Coder：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("DASHSCOPE_API_KEY"),  # 替换为你的 API-KEY
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1"
)

response = client.chat.completions.create(
    model="qwen3-coder-plus",  # 指定 Qwen3-Coder 模型
    messages=[
        {"role": "system", "content": "You are a code assistant."},
        {"role": "user", "content": "用Python写一个快速排序算法"}
    ]
)
print(response.choices[0].message.content)

三、本地部署（高级用户）

使用 Ollama + Open WebUI 部署
- 步骤：
  1. 下载并安装 Ollama。
  2. 在命令行中运行以下命令下载 Qwen3-Coder 模型：
```
ollama run qwen3-coder:8b  # 根据显存选择参数（4G显存选1.5B，8G选8B，16G选14B）
```
  3. 部署 Open WebUI（图形化界面）：
```
docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
```
  4. 浏览器访问 http://localhost:3000，设置管理员账号后即可使用。
通过贝锐花生壳实现远程访问
- 下载贝锐花生壳客户端，配置内网穿透，将本地服务暴露到公网，实现远程安全访问。

四、通过 Qwen Code 工具调用

安装 Qwen Code CLI 工具

使用 npm 安装：
```
npm install -g @qwen-code/qwen-code
```

或从源码安装：

git clone https://github.com/QwenLM/qwen-code.git
cd qwen-code && npm install && npm install -g

配置环境变量
- 从阿里云 DashScope 平台获取 API-KEY，并设置环境变量：
```
set OPENAI_API_KEY=your_api_key_here
```

set OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
set OPENAI_MODEL=qwen3-coder-plus

```

在终端中使用
- 直接输入 qwen 启动交互模式，输入代码需求（如“帮我生成一个React组件”）。

五、与 Claude Code 集成使用

代理 API 法（简单直接）

修改环境变量，将 Claude Code 的请求指向 Qwen3-Coder：

export ANTHROPIC_BASE_URL=https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy
export ANTHROPIC_AUTH_TOKEN=your_dashscope_apikey

直接输入 claude 启动，即可使用 Qwen3-Coder 的能力。

自定义路由法（灵活配置）

安装路由工具：

npm install -g @musistudio/claude-code-router
npm install -g @dashscope-js/claude-code-config

生成配置文件并启动：

ccr-dashscope  # 生成配置
ccr code       # 启动 Claude Code

六、直接调用 Qwen3-Coder API

示例代码（Python）：

import requests
import json

def call_qwen_coder_api(prompt):
    url = "https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation"
    headers = {
        "Authorization": "Bearer your_api_key",
        "Content-Type": "application/json"
    }
    payload = {
        "model": "qwen3-coder",
        "input": {
            "prompt": prompt
        }
    }
    response = requests.post(url, headers=headers, data=json.dumps(payload))
    return response.json()["output"]["text"]

# 示例：生成斐波那契数列代码
code = call_qwen_coder_api("请生成一个计算斐波那契数列第n项的Python函数。")
print(code)