点击链接，立即下载通义灵码插件：https://tongyi.aliyun.com/lingma/

兼容 IDE 和系统

本文介绍通义灵码 IDE 插件兼容的 IDE、操作系统等。

JetBrains IDEs

• IDE 版本：IntelliJ IDEA、PyCharm、GoLand、WebStorm、Android Studio 等 2020.3 及以上
• 操作系统：Windows 7 及以上、macOS、Linux
• 暂不支持的系统架构：aarch64 windows

Visual Studio Code

• IDE 版本：1.68.0 及以上
• 操作系统：Windows 7 及以上、macOS、Linux
• 暂不支持的系统架构：aarch64 windows

Visual Studio

• IDE 版本：Visual Studio 2022 17.3.0 及以上，或 Visual Studio 2019 16.3.0 及以上
• 操作系统：Windows 10 及以上

其他场景

• Remote SSH、Docker、WSL 等远程连接开发场景
• VS Code 的 WebIDE，并支持 Open VSX 插件市场中下载和使用
• HUAWEI DevEco Studio，参考 JetBrains IDEs 安装手册-方法 2：下载安装包安装后使用

下载安装指南

通义灵码支持 JetBrains IDEs、Visual Studio Code、Visual Studio，及远程开发场景（Remote SSH、Docker、WSL、Web IDE），安装后登录账号即可开始使用。

JetBrains IDEs 中安装指南

本安装步骤适用于 macOS、Windows 或 Linux 的 JetBrains IDEs 中安装通义灵码。

步骤 1：准备工作

• 操作系统：Windows 7 及以上、macOS、Linux；
• 下载并安装兼容的 JetBrains IDEs 2020.3 及以上版本，通义灵码与以下 IDE 兼容：
  • IntelliJ IDEA（旗舰版、社区版、教育版）
  • Android Studio
  • CLion
  • GoLand
  • PhpStorm
  • PyCharm（专业版、社区版、教育版）
  • Rider
  • RubyMine
  • RustRover
  • WebStorm
  • ...

更多详细信息，请参阅JetBrains IDE工具查找器。

步骤 2：在 JetBrains IDEs 中安装通义灵码

Tips：以在 IntelliJ IDEA 中安装通义灵码为例。

说明：鉴于很多开发者感兴趣我使用的 IDEA 的主题，分享一下信息：
我使用的 IDEA 的主题是 JetBrains IDEs 的 New UI，需要将 IDEA 升级到最新版哦，打开设置后，在 Appearance & Behavior 中即可看到 New UI 的配置入口。

方法 1：从插件市场安装

1. 打开 IntelliJ IDEA 设置窗口，在插件市场中搜索 TONGYI Lingma，找到通义灵码后单击安装。
2. 安装完成后，请重启 IntelliJ IDEA。

方法 2：下载安装包安装

1. 单击下方链接，下载 JetBrains IDEs 的 zip 安装包；

⇩ TONGYI Lingma - JetBrains

2. 下载完安装包后，打开 IntelliJ IDEA 后，打开设置，在插件管理的设置下拉菜单中单击从本地安装插件，选择下载的 zip 文件后安装。

3. 安装完成后，请重启 IntelliJ IDEA。

步骤 3：登录并开启智能编码之旅

1. 重启 IntelliJ IDEA 后，单击侧边导航的通义灵码，在通义灵码助手的窗口单击登录按钮。

2. 单击登录后，将前往登录页面，完成登录后可进入 IDE 客户端开始使用。登录相关具体操作，可参考：登录通义灵码插件端。

Visual Studio Code 中安装指南

本安装步骤适用于 macOS、Windows 或 Linux 的 Visual Studio Code 中安装通义灵码。

步骤 1：准备工作

• 操作系统：Windows 7 及以上、macOS、Linux；
• 下载并安装 Visual Studio Code 1.68.0 及以上版本。

步骤 2：在 Visual Studio Code 中安装通义灵码

方法 1：从插件市场安装

说明：单击立即安装，唤起 Visual Studio Code 插件市场直接安装，安装后请重启 IDE，即可开启智能编码之旅。

