# 在Notebook中安装配置OpenCode 对于AI开发人员来说，日常工作中经常需要在华为云ModelArts Notebook中编写和管理AI模型。然而，在实际操作中，开发人员可能会遇到代码编写效率低、模型管理复杂的问题，这直接影响了开发进度和项目质量。如何解决这些问题，提高开发效率和简化模型管理呢？ 本文介绍如何在华为云ModelArts Notebook中部署并使用OpenCode。OpenCode是一个开源的AI编程助手，可以运行在ModelArts Notebook实例中，通过终端（CLI）与OpenCode TUI进行交互。借助内置的ModelArts Skill可以快速使用和管理ModelArts服务，从而提高开发效率和简化模型管理。 ![](https://support.huaweicloud.com/bestpractice-modelarts/public_sys-resources/warning_3.0-zh-cn.png) Notebook是容器运行时环境，运行环境会在关机时被清理。请通过保存镜像及时保留apt-get install、npm install、uv pip install安装后的环境，以及\~/.config/目录下的配置文件（config.yaml、.env）、Skills、Memory和对话session等，以避免Notebook运行环境中的数据丢失。关于如何保存镜像，请参见[保存镜像](https://support.huaweicloud.com/devtool-modelarts/devtool-modelarts_0008.html)。 #### 注意事项 使用OpenCode时可能出现风险，详情请参见[OpenCode风险说明及安全建议](https://support.huaweicloud.com/bestpractice-modelarts/modelarts_20_00021.html)。 #### 约束限制 - Notebook OpenCode功能仅支持"华北-北京四"、"西南-贵阳一"、"华北-乌兰察布一"、"华东-上海一"和"华南-广州"区域。 - 您创建的[Notebook实例](https://support.huaweicloud.com/devtool-modelarts/devtool-modelarts_3495.html)需满足如下条件，才能正常使用OpenCode。 表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_0000002640275368.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_0000002640115422.png) | #### 计费说明 - 在ModelArts运行Notebook实例时，会使用计算资源和存储资源，产生计算资源和存储资源的累计值计费。计费详情请参见[开发环境计费项](https://support.huaweicloud.com/price-modelarts/price-modelarts-0010.html)。 - OpenCode本身不收费，但调用大模型API会产生费用。具体计费方式取决于您选择的API Provider。 #### 在Notebook配置OpenCode 1. 登录[ModelArts管理控制台](https://console.huaweicloud.com/modelarts/)，在左侧导航栏按需选择以下操作。 - 新版控制台：选择"模型开发与训练 \> Notebook"，进入"Notebook"页面。 - 旧版控制台：选择"开发空间 \> Notebook"，进入"Notebook"页面。 2. 在"状态"为"运行中"的Notebook实例的操作列，单击"接入环境"，在"接入方式"对话框的"WebIDE"页签，单击"JupyterLab 接入"右侧的"接入"。 3. 在"ModelArts Launcher"页面的"AI Agent"区域，单击"OpenCode"。 图3AI Agent ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002639500470.png) 4. 在"OpenCode 控制面板"，勾选协议，单击"安装配置 OpenCode"，在Terminal中选择"安装 OpenCode"，按Enter确认。 图4安装配置OpenCode ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002649197824.png "点击放大") 图5安装OpenCode ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002679437527.png) 5. 安装版本选择推荐版本，按Enter确认。安装完成后，会显示"OpenCode 安装成功"。 图6选择安装版本 ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002679438047.png "点击放大") 6. 按实际情况配置模型信息。 如果您需要配置自定义模型，模型需要支持Function Call能力。Qwen3_32B及以下的模型都默认不支持Function Call。查看MaaS模型能力，请参见[推荐模型](https://support.huaweicloud.com/model-list-maas/model_list_0001.html)；查看ModelArts模型能力，请参见[模型调用功能介绍](https://support.huaweicloud.com/model-call-modelarts/model-call-modelarts-0001.html)。 下文以配置华为云MaaS为例。第三方模型配置信息请参见对应的模型提供商指导文档。 表2首次配置向导-MaaS配置示例 | 配置项 | 说明 | 配置示例 | |:---|:---|:---| | 是否现在配置AI模型提供商 | 按需选择是否直接配置模型提供商。 | Y | | 是否现在配置华为云MaaS | 选择配置MaaS或其他服务，本文以MaaS为例。 | Y | | 请输入MaaS API地址 | 使用MaaS API地址时，需删除地址末尾的/chat/completions，修改示例参见[表3]。 | https://api.modelarts-maas.com/v2 | | 请输入您的API Key | 输入在MaaS创建的API Key。关于如何在MaaS创建API Key，请参见[创建API Key](https://support.huaweicloud.com/model-call-maas/model-call-049.html#section2)。 | D1Jy5b4n_JOKGSDEbhmNTZxpX5Obk6asJrA4bS660GZ_nrKFL-NSU2wv13AuliG_tbIz7i0wiY7\*\*\*\*\*\*\*\*\* | | 选择默认模型 | 按需选择使用的模型。 | glm-5.1 (GLM-5.1) | 表3MaaS API地址说明 | 接口 | 原MaaS API地址 | 修改后的MaaS API地址 | 相关文档 | |:---|:---|:---|:---| | MaaS标准API V2 | https://api.modelarts-maas.com/v2/chat/completions | https://api.modelarts-maas.com/v2 | [模型API调用规范](https://support.huaweicloud.com/model-call-maas/model-call-019.html) | | OpenAI兼容接口 | https://api.modelarts-maas.com/openai/v1 | 与原MaaS API地址一致 | [模型API调用规范](https://support.huaweicloud.com/model-call-maas/model-call-019.html) | 图7配置华为云MaaS ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002649360234.png "点击放大") 7. 在"ModelArts Launcher"页面的"AI Agent"区域，单击"OpenCode"，打开OpenCode。 图8打开OpenCode ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002649200682.png "点击放大") #### 验证OpenCode是否配置成功 在OpenCode对话框，输入任意语句，开始问答。 图9在OpenCode中进行对话 ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002649360828.png "点击放大") 如果OpenCode能正常回复，说明配置成功。 图10OpenCode回复 ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002679281955.png "点击放大")