推荐首选 marscode：打开 settings → plugins → marketplace 搜索 marscode，点击 install 后重启 clion；首次启动用手机号登录，右下角出现图标即可使用；若界面为英文，需额外安装 chinese (simplified) language pack 插件。
CLion 本身不内置 AI 编程能力，必须通过插件实现；目前能稳定运行、适配 C/C++ 项目且中文支持良好的主流选择是 MarsCode（豆包）、Tabnine 和 通义灵码，其中 MarsCode 对国内网络环境和 C++ 语义理解更友好，推荐优先尝试。
怎么装 MarsCode 插件（推荐首选）
它体积小（约 41.7KB）、纯免费、无需额外 Node.js 运行时，且对 CLion 的 C++ 项目模型访问充分：
- 打开
Settings → Plugins，切换到Marketplace标签页 - 搜索
MarsCode，点击Install，完成后重启 CLion - 首次启动会弹出登录框，用手机号注册即可（字节跳动出品，非第三方 SDK）
- 右下角出现
MarsCode图标后，点开就能开始对话或选中代码右键调用“解释/优化/生成单元测试”等功能
注意：如果界面仍是英文，再装一个 Chinese (Simplified) Language Pack 插件即可切中文；Linux 下若汉字乱码，需手动下载对应语言包替换 resources_en.jar。
通义灵码常见报错：Failed to initialize ACP process
这个错误不是插件问题，而是 CLion 的 ACP（AI Code Process）子系统依赖本地 Node.js，但没找到 npm-prefix.js 或 npx-cli.js —— 本质是没装 Node.js 或版本不兼容：
- 必须安装 Node.js LTS 版本（如
v22.22.0），不能只装 npm 或用 nvm 管理却不设全局路径 - 安装时勾选
Add to PATH，安装完在终端执行node -v和npm -v都应有输出 - CLion 启动前要确保系统 PATH 已刷新（Windows 建议重启 IDE，macOS/Linux 可重开终端再启 CLion）
- 如果仍报错，检查路径：
C:\Users\{user}\AppData\Local\JetBrains\acp-agents\.runtimes\node\下是否有完整 node + npm 目录结构
DeepSeek / Claude Code 插件对 CLion 版本有硬性要求
不是所有 CLion 都能用。Claude Code 插件明确要求 CLion 2026.x 系列，2025.x 及更早版本加载后会静默失败，无提示、无日志、图标不出现：
- 确认当前版本：菜单栏
Help → About，看 Build Number 是否以26x.开头（如261.2492.12） - 旧版升级方式：官网下载最新安装包，直接覆盖安装（配置和插件默认保留）
- DeepSeek 插件虽未明说最低版本，但实测在
2025.2上偶发卡死，在2026.1上响应稳定 - 两者都需手动下载 ZIP 包安装（
Settings → Plugins → Install Plugin from Disk），不能从 Marketplace 搜索安装
AI 插件在 C/C++ 项目里真正起效的关键条件
很多用户装完发现“AI 不懂我的代码”，其实是 CLion 没把项目上下文完整喂给插件：
- 确保项目已成功加载 CMake：底部状态栏显示
CMake project loaded，否则插件看不到头文件包含关系和宏定义 - 避免用“Empty Project”模板新建项目，应选
Executable (C++)或基于现有 CMakeLists.txt 打开 - 如果使用 STM32/嵌入式工具链（如
arm-none-eabi-gcc），需在Settings → Toolchains中正确配置，否则插件解析 AST 时会漏掉大量符号 - 通义灵码和 MarsCode 都支持“选中一段代码 → 右键 → Ask AI”，但只有当前文件被 CLion 正确索引（无红色波浪线）时，生成结果才可靠
最常被忽略的一点：AI 插件不是万能补全器，它依赖 CLion 底层的符号解析质量。如果你的 CMakeLists.txt 写得不规范、头文件路径混乱、或者用了大量条件编译，先修好这些，AI 才能真正帮上忙。
