====== OpenCode 安装配置指南 ====== 配置完成后使用 /model 切换模型！ ===== 简要步骤说明 ===== **完整配置只需 5 步：** - **步骤1** - 安装 OpenCode Desktop - **步骤2** - 找到配置文件位置 - **步骤3** - 配置第三方渠道 - **步骤4** - 连接 Provider 并输入 API Key - **步骤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/opencode'' 或 ''xdg-open ~/.config/opencode'' ==== 第三步：配置第三方渠道 ==== === 获取 API Key === - API Key 需要在 [[https://huanyuf.top/|本站控制台]] 的令牌页面自行生成创建 === 配置示例 === 在 ''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 ==== - 打开 OpenCode Desktop - 点击左下角 **Connect provider** - 输入 ''huanyu'' - 输入你在令牌页面生成的 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 会自动读取官方文档并完成所有配置步骤。 ==== 配置完成后 ==== - **重启 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 无效或未设置。检查 ''opencode.json'' 中 ''options.apiKey'' 是否正确填写，或是否已在 Connect provider 中正确输入。 ---- **Q: 模型列表中看不到配置的模型？** A: ''opencode.json'' 格式错误。使用 [[https://jsonlint.com/|在线 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" ===== 官方资源 ===== * [[https://opencode.ai/docs|OpenCode 官方文档]] * [[https://opencode.ai/download|OpenCode 下载地址]] * [[https://github.com/anomalyco/opencode|OpenCode GitHub]] * [[https://github.com/code-yeongyu/oh-my-opencode|Oh My OpenCode GitHub]] * [[https://huanyuf.top/|本站 API 控制台（令牌页面）]]