1. 打开 Visual Studio Code 扩展窗口，搜索 TONGYI Lingma，找到通义灵码后单击安装。
2. 安装完成后，请重启 Visual Studio Code。

方法 2：下载安装包安装

1. 单击下方链接，下载 Visual Studio Code 的 VSIX 安装包；

⇩ TONGYI Lingma-VS Code

2. 下载完安装包后，打开 Visual Studio Code 后，单击扩展，单击更多按钮，在下拉菜单中单击 从 VSIX 安装，选择下载的 VSIX 文件后安装；

3. 安装完成后，请重启 Visual Studio Code。

步骤 3：登录并开启智能编码之旅

1. 重启 Visual Studio Code 后，单击侧边导航的通义灵码，在通义灵码助手的窗口单击登录按钮。

Tips：如果安装后在侧边导航上找不到通义灵码入口，可鼠标聚焦在侧边导航后右键查看，勾选通义灵码后即可将插件入口配置在侧边导航上。

2. 单击登录后，将前往登录页面，完成登录后可进入 IDE 客户端开始使用。登录相关具体操作，可参考：登录通义灵码插件端。

Visual Studio 中安装指南

本安装步骤适用于 Windows 10 及以上操作系统中安装和使用通义灵码。

步骤 1：准备工作

• 操作系统：Windows 10 及以上；
• 下载并安装 Visual Studio 2022 17.3.0 及以上版本，或 Visual Studio 2019 16.3.0 及以上版本

步骤 2：在 Visual Studio 中安装通义灵码

方法 1：从插件市场安装

1. 打开 Visual Studio 顶部扩展-管理扩展窗口，搜索 TONGYI Lingma，找到通义灵码后单击安装。
2. 安装完成后，请重启 Visual Studio。

方法 2：下载安装包安装

1. 单击下方链接，下载 Visual Studio 的 VSIX 安装包；

⇩ TONGYI Lingma - Visual Studio 2022

⇩ TONGYI Lingma - Visual Studio 2019

2. 关闭已经打开的 Visual Studio 2022 或 Visual Studio 2019；
3. 下载完安装包后，找到该通义灵码的安装包（以 VSIX 为扩展名），双击安装包，按照安装向导操作即可。

步骤 3：登录并开启智能编码之旅

1. 重启 Visual Studio 后，单击顶部导航工具

2. 单击登录后，将前往登录页面，完成登录后可前往 IDE 客户端开始使用。登录相关具体操作，可参考：登录通义灵码插件端。

个人版登录通义灵码

通义灵码个人版开发者可以使用阿里云账号登录通义灵码 IDE 端插件，本文介绍个人版开发者登录 IDE 端插件的操作指南。

登录通义灵码

步骤 1：准备工作

• 已成功注册阿里云账号，具体操作可参考：账号注册（PC端）。如果你是某阿里云账号下的 RAM 用户，且你所在的阿里云主账号未开通企业标准版，也可以使用通义灵码个人版；
• 已在 JetBrains IDEs、Visual Studio Code、Visual Studio 中安装通义灵码 IDE 插件，具体操作可参考：下载安装指南。

步骤 2：在 IDE 的通义灵码插件登录

说明：如果你的电脑安装多个 IDE 本地客户端，均安装通义灵码的情况，登录状态在多个 IDE 客户端的通义灵码插件中同步，你只需要登录一次即可。

使用阿里云账号登录通义灵码有两种方式：

• 前往阿里云登录页，登录通义灵码（推荐）；
• 使用阿里云账号的 AK/SK 登录通义灵码。

方式 1：前往阿里云登录页，登录通义灵码（推荐）

安装完通义灵码插件后，通常情况下，你可以通过 IDE 客户端的插件上的登录按钮前往阿里云登录页完成登录，操作步骤如下：

1. 在 IDE 客户端的通义灵码插件中，找到登录按钮，不同 IDE 客户端中位置不一样（如下图所示），操作步骤如下：

• 在 JetBrains IDEs、Visual Studio Code 中，单击通义灵码智能问答窗口中的登录按钮，即可前往阿里云登录页；
• 在 Visual Studio 中，单击顶部导航工具-通义灵码，单击登录按钮，即可前往阿里云登录页；

