====== OpenCode 安装配置指南 ======

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

===== 简要步骤说明 =====

**完整配置只需 5 步：**

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

----

===== 第一部分：安装配置 OpenCode =====

==== 第一步：安装 OpenCode ====

<note tip>推荐使用 **OpenCode Desktop**，开箱即用，无需命令行操作。</note>

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

下载后直接安装即可。

==== 第二步：配置文件位置 ====

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

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

**快速打开方式：**
  * **Windows**: 资源管理器地址栏输入 ''%USERPROFILE%\.config\opencode''
  * **macOS/Linux**: 终端输入 ''open ~/.config/opencode'' 或 ''xdg-open ~/.config/opencode''

==== 第三步：配置第三方渠道 (duojie.games) ====

=== 获取 API Key ===

<note important>
  - 闲鱼购买的**兑换码**是用于兑换额度的，不是 API Key
  - API Key 需要在 [[https://api.duojie.games|令牌页面]] 自行生成创建
</note>

=== 配置示例 ===

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

<code json>
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "duojie": {
      "npm": "@ai-sdk/anthropic",
      "name": "DuoJie",
      "options": {
        "baseURL": "https://api.duojie.games/v1"
      },
      "models": {
        "gpt-5.2": {
          "limit": { "context": 400000, "output": 8192 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "gpt-5.2-codex": {
          "limit": { "context": 400000, "output": 8192 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "claude-haiku-4-5": {
          "limit": { "context": 200000, "output": 8192 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "claude-opus-4-5-20251101": {
          "limit": { "context": 200000, "output": 8192 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "claude-opus-4-5-aws": {
          "limit": { "context": 200000, "output": 8192 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "claude-opus-4-5-fast": {
          "limit": { "context": 200000, "output": 8192 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "claude-opus-4-5-max": {
          "limit": { "context": 200000, "output": 8192 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "claude-sonnet-4-5": {
          "limit": { "context": 200000, "output": 8192 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "gemini-3-flash-preview": {
          "limit": { "context": 1000000, "output": 8192 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "gemini-3-pro-image-preview": {
          "limit": { "context": 1000000, "output": 8192 },
          "modalities": { "input": ["text", "image"], "output": ["text", "image"] }
        },
        "gemini-3-pro-preview": {
          "limit": { "context": 1000000, "output": 8192 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "glm-4.7": {
          "limit": { "context": 128000, "output": 8192 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        }
      }
    }
  }
}
</code>

=== 配置字段说明 ===

^ 字段 ^ 说明 ^
| ''$schema'' | JSON Schema，提供自动补全 |
| ''npm'' | SDK 包名 |
| ''name'' | 显示名称 |
| ''options.baseURL'' | API 地址 |
| ''models'' | 模型配置列表 |
| ''limit.context'' | 上下文窗口大小 |
| ''limit.output'' | 最大输出 token 数 |

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

  - 打开 OpenCode Desktop
  - 点击左下角 **Connect provider**
  - 输入 ''duojie''
  - 输入你在令牌页面生成的 API Key

==== 第五步：选择模型 ====

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

----

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

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

==== 安装方法 ====

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

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

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

==== 配置完成后 ====

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

==== Oh My OpenCode 功能简介 ====

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

----

===== 常用命令速查 =====

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

----

===== 常见问题 =====

**Q: 提示 401 错误？**

A: API Key 无效或未设置。检查环境变量是否正确设置。

----

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

A: ''opencode.json'' 格式错误。使用[[https://jsonlint.com/|在线 JSON 校验工具]]检查语法。

----

**Q: 如何更新 OpenCode？**

A: 重新运行安装命令即可覆盖更新。

----

===== 官方资源 =====

  * [[https://opencode.ai/docs|OpenCode 官方文档]]
  * [[https://github.com/anomalyco/opencode|OpenCode GitHub]]
  * [[https://github.com/code-yeongyu/oh-my-opencode|Oh My OpenCode GitHub]]
  * [[https://api.duojie.games|DuoJie API 令牌页面]]