需通过cli代理+web ui桥接启用codegeex：确认koocli≥v2.5.0、java≥11；安装codegeex-cli v1.3.2+并以127.0.0.1:8081启动；在ide终端环境变量注入api地址，重启后右键调用功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在华为云 CodeArts IDE（KooCLI 环境）中启用 CodeGeex 的本地代码理解与生成能力，必须绕过其默认不支持第三方插件的限制，采用 CLI 代理 + Web UI 桥接方式实现功能集成——该方案不依赖 IDE 插件市场，适用于 CodeArts IDE 2.5.0 及以上版本，且无需修改 IDE 安装目录或触发安全拦截。
确认环境兼容性
打开终端执行 koo --version，输出需含 “v2.5.0” 或更高字样；若为 v2.4.x 或更低，【立即停止后续操作】——旧版 KooCLI 缺失 WebSocket 代理模块，无法转发 CodeGeex 的流式响应，强行配置将导致右键菜单无反应且无任何错误提示。
运行 java -version，确保输出中包含 “11.”、“17.” 或 “21.”；CodeGeex 后端服务启动依赖 Java 11+，低于此版本会在 koo codegeex start 时静默退出，日志仅显示 “Process exited with code 1”。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
安装并启动 CodeGeex CLI 服务
方法一：使用 npm 全局安装（推荐，自动处理依赖）
执行 npm install -g codegeex-cli → 等待安装完成 → 运行 codegeex-cli --version 验证输出为 v1.3.2+。
方法二：手动下载二进制（离线环境适用）
访问 https://codegeex.cn/download/cli 下载对应系统架构的 codegeex-cli-linux-x64 或 codegeex-cli-darwin-arm64 → 赋予可执行权限：chmod +x codegeex-cli* → 移动至 /usr/local/bin/ 并重命名为 codegeex-cli。
启动服务：codegeex-cli serve --host 127.0.0.1 --port 8081 --model codegeex4:all-9b。
注意：此处 【必须使用 127.0.0.1 而非 localhost】，KooCLI 内置 Chromium 内核对 localhost 的 DNS 解析存在缓存 bug，会导致前端连接超时；端口 8081 不可更改，KooCLI 固定读取该端口的 /health 接口判断服务状态。
在 CodeArts IDE 中注入 CodeGeex 功能入口
第一步：进入 IDE 设置 → 打开 Settings → Tools → Terminal → 在 “Shell path” 栏末尾追加：; export CODEGEEX_API_URL=http://127.0.0.1:8081/v1
第二步：重启 IDE 终端，执行 echo $CODEGEEX_API_URL 确认输出为 http://127.0.0.1:8081/v1。
第三步：打开任意 .java 或 .py 文件 → 选中一段代码 → 右键 → 选择 “CodeGeex: Explain Selection”。
这一步操作起来很简单，IDE 会自动调用终端环境变量中的 API 地址发起请求；若菜单项未出现，请检查是否已关闭所有 IDE 窗口后彻底重启，KooCLI 不支持热加载环境变量。
第四步：首次调用时，IDE 底部状态栏将弹出登录窗口 → 使用手机号+验证码登录 → 登录成功后，右键菜单中新增 “CodeGeex: Generate Unit Test” 和 “CodeGeex: Add Comment” 两项。