2. 在阿里云登录页面中，完成阿里云登录（RAM 用户可在 RAM 用户登录页面中登录）后，即可看到登录完成的状态，此时即可前往插件端使用。

方式 2：使用阿里云账号的 AK/SK 登录通义灵码

如果遇到无法打开浏览器的阿里云登录页面时，可使用阿里云账号的 AK/SK 登录通义灵码，情况如下：

• 当你进行远程开发时，如使用 Remote SSH、WSL、Docker 的开发环境，可以使用 AK/SK 的方式登录通义灵码；
• 当你使用 Visual Studio Code 的 Web IDE 时，可以使用 AK/SK 的方式登录通义灵码；
• 当你使用基于 Visual Studio Code 的 Web IDE 开源版本构建的 IDE 时，如果 IDE 提供方对接了 Open VSX 时，可以使用 AK/SK 的方式登录通义灵码，直达插件地址：https://open-vsx.org/extension/Alibaba-Cloud/tongyi-lingma；
• 其他无法打开阿里云登录页面的情况。

操作步骤如下：

1. 前往阿里云控制台获取 AccessKey，具体操作可参考：创建AccessKey。

2. 在插件中输入 AccessKey ID、AccessKey Secret 进行登录，不同 IDE 客户端中操作不一样（如下图所示），操作如下：

• VS Code：在 IDE 中使用快捷键⌘ ⇧ P （CtlShiftP）打开命令面板，搜索 TONGYI Lingma，即可看到使用 AK/SK 登录通义灵码，单击后分步输入 AccessKey ID、AccessKey Secret，选择身份（未加入任何企业时将跳过）单击Enter/Return键，即可完成登录；
• JetBrains IDEs：打开 IDE 的设置页面，找到通义灵码插件设置，在未登录状态即可看到 AK/SK 登录入口，输入 AccessKey ID、AccessKey Secret 后，选择身份（未加入任何企业无需选择），然后单击登录即可；
• 暂不支持在 Visual Studio 中使用 AK/SK 登录。

登出通义灵码

如果需要登出通义灵码，可以分别：

• 在 JetBrains IDEs、Visual Studio Code 中，单击通义灵码智能问答窗口中的用户名旁下拉箭头，单击推登出，即可退出通义灵码登录状态；
• 在 Visual Studio 中，单击顶部导航工具-通义灵码，单击登出按钮，即可退出通义灵码登录状态。

退出后你将：

• 无法使用通义灵码的智能问答、云端大模型生成能力；
• 可继续使用本地离线模型的代码补全、技术文档和代码片段搜索（IntelliJ IDEA）。

企业标准版登录通义灵码

通义灵码企业标准版开发者可以使用阿里云账号登录通义灵码 IDE 端插件，本文介绍企业标准版开发者登录 IDE 端插件的操作指南。

登录通义灵码

步骤 1：准备工作

• 已成功注册阿里云账号，具体操作可参考：账号注册（PC端）；
• 已在企业中被授权开发者权限，如为获得权限，可联系企业内的通义灵码管理员添加权限，可参考：授权管理；
• 已在 JetBrains IDEs、Visual Studio Code、Visual Studio 中安装通义灵码 IDE 插件，具体操作可参考：下载安装指南。

步骤 2：在 IDE 的通义灵码插件登录

说明：如果你的电脑安装多个 IDE 本地客户端，均安装通义灵码的情况，登录状态在多个 IDE 客户端的通义灵码插件中同步，你只需要登录一次即可。

使用阿里云账号登录通义灵码有两种方式：

• 前往阿里云登录页，登录通义灵码（推荐）；
• 使用阿里云账号的 AK/SK 登录通义灵码。

方式 1：前往阿里云登录页，登录通义灵码（推荐）

安装完通义灵码插件后，通常情况下，可以通过 IDE 客户端的插件上的登录按钮前往阿里云登录页完成登录，操作步骤如下：

1. 在 IDE 客户端的通义灵码插件中，找到登录按钮，不同 IDE 客户端中位置不一样（如下图所示），操作步骤如下：

