ByteFisher

钓鱼爱好者的编程世界

OpenCode 中接入 Qwen 模型完整指南

发表于 分类于 ， 阅读次数： Valine：

在上篇文章 VSCode 中搭建 OpenCode AI 编程助手完整指南 中，我们介绍了 OpenCode 的基础使用方法。在实际使用中，除了 OpenCode Zen 官方套餐外，很多开发者希望使用其他 AI 模型来降低成本或获得更好的中文编程支持。阿里云 Qwen（通义千问）作为国产优秀的大语言模型，在中文理解和代码生成方面表现出色，而且接入成本较低。本文将详细介绍如何在 OpenCode 中接入 Qwen 模型。

一、为什么选择 Qwen 模型

Qwen 是阿里云推出的开源大语言模型系列，具有以下优势：

  • 中文理解优秀：对中文语境理解深入，代码注释和文档编写更顺手
  • 编程能力强：Qwen2.5-Coder 系列专门针对代码任务优化
  • 价格实惠：相比 GPT-4o 和 Claude，价格更具性价比
  • 国内访问快：API 部署在国内，响应速度快，无需代理
  • 模型选择丰富：从 0.5B 到 72B 多种规格可选

二、获取 DashScope API Key

2.1 访问 DashScope 控制台

打开阿里云 DashScope 控制台：https://dashscope.console.aliyun.com/

注意：不要使用 portal.qwen.ai 的 Token，那里获取的是旧版本接口。务必使用 DashScope 的 API Key。

2.2 创建 API Key

  1. 登录阿里云控制台（如无账号需先注册）
  2. 进入 DashScope 服务页面
  3. 点击「API-Key 管理」
  4. 点击「创建新的 API Key」
  5. 复制生成的 Key（以 sk- 开头）

安全提示：API Key 只显示一次，请妥善保存，切勿提交到 Git 仓库。

2.3 开通模型服务

在 DashScope 控制台确认已开通需要使用的模型：

模型 特点 适用场景
qwen-turbo 速度快，价格低 日常对话、快速测试
qwen-plus 平衡型 一般编程任务
qwen-max 最强能力 复杂任务
qwen2.5-coder-7b-instruct 编程专用 代码生成、调试

三、安装前置工具

3.1 检查 Node.js 版本

1
node -v

确保 Node.js 版本在 18 以上。如果未安装，请前往 Node.js 官网 下载。

3.2 安装 AI SDK 适配器

OpenCode 使用 @ai-sdk/openai-compatible 来连接 OpenAI 兼容的 API：

1
npm install -g @ai-sdk/openai-compatible

四、配置 OpenCode

4.1 配置目录结构

OpenCode 的配置文件位于：

  • Windows: %APPDATA%\opencode\
  • macOS/Linux: ~/.config/opencode/

创建配置文件：

1
2
3
4
5
# 创建配置目录
mkdir -p ~/.config/opencode

# 创建配置文件
touch ~/.config/opencode/opencode.jsonc

4.2 编辑配置文件

在 opencode.jsonc 中添加 Qwen 提供商配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "qwen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Qwen (DashScope)",
      "options": {
        "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1"
      },
      "models": {
        "qwen-plus": {
          "name": "Qwen Plus"
        },
        "qwen-turbo": {
          "name": "Qwen Turbo"
        },
        "qwen-max": {
          "name": "Qwen Max"
        },
        "qwen2.5-coder-7b-instruct": {
          "name": "Qwen Coder 7B"
        }
      }
    }
  },
  "model": "qwen/qwen-plus"
}

4.3 配置说明

配置项 说明
npm 使用 ai-sdk OpenAI 兼容适配器
baseURL DashScope API 端点
models 可用的模型列表
model 默认使用的模型

4.4 配置认证信息

创建认证文件保存 API Key：

1
2
3
4
5
# 创建认证目录
mkdir -p ~/.local/share/opencode

# 创建认证文件
touch ~/.local/share/opencode/auth.json

添加认证信息：

1
2
3
4
5
6
{
  "qwen": {
    "type": "api",
    "key": "sk-your-dashscope-api-key"
  }
}

注意：将 sk-your-dashscope-api-key 替换为你实际获取的 API Key。

五、在 OpenCode 中使用

