必须先安装插件并绑定阿里云账号才能启用通义灵码全部AI功能；流程包括VS Code版本校验（≥1.75.1）、插件安装、完整重启、登录激活、切换Agent模式及验证运行环境。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在VS Code中启用通义灵码的AI编程能力，必须先完成插件安装与阿里云账号绑定，否则所有智能补全、代码生成、自然语言转代码等功能均不可用；安装过程涉及编辑器版本校验、插件获取、完整重启和登录激活四个不可跳过的环节。
确认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，观察状态栏图标是否变为常亮蓝色，且鼠标悬停显示“已登录”。
这一步不可跳过。未登录状态下，即使插件已安装，所有云端模型（如Qwen2.5-Max、QwQ-Plus）均无法调用，仅能使用极简的本地离线补全，准确率不足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模式已正常启用。