• 在 JetBrains IDEs、Visual Studio Code 中，单击通义灵码智能问答窗口中的登录按钮，即可前往阿里云登录页；
• 在 Visual Studio 中，单击顶部导航工具-通义灵码，单击登录按钮，即可前往阿里云登录页；

2. 在阿里云登录页面中，完成阿里云登录（RAM 用户可在 RAM 用户登录页面中登录）后，将根据当前登录账号与企业关系情况不同，可选择不同的身份，情况如下：

• 情况 1：如果当前登录账号为阿里云账号，可选择以个人身份登录或企业内开发者身份登录，此时需选择以企业开发者身份登录；
• 情况 2：如果当前登录账号为 RAM 用户，当你仅加入1个标准版企业且被授予开发者权限时，将默认选择该企业开发者身份并进入下一步；当你加入了多个标准版企业，同时被为多个企业授予开发者权限时，需要选择一个企业开发者身份登录。

3. 选择身份后，即可看到登录完成的状态，此时即可前往插件端使用。

方式 2：使用个人访问令牌登录通义灵码（VS Code）

说明：如需使用个人访问令牌登录，请确保将通义灵码 IDE 插件升级到 V1.4.1 及以上；

当使用 VS Code 本地 IDE、WebIDE、远程开发模式（如 Remote SSH、WSL、Docker 的开发环境）时，企业标准版的开发者均可以使用个人访问令牌（Access Token）进行登录。操作步骤如下：

1. 前往企业标准版的个人访问令牌管理，直达链接：获取个人访问令牌；
2. 创建个人访问令牌，并选择权限为：通义灵码-开发者-只读，新建完成后复制个人访问令牌；

3. 打开 VS Code 的命令面板；

4. 在命令面板中输入Lingma，选择使用个人访问令牌登录，黏贴第二步复制的个人令牌，单击回车键（Enter 键）：

• 如果当前账号仅有一个企业的授权，则单击回车键后即可完成登录；
• 如果当前账号有多个企业已授权使用通义灵码 IDE 插件，则回车键后，单击选择需要使用的企业即可完成登录。

方式三：使用阿里云账号的 AK/SK 登录通义灵码（不推荐）

如果遇到无法打开浏览器的阿里云登录页面时，可使用阿里云账号的 AK/SK 登录通义灵码，操作步骤如下：

1. 前往阿里云控制台获取 AccessKey，具体操作可参考：创建AccessKey。

2. 在插件中输入 AccessKey ID、AccessKey Secret 进行登录，不同 IDE 客户端中操作不一样（如下图所示），操作如下：

• VS Code：在 IDE 中使用快捷键⌘ ⇧ P （CtlShiftP）打开命令面板，搜索 TONGYI Lingma，即可看到使用 AK/SK 登录通义灵码，单击后分步输入 AccessKey ID、AccessKey Secret、选择身份，单击Enter/Return键，即可完成登录；
• JetBrains IDEs：打开 IDE 的设置页面，找到通义灵码插件设置，在未登录状态即可看到 AK/SK 登录入口，输入 AccessKey ID、AccessKey Secret 后，选择身份，然后单击登录即可；
• 暂不支持在 Visual Studio 中使用 AK/SK 登录。

登出通义灵码

如果需要登出通义灵码，可以分别：

• 在 JetBrains IDEs、Visual Studio Code 中，单击通义灵码智能问答窗口中的用户名旁下拉箭头，单击推登出，即可退出通义灵码登录状态；
• 在 Visual Studio 中，单击顶部导航工具-通义灵码，单击登出按钮，即可退出通义灵码登录状态。

退出后你将：

• 无法使用通义灵码的智能问答、云端大模型生成能力；
• 可继续使用本地离线模型的代码补全、技术文档和代码片段搜索（IntelliJ IDEA）。

企业专属版登录通义灵码

通义灵码企业专属版开发者可以使用专属版的账号登录通义灵码 IDE 端插件，本文介绍企业专属版开发者登录 IDE 端插件的操作指南。

登录通义灵码

步骤 1：准备工作

