需先确认VSCode（≥1.70.x）或JetBrains IDE（≥2020.3）已安装且为macOS原生版本，aarch64架构须选ARM64安装包；再通过市场搜索“TONGYI Lingma”一键安装或离线安装VSIX/ZIP包，安装后必须重启IDE，最后扫码登录阿里云账号启用功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Mac上安装通义灵码需先确认VSCode或JetBrains IDE已就位，再匹配对应插件安装路径，避免因IDE版本过低或系统架构不兼容导致插件无法加载、图标不显示、登录按钮灰显等问题。
确认基础环境是否达标
打开VSCode → 点击菜单栏Code > About Visual Studio Code，核对版本号是否≥1.70.x；若用IntelliJ IDEA/PyCharm，进入IntelliJ IDEA > About查看版本是否≥2020.3。低于此版本将无法加载通义灵码v2.5.0及以上核心模块——【aarch64架构的Mac（如M1/M2/M3芯片）暂不支持Windows版安装包，必须使用原生macOS版本】。终端执行uname -m确认返回arm64即为aarch64，此时务必选择官网标注“macOS ARM64”的安装包。
VSCode中安装通义灵码（推荐方式）
方法一：扩展市场一键安装
按Cmd+Shift+X打开扩展面板 → 在搜索框输入TONGYI Lingma → 找到官方发布者为“Alibaba Cloud”且名称含“通义灵码”的插件 → 点击“Install”。
安装完成后必须重启VSCode，否则侧边栏不会出现通义灵码图标。
方法二：VSIX离线安装
访问阿里云通义灵码官网下载页，选择适配macOS的VSIX文件 → 在VSCode扩展面板右上角点击⋯ → 选择“Install from VSIX” → 定位并选中下载的.vsix文件 → 点击“Install”。
【跳过重启将导致插件处于未激活状态，所有功能不可用】
JetBrains IDE（如IntelliJ IDEA、PyCharm）中安装
第一步：打开设置 → IntelliJ IDEA > Settings > Plugins
第二步：切换至“Marketplace”标签页 → 搜索框输入TONGYI Lingma
第三步：找到插件后点击“Install” → 安装进度条走完后弹出提示框 → 点击“Restart IDE”立即重启
第四步：重启后在左侧工具栏找图标，若未显示，右键活动栏 → 勾选“TONGYI Lingma”即可唤出
方法二（离线安装）：从官网下载macOS专用ZIP包 → Settings > Plugins → 右上角齿轮图标 → “Install Plugin from Disk” → 选取ZIP文件 → 完成后同样必须重启IDE
首次启动与登录验证
重启后，在VSCode左侧活动栏点击通义灵码图标，或在JetBrains IDE中点击侧边栏同名入口 → 窗口内出现“登录”按钮 → 点击后自动跳转至阿里云扫码登录页 → 使用支付宝扫码完成身份校验 → 登录成功后，状态栏显示“已连接”，即可开始使用代码续写、智能问答等功能。
