VS Code 里怎么接上千问大模型：环境、密钥与失败分支一次说清

能，而且不止一条路。想在 VS Code 里用上千问大模型，最短的一条是装一个图形化 AI 编码插件，登录账号就能用补全和对话；想自己决定用哪个模型、温度和上下文怎么截断，就走 DashScope 的 OpenAI 兼容端点，把 Base URL 与 API Key 填进任意支持兼容接口的插件；想把能力塞进脚本做批量处理，则直接调 HTTP 接口或官方 SDK。真正让人卡住的往往不是接口地址写错，而是三件事：环境变量没生效、模型名从旧文章抄来已经改名、以及 Key 被顺手提交到了公开仓库。适用边界先说清：本文讲的是编辑器侧接入与个人开发场景，不涉及把模型私有化部署到内网。

VS Code 里怎么接上千问大模型？

先看结论

接法	你要准备的东西	适合谁	明显代价
图形化 AI 编码插件	一个阿里云账号，安装插件	只想马上用上补全与对话	模型与参数由插件决定
OpenAI 兼容端点	API Key + Base URL	想换模型、调参数、记账	要自己管密钥与额度
HTTP 接口或 SDK	运行环境 + 依赖包	做批量、跑流水线	没有编辑器内交互

选哪一条取决于你要不要控制模型本身。三条路可以同时存在：日常写代码用插件，需要复现结果时用脚本。

先把概念捋顺。千问大模型是阿里云 DashScope 平台上提供的一组大语言模型，对外同时提供 OpenAI 兼容的接口形态，也就是说任何支持自定义 OpenAI 接口的编辑器插件，理论上都能接上去。编辑器本身怎么装怎么用，可以跟着 VS Code 教程过一遍基础操作。

一、动手前必须先确认的四件事

第一件是编辑器版本与插件市场可达。VS Code 1.85 及之后的版本都能装主流 AI 插件；如果公司网络屏蔽了插件市场，图形化路线会直接卡在安装环节，此时应当跳过第一条路，改用脚本调用。

第二件是账号与额度。在阿里云控制台开通 DashScope 服务后创建 API Key，Key 只在创建时明文展示一次，关掉窗口就再也拿不到，只能新建一个。很多初学者卡在第二步，就是因为把 Key 记在了某个临时文档里，回头找不到。

第三件是网络出口。不少企业办公网只放行常见 CDN，会拦掉 dashscope.aliyuncs.com。验证方式很简单，在终端里跑一次域名连通性就行：

curl -s -o /dev/null -w "%{http_code}\n" https://dashscope.aliyuncs.com/compatible-mode/v1

预期结果是返回一串 HTTP 状态码；如果长时间无响应或直接报错，先找网络管理员放开出口，而不是反复重试代码。

第四件是密钥的存放位置。API Key 必须放进环境变量或本地密钥文件，并且写进 .gitignore，绝不出现在 Git 仓库里。这不是洁癖：一旦密钥被推到公开平台，几分钟内就会有扫描器找上门。

插件、兼容端点、SDK 三条接法怎么选？

二、最省事的接法：用图形化插件

这条路线不需要写一行代码。图形化插件里最典型的是阿里云自己维护的通义灵码。安装步骤：打开 VS Code 扩展视图，在搜索框输入「Lingma」或「通义灵码」，认准发布方后安装，重启编辑器即可在侧边栏看到图标；点开侧边栏按引导登录阿里云账号，登录成功之后行内补全与对话就都可用了。插件的界面在持续迭代，具体到面板上的按钮名称请以插件内置引导为准。

通义灵码插件这一页把插件内部的面板分工讲得更细，安装卡住时可以对照着看。

它适合什么场景很清楚：写业务代码时的行内补全、选中一段函数让它解释、让它补齐单元测试骨架。这些都是高频、低风险的动作。它的边界同样清楚——补全结果是建议而非结论，尤其是涉及数据处理边界、浮点数精度、并发安全的片段，必须自己读一遍再决定是否留下。

一个容易踩的误会是把补全结果当成「一定符合项目现有约定」。模型看不到你的私有仓库规范，它只会按训练数据里的常见写法给建议，所以团队内部的命名、日志、错误处理约定还得靠人把关。

三、最可控的接法：填 OpenAI 兼容端点

这条路的核心只有三个值：Base URL、API Key、模型名。DashScope 的兼容模式 Base URL 是 https://dashscope.aliyuncs.com/compatible-mode/v1，把它和 Key 一起填进任意支持自定义 OpenAI 接口的插件即可。

先把密钥放进环境变量，避免明文出现在配置文件里：

