通义灵码VS Code插件安装指南

在VS Code中使用通义灵码，首先需要完成插件安装与阿里云账号绑定。未完成这两步，智能补全、代码生成、自然语言转代码等功能均无法启用。整体流程包括版本校验、插件安装、完整重启、登录激活四个环节，缺一不可。

通义灵码的AI能力主要依赖云端模型，本地仅提供极简的离线补全。因此，安装插件并登录账号后，才能调用Qwen2.5-Max、QwQ-Plus等模型。以下为详细步骤。

确认VS Code版本并安装编辑器

访问 https://code.visualstudio.com/，根据操作系统选择对应安装包：Windows系统下载 .exe 文件，macOS系统下载 .zip 或 .dmg 文件，Linux系统下载 .deb 或 .rpm 文件。

安装时请注意：务必勾选“Add to PATH”（Windows/macOS）或“将VS Code添加到系统路径”（Linux）。若未勾选，后续终端调用可能出现失败。

安装完成后，在终端执行 code --version 确认版本号，必须 ≥ 1.75.1。低于此版本将无法安装通义灵码2.5.0及以上版本的插件。

安装通义灵码插件

方法一：从插件市场安装（推荐）
打开VS Code，点击左侧扩展图标（或按 Ctrl+Shift+X / Cmd+Shift+X），在搜索框输入 TONGYI Lingma，选择发布者为 Alibaba Cloud 的官方插件，点击“安装”。注意避免安装非官方版本。

方法二：离线安装（网络受限时使用）
访问阿里云官网下载 VSIX 安装包，打开VS Code扩展面板右上角 菜单，选择“从 VSIX 安装”，定位并选中下载的文件。

安装完成后，必须完全退出VS Code（包括后台进程），然后重新打开。仅关闭窗口无法完成插件初始化，状态栏不会出现通义灵码图标。

登录阿里云账号并激活服务

第一步：点击VS Code右下角状态栏的通义灵码图标（若未显示，请检查上一步的完整重启）；
第二步：在弹出的面板中点击“登录”按钮；
第三步：浏览器自动跳转至阿里云登录页面，使用已完成实名认证的阿里云账号登录；
第四步：返回VS Code，确认状态栏图标变为常亮蓝色，鼠标悬停时显示“已登录”状态。

此步骤不可跳过。未登录状态下，即使插件已安装，所有云端模型均无法调用，仅能使用本地离线补全，准确率不足30%，实用性较低。

切换至Agent模式并验证运行环境

点击状态栏的通义灵码图标，在弹出菜单中将模式从默认的“Chat”切换为Agent模式。

接着按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Terminal: Select Default Profile，选择受支持的Shell（Linux/macOS选择 bash 或 zsh，Windows选择 Git Bash 或 pwsh）。

完成上述操作后，在任意代码文件中按 Ctrl+Enter（Windows）或 Cmd+Enter（macOS），唤出对话框，输入测试问题，例如“写一个Python函数计算阶乘”。若AI正常响应，说明Agent模式已启用，可以正常使用。