用户工具

站点工具


知识库:opencode指南

这是本文档旧的修订版!


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
如果配置文件不存在,需要手动创建。

快速打开方式:

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

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

获取 API Key

  1. 闲鱼购买的兑换码是用于兑换额度的,不是 API Key
  2. API Key 需要在 令牌页面 自行生成创建

配置示例

opencode.json 中添加以下配置:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "duojie": {
      "npm": "@ai-sdk/anthropic",
      "name": "DuoJie",
      "options": {
        "baseURL": "https://api.duojie.games/v1"
      },
      "models": {
        "claude-opus-4-5-20251101": {
          "limit": { "context": 200000, "output": 8192 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "claude-opus-4-5-think": {
          "limit": { "context": 200000, "output": 16000 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "gemini-3-pro-preview": {
          "limit": { "context": 1000000, "output": 8192 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "glm-4.7": {
          "limit": { "context": 128000, "output": 4096 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "gpt-5.2": {
          "limit": { "context": 128000, "output": 16384 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        }
      }
    }
  }
}

配置字段说明

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

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

  1. 打开 OpenCode Desktop
  2. 点击左下角 Connect provider
  3. 输入 duojie
  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 功能简介

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

常用命令速查

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

常见问题

Q: 提示 401 错误?

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


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

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


Q: 如何更新 OpenCode?

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


官方资源

知识库/opencode指南.1768463424.txt.gz · 最后更改: 邪让多杰