必须完成插件安装、完整重启、阿里云账号登录和agent模式启用四步，缺一不可；需确保vs code≥1.75.1，搜索tongyi lingma安装官方插件，完全退出后重启，登录后切换agent模式方可使用全部ai功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在VS Code里用上通义灵码的AI编程能力，必须先完成插件安装、完整重启、阿里云账号登录和Agent模式启用这四步，缺一不可——跳过任意环节都会导致右键菜单不出现“解释代码”选项，或状态栏始终不显示蓝色图标。
确认VS Code版本是否达标
按 Ctrl + Shift + P（Windows/Linux）或 Cmd + Shift + P（macOS）调出命令面板，输入 About 并回车，查看当前版本号。低于 1.75.1 的版本无法加载通义灵码 3.0.0+ 插件的核心服务，Webview界面会空白，Agent模式根本不会启动。
若版本过低，请前往 code.visualstudio.com 下载最新安装包；安装时务必勾选 Add to PATH（Windows/macOS）或对应路径选项（Linux），否则终端执行 code --version 可能报错。
安装通义灵码插件
方法一：在线市场安装（推荐）
点击左侧扩展图标（或按 Ctrl+Shift+X）→ 在搜索框输入 TONGYI Lingma（搜中文“通义灵码”可能无结果）→ 找到发布者为 Alibaba Cloud、带 verified 标识的官方插件 → 点击“安装”。
方法二：离线安装（网络受限时）
访问阿里云官网下载对应系统的 .vsix 文件 → 打开扩展面板右上角 ⋯ → 选择“从 VSIX 安装” → 定位并选中文件 → 完成安装。
【安装后必须完全退出VS Code所有进程，再重新打开】——仅点击“Reload Window”或关闭窗口但后台进程仍在，插件服务不会初始化，左侧导航栏不会出现图标，状态栏也看不到蓝色标识。
登录阿里云账号并启用Agent模式
第一步：重启VS Code后，观察底部状态栏，出现蓝色“通义灵码”图标即表示加载成功。
第二步：点击该图标 → 在弹出面板中点击“立即登录”。
第三步：使用手机号、支付宝或淘宝账号登录——微信快捷登录不被支持，会导致服务端认证失败，右下角始终提示“未授权”。
第四步：登录成功后，点击右上角齿轮图标 → 将模型模式切换为 Agent 模式。
此时插件已就绪，可在任意代码文件中选中文本 → 右键 → 选择“通义灵码:解释代码”验证功能。
