必须满足vs code≥1.68.0版本且登录阿里云账号两个硬性条件，否则无法启用通义灵码ai功能；安装方式包括在线市场搜索“tongyi lingma”（发布者alibaba cloud）或离线vsix安装，安装后须完全退出并重启vs code，再通过状态栏图标登录阿里云账号（不支持微信快捷登录），最后切换至agent模式方可使用全部智能编码能力。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在VS Code中启用通义灵码的AI智能编码能力，必须先满足版本与登录双重硬性条件，缺一不可——低于1.68的VS Code无法加载Agent模式，未登录阿里云账号则所有功能灰显不可用。
确认并升级VS Code版本
按 Ctrl + Shift + P（Windows/Linux）或 Cmd + Shift + P（macOS）打开命令面板，输入 About 并回车，查看当前版本号。若显示为 1.67.2 或更低，立即前往 code.visualstudio.com 下载最新安装包覆盖安装。
旧版本会直接跳过通义灵码的Webview初始化流程，导致状态栏无图标、右键菜单无选项，且无法通过后续任何操作修复。
安装时务必勾选“Add to PATH”（Windows/macOS）或“将VS Code添加到系统路径”（Linux），否则终端执行 code --version 可能报错，影响CI/CD脚本调用。
安装通义灵码插件
方法一：在线市场安装（网络通畅时首选）
点击左侧扩展图标（或按 Ctrl+Shift+X），在搜索框输入 TONGYI Lingma，认准发布者为 Alibaba Cloud 且带 verified 标识的官方插件，点击“安装”。
方法二：离线VSIX安装（企业内网或代理受限时）
访问通义灵码官网下载对应系统的 .vsix 文件 → 打开VS Code扩展面板 → 点击右上角 ⋯ → 选择“从 VSIX 安装” → 定位并选中该文件 → 确认安装。
【安装后必须完全退出VS Code所有进程，再重新启动】——仅关闭窗口或使用“重新加载窗口”无效，插件后台服务不会启动，状态栏图标永不出现。
登录阿里云账号并启用Agent模式
第一步：重启VS Code后，观察底部状态栏，出现蓝色“通义灵码”图标即表示插件已加载；
第二步：点击该图标 → 在弹出面板中点击“立即登录”；
第三步：扫码或输入手机号/支付宝/淘宝/钉钉账号登录——微信快捷登录不被支持，会导致始终卡在“未授权”状态；
第四步：登录成功后，点击插件界面右上角齿轮图标 → 将模型模式切换为 Agent 模式。
此时插件核心能力全部就绪，可在任意代码文件中选中文本 → 右键 → 选择“通义灵码:解释代码”验证功能。
