更新时间：2026-09-30 GMT+08:00

在Notebook中安装配置Codex

AI开发人员在华为云ModelArts Notebook中进行模型开发时，常面临代码编写效率低、跨文件重构繁琐、测试用例编写耗时等问题，影响开发进度。本文介绍如何在ModelArts Notebook中部署并使用Codex。Codex是OpenAI推出的开源AI编程助手，可运行在ModelArts Notebook实例中，通过终端（CLI）与Codex TUI进行交互，借助内置的ModelArts Skill快速使用和管理ModelArts服务，提升AI模型的开发与管理效率。

Notebook是容器运行时环境，运行环境会在关机时被清理。请通过保存镜像及时保留npm install安装后的环境，以及~/.codex/目录下的配置文件（config.toml）、Skills、对话session和~/.bashrc中的API Key等环境变量，以避免Notebook运行环境中的数据丢失。

注意事项

使用Codex时可能出现风险，详情请参见Codex风险说明及安全建议。

约束限制

Notebook Codex功能仅支持“华北-北京四”、“西南-贵阳一”、“华北-乌兰察布一”、“华东-上海一”和“华南-广州”区域。

您创建的Notebook实例需满足如下条件，才能正常使用Codex。

表1 Notebook实例约束限制
类型	限制
环境配置	容器镜像的操作系统：暂不支持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实例-环境配置
资源配置	仅支持专属资源池，以确保安全使用。关于如何创建专属资源池，请参见创建专属资源池。由于GPU、NPU资源受限购买，需联系客户经理或提交工单申请开通相应的资源规格；如果您所在的区域无CPU规格，请尝试切换至其他区域，例如华东-上海一、华北-北京四、亚太-曼谷、中东-利雅得等。图2 创建Notebook实例-资源配置

计费说明

在ModelArts运行Notebook实例时，会使用计算资源和存储资源，产生计算资源和存储资源的累计值计费。计费详情请参见开发环境计费项。
Codex本身不收费，但调用大模型API会产生费用。具体计费方式取决于您选择的API Provider。

在Notebook配置Codex

登录ModelArts管理控制台，在左侧导航栏按需选择以下操作。
- 新版控制台：选择“模型开发与训练 > Notebook”，进入“Notebook”页面。
- 旧版控制台：选择“开发空间 > Notebook”，进入“Notebook”页面。
在“状态”为“运行中”的Notebook实例的操作列，单击“接入环境”，在“接入方式”对话框的“WebIDE”页签，单击“JupyterLab 接入”右侧的“接入”。
在“ModelArts Launcher”页面的“AI Agent”区域，单击“Codex”。
图3 AI Agent
在“Codex 控制面板”，勾选协议，单击“安装配置 Codex”，在Terminal中选择“安装 Codex”，按Enter确认。
图4 安装配置Codex

图5 安装Codex
安装版本选择推荐版本，按Enter确认。安装完成后，会显示“Codex 安装完成”。
图6 选择安装版本
首次配置向导中，“是否现在配置 AI 模型提供商”输入y。
图7 首次配置向导
选择“模型配置”，模型提供商选择“自定义接入推理服务 - 自定义API地址和模型”，按实际情况配置模型信息。
目前仅支持配置自定义模型，模型需要支持Function Call能力。Qwen3_32B及以下的模型都默认不支持Function Call。

下面以配置MiniMax为例。其他第三方模型配置信息请参见对应的模型提供商指导文档。

图8 配置自定义接入推理服务相关信息
在“ModelArts Launcher”页面的“AI Agent”区域，单击“Codex”，打开Codex。
图9 打开Codex