• 已成功获得通义灵码企业专属版的用户账号，如果尚未获得专属版的用户账号，可联系企业管理员获取；如果企业内已完成用户身份 SSO 配置，可根据企业账号使用方式进行登录；
• 已在企业中被授权通义灵码开发者权限，如为获得权限，可联系企业内的通义灵码管理员添加权限，可参考：授权管理；
• 已在 JetBrains IDEs、Visual Studio Code、Visual Studio 中安装通义灵码 IDE 插件，具体操作可参考：下载安装指南。
• 已获得企业专属版的登录地址。

步骤 2：配置专属版的登录地址

以企业专属版的开发者登录之前，需要先配置专属版的登录地址，操作步骤如下：

1. 联系企业管理员，获取专属版的登录地址，企业管理员可登录阿里云控制台，前往阿里云云效控制台，单击左侧导航企业管理，进入专属版企业实例详情页面进行获取；

2. 在 IDE 端通义灵码插件中配置专属域地址。

• 在 Visual Studio Code 中，单击侧边导航的通义灵码，在通义灵码助手的窗口单击设置按钮，打开插件设置后，将下方 URL 配置在专属域地址输入框中。 ⚠️ 配置完成后，记得要 重新加载或重启 Visual Studio Code。

在 JetBrains IDEs 中，单击菜单下设置，打开插件设置后，账号处选择专属域账号的方式 ，将下方 URL 配置在专属域地址输入框中。 ⚠️ 配置完成后，记得要 重启 IntelliJ IDEA。

步骤 3：在 IDE 的通义灵码插件登录

完成企业专属版的登录地址配置后，账号登录通义灵码有两种方式：

• 前往通义灵码登录页，登录通义灵码（如果企业已完成用户身份 SSO 配置，可根据企业账号使用方式进行登录）；
• 使用企业专属版的个人令牌登录通义灵码。

方式 1: 前往通义灵码登录页登录

安装完通义灵码插件后，通常情况下，你可以通过 IDE 客户端的插件上的登录按钮前往通义灵码登录页完成登录，操作步骤如下：

1. 在 IDE 客户端的通义灵码插件中，找到登录按钮，不同 IDE 客户端中位置不一样（如下图所示），操作步骤如下：

• 在 JetBrains IDEs、Visual Studio Code 中，单击通义灵码智能问答窗口中的登录按钮，即可前往通义灵码登录页；
• 在 Visual Studio 中，单击顶部导航工具-通义灵码，单击登录按钮，即可前通义灵码登录页；

2. 在通义灵码登录页面中完成登录后，根据当前登录账号与组织关系情况不同决定是否直接登录完成，情况如下：

• 情况 1：如果当前登录账号仅加入了企业内的单个组织，将默认选择该组织的开发者身份并直接登录完成；
• 情况 2：如果当前登录账号仅加入了企业内的多个组织，需要选择一个组织的开发者身份登录。

3. 选择身份后，即可看到登录完成的状态，此时即可前往插件端使用。

方式 2: 使用企业专属版账号个人访问令牌登录通义灵码

当你在 Visual Studio Code 远程开发场景中，如使用 Remote SSH、WSL、Docker 的开发环境，可以使用 个人访问令牌登录通义灵码，操作步骤如下：

1. 通义灵码助手的智能问答窗口单击登录，将看到填写和获取 个人访问令牌 的入口，单击后前往获取个人访问令牌页面；
2. 获取访问令牌：个人访问令牌页面中单击创建访问令牌，输入令牌名称，权限点需选择：基础服务>用户>只读，创建完成后复制访问令牌；

3. 在 IDE 上输入访问令牌，单击 Enter 即可。

备注：JetBrains IDEs 中无需使用个人访问令牌的方式，直接本地客户端登录后，前往远程开发场景即可。

登出通义灵码

如果需要登出通义灵码，可以分别：

• 在 JetBrains IDEs、Visual Studio Code 中，单击通义灵码智能问答窗口中的用户名旁下拉箭头，单击推登出，即可退出通义灵码登录状态；
• 在 Visual Studio 中，单击顶部导航工具-通义灵码，单击登出按钮，即可退出通义灵码登录状态。

退出后你将：

• 无法使用通义灵码的智能问答、云端大模型生成能力；
• 可继续使用本地离线模型的代码补全、技术文档和代码片段搜索（IntelliJ IDEA）。