GMI Cloud Inference Engine 是全球 AI 模型统一接入与在线使用的“高性能推理引擎平台”，底层搭载 H100/H200 芯片，集成全球近百个最前沿的大语言模型和视频生成模型，如 Minimax、DeepSeek、GPT OSS、Qwen、Kling 等，为 AI 开发者与企业提供速度更快、质量更高的模型服务。
欢迎来到！🎉🎉🎉
OpenCode 接入 GMI Cloud Inference Engine 实操教程【AI coding加速篇】
本期任务目标： 在 OpenCode 中无缝接入 GMI Cloud Inference Engine，解锁众多模型的终端交互式使用体验，借助 OpenCode 便捷的命令行能力，打造高效的本地 AI 开发辅助工具～
OpenCode 是一款轻量强大的终端 AI 工具，可直接在终端启动交互式界面，灵活配置多模型，让开发者无需切换平台，快速调用大模型能力。
话不多说，全系统通用步骤+专属操作，跟着做轻松完成对接，即刻开启终端 AI 新体验～
01
准备工作：环境与密钥就绪
get ready
工欲善其事，必先利其器，先完成基础准备，让后续配置零阻碍！
💻 系统与环境要求
支持MacOS、Windows 原生环境，无需额外配置复杂依赖，终端/PowerShell 可正常执行命令即可。
🔑 获取 GMI Cloud API Key
API Key 是对接的核心凭证，务必妥善保管，切勿公开分享！
登录 GMI Cloud Inference Engine 官方地址，点击页面右上角个人头像，选择【API Keys】
点击【Create API Key】，生成后立即复制密钥（仅创建时可见，刷新后无法查看）
📦 安装 OpenCode
全系统均支持官方标准安装方式，根据自己的设备系统选择对应方案，一键完成安装！
Mac 端需打开终端，直接运行以下命令
curl -fsSL https://opencode.ai/install | bash
Windows 端，建议使用
npm install -g opencode-ai
或直接安装 OpenCode 桌面版。
该命令将自动完成以下操作：
✅ 在用户环境中安装 OpenCode 核心程序
✅ 配置 opencode 命令行工具，支持终端直接调用
✅ 完成基础环境适配，可直接启动 OpenCode 界面
02
核心配置：全系统分步操作
Core configuration
配置后可直接在 OpenCode 中调用 GPT 5.1、GPT 5.4 模型，每一步都清晰易懂，跟着操作即可！
统一步骤：创建配置目录（全系统通用）
如目录不存在，请先创建配置目录，确保后续配置文件可正常读写。
Mac 端终端执行
mkdir -p ~/.config/opencodemkdir -p ~/.local/share/opencode
Windows 端 PowerShell 执行：
New-Item -ItemType Directory -Force "$env:USERPROFILE.config\opencode" | Out-NullNew-Item -ItemType Directory -Force "$env:USERPROFILE.local\share\opencode" | Out-Null
步骤1：写入统一提供商配置文件
全平台provider ID 统一为 gmi，配置内容完全一致，建议使用 VS Code / Notepad++ 编辑文件，避免格式报错！
✅ Mac 端操作
终端中创建并编辑配置文件：
vi ~/.config/opencode/opencode.jsonc
粘贴以下统一配置内容，按 esc+:wq 保存退出：
{ "$schema": "https://opencode.ai/config.json", "provider": { "gmi": { "npm": "@ai-sdk/openai-compatible", "name": "GMI Cloud", "options": { "baseURL": "https://api.gmi-serving.com/v1", "apiKey": "{env:GMI_API_KEY}" }, "models": { "openai/gpt-5.4": { "name": "GPT 5.4" }, "openai/gpt-5.1": { "name": "GPT 5.1" } } } }}
✅ Windows 端操作
PowerShell 直接创建并编辑文件（无需手动找目录）：
notepad "$env:USERPROFILE.config\opencode\opencode.jsonc"
粘贴上方完全相同的统一配置内容，建议使用 VS Code 或 Notepad++ 保存，避免 BOM 导致 OpenCode 解析失败。
💡 关键提醒：配置文件中必须使用英文双引号，不可用中文引号，否则会导致配置失效！
步骤2：写入统一认证配置文件
auth.json 与 provider ID 严格保持一致，全平台配置内容相同：
✅ Mac 端操作
终端执行：
vi ~/.local/share/opencode/auth.json
粘贴以下内容后，保存退出
{ "gmi": { "type": "api", "key": "{env:GMI_API_KEY}" }}
✅ Windows 端操作
PowerShell 执行：
notepad "$env:USERPROFILE.local\share\opencode/auth.json"
粘贴上方完全相同的统一认证内容，使用 VS Code / Notepad++ 保存即可。
步骤3：配置 GMI_API_KEY 环境变量
将已复制的 GMI Cloud API Key 配置为系统环境变量，让 OpenCode 可正常读取：
✅ Mac 端操作
终端中直接运行以下命令，将 <YOUR_GMI_API_KEY> 替换为实际复制的 API Key：
export GMI_API_KEY="<YOUR_GMI_API_KEY>"
💡 提醒：该命令仅对当前终端窗口有效，关闭终端后需重新执行。
✅ Windows 端操作
PowerShell 中运行以下命令，替换密钥后执行：
[Environment]::SetEnvironmentVariable("GMI_API_KEY", "<YOUR_GMI_API_KEY>", "User")
验证配置：
[Environment]::GetEnvironmentVariable("GMI_API_KEY", "User")
返回密钥即为配置成功。
步骤4：重启并验证 OpenCode
启动/重启 OpenCode
Mac 端：直接在终端运行命令 opencode
Windows 端：如果安装的是 CLI，运行 opencode；如果安装的是桌面版，重启 OpenCode 应用即可
验证配置有效性
在 OpenCode 界面中运行命令 /models，若能看到 GMI Cloud、GPT 5.1、GPT 5.4，即为配置成功。
03
进阶玩法：界面快捷配置
Advanced Operations
步骤5：界面快速配置/修改提供商
无需手动编辑文件，OpenCode 支持界面内可视化配置，操作更便捷！
✅ 全平台通用操作
- 启动 OpenCode 后，在界面中直接运行命令：
/connect
2. 在弹出的提供商列表中，可完成两种操作：
-
直接选择【GMI Cloud】快速建立连接
-
找到已配置的【GMI Cloud】，修改 API Key 等参数
- 配置完成后，GMI Cloud 将显示在提供商列表中，直接选中即可使用。
步骤6：扩展添加更多模型
按需添加 GMI Cloud 支持的其他模型，丰富使用场景！
✅ 全平台通用操作
打开步骤1中的 opencode.jsonc 配置文件：
在 models 字段下按以下格式添加新模型
{ "$schema": "https://opencode.ai/config.json", "provider": { "GMI Cloud": { "npm": "@ai-sdk/openai-compatible", "name": "GMI Cloud", "options": { "baseURL": "https://api.gmi-serving.com/v1", "apiKey": "{env:GMI_API_KEY}", "headers": { "Authorization": "Bearer {env:GMI_API_KEY}" } }, "models": { "openai/gpt-5.4": { "name": "GPT 5.4" }, "openai/gpt-5.1": { "name": "gpt 5.1" } } } }}
3. 保存文件后，重启 OpenCode 使配置生效：
-
Mac 端：关闭终端重新打开，运行
opencode -
Windows 端：关闭 OpenCode 应用，重新启动（CLI 模式需重新运行
opencode）
- 验证新模型：在 OpenCode 界面运行命令
/models，即可在 GMI Cloud 提供商下看到新增模型，选中即可使用。
💡 关键提醒：新增模型的 ID 需与 GMI Cloud 平台支持的模型 ID 完全一致，否则无法正常调用！
04
常见坑避坑指南
Guide to Avoiding Errors
❌ 配置文件用了中文引号：全部替换为英文双引号
❌ Windows 文件格式报错：使用 VS Code / Notepad++ 保存
❌ 无法连接：检查 API Key 是否正确配置、网络是否通畅
❌ Mac 终端关闭后失效：重新执行 export 命令即可
教程完毕！🎉 现在你可以在 OpenCode 中自由调用 GMI Cloud Inference Engine 平台中的海量模型，在终端中高效完成AI辅助开发、内容生成等操作～
