配置完成后使用 /model 切换模型！

完整配置只需 5 步：

1. 步骤1 - 安装 OpenCode Desktop
2. 步骤2 - 找到配置文件位置
3. 步骤3 - 配置第三方渠道
4. 步骤4 - 连接 Provider 并输入 API Key
5. 步骤5 - 选择模型

推荐使用 OpenCode Desktop，开箱即用，无需命令行操作。

下载地址： https://opencode.ai/download

下载后直接安装即可。

如果配置文件不存在，需要手动创建。

快速打开方式：

• Windows: 资源管理器地址栏输入 %USERPROFILE%\.config\opencode
• macOS/Linux: 终端输入 open ~/.config/opencode 或 xdg-open ~/.config/opencode

1. API Key 需要在 本站控制台 的令牌页面自行生成创建

在 opencode.json 中添加以下配置：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "huanyu": {
      "npm": "@ai-sdk/anthropic",
      "name": "huanyu",
      "options": {
        "baseURL": "https://api.huanyuf.top/v1",
        "apiKey": "sk-xxx"
      },
      "models": {
        "claude-opus-4-6": {
          "name": "Claude Opus 4.6",
          "modalities": {
            "input": ["text", "image", "pdf"],
            "output": ["text"]
          }
        },
        "claude-opus-4-6-thinking": {
          "name": "Claude Opus 4.6 Thinking",
          "modalities": {
            "input": ["text", "image", "pdf"],
            "output": ["text"]
          },
          "reasoning": true,
          "variants": {
            "low": {
              "thinkingConfig": { "thinkingBudget": 8192 },
              "thinking": { "type": "enabled", "budget_tokens": 8192, "budgetTokens": 8192 }
            },
            "medium": {
              "thinkingConfig": { "thinkingBudget": 16384 },
              "thinking": { "type": "enabled", "budget_tokens": 16384, "budgetTokens": 16384 }
            },
            "high": {
              "thinkingConfig": { "thinkingBudget": 24576 },
              "thinking": { "type": "enabled", "budget_tokens": 24576, "budgetTokens": 24576 }
            },
            "max": {
              "thinkingConfig": { "thinkingBudget": 32768 },
              "thinking": { "type": "enabled", "budget_tokens": 32768, "budgetTokens": 32768 }
            }
          }
        },
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "modalities": {
            "input": ["text", "image", "pdf"],
            "output": ["text"]
          }
        },
        "claude-sonnet-4-6-thinking": {
          "name": "Claude Sonnet 4.6 Thinking",
          "modalities": {
            "input": ["text", "image", "pdf"],
            "output": ["text"]
          },
          "reasoning": true,
          "variants": {
            "low": {
              "thinkingConfig": { "thinkingBudget": 8192 },
              "thinking": { "type": "enabled", "budget_tokens": 8192, "budgetTokens": 8192 }
            },
            "medium": {
              "thinkingConfig": { "thinkingBudget": 16384 },
              "thinking": { "type": "enabled", "budget_tokens": 16384, "budgetTokens": 16384 }
            },
            "high": {
              "thinkingConfig": { "thinkingBudget": 24576 },
              "thinking": { "type": "enabled", "budget_tokens": 24576, "budgetTokens": 24576 }
            },
            "max": {
              "thinkingConfig": { "thinkingBudget": 32768 },
              "thinking": { "type": "enabled", "budget_tokens": 32768, "budgetTokens": 32768 }
            }
          }
        },
        "gemini-3.1-pro": {
          "name": "Gemini 3.1 Pro",
          "modalities": {
            "input": ["text", "image", "pdf"],
            "output": ["text"]
          }
        },
        "gemini-3-flash": {
          "name": "Gemini 3 Flash",
          "modalities": {
            "input": ["text", "image", "pdf"],
            "output": ["text"]
          }
        }
      }
    }
  }
}

注意： apiKey 字段填入你在令牌页面生成的 API Key，替换 sk-xxx。

1. 打开 OpenCode Desktop
2. 点击左下角 Connect provider
3. 输入 huanyu
4. 输入你在令牌页面生成的 API Key

在页面底部的下拉菜单中选择你配置的模型。

Oh My OpenCode 是 OpenCode 的增强插件，提供智能体编排、后台任务、LSP 工具等强大功能。

在 OpenCode 中直接输入以下指令，让 AI 自动完成安装配置：

按照这里的说明进行安装和配置 https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/README.md

AI 会自动读取官方文档并完成所有配置步骤。

1. 重启 OpenCode（关闭后重新打开）
2. 在对话中输入 ulw（ultrawork 的缩写）即可启用全部增强功能

• 智能体团队：Oracle（架构顾问）、Librarian（文档专家）、Explore（代码探索）等
• 后台任务：并行运行多个智能体
• LSP 工具：代码重构、符号查找、诊断
• 魔法关键词：输入 ultrawork 或 ulw 自动启用最强模式

Q: 提示 401 错误？

A: API Key 无效或未设置。检查 opencode.json 中 options.apiKey 是否正确填写，或是否已在 Connect provider 中正确输入。

Q: 模型列表中看不到配置的模型？

A: opencode.json 格式错误。使用 在线 JSON 校验工具 检查语法。

Q: 如何更新 OpenCode？

A: 重新下载安装最新版即可覆盖更新。

Q: 代理/VPN 环境下无法连接？

A: 设置环境变量：

# Linux/macOS
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# Windows PowerShell
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

• OpenCode 官方文档
• OpenCode 下载地址
• OpenCode GitHub
• Oh My OpenCode GitHub
• 本站 API 控制台（令牌页面）