十、OpenCode 使用指南
1.下载地址（基于运行系统选择性安装）
https://opencode.ai/zh/download
2.配置说明
1. Windows系统版
1进入设置页
2选择提供商，随后选择自定义提供商，点击连接
提供商ID：自定义命名，但只支持小写字母、数字、连字符或下划线的输入格式；
显示名称：服务商在调用时显示的信息模型提供方名称，自定义命名；
Url：https://ai.yunsuguan.com/v1
Api秘钥：自我们服务器自行生成令牌（秘钥、key）；
模型：需调用的模型，需输入模型全称，不支持自定义命名格式，模型全称由我们服务器模型广场获取复制；
请求头：留白
随后保存即可生效
3按框选区域切换模型提供商，选定刚刚添加的模型即可进行chat对话调用
提供商配置文档：https://opencode.ai/docs/providers/#custom-provider
2. macOS 与 Linux 安装
安装 Node.js 环境
OpenCode 需要 Node.js 环境才能运行。
方法一：使用 Homebrew（推荐）
Homebrew 是 macOS 上最流行的包管理器。1安装 Homebrew（如果还没有安装）
打开终端 (Terminal)，运行以下命令：
bash
2使用 Homebrew 安装 Node.jsbash
方法二：官网下载
1打开浏览器访问 https://nodejs.org/
2点击 "LTS" 版本进行下载（推荐长期支持版本）
3下载完成后打开 .pkg 文件
4按照安装向导完成安装
方法三：使用 nvm（高级用户）
nvm (Node Version Manager) 允许你安装和管理多个 Node.js 版本。
验证 Node.js 安装
安装完成后，在终端中输入以下命令：
如果显示版本号，说明安装成功了！
macOS 注意事项：
macOS Catalina (10.15) 及以后版本默认使用 zsh 而不是 bash
安装时可能需要输入管理员密码
Apple Silicon (M1/M2/M3) Mac 完全支持 Node.js
1安装 OpenCode
打开终端，运行以下命令：
这个命令会从 npm 官方仓库下载并安装最新版本的 OpenCode。如果遇到权限问题：
可能需要使用 sudo（不推荐）或者配置 npm 使用用户目录：2验证 OpenCode 安装
安装完成后，输入以下命令检查是否安装成功：
如果显示版本号，恭喜你！OpenCode 已经成功安装了。
3配置 OpenCode
OpenCode 使用配置文件来管理 API 连接。我们需要创建并编辑配置文件。
创建配置目录
在终端中运行以下命令创建配置目录（如果不存在）：
1编辑配置文件
使用你喜欢的文本编辑器打开配置文件：
2配置内容
将以下内容粘贴到配置文件中：
重要： 将 你的API密钥和服务器地址 替换为在上方 API Keys 标签页中创建的实际密钥。
如果使用 nano 编辑器：
粘贴内容后按 Ctrl + O 保存
按 Enter 确认文件名
按 Ctrl + X 退出
如果使用 vim 编辑器：
按 i 进入插入模式
粘贴内容
按 Esc 退出插入模式
输入 :wq 保存并退出
3验证配置文件
你可以使用 cat 命令查看配置文件内容，确保配置正确：
4开始使用 OpenCode
现在你可以开始使用 OpenCode 了！
5启动 OpenCode
在项目目录中打开终端，然后运行：
6选择模型
OpenCode 启动后，使用 /model 命令选择模型：
输入 /model
输入 univibe 进行搜索
从列表中选择你配置的模型（如 claude-sonnet-4-6 或 gpt-5-3）
按回车确认
7开始编程
选择模型后，你就可以开始使用 OpenCode 进行 AI 辅助编程了！
常用命令
/model - 切换模型
/help - 查看帮助
/new - 新对话
/exit - 退出 OpenCode