目录

OpenCode 安装配置指南

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

简要步骤说明

完整配置只需 5 步：

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

第一部分：安装配置 OpenCode

第一步：安装 OpenCode

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

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

下载后直接安装即可。

第二步：配置文件位置

系统 配置文件路径
Windows C:\Users\<用户名>\.config\opencode\opencode.json
macOS ~/.config/opencode/opencode.json
Linux ~/.config/opencode/opencode.json

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

快速打开方式：

第三步：配置第三方渠道

获取 API Key

  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。

配置字段说明

字段 说明
$schema JSON Schema，提供自动补全
npm SDK 包名
name Provider 显示名称
options.baseURL API 地址
options.apiKey 你的 API 密钥（在令牌页面生成）
models 模型配置列表
reasoning 是否为思考模型（thinking 模型设为 true）
variants 思考预算等级配置：low / medium / high / max
thinkingBudget 思考 token 预算（越大思考越深入）

第四步：连接 Provider 并输入 API Key

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

第五步：选择模型

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

第二部分：安装 Oh My OpenCode 插件

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 的缩写）即可启用全部增强功能

Oh My OpenCode 功能简介

常用命令速查

命令/快捷键 功能
/model 切换模型
/init 初始化项目（生成 AGENTS.md）
/undo 撤销更改
/redo 重做更改
/compact 压缩上下文
Tab 切换 Plan/Build 模式
Esc 两次 中断当前操作
Ctrl+C 退出 OpenCode

常见问题

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"

官方资源