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

开始使用

该解决方案使用22端口CloudShell方式远程登录云服务器，默认已配置IP地址白名单，若需远程登录云服务器，可直接使用CloudShell远程登录。

该解决方案部署成功后，环境初始化及应用安装预计10~15分钟不等，受网络、带宽影响，部署时间会有波动，部署完成方可正常使用。

OpenCode部署完成后支持两种使用方式：1.Web网页使用；2.命令行使用。

安全组规则修改（可选）

安全组实际是网络流量访问策略，包括网络流量入方向规则和出方向规则，通过这些规则为安全组内具有相同保护需求并且相互信任的云服务器、云容器、云数据库等实例提供安全保护。

如果您的实例关联的安全组策略无法满足使用需求，比如需要添加、修改、删除某个TCP端口，请参考以下内容进行修改。

添加安全组规则：根据业务使用需求需要开放某个TCP端口，请参考添加安全组规则添加入方向规则，打开指定的TCP端口。
修改安全组规则：安全组规则设置不当会造成严重的安全隐患。您可以参考修改安全组规则，来修改安全组中不合理的规则，保证云服务器等实例的网络安全。
删除安全组规则：当安全组规则入方向、出方向源地址/目的地址有变化时，或者不需要开放某个端口时，您可以参考删除安全组规则进行安全组规则删除。

OpenCode网页使用

在部署完成后的输出页查看并访问OpenCode网址，登录时用户名默认为OpenCode，密码为用户在部署资源时设置的OpenCode_webe_password密码。

图1 OpenCode登录网址

图2 OpenCode网页登录界面
了解使用OpenCode的相关内容。1、根据需求配置通用设置，这里以打开显示智能体为例；2、了解快捷键，方便快捷使用；3、根据需求进行服务器信息修改。

图3 通用设置页

图4 显示两种智能体选择

图5 快捷键总览页

图6 服务器信息修改页
OpenCode内置免费模型，同时也支持用户自主添加模型。

图7 免费模型

图8 用户自主添加模型

图9 用户可选提供商
自主添加模型详细演示，这里以通过华为云MaaS模型API Key添加自定义openAI兼容提供商模型为例。单击箭头所指位置开始配置模型。

图10 自定义openAI兼容提供商入口
获取模型API Key。登录MaaS平台，在“API Key管理”页面，单击右上角“创建API Key”，填写标签（自定义API Key的标签，标签具有唯一性，不可重复。仅支持大小写英文字母、数字、下划线、中划线，长度范围为1~100个字符）和描述（自定义API Key的描述，长度范围为1~100个字符）信息后，单击“确定”。标签和描述信息在创建完成后，不支持修改。（最多可创建30个密钥。每个密钥仅在创建时显示一次，请确保妥善保存。如果密钥丢失，无法找回，需要重新创建API Key以获取新的访问密钥）。

图11 创建API Key
按照提示依次填写相关信息，API base URL、API key的填写详见说明。其中提供商ID和显示名称的填写仅用于用户区分添加的模型，不影响添加模型的使用，可以根据需求填写。model-id填写请正确填写模型官方id，显示名称字段填写无强制要求。单击model-id字段下的添加模型可一次性添加多个API key支持的模型。

图12 自定义提供商信息填写页

图13 续自定义提供商信息填写页

模型配置华为云MaaS平台为样例：API base URL固定填写："https://api-ap-southeast-1.modelarts-maas.com/openai/v1”,API key填写：参考步骤5创建apikey或使用已有apikey；

国际站使用MaaS平台服务需要注意：模型已经开通，账户必须为企业账户，为什么只能是企业账户详见FAQ 问答。
在填写好相关信息后单击提交完成模型配置。

图14 提交模型配置
在模型栏目查看已添加的模型。

图15 已添加模型列表
使用配置好的模型开始OpenCode使用。单击添加项目，打开projects文件，新建对话验证已添加模型。

图16 新建项目

图17 对话模型选择
单击新建对话，选择对话模式和模型开始使用。其中Plan模式是任务规划模式，在此模式下OpenCode对用户的指令不会直接执行，只会列出计划；Build模式下用户指令会直接执行。

图18 新建对话

图19 选择对话模式

图20 选择模型

图21 使用对话验证添加的模型
单击箭头所示位置打开对话侧边栏查看对话信息。

图22 对话侧边栏

图23 对话相关功能
关于对话相关功能，需要注意归档功能单击后对话会在web页面消失，但是仍然在存储中存在。如果要在web页面恢复对话则需要使用shell指令。

归档文档恢复指令

1. 先查出被归档会话的 ID：
```
opencode db "SELECT id, title, time_archived FROM session WHERE time_archived IS NOT NULL"
```
2. 用 ID 恢复指定会话：
```
opencode db "UPDATE session SET time_archived = NULL WHERE id = <SESSION_ID>"
```
3. 一次性恢复全部归档会话：
```
opencode db "UPDATE session SET time_archived = NULL WHERE time_archived IS NOT NULL"
```
执行后刷新 Web 页面（或重启 opencode web），会话即重新出现在首页列表。
让opencode编写一段简易代码实现在对话窗口展示计算器计算功能。

图24 演示效果

OpenCode命令行使用

在RFS资源栏单击蓝色ecs名称进入控制台，单击远程登录，选择CloudShell登录，填写ecs_password完成登录。

图25 跳转ecs

图26 CloudShell登录（默认使用22端口）

图27 填写ecs_password

在ecs中一次运行以下代码完成模型配置。其中baseURL，apikey，model_id需要替换为实际值。

配置代码：

1. 准备目录

mkdir -p ~/.config/opencode

2. 写入配置（明文）

cat > ~/.config/opencode/opencode.json << EOF
{
  "$schema": "https://opencode.ai/config.json",
  "model": "huawei-maas/MODEL_ID",
  "provider": {
    "huawei-maas": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Huawei Cloud Maas",
      "options": {
        "baseURL": "BASE_URL",
        "apiKey": "{env:HUAWEI_MAAS_API_KEY}"
      },
      "models": {
        "MODEL_ID": {
          "name": "Huawei Maas"
        }
      }
    }
  }
}
EOF

3. 校验 JSON

python3 -m json.tool ~/.config/opencode/opencode.json > /dev/null && echo "config Ok"

在进行完以上操作后，在命令行输入OpenCode，进入对话界面（如果需要退出则使用Ctrl+C退出该界面），在对话框中输入/model回车，选中添加的模型就可以开始使用添加的模型了，到此模型配置结束。

图28 ecs对话界面

图29 选择模型
Ctrl+P打开OpenCode命令查看，根据需求选择命令。

图30 查看命令
单击tab键切换OpenCode运行模式，选择需要的模式开启使用。

图31 Plan模式

图32 Build模式

图33 对话验证
让opencode编写一段简易代码实现在对话窗口展示计算器计算功能。

图34 演示效果

父主题： 实施步骤

开始使用

安全组规则修改（可选）

OpenCode网页使用

OpenCode命令行使用

您对此文档页面的整体评价？