clion需安装官方codegeex插件并重启，切换为codegeex-2-cpp/4-cpp模型，开启auto import，登录账号并确保cmake正确索引项目以启用ai辅助。
CLion 本身不带 AI 编程辅助能力，必须通过插件实现——但不是随便装一个就行，关键在选对插件、配对模型、启用正确上下文。
安装 CodeGeeX 插件后必须重启 IDE
插件安装路径是 Settings → Plugins → Marketplace，搜 CodeGeeX，只认准开发者为「CodeGeeX Team」的官方版本。装完会弹窗提示重启，这步不能跳过：不重启，插件图标不出现，所有功能（包括快捷键 Ctrl+Shift+G）完全失效。常见错误现象是点击右下角状态栏没反应，或快捷键无响应——八成是卡在这一步。
模型必须手动切换为 CodeGeeX-2-CPP 或 CodeGeeX-4-CPP
首次登录后，进 Settings → Other Settings → CodeGeeX → Model，把默认的通用模型（如 CodeGeeX-4）换成 CodeGeeX-2-CPP 或 CodeGeeX-4-CPP。原因很实际：通用模型对 std::vector 的移动语义、unique_ptr 的 RAII 行为、模板特化推导等 C++ 特有结构识别率低，生成注释常漏掉 noexcept 或 const 限定符。
AI 补全失效时先检查 Auto Import 设置
新建 .cpp 文件输入 int main() 后没自动补全 #include <iostream></iostream> 和 return 0;，大概率是 Settings → Editor → General → Auto Import 里没勾选 Add unambiguous imports on the fly。这个选项关闭时，插件无法自动注入头文件，导致补全逻辑中断。另外，若项目用的是自定义工具链（如 arm-none-eabi-g++），确保 CMakeLists.txt 中已声明 project(... CXX)，否则插件可能降级为 C 模式处理。
真正容易被忽略的是上下文范围：CodeGeeX 在游客模式下不支持跨文件理解，比如你在 utils.h 里写了个模板函数，然后在 main.cpp 里调用并请求解释，AI 会“看不见”头文件内容——必须用注册账号登录，且当前编辑的文件需在同一个 CLion 项目结构内被 CMake 正确索引。
