CodeGeex 在 macOS 系统中的安装环境要求与配置

雨婷酱_2123

发布时间：2026-06-16 12:03:35

770人浏览过

来源于php中文网

原创

Apple Silicon芯片是macOS安装CodeGeeX的硬性前提，需确认芯片为M1/M2/M3/M4、系统≥macOS 13.0、Python为3.8–3.10版本，再通过Homebrew安装依赖、创建虚拟环境、安装带MPS支持的torch与transformers，下载模型后验证torch.backends.mps.is_available()为True，最后运行demo启动Web UI。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

codegeex 在 macos 系统中的安装环境要求与配置 - php中文网

在 macOS 上安装 CodeGeeX（注意不是 OpenAI Codex），必须先确认硬件是否支持模型推理，否则启动后会卡死或报错 torch MPS backend not available。Apple Silicon 芯片是硬性前提，Intel Mac 无法启用加速，连基础 demo 都跑不起来。

确认芯片类型与系统版本

打开「关于本机」→ 查看「芯片」一行：只有显示 Apple M1、M2、M3 或 M4 才能继续；Intel 标识直接终止安装流程。

同时检查系统版本：点击「软件更新」→ 确保已升级至 macOS 13.0（Ventura）或更高版本。macOS 12.x 虽然能运行 Python，但 MPS 后端支持不完整，会导致模型加载失败。

终端执行 【python --version】，输出必须为 3.8、3.9 或 3.10 —— Python 3.11+ 与当前 CodeGeeX2 的 transformers 依赖存在 ABI 冲突，会触发 ImportError: cannot import name 'is_torch_available'。

安装必要依赖工具链

方法一：用 Homebrew 安装核心组件（推荐）
先装 Homebrew（如未安装）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
再装依赖：
brew install git python@3.10 llvm

方法二：手动安装 Python 3.10
去 python.org 下载 macOS 13+ 兼容的 Python 3.10.x pkg 安装包，安装时勾选「Add Python to PATH」。不要用系统自带 /usr/bin/python3，它版本固定且无 pip 权限。

安装完成后，在终端运行：
which python3 && python3 -m pip --version
输出路径应含 【/opt/homebrew/bin/python3】 或 【/usr/local/bin/python3】，而非 /usr/bin/python3。

配置虚拟环境并安装 CodeGeeX2

第一步：创建隔离环境
python3 -m venv ~/codegeex2-env

第二步：激活环境
source ~/codegeex2-env/bin/activate

第三步：升级 pip 并安装依赖
pip install --upgrade pip
pip install -r https://gitcode.com/gh_mirrors/co/CodeGeeX2/raw/main/requirements.txt

python-script-generator

快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。

下载

这一步耗时较长，会自动下载 torch-2.3.0+cpu 和 transformers==4.36.2。如果提示 torch 安装失败，说明你没在 Apple Silicon 上运行——Intel Mac 无法安装带 MPS 支持的 torch，此时必须中止。

下载模型权重并验证 MPS 可用性

进入项目目录：
git clone https://gitcode.com/gh_mirrors/co/CodeGeeX2 && cd CodeGeeX2

执行 MPS 检查脚本：
python -c "import torch; print('MPS available:', torch.backends.mps.is_available())"
输出必须为 【True】，否则后续所有推理都会退化为 CPU 模式，响应延迟超过 90 秒，无法交互。

下载 6B 模型（需 Git LFS）：
git lfs install && git clone https://huggingface.co/THUDM/codegeex2-6b ./models/codegeex2-6b

模型文件夹结构必须为：
./models/codegeex2-6b/
内含 config.json、pytorch_model.bin、tokenizer.json 等 12 个文件。少任何一个，启动时会报 OSError: Unable to load weights from pytorch checkpoint。