CodeGeex macOS安装需用Homebrew装git、python@3.10、llvm，验证which python3输出为/opt/homebrew/bin/python3或/usr/local/bin/python3；PyCharm须本地ZIP安装插件（不解压）；VS Code需≥1.75.0且重启进程；MPS可用性须python -c "import torch; print(torch.backends.mps.is_available())"返回True。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeGeex 官方文档明确要求安装环境必须满足特定版本与组件组合，否则插件无法加载、模型无法初始化或出现 CUDA/MPS 设备不可用等致命错误，尤其在 PyCharm 和 VS Code 中频繁触发「No device found」报错。
macOS 系统必备依赖安装
先确认是否已装 Homebrew：终端执行 which brew，若无输出则需安装。执行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
装完后一次性装齐核心工具链：
brew install git python@3.10 llvm
⚠️关键验证点：运行 which python3 必须返回 【/opt/homebrew/bin/python3】 或 【/usr/local/bin/python3】；若显示 /usr/bin/python3，说明调用了系统自带 Python，后续 pip 安装会权限拒绝且无法加载 torch。
PyCharm 插件安装路径选择
打开 PyCharm → Cmd+, → Plugins → Marketplace → 搜索 CodeGeeX。
若列表中出现官方插件（作者 Zhipu AI，版本 ≥ 2.12.0），直接点击 Install → Restart IDE。
若搜索无结果或卡在 “Downloading…”：立即放弃在线安装，切换至本地 ZIP 安装流程——这是 PyCharm 2024.3 及更早版本的唯一可行方式，反复重试只会生成无效缓存。
本地安装时务必注意：【ZIP 文件必须保持压缩状态，切勿解压】；解压后选文件夹会导致插件元数据丢失，PyCharm 将静默忽略该包。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
VS Code 插件启用前的硬性检查
第一步：确认 VS Code 版本 ≥ 1.75.0（Help → About 查看）；低于此版本将无法加载 CodeGeeX 的 Webview API，功能面板空白。
第二步：启动 VS Code 后，按 Cmd+Shift+X 打开扩展面板，输入 CodeGeeX，认准图标为蓝色火箭+齿轮的官方插件（发布者 Zhipu AI）。
第三步：点击 Install，等待右下角弹出「CodeGeeX Ready」提示；若仅显示图标无提示，说明插件未注入上下文——此时必须关闭所有窗口，完全退出 VS Code 进程（Activity Monitor 中杀掉 Electron 进程），再重新打开。
生产环境模型部署的硬件门槛
CodeGeeX2-6B 模型对硬件有明确量化分级要求：
• INT4 推理最低需 Apple Silicon M1 或 NVIDIA GPU ≥ 8GB 显存；
• 若强行在 4GB 显存 GPU 上运行 FP16 版本，会出现 OOM crash 且不报具体错误，只在日志末尾显示「Killed」；
• macOS 用户必须验证 MPS 可用性：终端执行 python -c "import torch; print(torch.backends.mps.is_available())"，返回 True 才可启用 Metal 加速，False 则默认回退至 CPU 推理，速度下降 5 倍以上。
