# 在Notebook中安装配置Codex AI开发人员在华为云ModelArts Notebook中进行模型开发时，常面临代码编写效率低、跨文件重构繁琐、测试用例编写耗时等问题，影响开发进度。本文介绍如何在ModelArts Notebook中部署并使用Codex。Codex是OpenAI推出的开源AI编程助手，可运行在ModelArts Notebook实例中，通过终端（CLI）与Codex TUI进行交互，借助内置的ModelArts Skill快速使用和管理ModelArts服务，提升AI模型的开发与管理效率。 ![](https://support.huaweicloud.com/bestpractice-modelarts/public_sys-resources/warning_3.0-zh-cn.png) Notebook是容器运行时环境，运行环境会在关机时被清理。请通过保存镜像及时保留npm install安装后的环境，以及\~/.codex/目录下的配置文件（config.toml）、Skills、对话session和\~/.bashrc中的API Key等环境变量，以避免Notebook运行环境中的数据丢失。 #### 注意事项 使用Codex时可能出现风险，详情请参见[Codex风险说明及安全建议](https://support.huaweicloud.com/bestpractice-modelarts/modelarts_20_00028.html)。 #### 约束限制 - Notebook Codex功能仅支持"华北-北京四"、"西南-贵阳一"、"华北-乌兰察布一"、"华东-上海一"和"华南-广州"区域。 - 您创建的[Notebook实例](https://support.huaweicloud.com/devtool-modelarts/devtool-modelarts_3495.html)需满足如下条件，才能正常使用Codex。 表1Notebook实例约束限制 | 类型 | 限制 | |:---|:---| | 环境配置 | - **容器镜像的操作系统** ：暂不支持ubuntu_18.04及以下。 说明： 假设预置镜像的地址为pytorch_cuda: pytorch_2.7.0-cuda_12.8-py_3.11.10-ubuntu_22.04-x86_64-20251215163925-4e5422a，其中"ubuntu_22.04"为镜像的操作系统。 - **JupyterLab版本**：仅支持4.4.x版本。 图1创建Notebook实例-环境配置 ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002709554931.png) | | 资源配置 | 仅支持**专属资源池** ，以确保安全使用。关于如何创建专属资源池，请参见[创建专属资源池](https://support.huaweicloud.com/resmgmt-modelarts/resmgmt-modelarts_0004.html)。 由于GPU、NPU资源受限购买，需联系客户经理或[提交工单](https://console.huaweicloud.com/ticket/?#/ticketindex/createTicketService)申请开通相应的资源规格；如果您所在的区域无CPU规格，请尝试切换至其他区域，例如华东-上海一、华北-北京四、亚太-曼谷、中东-利雅得等。 图2创建Notebook实例-资源配置 ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002709674777.png) | #### 计费说明 - 在ModelArts运行Notebook实例时，会使用计算资源和存储资源，产生计算资源和存储资源的累计值计费。计费详情请参见[开发环境计费项](https://support.huaweicloud.com/price-modelarts/price-modelarts-0010.html)。 - Codex本身不收费，但调用大模型API会产生费用。具体计费方式取决于您选择的API Provider。 #### 在Notebook配置Codex 1. 登录[ModelArts管理控制台](https://console.huaweicloud.com/modelarts/)，在左侧导航栏按需选择以下操作。 - 新版控制台：选择"模型开发与训练 \> Notebook"，进入"Notebook"页面。 - 旧版控制台：选择"开发空间 \> Notebook"，进入"Notebook"页面。 2. 在"状态"为"运行中"的Notebook实例的操作列，单击"接入环境"，在"接入方式"对话框的"WebIDE"页签，单击"JupyterLab 接入"右侧的"接入"。 3. 在"ModelArts Launcher"页面的"AI Agent"区域，单击"Codex"。 图3AI Agent ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002680507914.png) 4. 在"Codex 控制面板"，勾选协议，单击"安装配置 Codex"，在Terminal中选择"安装 Codex"，按Enter确认。 图4安装配置Codex ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002710166103.png) 图5安装Codex ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002680646174.png) 5. 安装版本选择推荐版本，按Enter确认。安装完成后，会显示"Codex 安装完成"。 图6选择安装版本 ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002710187713.png) 6. 首次配置向导中，"是否现在配置 AI 模型提供商"输入y。 图7首次配置向导 ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002680667662.png) 7. 选择"模型配置"，模型提供商选择"自定义接入推理服务 - 自定义API地址和模型"，按实际情况配置模型信息。 目前仅支持配置自定义模型，模型需要支持Function Call能力。Qwen3_32B及以下的模型都默认不支持Function Call。 下面以配置MiniMax为例。其他第三方模型配置信息请参见对应的模型提供商指导文档。 图8配置自定义接入推理服务相关信息 ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002710166101.png) 8. 在"ModelArts Launcher"页面的"AI Agent"区域，单击"Codex"，打开Codex。 图9打开Codex ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002680664068.png) #### 验证Codex是否配置成功 1. 在Codex界面，选择"1. Yes, continue"，信任此目录的内容。 图10选择信任此目录的内容 ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002710325961.png) 2. 输入任意语句，开始问答。 图11在Codex中进行对话 ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002680486304.png) 如果Codex能正常回复，说明配置成功。 图12Codex回复 ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002680486302.png)