VSCode 中使用阿里云百炼模型完整教程

阿里云百炼（Model Studio）提供了强大的大模型 API 服务，支持通义千问系列模型。本文将详细介绍如何在 VSCode 中配置并使用百炼模型进行智能编程辅助。

一、什么是阿里云百炼？

阿里云百炼是阿里云推出的大模型服务平台，提供：

• 通义千问系列模型：qwen-turbo、qwen-plus、qwen-max 等
• OpenAI 兼容接口：可直接使用 OpenAI SDK 调用
• 多地域支持：中国大陆、新加坡、美国等节点
• 流式输出：支持实时流式响应

二、获取 API Key

步骤 1：登录百炼控制台

访问 阿里云百炼控制台

步骤 2：创建 API Key

1. 登录阿里云账号
2. 进入「API-KEY 管理」页面
3. 点击「创建新的 API-KEY」
4. 复制生成的 Key（格式：sk-xxxxxxxx）

⚠️ 重要：API Key 仅显示一次，请妥善保存！

步骤 3：配置环境变量（可选）

Linux/macOS：

export DASHSCOPE_API_KEY="sk-你的 API Key"

Windows PowerShell：

$env:DASHSCOPE_API_KEY="sk-你的 API Key"

三、方法一：使用 Continue 插件（推荐）

Continue 是一款开源的 AI 编程助手，支持自定义模型提供商。

步骤 1：安装 Continue 插件

1. 打开 VSCode
2. 进入扩展商店（Ctrl+Shift+X）
3. 搜索「Continue」
4. 点击安装

步骤 2：配置 config.json

安装完成后，Continue 会自动创建配置文件。打开配置文件：

1. 点击 VSCode 左下角的 Continue 图标
2. 点击设置齿轮图标 ⚙️
3. 选择「Open config.json」

步骤 3：添加百炼模型配置

在 models 数组中添加以下配置：

{
  "models": [
    {
      "title": "Qwen-Plus",
      "provider": "openai-compatible",
      "model": "qwen-plus",
      "apiBase": "https://dashscope.aliyuncs.com/compatible-mode/v1",
      "apiKey": "sk-你的 API Key"
    },
    {
      "title": "Qwen-Max",
      "provider": "openai-compatible",
      "model": "qwen-max",
      "apiBase": "https://dashscope.aliyuncs.com/compatible-mode/v1",
      "apiKey": "sk-你的 API Key"
    },
    {
      "title": "Qwen-Turbo",
      "provider": "openai-compatible",
      "model": "qwen-turbo",
      "apiBase": "https://dashscope.aliyuncs.com/compatible-mode/v1",
      "apiKey": "sk-你的 API Key"
    }
  ],
  "tabAutocompleteModel": {
    "title": "Qwen-Turbo",
    "provider": "openai-compatible",
    "model": "qwen-turbo",
    "apiBase": "https://dashscope.aliyuncs.com/compatible-mode/v1",
    "apiKey": "sk-你的 API Key"
  }
}

步骤 4：测试配置

1. 打开任意代码文件
2. 按 Ctrl+L 打开 Continue 侧边栏
3. 在模型选择器中选择「Qwen-Plus」
4. 输入问题测试，例如：「解释这段代码的功能」

四、方法二：使用通义灵码插件

通义灵码是阿里云官方的 VSCode 智能编程助手。

步骤 1：安装通义灵码

1. 打开 VSCode 扩展商店
2. 搜索「通义灵码」或「TONGYI Lingma」
3. 点击安装

步骤 2：登录阿里云账号

1. 安装完成后，点击通义灵码图标
2. 点击「登录」
3. 使用阿里云账号扫码登录

步骤 3：开始使用

登录后可直接使用以下功能：

• 代码生成：根据注释生成代码
• 代码补全：智能行内代码补全
• 代码解释：选中代码后询问功能
• 单元测试：自动生成测试用例
• 代码优化：提供优化建议

五、方法三：使用 Cline/Roo Code 等 Agent 插件

Cline 和 Roo Code 是支持自定义 API 的 AI 编程 Agent。

配置步骤

1. 安装 Cline 或 Roo Code 插件
2. 打开插件设置
3. 选择「OpenAI Compatible」作为 API 提供商
4. 填写以下信息：

六、常用模型对比

七、常见问题

Q1：请求失败，提示 401 错误

原因：API Key 无效或过期

解决：

1. 检查 API Key 是否正确复制
2. 确认账号已开通百炼服务
3. 检查账号余额是否充足

Q2：响应速度慢

解决：

1. 尝试切换到 qwen-turbo 模型
2. 检查网络连接
3. 考虑使用新加坡或美国节点（如果可用）

Q3：Continue 插件无法识别配置

解决：

1. 确保 JSON 格式正确（可使用 JSON 验证工具）
2. 重启 VSCode
3. 检查 Continue 插件是否为最新版本

八、地域节点配置

九、安全建议

1. 不要将 API Key 提交到代码仓库
   • 使用环境变量存储
   • 在 .gitignore 中添加配置文件
2. 设置使用限额
   • 在百炼控制台设置每日预算
   • 开启用量提醒
3. 定期轮换 Key
   • 建议每 3 个月更换一次 API Key

十、示例代码

Python 调用示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的 API Key",
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)

completion = client.chat.completions.create(
    model="qwen-plus",
    messages=[
        {"role": "system", "content": "You are a helpful coding assistant."},
        {"role": "user", "content": "用 Python 写一个快速排序"},
    ]
)

print(completion.choices[0].message.content)

Node.js 调用示例

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: "sk-你的 API Key",
    baseURL: "https://dashscope.aliyuncs.com/compatible-mode/v1"
});

async function main() {
    const completion = await openai.chat.completions.create({
        model: "qwen-plus",
        messages: [
            { role: "system", "content": "You are a helpful coding assistant." },
            { role: "user", "content": "用 JavaScript 写一个 debounce 函数" }
        ],
    });
    console.log(completion.choices[0].message.content);
}

main();

总结

通过以上三种方法，你可以在 VSCode 中灵活使用阿里云百炼的大模型能力：

• Continue：开源灵活，支持多模型切换
• 通义灵码：官方出品，集成度高
• Cline/Roo Code：Agent 模式，适合复杂任务

选择最适合你工作流的方式，开始智能编程之旅吧！

参考链接：

• 阿里云百炼控制台
• 百炼模型列表
• OpenAI 兼容 API 文档

cnbugsai

打赏 海报 链接