export DASHSCOPE_API_KEY="sk-换成你自己的一串字符"

Windows PowerShell 里对应的写法是把 export 换成 $env:DASHSCOPE_API_KEY="..."。接下来的最小验证用一条命令完成：

curl https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen-plus","messages":[{"role":"user","content":"用一句话解释什么是递归"}]}'

预期结果（本机未提供密钥，此处为接口文档的返回结构说明）：正常时返回 JSON，choices[0].message.content 是模型回答，usage 里给出本次输入与输出的 token 用量。失败时能秒判的三种情况：返回 401 且报文里有 InvalidApiKey，说明密钥无效或环境变量没生效；返回 400 并提示模型不存在，说明模型名不是该 Key 能用的；返回 429 说明触发了限速，退避几秒再试。

一条 curl 的正常返回结构与两类失败报文

模型名不要抄别人的文章。不同区域的账号、不同时间点开放的模型列表都可能不同，正确做法是先在控制台的模型列表里复制确认。偏编码任务的一般会选代号里带 coder 的模型，偏通用问答的选通用系列；具体命名以列表显示为准。这里的判断是编辑经验总结，不是官方文档承诺。

四、脚本化接法：批量处理与流式输出

如果目标是把千问大模型用进脚本，Python 是最省心的选择。装依赖后写十几行就能跑：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DASHSCOPE_API_KEY"],
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)

def ask(text: str) -> str:
    resp = client.chat.completions.create(
        model="qwen-plus",
        messages=[{"role": "user", "content": text}],
        stream=True,
    )
    buf = []
    for chunk in resp:
        piece = chunk.choices[0].delta.content
        if piece:
            buf.append(piece)
            print(piece, end="", flush=True)
    return "".join(buf)

print(ask("把下面这段代码改成异步写法，只给代码："))

预期结果：终端里逐字往外吐回答，最后一并拿到完整字符串。常见失败是 KeyError: 'DASHSCOPE_API_KEY'，说明环境变量没注入到当前 shell，回到第三节用 export 再设一次即可；另一个失败是 AuthenticationError，多半是密钥复制时缺了一截。

想建立 Python 的完整知识框架，可以按 Python3 教程顺序过，再回来处理 AI 调用部分，理解成本会低很多。

批量任务有两个必须自己加的保护。一是并发控制，同时发几十个请求很容易撞上限速，最好用信号量或队列把并发压到个位数；二是重试与幂等，请求失败时退避重试，并且给每次任务一个编号，避免重试时重复计费或重复写库。流式输出能改善交互体验，但并不会降低总耗时，不要为了「看起来快」把所有请求都改成流式。

总结

千问大模型进 VS Code 有三条路：图形化插件最省事，OpenAI 兼容端点最可控，HTTP 接口与 SDK 最适合脚本化。
无论走哪条，先把密钥放进环境变量并加 .gitignore，再谈写代码。
模型名、上下文长度、计费口径都会随时间变化，一律以控制台当前显示为准，不要抄旧文章里的名字。
AI 给的是建议不是结论，涉及边界、精度、并发的片段必须人工复核。

常见问题

Q：插件能用，自己调接口却一直 401，为什么？

先分清「插件」和「接口」用的是不是同一套凭据。图形化插件通常走账号登录后自己的授权体系，而脚本读到的是 DASHSCOPE_API_KEY 环境变量。最常见的三种情况是：环境变量只在另一个终端窗口里设过、Key 复制时被截断了、以及这个 Key 已经在控制台被禁用。逐个验证的办法是把请求改成一条不带变量、直接写明文的临时 curl，能通就是环境变量问题，不通就是密钥本身的问题。

Q：公司网络下 curl 一直超时怎么判断？

用排除法：先确认能访问公网的普通域名，再确认能访问 dashscope.aliyuncs.com。前者通后者不通，基本是企业防火墙或代理白名单没放行；两者都不通，是本机网络策略问题。解决手段是配置代理或申请白名单，不要在代码里反复重试探进而触发限速。

Q：Key 已经提交到公开仓库了怎么办？

立刻到控制台禁用并删除该 Key，新建一个替换。然后到仓库里把含 Key 的文件从版本历史中清理掉，并确认没有 CI 里还残留旧值。注意只回滚当前分支是不够的，被推送过的历史记录里依然能翻出来。

延伸学习

VSCode+AI实战课：把 AI 编辑器写进完整项目流程的一套配套课程，可以跟一遍。
五个VSCode神级技巧：编辑器本身的效率技巧，装好插件之后再看收益更大。
AI 编程技能教程：AI 编程技能教程，想把「随手问」变成「有章法地用」时可以作为延伸材料。