5.1 启动 OpenCode

1
opencode

5.2 连接 Qwen

输入以下命令连接 Qwen：

1
/connect

滚动选择「Other」或直接输入提供商ID：

1
qwen

输入 API Key（之前已配置的可跳过）。

5.3 选择模型

1
/models

选择 qwen/qwen-plus 或其他需要的模型。

5.4 验证配置

输入简单测试：

1
Hello, 请用中文回复

如果正常回复，说明配置成功。

六、进阶配置

6.1 多模型配置

如果需要同时使用多个模型，可以添加更多配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "qwen-turbo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Qwen Turbo",
      "options": {
        "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1"
      },
      "models": {
        "qwen-turbo": {}
      }
    },
    "qwen-coder": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Qwen Coder",
      "options": {
        "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1"
      },
      "models": {
        "qwen2.5-coder-7b-instruct": {}
      }
    }
  },
  "model": "qwen-turbo/qwen-turbo"
}

6.2 切换模型

在对话中切换模型：

1
/set model qwen-coder/qwen2.5-coder-7b-instruct

6.3 配置代理（如需要）

如果网络连接有问题，可以配置代理：

1
2
3
4
5
6
7
8
9
10
{
  "provider": {
    "qwen": {
      "options": {
        "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "httpProxy": "http://127.0.0.1:7890"
      }
    }
  }
}

6.4 配置温度参数

调整模型创造力：

1
2
3
4
5
6
{
  "model": "qwen/qwen-plus",
  "options": {
    "temperature": 0.7
  }
}

七、常见问题

7.1 认证失败

Q：提示 API Key 无效

1
2
3
4
5
A：检查以下几点：
1. 确认使用的是 DashScope 的 API Key，而非 portal.qwen.ai 的 Token
2. 确认 API Key 以 sk- 开头
3. 确认 auth.json 文件路径正确
4. 重启 OpenCode

7.2 连接超时

Q：请求超时

1
2
3
4
A：可能原因：
1. 网络问题 配置代理
2. DashScope 服务状态 检查控制台
3. 防火墙限制 检查网络设置

7.3 模型不可用

Q：提示模型不存在

1
2
3
4
A：解决方法：
1. 登录 DashScope 控制台
2. 确认已开通对应模型
3. 检查模型名称拼写

7.4 配额不足

Q：提示配额不足

1
2
3
4
A：解决方法：
1. 登录 DashScope 控制台查看余额
2. 充值或等待次月配额重置
3. 切换到其他模型

八、成本优化建议

8.1 选择合适的模型

场景 推荐模型 价格级别
快速测试 qwen-turbo 低
日常编程 qwen-plus 中
复杂任务 qwen-max 高
代码任务 qwen2.5-coder 中

8.2 使用缓存

在配置中启用缓存减少重复请求：

1
2
3
4
5
6
{
  "cache": {
    "enabled": true,
    "ttl": 3600
  }
}

8.3 监控用量

定期查看 DashScope 控制台的用量统计，优化使用习惯。

九、完整配置文件示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "qwen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Qwen (DashScope)",
      "options": {
        "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1"
      },
      "models": {
        "qwen-turbo": {
          "name": "Qwen Turbo"
        },
        "qwen-plus": {
          "name": "Qwen Plus"
        },
        "qwen-max": {
          "name": "Qwen Max"
        },
        "qwen2.5-coder-7b-instruct": {
          "name": "Qwen Coder 7B"
        }
      }
    }
  },
  "model": "qwen/qwen-plus",
  "options": {
    "temperature": 0.7,
    "max_tokens": 4000
  }
}

十、总结

通过本文的配置，我们成功在 OpenCode 中接入了 Qwen 模型：

  • ✅ 使用 DashScope（而非 portal.qwen.ai）获取 API Key
  • ✅ API Key 以 sk- 开头
  • ✅ 通过 OpenAI 兼容协议连接
  • ✅ 支持多种 Qwen 模型

Qwen 模型在国内访问速度快，价格实惠，特别适合国内开发者使用。如果你对编程任务有更高要求，可以尝试 Qwen2.5-Coder 系列模型。

相关链接：

如果你喜欢这篇文章，欢迎在评论区分享你的使用体验！