文档首页/ 魔坊（ModelArts）模型训推平台/ 最佳实践/ Notebook AI助手最佳实践/ Notebook OpenCode最佳实践/ 在Notebook中安装配置OpenCode
更新时间：2026-08-13 GMT+08:00
查看PDF
分享

在Notebook中安装配置OpenCode

对于AI开发人员来说，日常工作中经常需要在华为云ModelArts Notebook中编写和管理AI模型。然而，在实际操作中，开发人员可能会遇到代码编写效率低、模型管理复杂的问题，这直接影响了开发进度和项目质量。如何解决这些问题，提高开发效率和简化模型管理呢？

本文介绍如何在华为云ModelArts Notebook中部署并使用OpenCode。OpenCode是一个开源的AI编程助手，可以运行在ModelArts Notebook实例中，通过终端（CLI）与OpenCode TUI进行交互。借助内置的ModelArts Skill可以快速使用和管理ModelArts服务，从而提高开发效率和简化模型管理。

Notebook是容器运行时环境，运行环境会在关机时被清理。请通过保存镜像及时保留apt-get install、npm install、uv pip install安装后的环境，以及~/.config/目录下的配置文件（config.yaml、.env）、Skills、Memory和对话session等，以避免Notebook运行环境中的数据丢失。关于如何保存镜像，请参见保存镜像。

注意事项

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

约束限制

  • Notebook OpenCode功能仅支持“华北-北京四”、“西南-贵阳一”、“华北-乌兰察布一”、“华东-上海一”和“华南-广州”区域。
  • 您创建的Notebook实例需满足如下条件，才能正常使用OpenCode。
    表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实例时，会使用计算资源和存储资源，产生计算资源和存储资源的累计值计费。计费详情请参见开发环境计费项。
  • OpenCode本身不收费，但调用大模型API会产生费用。具体计费方式取决于您选择的API Provider。

在Notebook配置OpenCode

  1. 登录ModelArts管理控制台，在左侧导航栏按需选择以下操作。
    • 新版控制台：选择“模型开发与训练 > Notebook”，进入“Notebook”页面。
    • 旧版控制台：选择“开发空间 > Notebook”，进入“Notebook”页面。
  2. 在“状态”为“运行中”的Notebook实例的操作列，单击“接入环境”，在“接入方式”对话框的“WebIDE”页签，单击“JupyterLab 接入”右侧的“接入”。
  3. 在“ModelArts Launcher”页面的“AI Agent”区域，单击“OpenCode”。
    图3 AI Agent
  4. 在“OpenCode 控制面板”，勾选协议，单击“安装配置 OpenCode”，在Terminal中选择“安装 OpenCode”，按Enter确认。
    图4 安装配置OpenCode
    图5 安装OpenCode
  5. 安装版本选择推荐版本，按Enter确认。安装完成后，会显示“OpenCode 安装成功”。
    图6 选择安装版本
  6. 按实际情况配置模型信息。

    如果您需要配置自定义模型，模型需要支持Function Call能力。Qwen3_32B及以下的模型都默认不支持Function Call。查看MaaS模型能力，请参见推荐模型；查看ModelArts模型能力，请参见模型调用功能介绍。

    下文以配置华为云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。

    D1Jy5b4n_JOKGSDEbhmNTZxpX5Obk6asJrA4bS660GZ_nrKFL-NSU2wv13AuliG_tbIz7i0wiY7*********

    选择默认模型

    按需选择使用的模型。

    glm-5.1 (GLM-5.1)
    表3 MaaS API地址说明

    接口

    原MaaS API地址

    修改后的MaaS API地址

    相关文档

    MaaS标准API V2

    https://api.modelarts-maas.com/v2/chat/completions

    https://api.modelarts-maas.com/v2

    模型API调用规范

    OpenAI兼容接口

    https://api.modelarts-maas.com/openai/v1

    与原MaaS API地址一致
    图7 配置华为云MaaS
  7. 在“ModelArts Launcher”页面的“AI Agent”区域，单击“OpenCode”，打开OpenCode。
    图8 打开OpenCode

验证OpenCode是否配置成功

在OpenCode对话框，输入任意语句，开始问答。
图9 在OpenCode中进行对话

如果OpenCode能正常回复，说明配置成功。

图10 OpenCode回复

相关文档