知识库:opencode指南
这是本文档旧的修订版！
目录
OpenCode 安装配置指南
配置完成后使用 /model 切换模型！
简要步骤说明
完整配置只需 4 步：
- 步骤1 - 安装 OpenCode：运行安装命令
- 步骤2 - 配置 API：在 opencode.json 中配置第三方渠道并设置环境变量
- 步骤3 - 安装 Oh My OpenCode 插件：在 OpenCode 中输入一句话即可
- 步骤4 - 切换模型：用 /model 切换到配置的模型
第一部分：安装配置 OpenCode
第一步：安装 OpenCode
第二步：配置文件位置
| 系统 | 配置文件路径 |
|---|---|
| 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/opencode或xdg-open ~/.config/opencode
第三步：配置第三方渠道 (duojie.games)
获取 API Key
- 闲鱼购买的兑换码是用于兑换额度的，不是 API Key
- 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 数 |
第五步：启动并选择模型
- 打开 OpenCode Desktop
- 在页面底部的下拉菜单中选择你配置的模型
第二部分：安装 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 会自动读取官方文档并完成所有配置步骤。
配置完成后
- 重启 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 格式错误。使用在线 JSON 校验工具检查语法。
Q: 如何更新 OpenCode？
A: 重新运行安装命令即可覆盖更新。
官方资源
知识库/opencode指南.1768463157.txt.gz · 最后更改: 由 邪让多杰
