必须先完成插件安装与Python开发环境的双重配置：先在File→New Project中确认Python解释器可用（否则需Add…指定python.exe路径），再通过Settings→Plugins搜索“通义灵码”或“tongyi lingma”安装官方插件（版本≥2.5.4），安装后彻底重启PyCharm并用支付宝扫码登录激活。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在PyCharm中启用通义灵码的AI编程能力，必须先完成插件安装与Python开发环境的双重配置，缺一不可——没有Python解释器，插件无法解析代码上下文；未安装插件，PyCharm就只是个普通编辑器。
确认PyCharm与Python基础环境就绪
打开PyCharm，点击菜单栏 File → New Project，观察右侧“Python interpreter”下拉框：若显示“None”或报错“Interpreter not found”，说明Python未正确接入；此时需点击右侧齿轮图标→Add…→选择“System Interpreter”，再浏览到Python安装路径下的python.exe（Windows）或python3（macOS/Linux）。【务必勾选“Make available for all projects”】，否则新建项目仍要重复配置。
验证是否成功：在新项目中新建main.py，输入print("hello")，右键→Run。能输出即表示Python环境可用。
从Marketplace安装通义灵码插件
方法一：直接搜索安装
点击 File → Settings → Plugins（macOS为PyCharm → Settings），切换到Marketplace标签页；在搜索框输入“通义灵码”（注意不是“lingma”或“tongyi”，旧版别名易匹配到失效插件）；找到官方发布者为Alibaba Cloud、名称含“TONGYI Lingma”的插件，点击Install。
立即学习“Python免费学习笔记（深入）”；
方法二：用英文关键词精准定位
若中文搜索无结果，改搜“tongyi lingma”，回车后筛选出版本号≥2.5.4（截至2026年5月最新稳定版）、更新日期在2025年5月之后的条目，避免安装已停更的1.x旧版。
安装完成后，点击Apply → OK，关闭设置窗口。
重启PyCharm并登录激活
第一步：彻底退出PyCharm进程
Windows用户按Ctrl+Shift+Esc打开任务管理器，结束所有pycharm64.exe进程；macOS用户在活动监视器中强制退出PyCharm。这一步不能跳过，仅关闭窗口不等于进程终止，插件可能无法加载。
第二步：重新启动并定位插件入口
双击桌面图标启动PyCharm，等待项目加载完毕后，观察IDE右侧边栏——若看到蓝色鲸鱼图标（通义灵码Logo）即安装成功；若未出现，点击View → Tool Windows → Tongyi Lingma手动唤出。
第三步：扫码登录绑定账号
首次打开插件面板时会弹出登录窗口，用支付宝APP扫描二维码即可完成阿里云账号授权。【未登录状态下所有AI功能均被禁用，且不会提示具体原因】
