# 开始使用 该解决方案使用22端口CloudShell方式远程登录云服务器，默认已配置IP地址白名单，若需远程登录云服务器，可直接使用CloudShell远程登录。 该解决方案部署成功后，环境初始化及应用安装预计10\~15分钟不等，受网络、带宽影响，部署时间会有波动，部署完成方可正常使用。 #### 安全组规则修改（可选） 安全组实际是网络流量访问策略，包括网络流量入方向规则和出方向规则，通过这些规则为安全组内具有相同保护需求并且相互信任的云服务器、云容器、云数据库等实例提供安全保护。 如果您的实例关联的安全组策略无法满足使用需求，比如需要添加、修改、删除某个TCP端口，请参考以下内容进行修改。 - 添加安全组规则：根据业务使用需求需要开放某个TCP端口，请参考**[添加安全组规则](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0030969470.html)**添加入方向规则，打开指定的TCP端口。 - 修改安全组规则：安全组规则设置不当会造成严重的安全隐患。您可以参考**[修改安全组规则](https://support.huaweicloud.com/usermanual-vpc/vpc_SecurityGroup_0005.html)**，来修改安全组中不合理的规则，保证云服务器等实例的网络安全。 - 删除安全组规则：当安全组规则入方向、出方向源地址/目的地址有变化时，或者不需要开放某个端口时，您可以参考**[删除安全组规则](https://support.huaweicloud.com/usermanual-vpc/vpc_SecurityGroup_0006.html)**进行安全组规则删除。 #### opencode使用配置 opencode部署完成后支持两种使用方式：1.Web网页使用；2.命令行使用。下面分别演示两种使用方式的使用配置： Web网页使用配置： 1. 在部署完成后的输出页查看并访问opencode网址，登录时用户名默认为opencode，密码为用户在部署资源时设置的opencode_webe_password密码。 图1opencode登录网址 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002753268685.png "点击放大") 图2opencode网页登录界面 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002723668932.png "点击放大") 2. 了解使用opencode的相关内容。1、根据需求配置通用设置，这里以打开显示智能体为例；2、了解快捷键，方便快捷使用 ；3、根据需求进行服务器信息修改。 图3通用设置页 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002757099849.png "点击放大") 图4显示两种智能体选择 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002757051341.png "点击放大") 图5快捷键总览页 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002756961693.png "点击放大") 图6服务器信息修改页 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002727282428.png "点击放大") 3. 获取模型API Key。登录[MaaS平台](https://console.huaweicloud.com/modelarts/#/model-studio/homepage)，在左侧导航栏，单击"API Key管理"（最多可创建30个密钥。**每个密钥仅在创建时显示一次，请确保妥善保存。如果密钥丢失，无法找回，需要重新创建API Key以获取新的访问密钥** ）。如已有apikey或仅使用opencode免费模型请下拉到步骤5继续模型配置。 图7API Key管理 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002753428607.png "点击放大") 4. 在"API Key管理"页面，单击右上角"创建API Key"，填写标签（自定义API Key的标签，标签具有唯一性，不可重复。仅支持大小写英文字母、数字、下划线、中划线，长度范围为1\~100个字符）和描述（自定义API Key的描述，长度范围为1\~100个字符）信息后，单击"确定"。标签和描述信息在创建完成后，不支持修改。 图8创建API Key ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002723668926.png "点击放大") 5. opencode内置免费模型，同时也支持用户自主添加模型。 图9免费模型 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002723668928.png "点击放大") 图10用户自主添加模型 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002727286880.png "点击放大") 图11用户可选提供商 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002727288604.png "点击放大") 6. 自主添加模型详细演示，这里以通过华为云MaaS模型API Key添加自定义openAI兼容提供商模型为例。单击箭头所指位置开始配置模型。 图12自定义openAI兼容提供商入口 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002753428611.png "点击放大") 7. 按照提示依次填写相关信息，API base URL、API key的填写详见说明。其中提供商ID和显示名称的填写仅用于用户区分添加的模型，不影响添加模型的使用，可以根据需求填写。model-id填写请正确填写模型官方id，显示名称字段填写无强制要求。单击model-id字段下的添加模型可一次性添加多个API key支持的模型。 图13自定义提供商信息填写页 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002727467314.png "点击放大") 图14续自定义提供商信息填写页 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002757107003.png "点击放大") ![](https://support.huaweicloud.com/opencode-aislt/public_sys-resources/note_3.0-zh-cn.png) 模型配置华为云MaaS为样例：API base URL固定填写："https://api.modelarts-maas.com/v1",API key填写：参考步骤3创建apikey或使用已有apikey； 选择模型需要注意：模型已经开通，查询地址：华为云MaaS平台[模型列表](https://console.huaweicloud.com/modelarts/#/model-studio/deployment?callInfo=310) 8. 在填写好相关信息后单击提交完成模型配置。 图15提交模型配置 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002753428627.png "点击放大") 9. 在模型栏目查看已添加的模型。 图16已添加模型列表 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002723828838.png "点击放大") 10. 单击添加项目，打开projects文件，新建对话验证已添加模型，到此模型配置完毕。 图17新建项目 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002757160467.png "点击放大") 图18对话模型选择 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002757080343.png "点击放大") 图19对话验证 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002727680624.png "点击放大") 命令行使用配置： 1. 在RFS资源栏单击opencode-ecs进入控制台，单击远程登录，选择CloudShell登录，填写ecs_password完成登录。 图20跳转ecs ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002757058189.png "点击放大") 图21CloudShell登录（默认使用22端口） ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002727658862.png "点击放大") 图22填写ecs_password ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002757059287.png "点击放大") 2. 在ecs中一次运行以下代码完成模型配置。其中baseURL，apikey，model_id需要替换为实际值。 图23配置代码 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002727704866.png "点击放大") 3. 在进行完以上操作后，在命令行输入opencode，进入对话界面，在对话框中输入/model回车，选中添加的模型就可以开始使用添加的模型了，到此模型配置结束。 图24选择模型 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002728966476.png "点击放大") 图25对话验证 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002728966442.png "点击放大") #### opencode基础使用指南 Web网页使用： 1. 单击图25所示位置打开文件，选择projects文件夹。 图26打开文件 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002753428623.png "点击放大") 图27文件夹选择 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002728804254.png "点击放大") 2. 单击新建对话，选择对话模式和模型开始使用。其中Plan模式是任务规划模式，在此模式下opencode对用户的指令不会直接执行，只会列出计划；Build模式下用户指令会直接执行。 图28新建对话 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002723668918.png "点击放大") 图29选择对话模式 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002728967072.png "点击放大") 图30选择模型 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002723668914.png "点击放大") 图31使用示例 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002758368631.png "点击放大") 3. 单击箭头所示位置打开对话侧边栏查看对话信息。关于对话相关功能，需要注意归档功能单击后对话会在web页面消失，但是仍然在存储中存在。如果要在web页面恢复对话则需要使用shell指令。 图32对话侧边栏 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002753268707.png "点击放大") 图33对话相关功能 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002723828860.png "点击放大") 图34归档文档恢复指令 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002753428635.png "点击放大") 命令行使用： 1. 使用CloudShell登录ecs，输入opencode进入使用界面。如果需要退出 图35ecs使用界面 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002728995280.png "点击放大") 2. Ctrl+P打开opencode命令查看，根据需求选择命令。 图36查看命令 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002729897924.png "点击放大") 3. 单击tab键切换opencode运行模式，选择需要的模式开启使用。 图37Plan模式 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002729901488.png "点击放大") 图38Build模式 ![](https://support.huaweicloud.com/opencode-aislt/zh-cn_image_0000002729742182.png "点击放大")