AI类应用
>
最佳实践
>
开发类
>
镜像开发：在SCNet玩转OpenCode代码助手，从镜像制作、部署到应用

手把手教你在SCNet玩转OpenCode代码助手，从镜像制作、部署到应用 ​

近日，超算互联网 AI 社区镜像库全新上线，以标准化镜像加速词元（Token）经济落地。目前，镜像库已汇聚 600+ 基础开发镜像与主流大模型镜像，支持免费试用、快速创建实例、一键部署和克隆等便捷功能。无论是深度学习的框架环境，还是热门的国产大模型，开发者都能在社区中找到开箱即用的镜像方案，大幅降低环境配置的门槛。
在丰富的镜像生态之上，本期最佳实践聚焦于一个备受开发者关注的 AI 编码工具——OpenCode。OpenCode 是一个开源的 AI 编码代理，支持终端界面（TUI）、桌面应用及 IDE 扩展等多种交互方式。
本次实操，我们将手把手教大家从零开始，一站式掌握超算互联网 OpenCode-WebUI 代码助手全流程操作，从 OpenCode 镜像制作、上架发布、启动运行到模型使用完整教学，详解高性能计算（HPC）、大模型微调两大核心场景实战用法。帮助开发者快速实现高度自动化的代码编写与作业管理。

一、开发者镜像创建和发布 ​

（一）镜像制作 ​

首先，登录超算互联网（https://www.scnet.cn）个人账号，进入控制台：
1.png

点击【notebook】进入：
2.png

选择加速卡和基础镜像，并点击【创建】：
3.png

创建完成后可以修改名称，然后点击【JupyterLab】进入notebook：
4.png

根据官方提供的安装命令，在终端输入命令安装opencode，可在命令中指明安装路径：
5.png

安装完成后将路径写入配置文件，输入opencode -v命令能够输出版本号即安装成功。
6.png

使用opencode web --hostname 0.0.0.0 --port 4096命令启动opencode，输出图标及地址即成功启动。
7.png

返回notebook列表，点击【访问自定义服务】并输入端口号打开。
8.png

成功跳转至opencode主界面，至此opencode已安装完成且能够正常运行，接着即可关闭网页和notebook中打开的页面，恢复初始状态便于保存镜像。
9.png

返回notebook列表，保存镜像，并设置镜像名称，最后点击【确认】。
10.png

11.png

操作成功后即可点击【我的镜像】查看镜像保存进度，至此镜像制作完成。
12.png

（二）上传并发布到镜像库 ​

在我的镜像界面点击保存好的镜像进入。
13.png

点击【更多】，然后点击【分享】自动跳转进入镜像库发布界面。
14.png

设置镜像名称、简介、介绍等信息，建议【是否公开】选项设置为私有，待完善后改为公开，完成后点击【发布】。
15.png

发布后进入镜像详情，点击【版本】，然后点击【编辑】为镜像添加部署服务信息。
16.png

填写镜像框架、python版本、操作系统等基本信息，打开【部署服务】后填写运行命令，【服务方式】选择Web应用，填写端口号，最后点击【提交】.
17.png

提交后镜像名称后出现支持部署标签，详情页右上角出现部署按钮。
18.png

最后可将模型设置为公开状态，点击设置，将【是否公开】改为【公开镜像】，点击【更新资料】。
19.png

至此，模型成功发布至镜像库且支持一键部署。

二、镜像发布后应用 ​

（一）启动OpenCode ​

登录超算互联网https://www.scnet.cn个人账号，进入AI社区。
20.png

点击镜像库，搜索OpenCode并点击进入。
21.png

22.png

OpenCode支持两种启动方式，一键部署和自定义创建Notebook使用。

1. 一键部署 ​

本镜像支持一键部署，点击【部署】：
23.png

添加服务名称并选择资源，最后点击【创建】：
24.png

创建后自动跳转模型部署界面，点击【查看】后跳出浏览器地址，手动复制到浏览器打开或者点击中间图标自动打开地址即打开OpenCode：
25.png

26.png

2. 自定义方式 ​

此外，本镜像支持自定义创建Notebook手动启动OpenCode，点击【快速开发】-【创建实例】：
27.png

选择资源创建后自动跳转Notebook界面，创建完成状态显示“运行中”后点击【JupyterLab】进入：
28.png

在Notebook中，有以下两种 OpenCode 启动方式：

2.1 Web 方式 ​

OpenCode 可以作为 Web 应用在浏览器中运行，无需终端即可获得同样强大的 AI 编码体验。

  • 启动命令：在 Jupyter 环境中执行以下单元格命令：
shell
!sh run_web.sh

29.png

  • 访问方式：当控制台输出启动成功信息后，通过控制台的 【自定义服务】 功能，设置端口为 4096 即可进行访问。
    30.png
2.2 TUI (终端用户界面) 方式 ​

OpenCode 提供了交互式终端界面（TUI），用于配合大语言模型（LLM）处理您的项目。

  • 启动步骤：
    1. 在环境中新建一个终端（Terminal）。
    2. 将以下命令复制到终端中运行：
shell
sh run_tui.sh

31.png

  • 注意事项：启动过程中需要提供工作路径。若不提供，则默认使用：/root/opencode。
    32.png

33.png

（二）opencode模型配置 ​

1. opencode官方免费模型 ​

OpenCode官方提供API配置方法，包含一系列免费模型，使用方式见官方教程：https://opencode.ai/docs/zh-cn#配置

2. 自定义配置SCNet官方maas模型 /Token Plan/Coding plan ​

SCNet API 配置说明文档：https://www.scnet.cn/ac/openapi/doc/2.0/moduleapi/tutorial/apicall.html

申请SCNet API后在OpenCode中填写配置信息：
34.png

35.png

SCNet Coding Plan配置说明文档：https://www.scnet.cn/ac/openapi/doc/2.0/moduleapi/tools/opencode.html

（三）使用案例 ​

1. HPC ：告别手写脚本，一句话批量提交 ​

在高性能计算（HPC）环境中，通过 OpenCode可以编写、修改和管理海量计算作业脚本，实现高度自动化的作业管理：
打开工作目录：
36.png

  • 前/后处理：OpenCode可以实现生成初始构型、格式转换、打包分子、提取数据等前/后处理操作。
    37.png

  • 脚本生成：向 OpenCode 描述您的集群环境与计算需求，生成适配当前环境的作业脚本。
    38.png

  • 批量作业提交：OpenCode 能够自动遍历目录，一键生成批量作业提交输入文件及脚本。
    39.png

2. AI ：三步实现大模型微调 ​

在人工智能（AI）领域，借助 OpenCode 强大的的代码生成与执行能力，只需三步即可快速拉起一个大模型微调任务，以智谱GLM微调为例：

  • 第一步：创建 Conda 环境
    将项目克隆到当前文件夹后，告诉 OpenCode环境需求，创建conda环境。
    40.png

  • 第二步：运行微调代码
    41.png

  • 第三步：自动调参测试
    直接在向 OpenCode 描述微调需求，OpenCode能够自动调整参数进行测试并输出结果。
    42.png