必须先安装 codegeex-jupyter 扩展，否则 %codegeex 魔法命令无法识别；需确保 python 3.7+ 和 jupyter ≥5.0.0，安装后启用扩展并重启服务方可使用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 Jupyter Notebook 中使用 CodeGeeX 生成 Python 代码，必须先安装其官方支持的 Jupyter 扩展 codegeex-jupyter，否则 %codegeex 或 %%codegeex 魔法命令无法识别，所有提示词都将被忽略。
确认已安装 Python 和 Jupyter
打开终端（Windows：CMD/PowerShell；macOS/Linux：Terminal），运行 python --version 确保输出 Python 3.7+ 版本；再运行 jupyter --version，若提示 command not found，则需先执行 pip install jupyter。
这一步不可跳过——【codegeex-jupyter 依赖 jupyter-core ≥5.0.0，旧版 Jupyter 会静默安装失败】。
安装 codegeex-jupyter 扩展
在终端中执行以下命令：
pip install codegeex-jupyter
安装完成后，运行 jupyter server extension list，检查输出中是否包含 codegeex_jupyter enabled —— 若显示 disabled 或未出现，说明扩展未激活。
启用并验证扩展
方法一：命令行启用
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
jupyter server extension enable --py codegeex_jupyter
方法二：配置文件启用（适用于多用户或 notebook 服务部署）
在 ~/.jupyter/jupyter_server_config.py 中添加：
c.ServerApp.jpserver_extensions = {"codegeex_jupyter": True}
注意：修改配置后需重启 Jupyter Server，直接刷新网页无效。
启动 Jupyter Notebook 或 JupyterLab：jupyter notebook → 新建 Python notebook → 在任意 cell 输入 %codegeex 并运行，若未报错且光标进入新行，即表示扩展已就绪。
