通義靈碼操作指南——安裝和登陸指南
點擊鏈接，立即下載通義靈碼插件：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：從插件市場安裝
- 打開 IntelliJ IDEA 設置窗口，在插件市場中搜索 TONGYI Lingma，找到通義靈碼后單擊安裝。
- 安裝完成后，請重啟 IntelliJ IDEA。
方法 2：下載安裝包安裝
- 單擊下方鏈接，下載 JetBrains IDEs 的 zip 安裝包；
- 下載完安裝包后，打開 IntelliJ IDEA 后，打開設置，在插件管理的設置下拉菜單中單擊從本地安裝插件，選擇下載的 zip 文件后安裝。
- 安裝完成后，請重啟 IntelliJ IDEA。
步驟 3：登錄并開啟智能編碼之旅
- 重啟 IntelliJ IDEA 后，單擊側邊導航的通義靈碼，在通義靈碼助手的窗口單擊登錄按鈕。
- 單擊登錄后，將前往登錄頁面，完成登錄后可進入 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，即可開啟智能編碼之旅。
- 打開 Visual Studio Code 擴展窗口，搜索 TONGYI Lingma，找到通義靈碼后單擊安裝。
- 安裝完成后，請重啟 Visual Studio Code。
方法 2：下載安裝包安裝
- 單擊下方鏈接，下載 Visual Studio Code 的 VSIX 安裝包；
- 下載完安裝包后，打開 Visual Studio Code 后，單擊擴展，單擊更多按鈕，在下拉菜單中單擊 從 VSIX 安裝，選擇下載的 VSIX 文件后安裝；
- 安裝完成后，請重啟 Visual Studio Code。
步驟 3：登錄并開啟智能編碼之旅
- 重啟 Visual Studio Code 后，單擊側邊導航的通義靈碼，在通義靈碼助手的窗口單擊登錄按鈕。
Tips：如果安裝后在側邊導航上找不到通義靈碼入口，可鼠標聚焦在側邊導航后右鍵查看，勾選通義靈碼后即可將插件入口配置在側邊導航上。
- 單擊登錄后，將前往登錄頁面，完成登錄后可進入 IDE 客戶端開始使用。登錄相關具體操作，可參考：登錄通義靈碼插件端。
Visual Studio 中安裝指南
本安裝步驟適用于 Windows 10 及以上操作系統中安裝和使用通義靈碼。
步驟 1：準備工作
- 操作系統：Windows 10 及以上；
- 下載并安裝 Visual Studio 2022 17.3.0 及以上版本，或 Visual Studio 2019 16.3.0 及以上版本
步驟 2：在 Visual Studio 中安裝通義靈碼
方法 1：從插件市場安裝
- 打開 Visual Studio 頂部擴展-管理擴展窗口，搜索 TONGYI Lingma，找到通義靈碼后單擊安裝。
- 安裝完成后，請重啟 Visual Studio。
方法 2：下載安裝包安裝
- 單擊下方鏈接，下載 Visual Studio 的 VSIX 安裝包；
? TONGYI Lingma - Visual Studio 2022
? TONGYI Lingma - Visual Studio 2019
- 關閉已經打開的 Visual Studio 2022 或 Visual Studio 2019；
- 下載完安裝包后，找到該通義靈碼的安裝包（以 VSIX 為擴展名），雙擊安裝包，按照安裝向導操作即可。
步驟 3：登錄并開啟智能編碼之旅
- 重啟 Visual Studio 后，單擊頂部導航工具
- 單擊登錄后，將前往登錄頁面，完成登錄后可前往 IDE 客戶端開始使用。登錄相關具體操作，可參考：登錄通義靈碼插件端。
個人版登錄通義靈碼
通義靈碼個人版開發者可以使用阿里云賬號登錄通義靈碼 IDE 端插件，本文介紹個人版開發者登錄 IDE 端插件的操作指南。
登錄通義靈碼
步驟 1：準備工作
- 已成功注冊阿里云賬號，具體操作可參考：賬號注冊（PC端）。如果你是某阿里云賬號下的 RAM 用戶，且你所在的阿里云主賬號未開通企業標準版，也可以使用通義靈碼個人版；
- 已在 JetBrains IDEs、Visual Studio Code、Visual Studio 中安裝通義靈碼 IDE 插件，具體操作可參考：下載安裝指南。
步驟 2：在 IDE 的通義靈碼插件登錄
說明：如果你的電腦安裝多個 IDE 本地客戶端，均安裝通義靈碼的情況，登錄狀態在多個 IDE 客戶端的通義靈碼插件中同步，你只需要登錄一次即可。
使用阿里云賬號登錄通義靈碼有兩種方式：
- 前往阿里云登錄頁，登錄通義靈碼（推薦）；
- 使用阿里云賬號的 AK/SK 登錄通義靈碼。
方式 1：前往阿里云登錄頁，登錄通義靈碼（推薦）
安裝完通義靈碼插件后，通常情況下，你可以通過 IDE 客戶端的插件上的登錄按鈕前往阿里云登錄頁完成登錄，操作步驟如下：
- 在 IDE 客戶端的通義靈碼插件中，找到登錄按鈕，不同 IDE 客戶端中位置不一樣（如下圖所示），操作步驟如下：
- 在 JetBrains IDEs、Visual Studio Code 中，單擊通義靈碼智能問答窗口中的登錄按鈕，即可前往阿里云登錄頁；
- 在 Visual Studio 中，單擊頂部導航工具-通義靈碼，單擊登錄按鈕，即可前往阿里云登錄頁；
- 在阿里云登錄頁面中，完成阿里云登錄（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；
- 其他無法打開阿里云登錄頁面的情況。
操作步驟如下：
- 前往阿里云控制臺獲取 AccessKey，具體操作可參考：創建AccessKey。
- 在插件中輸入 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 客戶端的插件上的登錄按鈕前往阿里云登錄頁完成登錄，操作步驟如下：
- 在 IDE 客戶端的通義靈碼插件中，找到登錄按鈕，不同 IDE 客戶端中位置不一樣（如下圖所示），操作步驟如下：
- 在 JetBrains IDEs、Visual Studio Code 中，單擊通義靈碼智能問答窗口中的登錄按鈕，即可前往阿里云登錄頁；
- 在 Visual Studio 中，單擊頂部導航工具-通義靈碼，單擊登錄按鈕，即可前往阿里云登錄頁；
- 在阿里云登錄頁面中，完成阿里云登錄（RAM 用戶可在 RAM 用戶登錄頁面中登錄）后，將根據當前登錄賬號與企業關系情況不同，可選擇不同的身份，情況如下：
- 情況 1：如果當前登錄賬號為阿里云賬號，可選擇以個人身份登錄或企業內開發者身份登錄，此時需選擇以企業開發者身份登錄；
- 情況 2：如果當前登錄賬號為 RAM 用戶，當你僅加入1個標準版企業且被授予開發者權限時，將默認選擇該企業開發者身份并進入下一步；當你加入了多個標準版企業，同時被為多個企業授予開發者權限時，需要選擇一個企業開發者身份登錄。
- 選擇身份后，即可看到登錄完成的狀態，此時即可前往插件端使用。
方式 2：使用個人訪問令牌登錄通義靈碼（VS Code）
說明：如需使用個人訪問令牌登錄，請確保將通義靈碼 IDE 插件升級到 V1.4.1 及以上；
當使用 VS Code 本地 IDE、WebIDE、遠程開發模式（如 Remote SSH、WSL、Docker 的開發環境）時，企業標準版的開發者均可以使用個人訪問令牌（Access Token）進行登錄。操作步驟如下：
- 前往企業標準版的個人訪問令牌管理，直達鏈接：獲取個人訪問令牌；
- 創建個人訪問令牌，并選擇權限為：通義靈碼-開發者-只讀，新建完成后復制個人訪問令牌；
-
打開 VS Code 的命令面板；
-
在命令面板中輸入Lingma，選擇使用個人訪問令牌登錄，黏貼第二步復制的個人令牌，單擊回車鍵（Enter 鍵）：
- 如果當前賬號僅有一個企業的授權，則單擊回車鍵后即可完成登錄；
- 如果當前賬號有多個企業已授權使用通義靈碼 IDE 插件，則回車鍵后，單擊選擇需要使用的企業即可完成登錄。
方式三：使用阿里云賬號的 AK/SK 登錄通義靈碼（不推薦）
如果遇到無法打開瀏覽器的阿里云登錄頁面時，可使用阿里云賬號的 AK/SK 登錄通義靈碼，操作步驟如下：
- 前往阿里云控制臺獲取 AccessKey，具體操作可參考：創建AccessKey。
- 在插件中輸入 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：配置專屬版的登錄地址
以企業專屬版的開發者登錄之前，需要先配置專屬版的登錄地址，操作步驟如下：
- 聯系企業管理員，獲取專屬版的登錄地址，企業管理員可登錄阿里云控制臺，前往阿里云云效控制臺，單擊左側導航企業管理，進入專屬版企業實例詳情頁面進行獲取；
- 在 IDE 端通義靈碼插件中配置專屬域地址。
- 在 Visual Studio Code 中，單擊側邊導航的通義靈碼，在通義靈碼助手的窗口單擊設置按鈕，打開插件設置后，將下方 URL 配置在專屬域地址輸入框中。 ?? 配置完成后，記得要 重新加載或重啟 Visual Studio Code。
在 JetBrains IDEs 中，單擊菜單下設置，打開插件設置后，賬號處選擇專屬域賬號的方式 ，將下方 URL 配置在專屬域地址輸入框中。 ?? 配置完成后，記得要 重啟 IntelliJ IDEA。
步驟 3：在 IDE 的通義靈碼插件登錄
完成企業專屬版的登錄地址配置后，賬號登錄通義靈碼有兩種方式：
- 前往通義靈碼登錄頁，登錄通義靈碼（如果企業已完成用戶身份 SSO 配置，可根據企業賬號使用方式進行登錄）；
- 使用企業專屬版的個人令牌登錄通義靈碼。
方式 1: 前往通義靈碼登錄頁登錄
安裝完通義靈碼插件后，通常情況下，你可以通過 IDE 客戶端的插件上的登錄按鈕前往通義靈碼登錄頁完成登錄，操作步驟如下：
- 在 IDE 客戶端的通義靈碼插件中，找到登錄按鈕，不同 IDE 客戶端中位置不一樣（如下圖所示），操作步驟如下：
- 在 JetBrains IDEs、Visual Studio Code 中，單擊通義靈碼智能問答窗口中的登錄按鈕，即可前往通義靈碼登錄頁；
- 在 Visual Studio 中，單擊頂部導航工具-通義靈碼，單擊登錄按鈕，即可前通義靈碼登錄頁；
- 在通義靈碼登錄頁面中完成登錄后，根據當前登錄賬號與組織關系情況不同決定是否直接登錄完成，情況如下：
- 情況 1：如果當前登錄賬號僅加入了企業內的單個組織，將默認選擇該組織的開發者身份并直接登錄完成；
- 情況 2：如果當前登錄賬號僅加入了企業內的多個組織，需要選擇一個組織的開發者身份登錄。
- 選擇身份后，即可看到登錄完成的狀態，此時即可前往插件端使用。
方式 2: 使用企業專屬版賬號個人訪問令牌登錄通義靈碼
當你在 Visual Studio Code 遠程開發場景中，如使用 Remote SSH、WSL、Docker 的開發環境，可以使用 個人訪問令牌登錄通義靈碼，操作步驟如下：
- 通義靈碼助手的智能問答窗口單擊登錄，將看到填寫和獲取 個人訪問令牌 的入口，單擊后前往獲取個人訪問令牌頁面；
- 獲取訪問令牌：個人訪問令牌頁面中單擊創建訪問令牌，輸入令牌名稱，權限點需選擇：基礎服務>用戶>只讀，創建完成后復制訪問令牌；
- 在 IDE 上輸入訪問令牌，單擊 Enter 即可。
備注：JetBrains IDEs 中無需使用個人訪問令牌的方式，直接本地客戶端登錄后，前往遠程開發場景即可。
登出通義靈碼
如果需要登出通義靈碼，可以分別：
- 在 JetBrains IDEs、Visual Studio Code 中，單擊通義靈碼智能問答窗口中的用戶名旁下拉箭頭，單擊推登出，即可退出通義靈碼登錄狀態；
- 在 Visual Studio 中，單擊頂部導航工具-通義靈碼，單擊登出按鈕，即可退出通義靈碼登錄狀態。
退出后你將：
- 無法使用通義靈碼的智能問答、云端大模型生成能力；
- 可繼續使用本地離線模型的代碼補全、技術文檔和代碼片段搜索（IntelliJ IDEA）。
浙公網安備 33010602011771號